buildscript { repositories { maven { url 'http://maven.ej-technologies.com/repository' } } dependencies { classpath group: 'com.install4j', name: 'install4j-gradle', version: '6.0' } }
Then you can apply the install4j plugin to your build script:
apply plugin: 'install4j'
The plugin has two parts: The global configuration with the top-level install4j {...} configuration block and tasks of type com.install4j.gradle.Install4jTask.
The global configuration block must specify the install4j installation directory:
install4j { installDir = file('/path/to/install4j_home') }
On macOS, the installation directory is inside the application bundle, for the default application directory the full path is /Applications/install4j.app/Contents/Resources/app
In addition, the global configuration block can set defaults for the install4j tasks.
Attribute | Description | Required | Global |
---|---|---|---|
projectFile | The install4j project file that should be build. | Yes | No |
variableFiles | Corresponds to the --var-file command line option. Specify the list of variable files with variable definitions. | No | No |
variables |
A map of variable definitions. These definitions override compiler variables in the project and correspond to the -D command line option. Definitions with variable elements take precedence before definitions in the variable file referenced by the variableFiles parameter. The names of the variables must have been defined on the Compiler Variables tab of the General Settings step. The values can be of any type, toString() will be called on each value to convert the value to a java.lang.String. For example: [variableOne: 'One', variableTwo: 2]. | No | No |
release | Corresponds to the --release command line option. Enter a version number like "3.1.2". Version number components can be alphanumeric and should be separated by dots, dashes or underscores. | No | No |
destination | Corresponds to the --destination command line option. Enter a directory where the generated media files should be placed. | No | No |
buildIds | Corresponds to the --build-ids command line option. Enter a list of media file ids. The IDs for media files can be shown in the install4j IDE by choosing Project->Show IDs from the main menu. For example: [12, 24, 36]. | No | No |
verbose | Corresponds to the --verbose command line option. Either true or false. | No, verbose and quiet cannot both be true | Yes |
quiet | Corresponds to the --quiet command line option. Either true or false. | Yes | |
license | Corresponds to the --licensecommand line option. If the license has not been configured yet, you can set the license key with this attribute. | Yes | |
test | Corresponds to the --test command line option. Either true or false. | No, test and incremental cannot both be true | Yes |
incremental | Corresponds to the --incremental command line option. Either true or false. | Yes | |
debug | Corresponds to the --debug command line option. Either true or false. | No | Yes |
preserve | Corresponds to the --preserve command line option. Either true or false. | No | Yes |
faster | Corresponds to the --faster command line option. Either true or false. | No | Yes |
disableSigning | Corresponds to the --disable-signing command line option. Either true or false. | No | Yes |
disableBundling | Corresponds to the --disable-bundling command line option. Either true or false. | No | Yes |
winKeystorePassword | Corresponds to the --win-keystore-password command line option. | No | Yes |
macKeystorePassword | Corresponds to the --mac-keystore-password command line option. | No | Yes |
buildSelected | Corresponds to the --build-selected command line option. Either true or false. | No | Yes |
mediaTypes | Corresponds to the --media-types command line option. Enter a list of media types. To see the list of supported media types, execute install4jc --list-media-types. | No | Yes |
vmParameters | A list of VM parameters for the install4j command line compiler process. For example: ['-DproxySet=true', '-DproxyHost=myproxy', '-DproxyPort=1234', '-DproxyAuth=true', '-DproxyAuthUser=buildServer', '-DproxyAuthPassword=iq4zexwb8et'] sets an HTTP proxy that is required for code signing. | No | Yes |
The "Global" column shows if a parameter can also be specified in the global install4j {...} configuration block. Definitions in the task override global definitions.
Simple example:
install4j { installDir = file('/opt/install4j') } task media(type: com.install4j.gradle.Install4jTask) { projectFile = file('myProject.install4j') }
Larger example:
if (!hasProperty('install4jHomeDir')) { File propertiesFile = file("${System.getProperty('user.home')}/.gradle/gradle.properties") throw new RuntimeException("Specify install4jHomeDir in $propertiesFile") } boolean dev = hasProperty('dev') install4j { installDir = file(install4jHomeDir) faster = dev disableSigning = dev winKeystorePassword = 'supersecretWin' macKeystorePassword = 'supersecretMac' if (dev) { mediaTypes = ['windows'] } } task media(type: com.install4j.gradle.Install4jTask) { dependsOn 'dist' // example task that prepares the distribution for install4j projectFile = 'myProject.install4j' variables = [majorVersion: version.substring(0, 1), build: 1234] variableFiles = ['var1.txt', 'var2.txt'] }
In the samples/hello directory, execute
gradle media
to start the build. If you have not defined install4jHomeDir in gradle.properties next to build.gradle, the build will fail with a corresponding error message.