什么是闭环分享

现在，市场上主流 app 都具有分享功能。但是绝大部分 app 的分享功能仅仅局限于分享出去，而且在微信限制了开发者获取分享结果状态后，通过分享功能进行 app 或者业务推广的方式受到很大的限制。比如说：

1. 你不知道用户是否真的分享了 2. 不知道分享的链接传播效果怎么样，多少人点击 3. 不知道如何有效的引导用户到 App，转化沉淀成自己的客户

ShareSDK 从这几个问题入手，基于深度链接打造出闭环分享功能，从而真正意义上解决以上烦恼。使用体验如下：


快速实现以深度链接为基础的闭环分享功能
快速实现流程

一、注册、登陆开发者后台

打开 Mob 官网 点击右上角登陆或注册

成功登陆后，点击进入“产品中心”，如下图：

快速实现以深度链接为基础的闭环分享功能
在“开发者服务”–>“开发者平台”栏目，点击“立即进入”，进入之后如下图：

快速实现以深度链接为基础的闭环分享功能
二、下载 SDK 包

先进入 Mob 官网 SDK 下载页，iOS 开发者请从官网下载，如下图：

快速实现以深度链接为基础的闭环分享功能
保存配置后即可点击“下载”，如下图：

快速实现以深度链接为基础的闭环分享功能
安卓请使用 Gradle 在线集成，先选择配置，再使用 Gradle 脚本，如下图：

快速实现以深度链接为基础的闭环分享功能
快速实现以深度链接为基础的闭环分享功能
三、开发者后台配置

如果您尚未使用 ShareSDK，请点击“添加应用”，输入您的“应用名称”，点击“保存”，如下图：

快速实现以深度链接为基础的闭环分享功能
然后在左边栏点击“ShareSDK”，在弹出框中选择“确定添加”，如下图：

快速实现以深度链接为基础的闭环分享功能
如果您已经使用了 ShareSDK，请选择您的应用并打开 ShareSDK 边栏，点击“闭环分享”标签，如下图：

快速实现以深度链接为基础的闭环分享功能
图上有对闭环分享功能的简单介绍和相关集成文档，直接点击“立即体验”即可开始使用，点击后如下图：

快速实现以深度链接为基础的闭环分享功能
对于 iOS 开发者，请配置好“TeamID”、“Bundle ID”和“下载地址”，然后点击“保存设置”，如下图：

快速实现以深度链接为基础的闭环分享功能
图上系统自动生成的“Scheme”和“Association Domain”是用于 Xcode 项目配置的，请参考下文：五、iOS 客户端开发配置

对于安卓开发者，请将配置标签切换到“Android”填写好“下载地址”和“微信应用宝”的微下载链接，如下图：

快速实现以深度链接为基础的闭环分享功能
图上系统自动生成的“Scheme”和“App Links Host”是用于安卓项目配置的（使用 Gradle 集成的可以不用考虑这个），请参考下文 六、安卓客户端开发配置

到此，开发者后台就完成了，下面请开始您简单轻松的客户端和网页端开发配置吧！

四、前端网页 JS 初始化

闭环分享讲究的是网页内容不仅能够被分享，更是能够回环到 App，所以使用闭环分享功能时需要前端网页做一个简单的 JS 集成初始化。

打开您 App 中分享出去的网页源码（仅在需要的网页中进行以下配置），在适当的位置引用我们提供的在线 JS，如下图：

快速实现以深度链接为基础的闭环分享功能
在线 JS 地址为开发者后台看到的 iOS 配置中“Association Domain”的域名或者安卓配置中的“App Links Host” 域名下的 moblink.js，例如根据上面开发者后台展示的结果则为：ahmn.t4m.cn/moblink.js，在 JS 中直接通过 <script> 标签引入：<script type=”text/javascript” src=”//ahmn.t4m.cn/moblink.js”></script>
JS 引入之后即可写一段 JS 初始化代码了，如下图：

快速实现以深度链接为基础的闭环分享功能
关于 JS 初始化代码的释义如下：

