Comment on page
v1.4.0 to v2.2.0
Appfigurate app 2.2.0 is backwardly runtime compatible with apps and app extensions linked against Appfigurate library 1.4.0.
Appfigurate 2.2.0 is mostly source compatible with 1.4.0. Some minor changes are required:
- Remove the
APLInstallDelegateMethods
key/value pair if it exists. Appfigurate Library no longer supports swizzlingUIApplicationDelegate
orWKExtensionDelegate
. Instead you must programmatically callAPLApplicationDidFinishLaunchingWithOptions
,APLApplicationDidFinishLaunching
andAPLApplicationOpenURL
at the appropriate times.
- Appfigurate Library is now distributed as a single static XCFramework rather than separate
libAppfigurateLibrary.a
(iOS) andlibAppfigurateLibraryWatch.a
(watchOS) static libraries. - Delete the old
libAppfigurateLibrary.a
and/orlibAppfigurateLibraryWatch.a
files from your project. Remove any search paths that pertain to Appfigurate under theApp target
‣Build Settings
‣Library Search Paths/Header Search Paths
. - Add
AppfiguateLibrary.xcframework
to your project by dragging the.xcframework
bundle over the top of the project navigator into your projectsFrameworks
directory. You can also continue to use Swift Package Manager, Cocoapods or Carthage.

- Appfigurate Library requires Swift to be linked to your target. If your Objective-C project doesn't currently have any Swift source files, you'll need to create at least one empty
.swift
file.
- References to
#import "AppfigurateLibrary.h"
need to be changed to@import AppfigurateLibrary;
. - The configuration property macros all contain an extra
restart
parameter. Therestart
parameter is after thedescription
parameter in every macro. If your configuration property requires an app restart after changing, set the value to YES.
SDK 1.4.0 examples (before)
BOOL_PROPERTY(logging, @"Enable debug logging to console");
DOUBLE_PROPERTY_SLIDER(maxDecibel, 60.5, 120.41, APLIconSliderVolume, @"Clipping - decibels");
STRING_PROPERTY_LIST(backgroundColorHex, @"Color of background", @{@"LightGray":@"#d3d3d3", @"White":@"#ffffff", @"Beige":@"f5fcdc"});
SDK 2.2.0 examples (after)
BOOL_PROPERTY(logging, @"Enable debug logging to console", NO);
DOUBLE_PROPERTY_SLIDER(maxDecibel, 60.5, 120.41, APLIconSliderVolume, @"Clipping - decibels", NO);
STRING_PROPERTY_LIST(backgroundColorHex, @"Color of background", NO, @{@"LightGray":@"#d3d3d3", @"White":@"#ffffff", @"Beige":@"f5fcdc"});
- Add an implementation of the C
APLConfigurationClass
function (prototype available inAppfigurate.h
header) to the bottom of yourAPLConfiguration
subclass:
...
self.debugLogging = YES;
self.serverURL = @"https://www.yourappserver.com/api";
}
@end
Class APLConfigurationClass(void) {
return [ExampleConfiguration class];
}
Last modified 8mo ago