Please login to access all of the features of the Community Site.

App Switcher

The App Switcher points the Rock Core app at any Rock Mobile application, so you can see your own app on a real phone without publishing it. Use it while you build your app, to try changes on a sandbox before they reach your live app, and to run a pre-release build against your own server.

Opening the Switcher

Install the Rock Core app from the App Store or Google Play.

In the app, tap and hold the screen with two fingers. A small popup with app information appears. Tap App Switcher to change the server the app connects to.

The app information popup with the App Switcher button

Connection Fields

The App Switcher needs three values. You'll find all of them on your application's page under Admin Tools > Settings > Mobile Applications.

FieldWhere to find it
App IdThe Site/App Id in the top right of your application's page, or the number in the page's URL. Rock assigns it when the app is created, and it can't be changed.
API URLYour server's Public Application Root followed by /api, such as https://www.rockrms.com/api.
API KeyThe key you set when you created the application. If you change it during development, re-enter it in the App Switcher on every device you test with.

The Site/App Id on the application page

The App Id in the page URL

Important

Don't change the API Key after your app has been published to the stores. If it needs to change for any reason, reach out to App Factory for help.

When you're done, the form looks something like this:

The App Switcher form filled in

Tap Launch App to connect. The App Switcher remembers what you entered, so you only need to do this once per server.

Sandbox Testing

If your organization has a sandbox copy of Rock, test your app changes there first. Make your page and block changes on the sandbox, deploy them there, then enter the sandbox's App Id, API URL and API Key in the App Switcher. Your published app keeps loading from your production server, so the people using it won't see anything until you make the same changes there.

If your sandbox was copied from production, the App Id and API Key are usually the same as production, and only the API URL changes.

Pre-Release Builds

Pre-release builds of Rock Core from TestFlight and Firebase App Distribution include the App Switcher too. Some features in a pre-release build need a matching pre-release version of Rock, so a sandbox running that version is the best place to point one. See Pre-Release Testing to install a build.

Back to Rock Core

To connect back to the original Rock Core app, enter these values:

FieldValue
App Id36
API URLhttps://www.rockrms.com/api
API Keyrocksolidpihc

Troubleshooting

If the app won't connect, check these:

  • Typos: Re-check all three values, especially the API URL and API Key.
  • Deployment: The app has to be deployed first. Its status on the application page should show a green tag. See Deploying Your App.
  • Reachability: The phone has to reach your server over the internet. The app can't connect to localhost unless you expose it with a tool like ngrok.
  • Changed key: If someone changed the API Key, enter the new one in the App Switcher.