Primer iOS SDK
Instantly deploy native screens without writing code. Primer enables you to design and test new user experiences, and personalize them for each user.
The Primer iOS SDK requires a free account to be created at https://goprimer.com, and your app to have a deployment target of at least iOS 8.
Get Started
-
We have a Quick Start Guide to help you get Primer up and running in your iOS app in less than 10 minutes.
-
If your app uses user accounts, follow up with our Quick Authentication Guide to get account authentication with Primer tied into your app's user system.
-
Upgrading from v2? We have an Upgrade Guide to cover you.
Installation
CocoaPods
To integrate using CocoaPods, add the necessary sources and the Primer pod to your Podfile:
pod 'Primer', '~> 3.6'
Carthage
To integrate using Carthage, add the following to your Cartfile:
github "goprimer/primer-ios-sdk" "~> 3.6"
Don't forget to add the path to the framework under "Input Files" for the copy-frameworks script Build Phase:
$(SRCROOT)/Carthage/Build/iOS/Primer.framework
Then add the AdSupport.framework in the Linked Frameworks and Libraries section of the General tab of your app target's settings.
Manually
To integrate manually please take a look at the Manual Integration section of our Quick Start Guide.
Integration
iOS 9 introduced App Transport Security that impacts your app and the Primer iOS SDK integration. To finish your integration you need to whitelist the Primer domains in your app by adding the following to your application's info plist.
<key>NSAppTransportSecuritykey>
<dict>
<key>NSExceptionDomainskey>
<dict>
<key>goprimer.comkey>
<dict>
<key>NSIncludesSubdomainskey>
<true/>
<key>NSThirdPartyExceptionAllowsInsecureHTTPLoadskey>
<true/>
dict>
dict>
dict>
Usage
Start the SDK
First import Primer by adding #import
#import <Primer/Primer.h>
- (BOOL)application:(UIApplication *)application
didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {
// Initialize the Primer SDK
[Primer startWithToken:@"YOUR_APP_TOKEN"];
return YES;
}
Present Onboarding
The most common time to present an onboarding experience is right when the application launches. The best way of doing this in most of the applications is by calling the presentation method in the -viewDidLoad of your first view controller to be presented to the user on app load.
To let the SDK automatically present an onboarding experience just simply call the +presentExperience method.
#import <Primer/Primer.h>
- (void)viewDidLoad {
[super viewDidLoad];
// Present the Primer onboarding experience
[Primer presentExperience];
}
Contact Us
Need help or have questions? Please contact us at [email protected] and we will provide you personal support to guarantee success in your app!
1 Dec 6, 2022
8 Jan 10, 2022
25 Dec 14, 2022
59 Jan 8, 2023
19 Dec 20, 2022
522 Jan 6, 2023
230 Mar 18, 2022
256 Oct 6, 2022
112 Dec 19, 2022
2 Feb 5, 2022
1 Nov 20, 2022
45 Nov 29, 2022
146 Nov 24, 2022
674 Dec 18, 2022
8 Nov 26, 2021
3k Jan 8, 2023
35 Oct 26, 2022
0 May 6, 2022
0 Oct 21, 2021