How do I test changes in the editable copy?

Depending on the initial screen, there are 3 ways to test the editable copy of the app: the classic, phone number registration, and web view registration. Most changes in the editable copy of the app are provisioned with the settings.

Most changes in the editable copy of the app are actually provisioned with the settings, so as they are not part of the build, you need to provision the editable settings to test if your changes are reflected. To test the changes made to the editable settings, you need to provision them in the app.

Important: White-label options and certain white-label specific theme changes require a rebuild and new install to test. Settings-only changes appear by provisioning the editable copy.

How to test changes:

Load the editable copy (sandbox) by provisioning with an asterisk: sign in as username@CLOUDID*, add * in the Registration Wizard, or use a QR/link that ends with CLOUDID*.

Before you start

  • Reset the app so it re-provisions on next launch.
  • Keep one test device for editable, another for live to avoid confusion.

Reset the app:

  • Android: Settings icon → Settings → Settings → Reset Application.
  • iOS: Keypad tab → iOS Settings icon → Settings → Reset Application.
  • macOS/Windows: App settings icon → Reset.
Three ways to load the editable copy:

1) Classic initial screen (generic app)

The initial screen has a username and a password fields, and a QR code scanning option.

To provision the editable settings:

  1. To reset the app:
    • Android - Select Android Settings icon > Settings > Settings > Reset Application.
    • iOS - Open the Keypad tab, select iOS Setting iconSettings > Reset Application.
    • macOS or Windows - Select Cloud Softphone desktop app settings icon > Reset.
  2. Fill in the Cloud ID and Password fields.
    • Fill in your username in the Cloud ID field with the format username@CLOUDID*
    • Adding an asterisk (*) to the end of the Cloud ID is to let the app know to provision the editable settings.

Tip:

Go to faq.acrobits.net/how-do-i-test-the-application to view those initial screens of Android, iOS, and desktop apps.

Enter your Cloud ID and credentials. To load the editable copy, use username@CLOUDID* in the Cloud ID field. For live testing (no sandbox), use the same steps without the asterisk; see the live test guide here.

2) Phone Number Registration Wizard (white-label)

When the wizard asks for your number or username, append an asterisk at the end (for example, +15551234567*). The app maps * to the editable version of your Cloud ID.

  1. Reset the app.
  2. To provision editable settings, add an asterisk (*) to the end of your phone number when logging in.

3) QR code or link

Use a CSC link or QR that ends with the star, for example: csc:username:password@CLOUDID*. Format details are in the QR reference here.

Troubleshooting

  • No changes visible: Confirm you used the star (*). Reset and provision again.
  • Accidentally loaded live: Reset and provision with username@CLOUDID* (or add * in the wizard/QR).
  • QR/link not working: Check the format and that credentials with special characters are URL-encoded.