Login
    Contents x
    Customization Tool via command-line
    • 23 Oct 2024
    • 4 Minutes to read
    • Dark
      Light
    • PDF
    Contents

    Customization Tool via command-line

    • Updated on 23 Oct 2024
    • 4 Minutes to read
    • Dark
      Light
    • PDF
    Article summary

    To open the Customization Tool in Microsoft Windows, open a terminal window and type the following command:

    java -Djava.util.logging.config.file=core/logging.properties -cp lib\vasco\dp4mobile-tools.jar;lib\vasco\UtilitiesSDK.jar;lib\ant\ant.jar com.vasco.dp4mobile.customization.launcher.LauncherCMD

    To open the Customization Tool in Linux and macOS, open a terminal window and type the following command:

    java -Djava.util.logging.config.file=core/logging.properties -cp lib/vasco/dp4mobile-tools.jar:lib/vasco/UtilitiesSDK.jar:lib/ant/ant.jar com.vasco.dp4mobile.customization.launcher.LauncherCMD

    The customization parameters must be added at the end of the command line.

    java -Djava.util.logging.config.file=core/logging.properties -cp lib/vasco/dp4mobile-tools.jar:lib/vasco/UtilitiesSDK.jar:lib/ant/ant.jar com.vasco.dp4mobile.customization.launcher.LauncherCMD -customizationAndroid true -binaryName MY_APP -androidKeystorePassword myApkKeystorePassword -androidCertificateName myApkCertificateName -androidCertificatePassword myApkCertificatePassword -androidAabSignatureEnabled true -androidAabKeystorePassword myAabKeystorePassword -androidAabCertificateName myAabCertificateName -androidAabCertificatePassword myAabCertificatePassword

    Command-line options

    Common command-line options

    Option

    Parameter

    Description

    -customizationAndroid

    [{true | false}]

    Indicates whether customization is for Android. The default value is false.

    -customizationIOS

    [{true | false}]

    Indicates whether customization is for iOS. The default value is false.

    -binaryName

    BINARYNAME

    Use the binary with the name BINARYNAME. The binary name is the unique identifier of your application on the mobile phone.

    Several applications can have the same application name, however, each one must have its own binary name.

    The binary name can consist of uppercase or lowercase letters and numbers. However, it needs to start with a letter.

    The default value is DIGIPASS.

    -versionNumber

    VERSION

    Set the version number to VERSION. The version number must contain three or four numbers between 0 and 99. These numbers are separated by a period (e.g. 1.2.3, 11.22.33, 1.2.33.4 are valid, but 1.2 and 1.22.333 are invalid).

    This is the version number of your application as displayed on the device.

    Mobile Authenticator Studio embeds its own build version number, which can be displayed in the application.

    The default value is the current release version.

    -iconName

    ICONNAME

    Use the icon with the name ICONNAME.

    The default value is icon.png.

    For the iOS version, see iOS icon.

    To customize Mobile Authenticator Studio for iOS, a list of icons is required. The name of the different icons and their size is defined in iOS icons naming convention.

    Command-line options for Android

    Option

    Parameter

    Description

    -androidApplicationIDEnabled

    [{true | false}]

    Indicates whether the application identifier is enabled. If enabled, the androidApplicationID option is mandatory.

    -androidApplicationID

    APPLICATIONIDENTIFER

    Use the application identifier (package name) parameter to uniquely identify the customized application on the Play Store. Only lowercase/uppercase letters, numbers, dots and underscores are supported. It must have at least two segments (one or more dots) and each segment must start with a letter.

    If the value for this parameter is not set, the unique application identifier is set to com.+BINARYNAME

    -androidAutoLaunchEnabled

    [{true | false}]

    Indicates whether the launch of the application via a web browser is enabled. If enabled, the androidScheme option is mandatory.

    For more information, refer to the Mobile Authenticator Studio Product Guide.

    -androidScheme

    SCHEME

    Use the auto-launch scheme SCHEME to launch the application via a web browser. Only lowercase letters are supported.

    For more information, refer to the Mobile Authenticator Studio Product Guide.

    -androidApkSignatureEnabled

    [{true | false}]

    Indicates whether the APK binary is signed with the given certificate. If enabled, the androidKeystorePassword, androidCertificateName and androidCertificatePassword options are mandatory. If disabled, the default debug certificate ($HOME/.android/debug.keystore) will be used to sign the APK binary. If this certificate doesn't exist, then the application will not be signed.

    If the androidKeystorePassword, androidCertificateName and androidCertificatePassword options are given in command line, this option is silently set to true.

    -androidKeystorePassword

    PASSWORD

    The password of the keystore that contains the certificate used to sign the APK.

    -androidCertificateName

    CERTNAME

    Use the certificate with the name CERTNAME to sign the APK binary.

    -androidCertificatePassword

    CERTPASSWORD

    The password of the certificate which will be used to sign the APK binary.

    -androidAabSignatureEnabled

    [{true | false}]

    Indicates whether the AAB binary is signed with the given certificate. If enabled, the androidAabKeystorePassword, androidAabCertificateName and androidAabCertificatePassword options are mandatory. If disabled, the AAB binary will not be signed.

    If the androidAabKeystorePassword, androidAabCertificateName and androidAabCertificatePassword options are given in command line, this option is silently set to true.

    -androidAabKeystorePassword

    PASSWORD

    The password of the keystore that contains the certificate used to sign the AAB.

    -androidAabCertificateName

    CERTNAME

    Use the certificate with the name CERTNAME to sign the AAB binary.

    -androidAabCertificatePassword

    CERTPASSWORD

    The password of the certificate which will be used to sign the AAB binary.

    -androidVersionCode

    VERSIONCODE

    Set the version number to VERSIONCODE. The version code is an integer value which represents the version of your application.

    -androidVersionCode is used to set the version of the application.

    -versionNumber is displayed to the user.

    You can set the value to any integer, but make sure that each subsequent release of your application uses a greater value.

    The default value is the current release version.

    -androidScreenshotEnabled

    [{true | false}]

    Indicates if it will be possible to allow screenshots of the application. If enabled (true) the output file name will be suffixed with _UNSECURE.

    For security reasons, it is recommended to publish applications that have been generated with this option disabled (false).

    The default value is false.

    In previous Mobile Authenticator Studio versions, the application version was not customizable. If you want to update your application from an old Mobile Authenticator Studio version, you need to set a correct version code, considering that the previous version code was built from the version number (e.g. the version number 3.5.5 has the version code 3550).

    Command-line options for iOS

    Option

    Parameter

    Description

    -iOSDeploymentTarget

    [{universal | iphone | ipad}]

    Use the deployment target TARGET.

    • universal: The binary can be used on both iPhone and iPad.

    • iphone: The binary can be used on iPhone only.

    • ipad: The binary can be used on iPad only.

    The default value is universal.

    -iOSAutoLaunchEnabled

    [{true | false}]

    Indicates whether the launch of the application via a web browser is enabled. If enabled, the option iOSScheme is mandatory.

    For more information, refer to the Mobile Authenticator Studio Product Guide.

    -iOSScheme

    SCHEME

    Use the auto-launch scheme SCHEME to launch the application via a web browser. Only lowercase letters are supported.

    The default value is digipass.

    For more information, refer to the Mobile Authenticator Studio Product Guide.

    -iOSCertificateIdentifier

    IDENTIFIER

    Use the certificate with the IDENTIFIER identifier to sign the binary.

    -iOSXCodePath

    PATH

    Indicates the XCode path. This parameter is optional.

    If not set, /Applications/Xcode.app is used.

    -iOSBuildNumber

    BUILDVERSION

    Sets the build number to BUILDVERSION.

    The version must contain only numbers that can be separated by a period (e.g. 123 or 1.2.1 or 1.2.4).

    The build version can be used to send multiple application builds with the same version number.

    This number needs to be incremented since last upload.

    By default, the value of the version number is used.

    Was this article helpful?
    What's Next
    Change password!
    Changing your password will log you out immediately. Use the new password to log back in.
    Change profile
    Success!
    First name must have atleast 2 characters. Numbers and special characters are not allowed.
    Last name must have atleast 1 characters. Numbers and special characters are not allowed.
    Enter a valid email
    Enter a valid password
    Your profile has been successfully updated.
    Logout
    ESC

    Ozzy, our interactive help assistant