Deploying Your App

Deployment

Navigating to the Application page for your app shows the deployment status in the top right. New apps start as Not Deployed, so you'll need to click the Deploy button in the bottom right corner to test your app. The first deploy may take a few moments, but generally this process happens quickly.

Note that making changes to the app (like adding new pages and blocks or changing block settings and application colors) will require you to Deploy again, as well as reloading the app, to see the changes. Changes to Content blocks that have a Dynamic Content value of Yes will be shown without a new deployment. When a user opens the app and is shown the splash / launch screen the app is pulling the latest deployment from your server (or wherever your bundle is hosted).

Testing

The best way to test your application is using the Rock Mobile Showcase app available on the app stores.

Apple / iOS: https://apps.apple.com/us/app/rock-mobile-showcase/id1498547817 Google / Android: https://play.google.com/store/apps/details?id=org.sparkdevnetwork.rockmobile

Open the app once it's installed and tap the icon in the top right (phone with a downward arrow). This will allow you to change the server that the app on your device connects to.

The App Switcher page has three fields that are required to connect to your server. All of this information can be found by navigating to the application's internal page, under Home > CMS Configuration > Mobile Applications and selecting your app. Let's take a look at each of them.

Application Id

This is the ID given to the application by Rock when it is created. It cannot be changed. To find your application ID, navigate to the Application page and find the Site/App Id in the top right. Alternatively you can see the number in the URL bar.

API URL

This is simply the URL to your Rock server's API. The Public Application Root with /api will be your URL. For example: https://www.rockrms.com/api

API Key

This was configured when creating your application. You can change this value during development, but any apps using this key will need to update their App Switcher page in order to connect again.

You should not change this value after your app has been deployed to the stores. If it needs to be changed for any reason please reach out to Triumph for assistance.

When finished, your form will look something like this:

Tap the Launch App button to connect and view your app. The App Switcher page will remember what you've entered so you only have to do this once.

If the connection fails, double check that you've inserted the correct values and haven't mistyped anything. Also be sure that your app has been deployed and has a green status tag.

Rock Mobile Showcase

You can always connect back to the Rock Mobile Showcase if needed:

App Id 36

API URL https://www.rockrms.com/api

API Key rocksolidpihc