Skip to content

ActionExample Extension

Electric Bolt edited this page Jun 21, 2020 · 2 revisions



UPGRADE 1.4.0 to 2.2.0
UPGRADE 2.1.1 to 2.2.0
UPGRADE 2.2.1 to 3.0.0


    ActionExample Extension
    WatchExample Intent Extension

    APLConfiguration subclass
        Custom executable actions
        Supported property types
            plain NSString
            encrypted NSString
               Best practice
               String Encryption util
        UISlider icon types
    Advanced configuration
        App Startup
    Additional functions
    Display overridden config

    Export compliance
    Best practice
    App Store compliance

    Automation testing

Clone this wiki locally

  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.


  • Assumes you've followed the prerequisites to install example app metadata.
  • Select ActionExample Extension (ObjC iOS) or ActionExample Extension (Swift iOS) in Xcode scheme drop down. Tap run.
  • Xcode will prompt you with the following:
  • Select Photos, then tap the Run 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.