OLD | NEW |
| (Empty) |
1 #!/usr/bin/python2.4 | |
2 # | |
3 # Copyright 2009-2010 Google Inc. | |
4 # | |
5 # Licensed under the Apache License, Version 2.0 (the "License"); | |
6 # you may not use this file except in compliance with the License. | |
7 # You may obtain a copy of the License at | |
8 # | |
9 # http://www.apache.org/licenses/LICENSE-2.0 | |
10 # | |
11 # Unless required by applicable law or agreed to in writing, software | |
12 # distributed under the License is distributed on an "AS IS" BASIS, | |
13 # WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. | |
14 # See the License for the specific language governing permissions and | |
15 # limitations under the License. | |
16 # ======================================================================== | |
17 | |
18 """ Build enterprise installers examples. | |
19 | |
20 This file contains the product-specific information for building an | |
21 MSI for remote installation in the enterprise. Product teams should only | |
22 need to modify this file. | |
23 APPTEAMS: | |
24 There are two ways to build such an MSI depending on whether the product's | |
25 installer is or contains an MSI. | |
26 """ | |
27 | |
28 Import('env') | |
29 | |
30 import urllib | |
31 from enterprise.installer import build_enterprise_installer | |
32 | |
33 # APPTEAMS: Change this value to False. | |
34 # Build the installer using build rules specific to Google Update builds. | |
35 BUILDING_WITH_GOOGLE_UPDATE = True | |
36 | |
37 # We need to build the custom_actions dll. | |
38 env.BuildSConscript('custom_actions') | |
39 | |
40 if BUILDING_WITH_GOOGLE_UPDATE and not env.Bit('no-tests'): | |
41 env.BuildSConscript('test') | |
42 | |
43 # APPTEAMS: | |
44 # Note about versions: Each released build needs to have a different Build | |
45 # number in the version "Major.Minor.Build.Qfe". The Qfe is ignored by MSI and | |
46 # only increasing it may cause both the old and new versions of the this MSI | |
47 # to exist side-by-side (http://msdn.microsoft.com/en-us/library/aa370859.aspx). | |
48 | |
49 # Custom action DLL name. | |
50 # Set this to the path to the DLL containing the error display custom action. | |
51 CUSTOM_ACTION_DLL = ('$STAGING_DIR/show_error_action.dll') | |
52 | |
53 # | |
54 # Applications with EXE installers | |
55 # | |
56 # Use this section to build an MSI that contains Google Update and a product's | |
57 # EXE installer. The EXE may not use an MSI installer internally. | |
58 # MSI installers cannot be wrapped in this way because nested MSI installs are | |
59 # discouraged, problematic, and deprecated from WiX. | |
60 | |
61 # APPTEAMS: Make appropriate call to BuildEnterpriseInstaller(). Example below. | |
62 | |
63 # This sample: | |
64 # * Builds multiple "products" (each product is actually a different version). | |
65 # Products are specified in an array of structures, which specify the values | |
66 # for each product. | |
67 # * Builds multiple pre-tagged brands and ap values for each "product." | |
68 def _BuildSampleForTest(): | |
69 ENTERPRISE_INSTALLER_PRODUCTS = [ | |
70 ('Save Arguments', '0.1.2.0', '{7DD1EF7B-D075-47c0-BD51-F624ED87CCF0}', | |
71 '&brand=mkfi', | |
72 '$MAIN_DIR/testing/unittest_support/SaveArguments.exe', | |
73 '/install 0.1.2.0', '/donotregister', '/silentuninstall 0.1.2.0', | |
74 CUSTOM_ACTION_DLL, | |
75 'SaveArguments_Enterprise_Installer_0.1.2.0'), | |
76 ('Save Arguments', '0.1.3.0', '{7DD1EF7B-D075-47c0-BD51-F624ED87CCF0}', | |
77 '&brand=mkfi', | |
78 '$MAIN_DIR/testing/unittest_support/SaveArguments.exe', | |
79 '/install 0.1.3.0', '/donotregister', '/silentuninstall 0.1.3.0', | |
80 CUSTOM_ACTION_DLL, | |
81 'SaveArguments_Enterprise_Installer_0.1.3.0'), | |
82 ] | |
83 | |
84 # Example of calling BuildEnterpriseInstaller with multiple brands and ap | |
85 # value combinations for each product. | |
86 BRAND_AP_COMBINATIONS = [ | |
87 ('FOOB', 'foobar'), | |
88 #('ENTA', 'enterprise'), | |
89 #('ENTB', 'enterprise'), | |
90 ] | |
91 | |
92 # Omaha only: Build the enterprise installer for each version of Omaha. | |
93 for omaha_version_info in env['omaha_versions_info']: | |
94 prefix = omaha_version_info.filename_prefix | |
95 | |
96 for combo in BRAND_AP_COMBINATIONS: | |
97 for product in ENTERPRISE_INSTALLER_PRODUCTS: | |
98 (product_name, product_version, product_guid, | |
99 product_custom_params, | |
100 product_installer_path, | |
101 product_installer_install_command, | |
102 product_installer_disable_update_registration_arg, | |
103 product_uninstaller_additional_args, | |
104 show_error_action_dll, | |
105 msi_base_name) = product | |
106 | |
107 product_custom_params = '&brand=' + combo[0] + '&ap=' + combo[1] | |
108 | |
109 build_enterprise_installer.BuildEnterpriseInstaller( | |
110 env, | |
111 product_name, product_version, product_guid, | |
112 product_custom_params, | |
113 product_installer_path, | |
114 product_installer_install_command, | |
115 product_installer_disable_update_registration_arg, | |
116 product_uninstaller_additional_args, | |
117 prefix + msi_base_name + '_' + combo[0], | |
118 '$MAIN_DIR/enterprise/installer', | |
119 show_error_action_dll, | |
120 '$STAGING_DIR/%sGoogleUpdateSetup.exe' % prefix, | |
121 output_dir = '$TARGET_ROOT/Test_Installers' | |
122 ) | |
123 | |
124 # Builds a sample enterprise installer based on a standalone installer. | |
125 # TODO(omaha): Use a standalone installer that does not wrap an MSI. This | |
126 # mechanism is not intended to be used for apps that use MSI installers. | |
127 # As is, Omaha tries to install the MSI but fails because the Windows | |
128 # Installer is busy. It takes a long time to fail because Omaha retries. | |
129 # TODO(omaha): This is a bad example because it uses MSI. See above. | |
130 def _BuildSampleStandaloneForTest(): | |
131 # Omaha only: Build the enterprise installer for each version of Omaha. | |
132 for omaha_version_info in env['omaha_versions_info']: | |
133 prefix = omaha_version_info.filename_prefix | |
134 | |
135 msi_base_name = 'TestFoo_Installer_1.0.101.0' | |
136 BRAND = 'ENTC' | |
137 AP = 'enterprise-C' | |
138 product_custom_params = '&brand=' + BRAND + '&ap=' + AP | |
139 | |
140 # Sample installer data, encoded for the command line. This sample uses a | |
141 # JSON format but the format is app-specific. | |
142 product_installer_data = ( | |
143 '{"enterprise":{"param1":true,"param2":true},"value1":"foo"}') | |
144 product_installer_data = urllib.quote(product_installer_data) | |
145 | |
146 build_enterprise_installer.BuildEnterpriseInstallerFromStandaloneInstaller( | |
147 env, | |
148 'Test Foo', | |
149 '1.0.101.0', | |
150 '{D6B08267-B440-4c85-9F79-E195E80D9937}', | |
151 product_custom_params, | |
152 '/silentuninstall', | |
153 product_installer_data, | |
154 ('$TARGET_ROOT/Test_Installers/' + | |
155 '%sUNOFFICIAL_TestFooStandaloneInstaller.exe' % (prefix)), | |
156 CUSTOM_ACTION_DLL, | |
157 prefix + msi_base_name + '_' + BRAND, | |
158 '$MAIN_DIR/enterprise/installer', | |
159 output_dir = '$TARGET_ROOT/Test_Installers' | |
160 ) | |
161 | |
162 if BUILDING_WITH_GOOGLE_UPDATE: | |
163 _BuildSampleForTest() | |
164 _BuildSampleStandaloneForTest() | |
165 | |
166 | |
167 # | |
168 # Applications with MSI installers | |
169 # | |
170 # To bundle Google Update with a product that has an MSI installer: | |
171 # * Build a .wixobj that contains the Google Update installation fragment | |
172 # by calling BuildGoogleUpdateFragment(). | |
173 # * Include the ComponentGoogleUpdate component in the appropriate feature in | |
174 # the product's WiX code. | |
175 # | |
176 # For an example, see instances of "enterprise" in the following files: | |
177 # omaha/test/test_foo.wxs.xml | |
178 # omaha/test/build.scons | |
OLD | NEW |