Test and publish a new branded Android app for private distribution

  • Release version: Xanadu
  • Updated February 12, 2025
  • 2 minutes to read
    • Summarize
    Summarized using AI
    This content was generated using new OpenAI-powered functionality. Results are provided on an as is basis and are not guaranteed to be accurate or complete.

    Summary of Test and publish a new branded Android app for private distribution

    This guide outlines the essential steps for ServiceNow customers to test, configure, approve, customize, and publish a new branded Android app for private distribution after requesting it through Mobile Publishing.

    Show full answer Show less

    Testing the App

    • After a successful build, access the Request details page via All > Mobile Branding > Manage Mobile Publishing Apps and select your recent app request.
    • Download the Android APK testing file and distribute it to testers for installation on Android devices or emulators.
    • Verify branding elements such as app name, icon, splash screen, and theming align with your specifications.
    • Confirm the correct default instance is set for login if pre-fill was selected.
    • Ensure the End User License Agreement (EULA) and privacy policy links appear correctly in the app’s Legal settings.
    • Important: Use the same APK tested for deployment to maintain consistency.

    Setting Up the App

    Optional configurations after testing include:

    • Enable push notifications by adding your Google Firebase Cloud Messaging HTTPv1 OAuth token to the app’s push application record.
    • Test push notifications using out-of-the-box functionality.
    • Configure deep links by setting up an assetlinks.json file on each relevant instance.

    Approving or Rejecting the App

    • Once the app status is “Ready for testing,” you have 90 days to review it against branding requirements.
    • Reject the app to make branding or app detail changes.
    • Use the Duplicate option to create a new request based on the rejected app information.
    • Approve the build to proceed with publishing to end users.

    Customizing App Workflows

    Leverage Mobile App Builder to tailor your app’s workflows to better fit your organizational needs. This customization enhances user experience and operational efficiency.

    Publishing and Distribution

    After testing, setup, and customization, publish your branded Android app for private distribution through one of the following:

    • Your private distribution site
    • Managed Google Play Console (refer to Google documentation for publishing steps)
    • BlackBerry Portal if using BlackBerry MAM
    • Microsoft Intune by syncing the app from Google Play

    Maintaining Your App

    Keep your app updated at least annually or before updating your ServiceNow family version to ensure continued push notification functionality and access to the latest ServiceNow mobile features.

    Learn the next steps to test and publish a new branded Android app for private distribution after you request it in Mobile Publishing.

    1. Test the app

    After the build successfully completes and your app is ready for testing:
    1. Navigate to the Request details page by selecting All > Mobile Branding > Manage Mobile Publishing Apps > Your recent app requests.
    2. Select the card for your mobile app build request. The Request details page appears.

    3. Select the Android testing file link and the APK file is downloaded to your local system for testing:

      Mobile Publishing UI showing the Android .apk file download link

    4. Send the APK file to your testers via email so they can open the file on their Android device or in an emulator.

      See KB0727776 for information about how to install a mobile simulator and APK file on your computer so you can test the Android testing file.

    5. Check the following items on your app:
      • App has the correct name, icon, splash screen, branding, and theming. For more information, see Create a theme with Theme Builder.
      • App uses the default instance you specified for login if you selected the instance pre-fill option when you requested the branded app.
      • EULA and privacy policy listed in the mobile app Settings tab under Legal link to the policies you specified.
      Important:
      The APK file that was used during testing should also be used for deployment.

    2. Set up the app

    After testing completes successfully, you can set up your app for use. These configurations are optional.

    1. Set up push notifications by adding your Google Firebase Cloud Messaging HTTPv1 Oauth token to your app type's push application record.

      See KB1639289 for detailed instructions.

    2. Test push notifications using an out-of-the-box push notification.

      See KB0829093 for detailed instructions.

    3. Set up deep links for your app by configuring an assetlinks.json file on each instance.

      See KB1648690 for detailed instructions.

    3. Approve or reject the app

    Once the status of your app is Ready for testing, you have 90 days to make sure the app meets your branding requirements:
    • Reject the app to edit the branding, app name, app type, or any third-party information. Use the Duplicate option to copy information over to a new app request after you have rejected the app.
    • Approve the build to move forward with publishing the app to your end users.

    4. Customize your app's workflows

    Use Mobile App Builder to customize your app. See Mobile App Builder for detailed information about how you can customize your branded app.

    5. Publish and distribute your app

    After you have tested your app, set it up, and customize its workflows, you are ready to publish your branded Android app for private distribution. Upload your APK file to your private distribution site, the managed Google Play Console, or your enterprise mobility management (EMM) provider:
    Google Play Console:
    To publish your private branded Android app from the Google Play Console, see Google documentation.
    BlackBerry Portal:
    To publish your private branded Android app to the BlackBerry Portal if you are using BlackBerry mobile application management (MAM), see KB0813295.
    Microsoft Intune:
    To sync your private branded Android app from Google to Microsoft Intune, see Microsoft documentation.

    6. Keep your app updated

    Update your app before you update your ServiceNow® family version, or at least once per year to keep your push notifications working and to leverage the most up to date ServiceNow mobile features. For more information, see Tested devices and supported versions for ServiceNow mobile apps.