Select app

Starting Appfigurate for the first time, or when you have no app metadata records in your local database will result in the following screen.

If you have one or more apps:

A placeholder icon and title will be used until you configure the app for the first time. Once configured, the app metadata record will be updated and contain the app's actual icon, name and version number extracted from the app's Info.plist or AndroidManifest.xml.

Configuring an app

Tap on an app row to configure the app. If the app is installed on the device, then:

• iOS: the app will be run and made visible, it's configuration read, and then swap back to Appfigurate. You may be prompted with a dialog in the app to 'Open Appfigurate'. Click Yes. (This dialog will be displayed only once).

• watchOS: the companion iOS app will be run and made visible. The companion iOS app will read the watchOS apps configuration, then swap back to Appfigurate. You may be prompted with a dialog in the app to 'Open Appfigurate'. Click Yes. (This dialog will be displayed only once).

• Android: the app's configuration will be read in the background.

If the app is not installed on the device, then a dialog will be displayed with text similar to "The app Example is not installed on this iPhone Simulator".

If the configuration was read successfully, the Configure app screen is displayed.

Very occasionally, your app will remain visible while trying to read the configuration, instead of swapping back to Appfigurate. In this instance, manually swap back to Appfigurate and try again. The second time will succeed.

If you're attempting to configure a watchOS app, it must must be actively running in the foreground (the screen will appear at peak brightness) - the easiest way to confirm is to simply touch the screen before attempting to read or apply configuration. If the screen is dimmed, the watch is in a low power mode and the watch won't be able to communicate with it's paired iOS device.

The following error dialog will be displayed in your companion iOS app when low power mode is in effect:

Editing an app

Swipe the row from left to right to display an Edit button. Tapping the Edit button will display the Edit app screen.

Deleting an app

Swipe the row from right to left to display a Delete button. Tapping the Delete button will first confirm that you want to delete the app, then delete the app's metadata record from the local database.

Caution: If you haven't got a backup of the app's metadata record, then once it's deleted the app metadata record (specifically the private key) is gone forever.