10 #
11 # This code is distributed in the hope that it will be useful, but WITHOUT
12 # ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
13 # FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
14 # version 2 for more details (a copy is included in the LICENSE file that
15 # accompanied this code).
16 #
17 # You should have received a copy of the GNU General Public License version
18 # 2 along with this work; if not, write to the Free Software Foundation,
19 # Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
20 #
21 # Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
22 # or visit www.oracle.com if you need additional information or have any
23 # questions.
24 #
25 #
26
27 MSG_Help=Usage: jpackage <mode> <options>\n\
28 \n\
29 where mode is one of: \n\
30 \ create-image\n\
31 \ Generates a platform-specific application image.\n\
32 \ create-installer\n\
33 \ Generates a platform-specific installer for the application.\n\
34 \ \n\
35 Sample usages:\n\
36 --------------\n\
37 \ Generate a modular application image:\n\
38 \ jpackage create-image -o outputdir -n name \\\n\
39 \ -m moduleName/className -p modulePath\n\
40 \ To provide your own options to jlink, run jlink separately:\n\
41 \ jlink --output app.runtime -m moduleName -p modulePath \\\n\
42 \ --no-header-files [<additional jlink options>...]\n\
43 \ jpackage -o outputdir -n name -m moduleName/className \\\n\
44 \ --runtime-image app-runtime\n\
45 \ Generate a non-modular application image:\n\
46 \ jpackage create-image -o outputdir -i inputdir -n name \\\n\
47 \ --main-class className --main-jar MyJar.jar\n\
48 \ Generate an application installer:\n\
49 \ jpackage create-installer -o outputdir -n name \\\n\
50 \ -m moduleName/className -p modulePath\n\
51 \ jpackage create-installer -i inputdir -o outputdir -n name \\\n\
52 \ --main-class package.ClassName --main-jar MyJar.jar\n\
53 \ jpackage create-installer -o outputdir -n <installer-name> \\\n\
54 \ --app-image <app image dir> [--installer-type <type>]\n\
55 \ Generate a Java runtime installer:\n\
56 \ jpackage create-installer -o outputdir -n name \\\n\
57 \ --runtime-image <runtime-image>\n\
58 \n\
59 Generic Options:\n\
60 \ @<filename> \n\
61 \ Read options and/or mode from a file \n\
62 \ --app-version <version>\n\
63 \ Version of the application and/or installer\n\
64 \ --copyright <copyright string>\n\
65 \ Copyright for the application\n\
66 \ --description <description string>\n\
67 \ Description of the application\n\
68 \ --help -h \n\
69 \ Print the usage text with a list and description of each valid\n\
70 \ option for the current platform to the output stream, and exit\n\
71 \ --name -n <name>\n\
72 \ Name of the application and/or installer\n\
73 \ --output -o <output path>\n\
74 \ Path where generated output file is placed\n\
75 \ (absolute path or relative to the current directory)\n\
76 \ --temp-root <file path>\n\
77 \ Path of a new or empty directory used to create temporary files\n\
78 \ (absolute path or relative to the current directory)\n\
79 \ If specified, the temp-root will not be removed upon the task\n\
80 \ completion and must be removed manually\n\
81 \ If not specified, a temporary directory will be created and\n\
82 \ removed upon the task completion.\n\
83 \ --vendor <vendor string>\n\
84 \ Vendor of the application\n\
85 \ --verbose\n\
86 \ Enables verbose output\n\
87 \ --version\n\
88 \ Print the product version to the output stream and exit\n\
89 \n\
90 \Options for creating the runtime image:\n\
91 \ --add-modules <module name>[,<module name>...]\n\
92 \ A comma (",") separated list of modules to add.\n\
93 \ This module list, along with the main module (if specified)\n\
94 \ will be passed to jlink as the --add-module argument.\n\
95 \ if not specified, either just the main module (if --module is\n\
96 \ specified), or the default set of modules (if --main-jar is \n\
97 \ specified) are used.\n\
98 \ --module-path -p <module path>...\n\
99 \ A {0} separated list of paths\n\
100 \ Each path is either a directory of modules or the path to a\n\
101 \ modular jar.\n\
102 \ (each path is absolute or relative to the current directory)\n\
103 \ --runtime-image <file path>\n\
104 \ Path of the predefined runtime image that will be copied into\n\
105 \ the application image\n\
106 \ (absolute path or relative to the current directory)\n\
107 \ If --runtime-image is not specified, jpackage will run jlink to\n\
108 \ create the runtime image using options:\n\
109 \ --strip-debug, --no-header-files, --no-man-pages, and\n\
110 \ --strip-native-commands. --bind-services will also be added if\n\
111 \ --add-modules is not specified.\n\
112 \n\
113 \Options for creating the application image:\n\
114 \ --files -f <input file>[{0}<input file>...]\n\
115 \ A {0} separated list of files in the input dir to be packaged\n\
116 \ If omitted, all files in the input directory will be packaged.\n\
117 \ --icon <icon file path>\n\
118 \ Path of the icon of the application bundle\n\
119 \ (absolute path or relative to the current directory)\n\
120 \ --input -i <input path>\n\
121 \ Path of the input directory that contains the files to be packaged\n\
122 \ (absolute path or relative to the current directory)\n\
123 \n\
124 \Options for creating the application launcher(s):\n\
125 \ --add-launcher <file path>\n\
126 \ Path to a Properties file that contains list of key, value pairs\n\
127 \ (absolute path or relative to the current directory)\n\
128 \ The keys "name" (required), "module", "add-modules",\n\
129 \ "main-jar", "main-class", "arguments", "java-options",\n\
130 \ "app-version", "icon", and "win-console" can be used.\n\
131 \ These options are added to, or used to overwrite, the original\n\
132 \ command line options when building an additional launcher.\n\
133 \ --arguments <main class arguments>\n\
134 \ Command line arguments to pass to the main class if no command\n\
135 \ line arguments are given to the launcher\n\
136 \ --java-options <java options>\n\
137 \ Options to pass to the Java runtime\n\
138 \ --main-class <class name>\n\
139 \ Qualified name of the application main class to execute\n\
140 \ This option can only be used if --main-jar is specified.\n\
141 \ --main-jar <main jar file>\n\
142 \ The main JAR of the application; containing the main class\n\
143 \ (specified as a path relative to the input path)\n\
144 \ Either --module or --main-jar option can be specified but not\n\
145 \ both.\n\
146 \ --module -m <module name>[/<main class>]\n\
147 \ The main module (and optionally main class) of the application\n\
148 \ This module must be located on the module path.\n\
149 \ When this option is specified, the main module will be linked\n\
150 \ in the Java runtime image. Either --module or --main-jar\n\
151 \ option can be specified but not both.\n\
152 {2}\n\
153 \Options for creating the application installer(s):\n\
154 \ --app-image <file path>\n\
155 \ Location of the predefined application image that is used\n\
156 \ to build an installable package\n\
157 \ (absolute path or relative to the current directory)\n\
158 \ See the create-image mode options to create the application image.\n\
159 \ --file-associations <file path>\n\
160 \ Path to a Properties file that contains list of key, value pairs\n\
161 \ (absolute path or relative to the current directory)\n\
162 \ The keys "extension", "mime-type", "icon", and "description"\n\
163 \ can be used to describe the association.\n\
164 \ --identifier <id string>\n\
165 \ Machine readable identifier of the application\n\
166 \ The format must be a DNS name in reverse order,\n\
167 \ such as com.example.myapplication.\n\
168 \ --install-dir <file path>\n\
169 \ {4}\
170 \ --installer-type <type> \n\
171 \ The type of the installer to create\n\
172 \ Valid values are: {1} \n\
173 \ If this option is not specified (in create-installer mode) all\n\
174 \ supported types of installable packages for the current\n\
175 \ platform will be created.\n\
176 \ --license-file <file path>\n\
177 \ Path to the license file\n\
178 \ (absolute path or relative to the current directory)\n\
179 \ --resource-dir <path>\n\
180 \ Path to override jpackage resources\n\
181 \ Icons, template files, and other resources of jpackage can be\n\
182 \ over-ridden by adding replacement resources to this directory.\n\
183 \ (absolute path or relative to the current directory)\n\
184 \ --runtime-image <file-path>\n\
185 \ Path of the predefined runtime image to install\n\
186 \ (absolute path or relative to the current directory)\n\
187 \ Option is required when creating a runtime installer.\n\
204 \ Adds the application to the system menu\n\
205 \ --win-menu-group <menu group name>\n\
206 \ Start Menu group this application is placed in\n\
207 \ --win-per-user-install\n\
208 \ Request to perform an install on a per-user basis\n\
209 \ --win-registry-name <registry name>\n\
210 \ Name of the application for registry references.\n\
211 \ The default is the Application Name with only\n\
212 \ alphanumerics, dots, and dashes (no whitespace)\n\
213 \ --win-shortcut\n\
214 \ Creates a desktop shortcut for the application\n\
215 \ --win-upgrade-uuid <id string>\n\
216 \ UUID associated with upgrades for this package\n\
217
218 MSG_Help_win_install_dir=\
219 \Relative sub-path under the default installation location\n\
220
221 MSG_Help_mac_launcher=\
222 \ --mac-bundle-identifier <ID string>\n\
223 \ An identifier that uniquely identifies the application for MacOSX\n\
224 \ (and on the Mac App Store)\n\
225 \ May only use alphanumeric (A-Z,a-z,0-9), hyphen (-),\n\
226 \ and period (.) characters.\n\
227 \ --mac-bundle-name <name string>\n\
228 \ Name of the application as it appears in the Menu Bar\n\
229 \ This can be different from the application name.\n\
230 \ This name must be less than 16 characters long and be suitable for\n\
231 \ displaying in the menu bar and the application Info window.\n\
232 \ Defaults to the application name.\n\
233 \ --mac-bundle-signing-prefix <prefix string>\n\
234 \ When signing the application bundle, this value is prefixed to all\n\
235 \ components that need to be signed that don't have\n\
236 \ an existing bundle identifier.\n\
237 \ --mac-sign\n\
238 \ Request that the bundle be signed\n\
239 \ --mac-signing-keychain <file path>\n\
240 \ Path of the keychain to use\n\
241 \ (absolute path or relative to the current directory)\n\
242 \ If not specified, the standard keychains are used.\n\
243 \ --mac-signing-key-user-name <user name>\n\
244 \ User name portion of the typical\n\
|
10 #
11 # This code is distributed in the hope that it will be useful, but WITHOUT
12 # ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
13 # FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
14 # version 2 for more details (a copy is included in the LICENSE file that
15 # accompanied this code).
16 #
17 # You should have received a copy of the GNU General Public License version
18 # 2 along with this work; if not, write to the Free Software Foundation,
19 # Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
20 #
21 # Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
22 # or visit www.oracle.com if you need additional information or have any
23 # questions.
24 #
25 #
26
27 MSG_Help=Usage: jpackage <mode> <options>\n\
28 \n\
29 where mode is one of: \n\
30 \ create-app-image\n\
31 \ Generates a platform-specific application image.\n\
32 \ create-installer\n\
33 \ Generates a platform-specific installer for the application.\n\
34 \ \n\
35 Sample usages:\n\
36 --------------\n\
37 \ Generate a non-modular application image:\n\
38 \ jpackage create-app-image -o outputdir -i inputdir -n name \\\n\
39 \ --main-class className --main-jar MyJar.jar\n\
40 \ Generate a modular application image:\n\
41 \ jpackage create-app-image -o outputdir -n name \\\n\
42 \ -p modulePath -m moduleName/className\n\
43 \ To provide your own options to jlink, run jlink separately:\n\
44 \ jlink --output appRuntimeImage -p ModulePath -m moduleName\\\n\
45 \ --no-header-files [<additional jlink options>...]\n\
46 \ jpackage create-app-image -o outputdir -n name\\\n\
47 \ -m moduleName/className --runtime-image appRuntimeIMage\n\
48 \ Generate an application installer:\n\
49 \ jpackage create-installer -o outputdir -n name \\\n\
50 \ -p modulePath -m moduleName/className\n\
51 \ jpackage create-installer -i inputdir -o outputdir -n name \\\n\
52 \ --main-class package.ClassName --main-jar MyJar.jar\n\
53 \ jpackage create-installer -o outputdir -n <installer-name> \\\n\
54 \ --app-image <app image dir> [--installer-type <type>]\n\
55 \ Generate a Java runtime installer:\n\
56 \ jpackage create-installer -o outputdir -n name \\\n\
57 \ --runtime-image <runtime-image>\n\
58 \n\
59 Generic Options:\n\
60 \ @<filename> \n\
61 \ Read options and/or mode from a file \n\
62 \ This option can be used multiple times.\n\
63 \ --app-version <version>\n\
64 \ Version of the application and/or installer\n\
65 \ --copyright <copyright string>\n\
66 \ Copyright for the application\n\
67 \ --description <description string>\n\
68 \ Description of the application\n\
69 \ --help -h \n\
70 \ Print the usage text with a list and description of each valid\n\
71 \ option for the current platform to the output stream, and exit\n\
72 \ --name -n <name>\n\
73 \ Name of the application and/or installer\n\
74 \ --output -o <output path>\n\
75 \ Path where generated output file is placed\n\
76 \ (absolute path or relative to the current directory)\n\
77 \ --temp-root <file path>\n\
78 \ Path of a new or empty directory used to create temporary files\n\
79 \ (absolute path or relative to the current directory)\n\
80 \ If specified, the temp-root will not be removed upon the task\n\
81 \ completion and must be removed manually\n\
82 \ If not specified, a temporary directory will be created and\n\
83 \ removed upon the task completion.\n\
84 \ --vendor <vendor string>\n\
85 \ Vendor of the application\n\
86 \ --verbose\n\
87 \ Enables verbose output\n\
88 \ --version\n\
89 \ Print the product version to the output stream and exit\n\
90 \n\
91 \Options for creating the runtime image:\n\
92 \ --add-modules <module name>[,<module name>...]\n\
93 \ A comma (",") separated list of modules to add.\n\
94 \ This module list, along with the main module (if specified)\n\
95 \ will be passed to jlink as the --add-module argument.\n\
96 \ if not specified, either just the main module (if --module is\n\
97 \ specified), or the default set of modules (if --main-jar is \n\
98 \ specified) are used.\n\
99 \ This option can be used multiple times.\n\
100 \ --module-path -p <module path>...\n\
101 \ A {0} separated list of paths\n\
102 \ Each path is either a directory of modules or the path to a\n\
103 \ modular jar.\n\
104 \ (each path is absolute or relative to the current directory)\n\
105 \ This option can be used multiple times.\n\
106 \ --runtime-image <file path>\n\
107 \ Path of the predefined runtime image that will be copied into\n\
108 \ the application image\n\
109 \ (absolute path or relative to the current directory)\n\
110 \ If --runtime-image is not specified, jpackage will run jlink to\n\
111 \ create the runtime image using options:\n\
112 \ --strip-debug, --no-header-files, --no-man-pages, and\n\
113 \ --strip-native-commands. --bind-services will also be added if\n\
114 \ --add-modules is not specified.\n\
115 \n\
116 \Options for creating the application image:\n\
117 \ --icon <icon file path>\n\
118 \ Path of the icon of the application bundle\n\
119 \ (absolute path or relative to the current directory)\n\
120 \ --input -i <input path>\n\
121 \ Path of the input directory that contains the files to be packaged\n\
122 \ (absolute path or relative to the current directory)\n\
123 \ All files in the input directory will be packaged into the\n\
124 \ application image.\n\
125 \n\
126 \Options for creating the application launcher(s):\n\
127 \ --add-launcher <launcher name>=<file path>\n\
128 \ Name of launcher, and a path to a Properties file that contains\n\
129 \ a list of key, value pairs\n\
130 \ (absolute path or relative to the current directory)\n\
131 \ The keys "module", "add-modules", "main-jar", "main-class",\n\
132 \ "arguments", "java-options", "app-version", "icon", and\n\
133 \ "win-console" can be used.\n\
134 \ These options are added to, or used to overwrite, the original\n\
135 \ command line options to build an additional alternative launcher.\n\
136 \ The main application launcher will be built from the command line\n\
137 \ options. Additional alternative launchers can be built using\n\
138 \ this option, and this option can be used multiple times to\n\
139 \ build multiple additional launchers. \n\
140 \ --arguments <main class arguments>\n\
141 \ Command line arguments to pass to the main class if no command\n\
142 \ line arguments are given to the launcher\n\
143 \ This option can be used multiple times.\n\
144 \ --java-options <java options>\n\
145 \ Options to pass to the Java runtime\n\
146 \ This option can be used multiple times.\n\
147 \ --main-class <class name>\n\
148 \ Qualified name of the application main class to execute\n\
149 \ This option can only be used if --main-jar is specified.\n\
150 \ --main-jar <main jar file>\n\
151 \ The main JAR of the application; containing the main class\n\
152 \ (specified as a path relative to the input path)\n\
153 \ Either --module or --main-jar option can be specified but not\n\
154 \ both.\n\
155 \ --module -m <module name>[/<main class>]\n\
156 \ The main module (and optionally main class) of the application\n\
157 \ This module must be located on the module path.\n\
158 \ When this option is specified, the main module will be linked\n\
159 \ in the Java runtime image. Either --module or --main-jar\n\
160 \ option can be specified but not both.\n\
161 {2}\n\
162 \Options for creating the application installer(s):\n\
163 \ --app-image <file path>\n\
164 \ Location of the predefined application image that is used\n\
165 \ to build an installable package\n\
166 \ (absolute path or relative to the current directory)\n\
167 \ See create-app-image mode options to create the application image.\n\
168 \ --file-associations <file path>\n\
169 \ Path to a Properties file that contains list of key, value pairs\n\
170 \ (absolute path or relative to the current directory)\n\
171 \ The keys "extension", "mime-type", "icon", and "description"\n\
172 \ can be used to describe the association.\n\
173 \ This option can be used multiple times.\n\
174 \ --identifier <id string>\n\
175 \ An identifier that uniquely identifies the application\n\
176 \ Defaults to the main class name.\n\
177 \ The value should be a valid DNS name.\n\
178 \ --install-dir <file path>\n\
179 \ {4}\
180 \ --installer-type <type> \n\
181 \ The type of the installer to create\n\
182 \ Valid values are: {1} \n\
183 \ If this option is not specified (in create-installer mode) all\n\
184 \ supported types of installable packages for the current\n\
185 \ platform will be created.\n\
186 \ --license-file <file path>\n\
187 \ Path to the license file\n\
188 \ (absolute path or relative to the current directory)\n\
189 \ --resource-dir <path>\n\
190 \ Path to override jpackage resources\n\
191 \ Icons, template files, and other resources of jpackage can be\n\
192 \ over-ridden by adding replacement resources to this directory.\n\
193 \ (absolute path or relative to the current directory)\n\
194 \ --runtime-image <file-path>\n\
195 \ Path of the predefined runtime image to install\n\
196 \ (absolute path or relative to the current directory)\n\
197 \ Option is required when creating a runtime installer.\n\
214 \ Adds the application to the system menu\n\
215 \ --win-menu-group <menu group name>\n\
216 \ Start Menu group this application is placed in\n\
217 \ --win-per-user-install\n\
218 \ Request to perform an install on a per-user basis\n\
219 \ --win-registry-name <registry name>\n\
220 \ Name of the application for registry references.\n\
221 \ The default is the Application Name with only\n\
222 \ alphanumerics, dots, and dashes (no whitespace)\n\
223 \ --win-shortcut\n\
224 \ Creates a desktop shortcut for the application\n\
225 \ --win-upgrade-uuid <id string>\n\
226 \ UUID associated with upgrades for this package\n\
227
228 MSG_Help_win_install_dir=\
229 \Relative sub-path under the default installation location\n\
230
231 MSG_Help_mac_launcher=\
232 \ --mac-bundle-identifier <ID string>\n\
233 \ An identifier that uniquely identifies the application for MacOSX\n\
234 \ Defaults to the value of --identifier option.\n\
235 \ May only use alphanumeric (A-Z,a-z,0-9), hyphen (-),\n\
236 \ and period (.) characters.\n\
237 \ --mac-bundle-name <name string>\n\
238 \ Name of the application as it appears in the Menu Bar\n\
239 \ This can be different from the application name.\n\
240 \ This name must be less than 16 characters long and be suitable for\n\
241 \ displaying in the menu bar and the application Info window.\n\
242 \ Defaults to the application name.\n\
243 \ --mac-bundle-signing-prefix <prefix string>\n\
244 \ When signing the application bundle, this value is prefixed to all\n\
245 \ components that need to be signed that don't have\n\
246 \ an existing bundle identifier.\n\
247 \ --mac-sign\n\
248 \ Request that the bundle be signed\n\
249 \ --mac-signing-keychain <file path>\n\
250 \ Path of the keychain to use\n\
251 \ (absolute path or relative to the current directory)\n\
252 \ If not specified, the standard keychains are used.\n\
253 \ --mac-signing-key-user-name <user name>\n\
254 \ User name portion of the typical\n\
|