Comment on page
iOS and watchOS native integration
Integrating Appfigurate Library into an iOS and watchOS native apps and app extensions.
iOS and watchOS native apps and app extensions can be developed in both Swift and Objective-C.
Independent watchOS native apps are not supported, watchOS native apps must be bundled inside a companion iOS app. (The companion iOS app's Appfigurate Library is used to proxy any configuration payloads applied to the watchOS native app).
You must have the following:
- Xcode 14.3+
- iOS (and optionally watchOS) SDKs and associated Simulators.
- AppfigurateSE macOS app.
- Appfigurate Simulator app installed into one or more iOS Simulators (use the AppfigurateSE macOS app for easy 1 click installation).
- Your iOS app must target iOS 13.0+ in order to link Appfigurate Library.
- Your watchOS app must target watchOS 5.0+ in order to link Appfigurate Library.
Choose one of the following integration methods (all of which are compatible with both Swift and Objective-C):
Clone the github repo:
git clone
https://github.com/electricbolt/appfiguratesdk.git
Drag and drop
AppfigurateLibrary.xcframework
into your project.Note: Ensure you are running Cocoapods 1.9.0 or later (to provide support for distribution of XCFrameworks).
Add the following to your apps
Podfile
:pod 'AppfigurateLibrary'
Run either the
pod install
or pod update
from the terminal to download and build the AppfigurateLibrary pod.Add the following to your apps
Cartfile
:github "electricbolt/appfiguratesdk"
Run the
carthage update
from the terminal to download the appfiguratesdk repository into your apps Carthage/Checkouts
directory.Note: Carthage will output the following error:
*** Skipped building appfiguratesdk due to the error:
Dependency "appfiguratesdk" has no shared framework schemes
If you believe this to be an error, please file an issue with the maintainers at https://github.com/electricbolt/appfiguratesdk/issues/new
You can ignore this error as we will be using the
Carthage/Checkouts
directory (instead of Carthage/Build
).Drag and drop
AppfigurateLibrary.xcframework
from the Carthage/Checkouts/
directory into your project.Add a package dependency
File ‣ Swift Packages ‣ Add Package Dependency
with the URL https://github.com/electricbolt/appfiguratesdk
Note: Replace any references to
quickstart
with your own apps target name.Run Appfigurate in the iOS Simulator.
Tap
≡
Add app
.Select app type
iOS
.Enter the URL scheme
quickstart
that will be used by Appfigurate to launch your app in order to read or apply configuration. The URL scheme must be 4-64 ascii characters in length and must be unique to your app.Tap
Add app
.Last modified 2mo ago