入门手册 iOS SDK
无需编写代码即可立即部署原生屏幕。入门手册可以帮助您设计和测试新的用户体验,并为每位用户提供个性化。
入门手册 iOS SDK 需要您在 https://goprimer.com 创建免费账户,并确保您的应用部署目标至少为 iOS 8。
开始使用
-
我们有一个 快速入门指南,帮助您在不到 10 分钟的时间内启动 Primer 并在 iOS 应用中使用。
-
如果您的应用使用用户账户,请使用我们的 快速身份验证指南,将 Primer 与您应用的用户系统关联起来实现账户验证。
-
从 v2 升级?我们有一个 升级指南。
安装
CocoaPods
使用CocoaPods集成,请在Podfile
中添加必要的资源和Primer库
pod 'Primer', '~> 3.6'
Carthage
使用Carthage集成,请在您的Cartfile
中添加以下内容
github "goprimer/primer-ios-sdk" "~> 3.6"
记得为copy-frameworks
脚本的构建阶段在“输入文件”下添加框架的路径
$(SRCROOT)/Carthage/Build/iOS/Primer.framework
然后,在您的应用目标的设置中,在“通用”选项卡的“链接框架和库”部分添加AdSupport.framework
手动
手动集成,请参阅我们的快速入门指南中的“手动集成”部分。
集成
iOS 9引入了影响您的应用和Primer iOS SDK集成的应用传输安全。要完成集成,您需要在应用的信息plist中添加以下内容,将Primer域名添加到白名单中。
<key>NSAppTransportSecurity</key>
<dict>
<key>NSExceptionDomains</key>
<dict>
<key>goprimer.com</key>
<dict>
<key>NSIncludesSubdomains</key>
<true/>
<key>NSThirdPartyExceptionAllowsInsecureHTTPLoads</key>
<true/>
</dict>
</dict>
</dict>
用法
启动SDK
首先,通过在应用代理的顶部添加 #import <Primer/Primer.h> (或使用Swift导入Primer) 来导入Primer。然后在您的 -application:didFinishLaunchingWithOptions: 实现中,使用SDK令牌调用我们的启动方法(您可以在您的项目设置中找到它)。
#import <Primer/Primer.h>
- (BOOL)application:(UIApplication *)application
didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {
// Initialize the Primer SDK
[Primer startWithToken:@"YOUR_APP_TOKEN"];
return YES;
}
应用入门展示
在应用启动时展示应用入门体验是最常见的时间。在大多数应用中,最佳做法是在首次展示给用户的视图控制器的-viewDidLoad方法中调用展示方法。
要使SDK自动展示应用入门体验,只需调用+presentExperience方法。
#import <Primer/Primer.h>
- (void)viewDidLoad {
[super viewDidLoad];
// Present the Primer onboarding experience
[Primer presentExperience];
}
联系我们
需要帮助或有疑问?请通过[email protected]联系我们,我们将为您提供个性化支持,确保您的应用程序取得成功!