<script type=”text/javascript”>
MobLink([// 初始化对象叫 MobLink
{
path: “share/link”, //path 字段保留字段, 暂时不具使用意义
params: {//params 字段是网页回环跳转到 App 时带给 App 的参数
// targetAction_iOS 和 targetAction_And 这两个字段是必须字段, 对应 iOS 的一个 Controller 的名字和安卓的一个 Activity 的名字, 请让 iOS 和安卓的小伙伴提供
targetAction_iOS: “MOBAboutMobLinkViewController”,
targetAction_And: “ShareMobLinkActivity”,
// 以下是可选字段, 这些字段会原封不动的带给客户端 App, 以某小说 App 的网页为例, 下面配置字段表示的含义是：跳转到 App 时告诉 App 这部小说名字[name] 叫什么, 当前在读哪一页 [pageid], 阅读进度[process] 是多少
name: “ 闭环分享 ”,
pageid: 1,
process: 89,
}
}
])
</script>
以上 JS 代码初始化完成之后您的网页上将会多出一个浮层类似于下图：

快速实现以深度链接为基础的闭环分享功能
注意：仅手机模式下可见！建议通过谷歌浏览器的检查器调试。
至此，前端 JS 的配置工作就完成了，还是比较简单的。这个时候等客户端配置好了，点击上图浮层中的“打开 App”按钮即可立即跳转到您的 App 客户端，并将对应的参数携带给您的 App 了。

五、iOS 客户端开发配置

iOS 客户端比较简单就只有两步，Xcode 配置和代码开发：

1、Xcode 配置

主要配置 Scheme 和“Association Domain”，直接从开发者后台复制、粘贴即可 scheme 配置如下图：

快速实现以深度链接为基础的闭环分享功能
Association Domain 配置如下图：

快速实现以深度链接为基础的闭环分享功能
提示：由于“Association Domain”是需要 iOS 证书打开该权限的，所以您可能需要更新一下您的证书，确保已开启该权限，否则 Xcode 会报错。
2、代码开发

场景还原设置代理

import <ShareSDKExtension/ShareSDK+Extension.h>

import <ShareSDKExtension/SSERestoreSceneHeader.h>

@interface AppDelegate () <ISSERestoreSceneDelegate>
@end
@implementation AppDelegate

• (BOOL)application:(UIApplication )application didFinishLaunchingWithOptions:(NSDictionary )launchOptions

{
[ShareSDK setRestoreSceneDelegate:self];
…
}
…

pragma mark – ISSERestoreSceneDelegate

• (void)ISSEWillRestoreScene:(SSERestoreScene *)scene Restore:(void (^)(BOOL))restoreHandler

{

//YES：进行场景还原，NO：不执行场景还原

restoreHandler(YES);
}
@end
还原的场景视图配置

// 以下分类默认已经实现 - (instancetype) initWithShareSDKScene:(SSERestoreScene *)scene 方法，Build Settings -> Other Linker Flags 添加 -ObjC 所有 ViewController 自动实现此方法

import <ShareSDKExtension/UIViewController+SSERestoreScene.h>

// 用户如果需要获取透传的参数，对 ViewController 其他属性赋初值可以重写覆盖 - (instancetype) initWithShareSDKScene:(SSERestoreScene *)scene 方法如下：
// 例如 DemoViewController 为还原回来的场景视图
@interface DemoViewController ()
@property(nonatomic, strong) SSERestoreScene *scene;
@end
@implementation DemoViewController

• (instancetype) initWithShareSDKScene:(SSERestoreScene *)scene

{
if (self = [super init])
{
self.scene = scene;
…
}
return self;
}

• (void)viewDidLoad {
  [super viewDidLoad];
  …

}
….
@end
六、安卓客户端开发配置

指定跳转的 Activity

在 四、前端网页 JS 初始化 部分，初始化代码中 targetAction_And 字段设定的值即为要跳转的 Activity 名称，您需要在项目中创建一个与设定的名称相同的 Activity。

获取场景数据

HashMap<String, Object> customDataMap = ShareSDK.getCustomDataFromLoopShare();
在跳转的目标 Activity 内（即上一步中设定的 Activity），调用此接口来获取所需的场景数据。类型已经转换为 HashMap 类型，可以直接调用 toString() 方法来获取数据。