Release History
Current release
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
Release history
4.0.0 - Coming soon
Appfigurate 4.0.0 is currently in private beta.
App: Locally override third party remote provider configuration/feature toggles/flags. Tested and documented providers include Firebase Remote Config and Launch Darkly.
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 Add a new watchOS app. Instead Duplicate the companion iOS app to create a new watchOS app using the same public/private keypair.
SDK: Added
@RemoteBoolProperty,@RemoteIntPropertyEdit,@RemoteDoublePropertyEditand@RemoteStringPropertyEditannotations/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_WATCHOSfunction/macro has been removed. See the upgrade guide for migration guidance.SDK: Swift example, Objective-C example, Kotlin example and Java example 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, Sync database feature no longer requires adb daemon root access. This allows for easier installation and testing of Google Play Services system images.
Requirements
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+)
3.2.1 - 29 November 2024
SDK: iOS AppfigurateLibrary.xcframework now includes enhanced automation testing functionality:
Apply and read configuration from the app under test, at runtime.
Invoke functionality in the app under test, at runtime.
SDK: Appfigurate Flutter plugin for Mobile Flutter apps updated to include latest iOS AppfigurateLibrary.xcframework.
SDK: Objective-C example and Swift example updated to demonstrate enhanced automation testing functionality.
SDK: Java example and Kotlin example updated to Android Studio Ladybird 2024.2.1 Patch 2.
3.2.0 - 24 July 2024
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.
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 real device cloud testing services (currently BrowserStack App Live).
AppfigurateSE: Windows 10 compatible version of AppfigurateSE is now available, which has all of the functionality of the macOS version with the exception of Apple specific features Setup iOS Simulator app and Xcode Source Editor Extension.
3.1.4 - 9 July 2024
SDK: iOS and watchOS AppfigurateLibrary.xcframework resigned (Electric Bolt Limited, KLCLPVKM8C). No other changes applied.
3.1.3 - 25 February 2024
SDK: iOS and watchOS AppfigurateLibrary.xcframework is now signed (Electric Bolt Limited, KLCLPVKM8C) and includes an embedded PrivacyInfo.xcprivacy file.
SDK: The Swift Example and Objective-C Example apps now use Swift Package Manager to automatically use the latest version of AppfigurateLibrary.xcframework.
SDK: Appfigurate Flutter plugin for Mobile Flutter apps updated to include latest iOS AppfigurateLibrary.xcframework.
Requirements
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+)
3.1.2 - 31 August 2023
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.
Requirements
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+)
3.1.1 - 2 June 2023
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.
Requirements
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+)
3.1.0 - 27 May 2023
App: Bug fixes.
SDK: Support for automation testing Android apps using Espresso.
SDK: Improved algorithm for launching Android apps from Appfigurate (by task id).
SDK: Appfigurate Emulator for Android when running on Apple Silicon based Mac computers now only contains arm64 architecture slice for a smaller download size.
SDK: Appfigurate Emulator for Android 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.
AppfigurateSE: Bug fixes.
Requirements
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+)
3.0.0 - 3 March 2023
Release notes
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.
App: Multipeer import/export is no longer available. Use the iOS Share Sheet to Airdrop
.apcfiles to another device instead.SDK: The
APLConfiguration customIdentifiermethod is no longer supported and you should remove any subclass implementations.SDK: New Appfigurate Library for Android, distributed in an AAR format supporting both Java and Kotlin languages.
SDK: New Appfigurate Flutter plugin for Mobile Flutter apps (iOS and Android).
SDK: AppfigurateLibrary.xcframework for watchOS now contains arm64 architecture alongside the existing arm64_32 and armv7k for physical devices.
AppfigurateSE: Appfigurate Simulator for iOS and Appfigurate Emulator for Android 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 direct download 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.
Known issues
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.
Requirements
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+)
2.2.1 - 30 March 2022
Release notes
SDK: Bug fix for iOS Extensions and watchOS Intent Extensions to read the current APLConfiguration from shared keychain.
Requirements
Xcode: 13.2+, Minimum deployment target: iOS 10.0, watchOS 3.0
2.2.0 - 19 October 2021 (Updated)
Release notes
Xcode: Tested for compatibility with Xcode 13
Requirements
Xcode: 12.4+, Minimum deployment target: iOS 10.0, watchOS 3.0
2.2.0 - 17 March 2021
Release notes
SDK: Removal of
APLConfigurationClassfromInfo.plistfor increased reliability and faster startup time of your app. You must add an implementation of theAPLConfigurationClassfunction into your app as per the prototype inAppfigurate.h, otherwise a linker error will be issued. The suggested location is to place this function at the end of yourAPLConfigurationsubclass 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).
Requirements
Xcode: 12.4+, Minimum deployment target: iOS 10.0, watchOS 3.0
2.1.1 - 14 March 2021
Release notes
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.swiftremoved use of#if DEBUGactive compliation condition and replaced withENCRYPTED()function. Online documentation also updated to remove Step 2: DEBUG active compilation condition.SDK: Moved SwiftExample and ObjCExample into their own repositories.
Requirements
Xcode: 12.4+, Minimum deployment target: iOS 10.0, watchOS 3.0
2.1.0 - 27 September 2020
Release notes
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.
Requirements
Xcode: 12.0+, Minimum deployment target: iOS 10.0, watchOS 3.0
2.0.2 - 17 September 2020
Release notes
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.
Requirements
Xcode: 12.0+, Minimum deployment target: iOS 9.0, watchOS 3.0
2.0.1 - 13 July 2020
Release notes
AppfigurateSE: Bug fix.
Requirements
Xcode: 11.5+, Minimum deployment target: iOS 9.0, watchOS 3.0
2.0.0 - 21 June 2020
Release notes
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) andlibAppfigurateLibraryWatch.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.plistitemAPLConfigurationClass. SwiftAPLConfigurationsubclasses may use unicode characters.SDK: Appfigurate Library no longer supports swizzling
UIApplicationDelegateorWKExtensionDelegate. Instead you must programmatically callAPLApplicationDidFinishLaunchingWithOptions,APLApplicationDidFinishLaunchingandAPLApplicationOpenURLat the appropriate times.SDK:
APLConfigurationsubclass 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
UIWindowSceneDelegatesnippets 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
APLConfigurationsubclasses.
Requirements
Xcode: 11.5+, Minimum deployment target: iOS 9.0, watchOS 3.0
1.4.0 - 21 December 2019
Release notes
App: Support for iOS 13 Dark Mode.
SDK: Added ability to execute custom actions declared in an
APLConfigurationsubclass. Check API documentation for ACTION_METHOD macro.
Requirements
Xcode: 10.1+, Minimum deployment target: iOS 8.0, watchOS 3.0
1.3.1 - 6 October 2019
Release notes
App: Minor fixes to UI for iOS 13 compatibility.
Requirements
Xcode: 10.1+, Minimum deployment target: iOS 8.0, watchOS 3.0
1.3.0 - 27 August 2019
Release notes
App: Share app metadata quickly using Multipeer connectivity. (≡ ‣ Import apps ‣ Multipeer).
App: The shared Simulator database stored in
~/Library/Application Support/Appfigurateis 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
allowInvalidSignaturesreturnYES, e.g. Debug builds) in the following scenarios: Invalid APLKeychainAccessibility value, Invalid configuration after reset method, Invalid list values found not conforming to regex.
Requirements
Xcode: 10.1+, Minimum deployment target: iOS 8.0, watchOS 3.0
1.2.1 - 22 May 2019
Release notes
SDK only: Added
APLSaveConfiguration()andAPLRestoreConfiguration()to save and restore keychain.
Requirements
Xcode: 10.1+, Minimum deployment target: iOS 8.0, watchOS 3.0
1.2.0 - 28 Mar 2019
Release notes
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_STRINGandENCRYPTED_STRING_IOS_WATCHOSmacros.AppfigurateSE: Use the new StringEncryption macOS app to generate the encrypted string list item values.
Requirements
Xcode: 9.0+, Minimum deployment target: iOS 8.0, watchOS 3.0
1.1.3 - 10 Feb 2019
Release notes
App: Minor bug fixes.
SDK: Added
APLAddConfigurationUpdatedBlock()andAPLRemoveConfigurationUpdatedBlock()functions to complement the existing delegate based callbacks.SDK:
APLConfigurationsubclass is now instantiated earlier, allowing it to be accessed from within+loadmethods and__attribute__((constructor))functions.
Requirements
Xcode: 9.0+, Minimum deployment target: iOS 8.0, watchOS 3.0
1.1.2 - 17 Jan 2019
Release notes
App: Automatic notification of new releases.
SDK: Bug fixes.
Requirements
Xcode: 9.0+, Minimum deployment target: iOS 8.0, watchOS 3.0
1.1.1 - 16 Dec 2018
Release notes
SDK: Support for arm64_32 architecture (Apple Watch series 4) in Appfigurate Library.
SDK: Fix missing Watch Extension icon.
Requirements
Xcode: 9.0+, Minimum deployment target: iOS 8.0, watchOS 3.0
1.1.0 - 12 Sep 2018
Release notes
SDK: Support for watchOS app intent extensions (e.g. SiriKit)
Requirements
Xcode: 9.0+, Minimum deployment target: iOS 8.0, watchOS 3.0
1.0.1 - 9 Feb 2018
Release notes
App: Device builds have optional PIN/TouchID/FaceID authentication.
Requirements
Xcode: 8.0, Minimum deployment target: iOS 8.0, watchOS 3.0
1.0.0 - 17 Jan 2018
Release notes
Initial public release.
Requirements
Xcode: 8.0+, Minimum deployment target: iOS 8.0, watchOS 3.0
Last updated