📱
Getting Started
👨💻
Developers
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 Core app available on the app stores.
In shell version 1, you could access the App Switcher by tapping an icon in the navbar. In version 2, we've removed this icon and replaced it with a two-finger hold gesture. Simply tap and hold the screen with two fingers and a small popup with app information will appear. Tapping the App Switcher button 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/apiAPI 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
Last modified 10mo ago
Copy link