electricbolt / appfiguratesdk Public
ActionExample Extension
Pages 23
Documentation
UPGRADE 1.4.0 to 2.2.0
UPGRADE 2.1.1 to 2.2.0
UPGRADE 2.2.1 to 3.0.0
EXAMPLES
AppfigurateExample
ActionExample Extension
WatchExample
WatchExample Intent Extension
CONFIGURATION
APLConfiguration subclass
Custom executable actions
Supported property types
BOOL
NSInteger
float
double
plain NSString
encrypted NSString
Best practice
String Encryption util
Troubleshooting
UISlider icon types
Overrides
Advanced configuration
App Startup
Info.plist
WCSession
Additional functions
Display overridden config
SECURITY
Export compliance
Best practice
App Store compliance
TESTING
Automation testing
Clone this wiki locally
Setup
Reading current configuration
Changing and applying configuration
This example demonstrates configuring an iOS app extension. This specific example is an Action extension, but any iOS app extension type can be configured.
For Appfigurate to be able to configure app extensions the following must be observed:
-
APLConfiguration
subclass must be shared between the iOS app and app extension. - Since the configuration is stored in the keychain, the keychain must be shared between the iOS app and app extension.
For more information on keychain sharing and associated Info.plist
attributes, see Advanced Configuration.
Setup
- Assumes you've followed the prerequisites to install example app metadata.
- Select
ActionExample Extension (ObjC iOS)
orActionExample Extension (Swift iOS)
in Xcode scheme drop down. Tap run. - Xcode will prompt you with the following:

- Select
Photos
, then tap theRun
button. - The Photos app will be launched on the Simulator (or connected device).
- Select a photo.
- Tap the
Share
icon:

- The share sheet will appear. Scroll down to reveal the
ActionExample
row:

- The ActionExample app extension will now be launched. The example doesn't do anything with a photo, but it does display a storyboard of the current configuration that is shared with the containing iOS app AppfigurateExample.
Reading current configuration
- Launch Appfigurate. Tap
Example 2.0.0
. - The screen will briefly flash and control will be given back to Appfigurate. The current configuration will be displayed.
Changing and applying configuration
- Change the boolean switch to the opposite value.
- Tap the
Apply ⌄
button in navigation bar. The AppfigurateExample app will now be launched, and the configuration applied. - Launch the Photos app again. The ActionExample Extension should still be displayed, if not follow the instructions above to redisplay.
- The ActionExample app extension storyboard of the current configuration will be displayed. The value of the boolean should be updated to reflect the value you applied.

Copyright © 2013-2022 Electric Bolt Limited. Appfigurate is a trademark of Electric Bolt, registered in New Zealand