Edit app

The Edit app screen allows the developer of the app to perform some administration and integration functions on the app metadata record.

Header

The header displays the app's icon, title and the hash of the public key.

The hash of the public key is also output using one of the Output implementation rows. For instance:

override func publicKey() -> String {
  // 41 36 87 71 0D 05
  return "-----BEGIN PUBLIC KEY-----\n" +
  ...

If your app metadata record is not exportable (the exportable switch is off), then the header will display the number of days remaining before the app metadata record expires:

Expired app metadata records cannot be used to configure apps.

Exportable

The exportable switch when on (the default value after creation) indicates that this app metadata record can be exported/backed up. When the exportable switch is off the app metadata record cannot be exported/backed up. You can only change the exportable switch from on to off. A confirmation dialog will be displayed to ensure you want to perform this operation.

Caution: Ensure you have a backup of the app metadata record before you switch exportable to off. Once exportable is switched off it cannot be switched back on.

Ensure you read the best practice guide for app metadata records.

URL Scheme

If required, the URL Scheme that is used to launch your app in order to retrieve, apply or reset configuration can be modified. The application type (iOS, watchOS, Android) and the URL Scheme must be unique in the local database, otherwise an error dialog is displayed.

Select app

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

• iOS: the app will be run and made visible, configuration read, 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.

Delete app

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.

Export/Share app

You can export/share any exportable app metadata records so you can either share them to another Appfigurate instance, or for safe keeping.

Enter a passphrase used to encrypt the app metadata record. The passphrase must be 8 to 64 characters in length.

The Exportable switch is off by default, meaning that the app metadata record when imported into another device will not be able to be exported/backed up from that device.

If the Custom list items options switch is on, then any custom list items the user has entered in the app will be persisted in the app metadata record, allowing them to be imported into another device.

Tap the Next button to continue.

The Export screen has identical functionality to the Backup screen.

Duplicate app

If you already have an existing iOS or Android app metadata record, and you want your new iOS, watchOS or Android app to have the same public/private keypair, then use the Duplicate app function instead.

Library integration

The library integration section outputs sample app integration snippets including:

• Objective-C headers, implementation, UIAppDelegate, UIWindowSceneDelegate and Info.plist

• Swift implementation, UIAppDelegate, UIWindowSceneDelegate and Info.plist

• Java implementation and AndroidManifest.xml

• Kotlin implementation and AndroidManifest.xml

• Flutter implementation