shareinstall之IOS集成

4、一键跳转
ShareInstall通过标准的scheme、universal link等技术，在app安装的情况下，从各种浏览器（微信、QQ、新浪微博、钉钉等主流社交软件的内置浏览器）唤醒 app 并传递自定义参数，避免重复安装。
5、 universal link 配置
Universal link是iOS9的一个新特性，通过Universal link，App可以通过各种浏览器跳转到App（例如微信内可不通过safari，一键跳转到App），真正实现一键跳转到相应界面。
备注：iOS9以上推荐使用Universal link。
5.1 配置developer.apple.com的相关信息
到苹果开发者中心，为当前的App ID开启Associated Domains服务：

5.2 配置Xcode
在Xcode中配置ShareInstall为当前应用生成的关联域名：Associated Domains 开关打开，添加Domains: applinks:k2bk7b6hh7f7r2.shareinstall.com

在AppDelegate中的continueUserActivity方法中调用，用来处理Universal link。

//Universal Links 通用链接

• (BOOL)application:(UIApplication )application continueUserActivity:(NSUserActivity )userActivity restorationHandler:(void (^)(NSArray * _Nullable))restorationHandler
  {
  //判断是否通过ShareInstall Universal Links 唤起App
  if ([ShareInstallSDK continueUserActivity:userActivity]) {
  return YES ;
  }else{
  //其他代码
  return YES;
  }
  }

5.3 配置App的URL Scheme
iOS系统中App之间是相互隔离的，通过URL Scheme, App之间可以相互调用，并且可以传递参数。
备注：iOS9以下通过Url Scheme实现拉起。
5.4 在Xcode里选中Target—Info—URL Types, 配置shareInstall为当前应用生成的Url Scheme，如图所示：
identifier 配置为 com.ShareInstall，URL Schemes从shareInstall获取(afap0343)。
注：identifier 一定要配置为com.ShareInstall

5.5 URL Scheme相关代码配置
注意：当需要在shareInstall这个方法中处理第三方回调的时候（比如支付宝、微信回调等），请注意区分。

//iOS9以下 URI Scheme
-(BOOL)application:(UIApplication )application openURL:(NSURL )url sourceApplication:(NSString *)sourceApplication annotation:(id)annotation{

//判断是否通过ShareInstall URL Scheme 唤起App
if ([ShareInstallSDK handLinkURL:url]) {
     return YES;
}else{
    //其他代码
    return YES;
}

return YES;

}

//iOS9以上 URL Scheme

• (BOOL)application:(UIApplication )app openURL:(NSURL )url options:(nonnull NSDictionary *)options
  {
  //判断是否通过ShareInstall URL Scheme 唤起App
  if ([ShareInstallSDK handLinkURL:url]) {

  return YES;

  }else{
  //其他代码
  return YES;
  }

  return YES;
  }

5.6获取唤醒参数，直达具体页
通过在url中附带具体的参数，唤醒app并跳转到具体页。

5.7 其他代码配置
如果做测试，获取参数，则必须在Appdelegate.h加上如下测试代码。

#pragma mark 将oc数据类型转成NSString
-(NSString *)DataTOjsonString:(id)object
{
if (!object) {
return nil;
}

NSString *jsonString = nil;
NSError *error;
NSData *jsonData = [NSJSONSerialization dataWithJSONObject:object
                                                   options:NSJSONWritingPrettyPrinted
                                                     error:&error];
if (! jsonData) {
    NSLog(@"Got an error: %@", error);
} else {

jsonString = [[NSString alloc] initWithData:jsonData encoding:NSUTF8StringEncoding];
}
return jsonString;
}

6、注册量统计
使用Shareinstall 控制中心提供的渠道统计时，在App用户注册完成后调用，可以统计渠道注册量。
#warning 必须在注册成功的时调用[ShareInstallSDK reportRegister] 方法，否则可能导致注册统计不准。
下一步