Continuous Integration for Binary-Upload and Native-Publish

Binary-upload and Native-publish commands are introduced in MFCLI V8 SP4.

• binary-upload command uploads a client binary to Quantum Fabric. Supported platforms for client binaries are ios_phone, ios_tablet, android_phone, android_tablet, windows_phone, and web_phone.
• native-publish command publishes the native binaries to the environment.

binary-upload command

• To upload a native client binary to a Cloud (manage.kony.com) environment

   java -jar mfcli.jar binary-upload -u <user> -p <password> -t <account id> -a <app name> [-v <app version>] -bp <Path to binary> -plat <platform name> --binary-version <Binary version> --description <Description> --display-name <Display Name> --appIcon <Path to app icon> [-ssdirpath <Path to screenshots directory>] [--upgradable]

   For example:
  
      java -jar mfcli.jar binary-upload -u abc@kony.com -p password -t 100054321 -a MyApp -v 1.0 -bp "D:\\WorkDir\\iosClient.ipa" -plat ios_phone --binary-version 1.0.2 --description "This is iphone binary" --display-name "sampleDisplayName" --appIcon "D:\\WorkDir\\icon1.png" -ssdirpath "D:\\WorkDir\\screenshotsDir" --upgradable

• To upload a native client binary to an on premise installation

   java -jar mfcli.jar binary-upload -u <user> -p <password> -au <Identity URL> -cu <Console URL> -a <app name> [-v <app version>] -bp <Path to binary> -plat <platform name> --binary-version <Binary version> --description <Description> --appIcon <Path to app icon> [-ssdirpath <Path to screenshots directory>] [--upgradable]

   
  For example:
     java -jar mfcli.jar binary-upload -u abc@kony.com -p password -au http://10.10.24.79:8080 -cu http://10.10.24.78:8081 -a MyApp -v 1.0 -bp "D:\\WorkDir\\iosClient.ipa" -plat ios_phone --binary-version 1.0.2 --description "This is iphone binary" --display-name "sampleDisplayName" --appIcon "D:\\WorkDir\\icon1.png" -ssdirpath "D:\\WorkDir\\screenshotsDir" --upgradable

  • The following arguments are supported for the binary-upload command:

     For example, to get summary help on all the commands,
    java -jar mfcli.jar help binary-upload
    
    Usage: Run the self-executable JAR with relevant arguments. 
      Options:
          -t, --account
           9 digit id of the Kony Cloud account (visible in top right corner in Console) for e.g. 100054321. Not relevant for an on-premise installation.
      * -a, --app
           Name of the app to which binary to be uploaded.
        --appIcon
           Path to app icon
      * -bp, --binary-path
           Path to the client binary file .ipa or .apk
      * --binary-version
           The version of the client binary.
           Default: 1.0.0
        --channels
           Comma separated channel names of web build. Valid values are web_phone,web_tablet,responsive_web
        -cu, --console
           URL of Kony Fabric Console (without context path), relevant for on-premise installation only. For e.g. http://10.10.24.78:8081
      * --description
           Description of client binary.
      --display-name
           Display name of client binary.
        -au, --identity
           URL of Kony Fabric Identity Services (without context path), relevant for on-premise installation only. For e.g. http://10.10.24.79:8080
        --mfa
           If specified, multi-factor authentication is enabled. The secret key for multi-factor authentication required for generating one time password (OTP) needs to be specified in the properties file.
           Default: false
        -p, --password
           Password for the Kony user. This could be plain text or, encrypted using 'encrypt' command. This is mandatory.
      * -plat, --platform
           The platform of the client binary.
           Possible Values: [ios_phone, ios_tablet, android_phone, android_tablet, windows_phone, web_phone]
        -ssdirpath, --screenshot-directory-path
           Path to the screenshots folder.
      --upgradable 
    
           If true, marks the binary as upgradable in EAS
           Default: false
    
    
        -u, --user
           Kony user required for authentication, for e.g. abc@kony.com. This is mandatory.
        -v, --version
           The app version for which the binary to be uploaded.
           Default: 1.0 

 

native-publish command

The native-publish command helps you publish the native client binaries to the environment.

• To publish native client binaries to a Cloud (manage.kony.com) environment

   java -jar mfcli.jar native-publish -u <user> -p <password> -t <account id> -a <app name> [-v <app version>] -e <environment name> -cbmeta <client binary meta>

   For example:
  
      java -jar mfcli.jar native-publish -u abc@kony.com -p password -t 100054321 -a MyApp -v 2.0 -e MyEnv -cbmeta "{"ios_phone" : 1.2.1, "android_phone" : 1.2.0}"

• To publish native client binaries to an on premise installation

   java -jar mfcli.jar native-publish -u <user> -p <password> -au <Identity URL> -cu <Console URL> -a <app name> [-v <app version>] -e <environment name> -cbmeta <client binary meta>

   For example:
  
      java -jar mfcli.jar native-publish -u abc@kony.com -p password -au http://10.10.24.79:8080 -cu http://10.10.24.78:8081 -a MyApp -v 2.0 -e MyEnv -cbmeta "{"ios_phone" : 1.2.1, "android_phone" : 1.2.0}"

  • The following arguments are supported for the native-publish command:

     For example, to get summary help on all the commands,
    java -jar mfcli.jar help native-publish
    
    Usage: Run the self-executable JAR with relevant arguments. 
      Options:
          -t, --account
           9 digit id of the Kony Cloud account (visible in top right corner in Console) for e.g. 100054321. Not relevant for an on-premise installation.
      * -a, --app
           Name of the app to be published/unpublished.
      * -cbmeta, --clientbinary-meta
           Json string of native channel name vs binary version
        -cu, --console
           URL of Kony Fabric Console (without context path), relevant for on-premise installation only. For e.g. http://10.10.24.78:8081
      * -e, --environment
           Name of the environment to publish to/unpublish from.
        -au, --identity
           URL of Kony Fabric Identity Services (without context path), relevant for on-premise installation only. For e.g. http://10.10.24.79:8080
        --mfa
           If specified, multi-factor authentication is enabled. The secret key for multi-factor authentication required for generating one time password (OTP) needs to be specified in the properties file.
           Default: false
        -p, --password
           Password for the Kony user. This could be plain text or, encrypted using 'encrypt' command. This is mandatory.
        --release-lock
           Forcibly release lock taken by previous operation (use with caution) when doing a publish/unpublish.
           Default: false
        -u, --user
           Kony user required for authentication, for e.g. abc@kony.com. This is mandatory.
        --verbose
           If specified, prints details of all steps.
           Default: false
        -v, --version
           Version of the app to be published/unpublished.
           Default: 1.0