4 Build Release Artifacts

This topic describes the systematic instruction to Build Release Artifacts option.

  1. Clean and Rebuild your project in Android Studio.
  2. In Android Studio, on the menu bar Click on Build → Edit Build Types → select release.
    Description of mnandrd25.png follows
    Description of the illustration mnandrd25.png
  3. Set Minify Enabled → True & click on Proguard File selection → Navigate to proguard-rules.pro (zigbank\platforms\android\app).
    Description of mnandrd26.png follows
    Description of the illustration mnandrd26.png
  4. Click OK → again click OK.
  5. In your mobile application, set below properties as mentioned below:
    1. LOGIN_SCOPE: openid
    2. SERVER_TYPE: OAUTH3

    Replace below $ variables with actual values as per bank's setup: (These values will be available in the mobile application cloud configuration guide).

    1. KEY_SERVER_URL: ${KEY_SERVER_URL}
    2. APP_CLIENT_ID: ${Client ID} - (generated in IDCS
    3. IDCS_URL: ${IDSC_URL}/oauth2/v1/token
    4. WEB_URL: ${WEB_URL}
    5. REDIRECT_URI: ${REDIRECT_URI} – (Set this value which is configured in IDCS mobile application)
    6. KEY_OAUTH_PROVIDER_URL: ${KEY_OAUTH_PROVIDER_URL}
  6. Domain Based Setup (This is same for OBDX servicing App).

    To use domain based setup enable below flag in app.properties file:

    <string name="DOMAIN_BASED_CATEGORIZATION">true</string>

  7. To Enable SSL.

    There are 2 levels of SSL checks added in the app. One is to check SSL on app launch only and another one is to check SSL for every api calls in UI. By default app launch SSL is enabled & UI SSL check is disabled. Bank can enable/disable SSL by using below properties.

  8. Enable/Disable Face biometric.

    Below flag is use to enable or disable Face biometric for alternate login in OBDX app.

    By default product support both biometric type i.e. Face & Fingerprint for alternate login.

  9. Domain Based Setup (This is same for OBDX servicing App).

    To use domain based setup, enable below flag in app.properties file -

    <string name="DOMAIN_BASED_CATEGORIZATION">true</string>
  10. For Generating Signed Apk: To Generate release-signed apk as follows:

    On menu bar click on Build → Generate Signed Apk.


    Description of mnandrd28.png follows
    Description of the illustration mnandrd28.png

    Description of mnandrd30.png follows
    Description of the illustration mnandrd30.png

    Description of mnandrd31.png follows
    Description of the illustration mnandrd31.png
  11. If you have an existing keystore.jks file then select choose Existing else click Create New.
    Description of mnandrd32.png follows
    Description of the illustration mnandrd32.png

    Description of mnandrd33.png follows
    Description of the illustration mnandrd33.png
  12. Select Build Type as Release, Signature Version as V1(JAR Signature) and V2(Full APK Signature) and Change APK Destination folder if you want and click Finish .
    Description of mnandrd35.png follows
    Description of the illustration mnandrd35.png
  13. This will generate APKby the given name and destination folder. Default APK Destination folder is zigbank\platforms\android\app\release.
  14. Run the App and select Device or Simulator.
  15. Repeat same steps (From step 8 and obdxwear as module) for OBDX Wear App for Release Signing. Use proguard-rules.pro from workspace_installer\zigbank\platforms\android\obdxwear using explorer. The select obdxwear as the module and follow same signing steps with same keystore.
  16. The application has a config page at launch to enter the URL of the server (for development only). To remove this page, update the config.xml as shown below:

    The application has config page to add URL. This is for development purpose only and can be removed using below step (Update content src tag).


    Description of mnandrd36.png follows
    Description of the illustration mnandrd36.png
  17. Application will work on https only, there is no support for http url further.
  18. Maintenance page configs-
    Enable below flag to
            show maintenance page when server is under maintenance       <string
            name="SHOW_MAINTENANCE_PAGE">true</string>      Also add the status code returned when server
            is under main in below property-      <string-array
            name="MAINTENANCE_PAGE_STATUS_CODE">        <item>Your Status
          Code</item>     </string-array>

    Note:

    You can add multiple status code.
  19. To disable caching in app, make below flag to false
    <bool name="ENABLE_CACHING">true</bool>
  20. To disable ssl pinning in app, make below flag to false
    <bool name="ENABLE_SSL">true</bool> in app.properties.
  21. To disable ssl pinning for ui in app, make below flag to false
    <bool name="ENABLE_SSL_FOR_UI ">true</bool> in app.properties
    .