AppTrace

主题

iOS 集成指南 ​

SDK 支持 iOS11 及以上版本 ​

一、SDK 安装 ​

ruby
pod 'ApptraceSDK'

二、配置 appKey ​

请先从AppTrace控制台获取AppKey

支持 2 种方式来进行 appKey 的配置

  • 在 Info.plist 文件中配置
html
<key>cn.apptrace.appKey</key>
<string>AppTrace管理平台分配的key</string>
  • 初始化 Apptrace SDK 时通过入参来设置
objectivec
[Apptrace initWithDelegate:self appKey:@"AppTrace管理平台分配的key"];

三、初始化 SDK ​

在 AppDelegatede 的 application:didFinishLaunchingWithOptions:launchOptions 中初始化 SDK

objectivec
#import <ApptraceSDK/ApptraceSDK.h>

- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {
    [Apptrace initWithDelegate:self];

    return YES;
}

四、功能集成 ​

1、获取应用安装时携带的参数 ​

在 APP 需要安装参数时（由 web 网页中传递过来的，如邀请码、游戏房间号等动态参数），调用 getInstall 方法，在回调中获取参数（可重复调用）

objectivec
[Apptrace getInstall:^(AppInfo * _Nullable appdata) {
    NSLog(@"get Install Success: paramsData = %@", appdata.paramsData);
} fail:^(NSInteger code, NSString * _Nonnull message) {
    NSLog(@"get Install failed: code：%ld; message：%@", code, message);
}];

2、一键拉起 ​

2.1 开启一键拉起功能 ​

登录 AppTrace 的管理后台，找到 iOS 集成配置，开启相关功能，其中 Team Id 可以在 Apple 开发者后台查看。

2.2 开启 Associated Domains 服务 ​

在 xcode 中所示位置配置 AppTrace 后台提供的关联域名

2.3 代码集成 ​

找到AppDelegate文件，实现以下代码

objectivec
@interface AppDelegate ()<ApptraceDelegate>

@end

@implementation AppDelegate

// UniversalLink
- (BOOL)application:(UIApplication *)application continueUserActivity:(NSUserActivity *)userActivity restorationHandler:(void (^)(NSArray<id<UIUserActivityRestoring>> * _Nullable))restorationHandler {
    
    if ([Apptrace handleUniversalLink:userActivity]) {
        return YES;
    }
    return YES;
}

#pragma mark - ApptraceDelegate

- (void)handleWakeUp:(AppInfo * _Nullable)appData {
    if (appData != nil) {
        NSLog(@"getWakeUp Success, paramsData = %@",appData.paramsData);
    } else {
        NSLog(@"getWakeUp nil");
    }
}

@end