Release History
Last updated
Last updated
3.2.0
3.2.0
3.2.0
3.2.0
3.2.0
3.2.0
3.2.1
3.1.0
3.2.1
Appfigurate 4.0.0 is currently in private beta.
App: Locally override configuration/feature toggles/flags. Tested and documented providers include and .
App: The Configuration screen now displays an additional header label if the app has remote properties. The label is either "App has received remote config" or "App is using default remote config". If the label says "App is using default remote config" and you are expecting non default values to be displayed, re-run your app and give it some time to allow the third party remote configuration provider to update itself. Then try again.
App: Change multiple list property values at the same time by selecting an environment. e.g. Dev, Test, PVT.
App: Properties in the Configuration screen are now sorted by alphabetical order.
App: Filter by value name on property list screen.
App: You can no longer . Instead the companion iOS app to create a new watchOS app using the same public/private keypair.
SDK: Added , , and annotations/property wrappers to support third party remote provider configuration/feature toggles/flags.
SDK: Appfigurate Library no longer supports having an iOS and watchOS app using different public/private key pairs. Instead the watchOS app must be changed to use the iOS companion app's public/private key pair. The ENCRYPTED_STRING_IOS_WATCHOS
function/macro has been removed. See the for migration guidance.
SDK: , , and repositories updated to demonstrate Firebase Remote Config and Launch Darkly integration. By default the apps use Firebase Remote Config, but can be changed using Appfigurate at runtime to use Launch Darkly (adjust the thirdPartyRemoteProvider property and restart the app).
AppfigurateSE: The Appfigurate Emulator for Android, feature no longer requires adb daemon root access. This allows for easier installation and testing of Google Play Services system images.
Xcode: 16.0+, Minimum deployment target: iOS 15.0, watchOS 5.0
Android Studio: Electric Eel 2024.2.2+, IntelliJ: 2024.3.0+, Minimum API level: Android 26 (Marshmallow 8.0)
Flutter: 3.27.0+ (Dart 3.6.0+)
SDK: iOS AppfigurateLibrary.xcframework now includes enhanced automation testing functionality:
App: Improved performance on the configuration screen, including refreshed design.
App: Filter by property name on configuration screen.
App: Access help from most screens in the app.
App: General bug fixes.
SDK: iOS and watchOS AppfigurateLibrary.xcframework resigned (Electric Bolt Limited, KLCLPVKM8C). No other changes applied.
Xcode: 15.2+, Minimum deployment target: iOS 13.0, watchOS 5.0
Android Studio: Electric Eel 2022.1.1+, IntelliJ: 2022.3+, Minimum API level: Android 26 (Marshmallow 8.0)
Flutter: 3.10.0+ (Dart 3.0.0+)
App: Bug fixes - Property with string text fields increased from 16 to 250 characters.
App: Bug fixes - Catch exception thrown from decryption of incorrect ENCRYPTED_STRING value.
App: Bug fixes - Display actual decryption error on Apply App screen.
App: iOS bug fixes - Crash after sending email.
Xcode: 14.3+, Minimum deployment target: iOS 13.0, watchOS 5.0
Android Studio: Electric Eel 2022.1.1+, IntelliJ: 2022.3+, Minimum API level: Android 26 (Marshmallow 8.0)
Flutter: 3.10.0+ (Dart 3.0.0+)
App: iOS bug fixes - Applied app configuration was not being kept for 7 days.
App: Android bug fixes - Reliability improvements for launching Android apps from Appfigurate.
Xcode: 14.2+, Minimum deployment target: iOS 13.0, watchOS 5.0
Android Studio: Electric Eel 2022.1.1+, IntelliJ: 2022.3+, Minimum API level: Android 26 (Marshmallow 8.0)
Flutter: 3.10.0+ (Dart 3.0.0+)
App: Bug fixes.
SDK: Improved algorithm for launching Android apps from Appfigurate (by task id).
AppfigurateSE: Bug fixes.
Xcode: 14.2+, Minimum deployment target: iOS 13.0, watchOS 5.0
Android Studio: Electric Eel 2022.1.1+, IntelliJ: 2022.3+, Minimum API level: Android 26 (Marshmallow 8.0)
Flutter: 3.10.0+ (Dart 3.0.0+)
App: Now available for Android Emulator and physical devices.
App: Upgrading to Appfigurate 3.0.0 from a previous version converts the database to a new format, therefore downgrading to an earlier version is not possible.
App: Appfigurate can no longer be used to apply configuration remotely.
SDK: The APLConfiguration customIdentifier
method is no longer supported and you should remove any subclass implementations.
SDK: AppfigurateLibrary.xcframework for watchOS now contains arm64 architecture alongside the existing arm64_32 and armv7k for physical devices.
If the app icon in a watchOS app is compiled into an Assets.car file, it won't be made available to Appfigurate and the default placeholder icon will be used instead.
Xcode: 14.0+, Minimum deployment target: iOS 13.0, watchOS 5.0
Android Studio: Electric Eel 2022.1.1+, IntelliJ: 2022.3+, Minimum API level: Android 26 (Marshmallow 8.0)
Flutter: 3.3.10+ (Dart 2.18.6+)
SDK: Bug fix for iOS Extensions and watchOS Intent Extensions to read the current APLConfiguration from shared keychain.
Xcode: 13.2+, Minimum deployment target: iOS 10.0, watchOS 3.0
Xcode: Tested for compatibility with Xcode 13
Xcode: 12.4+, Minimum deployment target: iOS 10.0, watchOS 3.0
SDK: Removal of APLConfigurationClass
from Info.plist
for increased reliability and faster startup time of your app. You must add an implementation of the APLConfigurationClass
function into your app as per the prototype in Appfigurate.h
, otherwise a linker error will be issued. The suggested location is to place this function at the end of your APLConfiguration
subclass file.
App: Output Objective-C implementation now includes APLConfigurationClass() function (≡ ‣ [App name] ‣ OBJ-C LIBRARY INTEGRATION section ‣ Output implementation).
App: Output Swift implementation now includes APLConfigurationClass() function (≡ ‣ [App name] ‣ SWIFT LIBRARY INTEGRATION section ‣ Output implementation).
App: Output Info.plist snippet no longer includes APLConfigurationClass declaration (≡ ‣ [App name] ‣ OBJ-C/SWIFT LIBRARY INTEGRATION section ‣ Output Info.plist snippet).
Xcode: 12.4+, Minimum deployment target: iOS 10.0, watchOS 3.0
App: Due to incomplete emulation of iOS in macOS Big Sur on Apple Silicon, Appfigurate can not be downloaded from the App Store and run as an iOS App on macOS app. Appfigurate App Store continues to function on a real iPhone, iPod or iPad device.
SDK: Due to incomplete emulation of iOS in macOS Big Sur on Apple Silicon, Appfigurate Library will ignore any attempted configuration changes when your app is run as an iOS app on macOS. Appfigurate Library continues to function on a real iPhone, iPod, iPad or Simulator device.
SDK: For SwiftExample/Common/ExampleConfiguration.swift
removed use of #if DEBUG
active compliation condition and replaced with ENCRYPTED()
function. Online documentation also updated to remove Step 2: DEBUG active compilation condition.
SDK: Moved SwiftExample and ObjCExample into their own repositories.
Xcode: 12.4+, Minimum deployment target: iOS 10.0, watchOS 3.0
App: Full Apple Silicon support - Appfigurate Simulator now contains arm64 architecture alongside existing i386 and x86_64 architectures.
App: Fix broken multipeer import/export on OS 14.
Xcode: 12.0+, Minimum deployment target: iOS 10.0, watchOS 3.0
App: Changes required for compatibility with iOS 14
SDK: Adds support for Swift Package Manager. Existing integration technologies (Manual, Carthage, Cocoapods) continue to be available.
SDK: Appfigurate Library security enhancements - digital signature verification of applied configuration via secure enclave on eligible devices.
SDK: Partial Apple Silicon support - Appfigurate Library contains arm64 architecture for iOS and watchOS Simulators. A future release will support running Appfigurate Simulator on Apple Silicon Macs.
Xcode: 12.0+, Minimum deployment target: iOS 9.0, watchOS 3.0
AppfigurateSE: Bug fix.
Xcode: 11.5+, Minimum deployment target: iOS 9.0, watchOS 3.0
SDK: Full support of Swift 5.2+ using property wrappers.
SDK: Appfigurate Library requires Swift to be linked to your target.
SDK: Appfigurate Library is now distributed as a single static XCFramework rather than separate libAppfigurateLibrary.a
(iOS) and libAppfigurateLibraryWatch.a
(watchOS) static libraries.
SDK: Example apps are now available in both Objective-C and Swift, and have been updated to support UIWindowScene
(multiple windows) on iPadOS 13+.
SDK: Your APLConfiguration subclass must now be specified in the Info.plist
item APLConfigurationClass
. Swift APLConfiguration
subclasses may use unicode characters.
SDK: Appfigurate Library no longer supports swizzling UIApplicationDelegate
or WKExtensionDelegate
. Instead you must programmatically call APLApplicationDidFinishLaunchingWithOptions
, APLApplicationDidFinishLaunching
and APLApplicationOpenURL
at the appropriate times.
SDK: APLConfiguration
subclass properties and executable actions can now be marked as requiring an app restart when they change.
SDK: Appfigurate Library now works correctly inside applications that use UIWindowScene
.
SDK: Appfigurate in conjunction with Appfigurate Library can automatically restart your app when restartable properties have changed.
App: Restart required properties and executable actions are now indicated in the UI with a green refresh icon (↩).
App: Install example app metadata for easier testing of included SDK example apps (≡ ‣ Install example apps).
App: Output UIWindowSceneDelegate
snippets for easier integration. (≡ ‣ App ‣ Output UIWindowSceneDelegate snippet).
AppfigurateSE: Companion AppfigurateSE macOS app updated to automatically generate encrypted string list items for both Objective-C and Swift APLConfiguration
subclasses.
Xcode: 11.5+, Minimum deployment target: iOS 9.0, watchOS 3.0
App: Support for iOS 13 Dark Mode.
SDK: Added ability to execute custom actions declared in an APLConfiguration
subclass. Check API documentation for ACTION_METHOD macro.
Xcode: 10.1+, Minimum deployment target: iOS 8.0, watchOS 3.0
App: Minor fixes to UI for iOS 13 compatibility.
Xcode: 10.1+, Minimum deployment target: iOS 8.0, watchOS 3.0
App: Share app metadata quickly using Multipeer connectivity. (≡ ‣ Import apps ‣ Multipeer).
App: The shared Simulator database stored in ~/Library/Application Support/Appfigurate
is upgraded to 1.3.0 and is incompatible with <= 1.2.1. Please ensure you upgrade Appfigurate to 1.3.0 in all Simulators you use.
App: Output Swift implementation (≡ ‣ [App name] ‣ Output Swift implementation).
App: Non-exportable app metadata will now expire after 180 days from installation.
App: Removed ability to perform remote apply of configuration using non-exportable app metadata.
App: Conversion of exportable app metadata to non-exportable app metadata. Use with caution as this action cannot be undone. (≡ ‣ [App name] ‣ Exportable switch).
App: Custom list item screen improvements.
App: Refreshed look and feel.
AppfigurateSE: StringEncryption macOS app removed and replaced with AppfigurateSE app, available on macOS App Store. Includes source editor extension for Xcode to automatically generate encrypted string list items (currently Objective-C only).
SDK: Reformatted API documentation available.
SDK: Library now throws an NSException (only when allowInvalidSignatures
return YES
, e.g. Debug builds) in the following scenarios: Invalid APLKeychainAccessibility value, Invalid configuration after reset method, Invalid list values found not conforming to regex.
Xcode: 10.1+, Minimum deployment target: iOS 8.0, watchOS 3.0
SDK only: Added APLSaveConfiguration()
and APLRestoreConfiguration()
to save and restore keychain.
Xcode: 10.1+, Minimum deployment target: iOS 8.0, watchOS 3.0
App: Minor bug fixes.
App: Share app metadata quickly using QR codes. Scanning requires a device running iOS 11.0+ (≡ ‣ Import apps ‣ QR code).
SDK: Support for encrypted string list items using the ENCRYPTED_STRING_PROPERTY_LIST_EDIT
, ENCRYPTED_STRING
and ENCRYPTED_STRING_IOS_WATCHOS
macros.
AppfigurateSE: Use the new StringEncryption macOS app to generate the encrypted string list item values.
Xcode: 9.0+, Minimum deployment target: iOS 8.0, watchOS 3.0
App: Minor bug fixes.
SDK: Added APLAddConfigurationUpdatedBlock()
and APLRemoveConfigurationUpdatedBlock()
functions to complement the existing delegate based callbacks.
SDK: APLConfiguration
subclass is now instantiated earlier, allowing it to be accessed from within +load
methods and __attribute__((constructor))
functions.
Xcode: 9.0+, Minimum deployment target: iOS 8.0, watchOS 3.0
App: Automatic notification of new releases.
SDK: Bug fixes.
Xcode: 9.0+, Minimum deployment target: iOS 8.0, watchOS 3.0
SDK: Support for arm64_32 architecture (Apple Watch series 4) in Appfigurate Library.
SDK: Fix missing Watch Extension icon.
Xcode: 9.0+, Minimum deployment target: iOS 8.0, watchOS 3.0
SDK: Support for watchOS app intent extensions (e.g. SiriKit)
Requirements
Xcode: 9.0+, Minimum deployment target: iOS 8.0, watchOS 3.0
App: Device builds have optional PIN/TouchID/FaceID authentication.
Xcode: 8.0, Minimum deployment target: iOS 8.0, watchOS 3.0
Initial public release.
Xcode: 8.0+, Minimum deployment target: iOS 8.0, watchOS 3.0
from the app under test, at runtime.
in the app under test, at runtime.
SDK: Appfigurate for Mobile Flutter apps updated to include latest iOS AppfigurateLibrary.xcframework.
SDK: and updated to demonstrate enhanced automation testing functionality.
SDK: and updated to Android Studio Ladybird 2024.2.1 Patch 2.
AppfigurateSE: Support for pre-packaging your local database of app metadata records with the iOS or Android physical device builds, and uploading it to supported (currently BrowserStack App Live).
AppfigurateSE: is now available, which has all of the functionality of the macOS version with the exception of Apple specific features and .
SDK: iOS and watchOS AppfigurateLibrary.xcframework is now signed (Electric Bolt Limited, KLCLPVKM8C) and includes an embedded file.
SDK: The and apps now use Swift Package Manager to automatically use the latest version of AppfigurateLibrary.xcframework.
SDK: Appfigurate for Mobile Flutter apps updated to include latest iOS AppfigurateLibrary.xcframework.
SDK: Support for using Espresso.
SDK: when running on Apple Silicon based Mac computers now only contains arm64 architecture slice for a smaller download size.
SDK: when running on Intel based Mac computers now contains additional x86_64 architecture slice (along with existing arm64 and armv7) for better compatibility with later Android versions.
App: Multipeer import/export is no longer available. Use the to Airdrop .apc
files to another device instead.
SDK: New , and examples.
SDK: New , distributed in an AAR format supporting both Java and Kotlin languages.
SDK: New Appfigurate for Mobile Flutter apps (iOS and Android).
AppfigurateSE: and are now included in the AppfigurateSE macOS app, and have easy 1 click installation. You no longer have to build the Appfigurate Simulator app in Xcode to deploy.
AppfigurateSE: Is now a instead of through the Mac App Store, and is using the hardened runtime and is notarised by Apple. The app is available in either a x86_64 binary for Intel based Mac computers or an arm64 binary for Apple Silicon based Mac computers. You must download the correct binary that matches your computers architecture.