物联网开发平台
有奖捉虫：办公协同&微信生态&物联网文档专题 HOT
文档中心 > 物联网开发平台

第三方服务接入指南

最近更新时间：2020-12-15 15:22:14

我的收藏

本页目录：

本文档为您介绍开源版 App 可接入的第三方服务，包括腾讯移动推送、第三方登录（微信登录）和 Firebase 上报 Crash 信息。第三方服务为可选服务，可根据项目需要进行配置使用。

接入腾讯移动推送

步骤1：创建移动推送应用

1. 登录 腾讯移动推送平台 。
2. 选择【产品管理】，单击【新增产品】。


3. 进入到产品新增界面，填写产品相关信息，并勾选“Android”、“iOS”平台，单击【确定】。


产品名称：支持汉字、字母、数字，长度限制30个字符。
产品描述：支持汉字、字母、数字，长度限制60个字符。
产品分类：可根据您的 App 项目进行选择工具、生活等分类。
接入服务点：支持选择广州、上海、香港、新加坡。
4. 新增产品完成后，将出现【查看新手指引】弹窗，可忽略直接关闭，并按照以下步骤继续执行。


5. 在已创建的产品中：
1. 选择 Android 平台所在行右侧的【配置管理】，进入应用信息界面，填写“应用包名”并单击【保存】。


2. 选择 iOS 平台所在行右侧的【配置管理】，进入应用信息界面，填写 BundleID 并单击【保存】。

BundleID 和应用包名保存后，即可获取到对应的 Access ID 和 SecretKey。
3. 上传 iOS 平台对应的证书，详情可参见 推送证书获取指引。



步骤2：推送配置

1. 登录 物联网开发平台控制台，选择 新建项目 或者进入已有项目。
2. 选择左侧导航菜单【应用开发】，单击【新建应用】并填写应用信息，单击【保存】。


应用名称：必填，支持中文、英文、数字、下划线的组合，最多不超过50个字符。
备注：非必填，最多不超过1024个字符。
3. 创建完成后，单击【推送配置】进入推送配置页面，填写在 步骤1 所选择的服务接入点以及获取到 Access ID、SecretKey。


注意
请认真核对 Access ID、SecretKey 以及对应的服务接入点，若信息填写有误将导致配置不成功。
iOS 和 Android 的推送配置可以只选择其一，请在填写配置时保持另一端内容为空。
4. 填写完成后单击【保存】即可生效。

步骤3：配置工程文件

将 步骤1 获取的 AccessID 和 AccessKey 写入对应的工程文件中：
{
  "WXAccessAppId": "",
  "TencentIotLinkAppkey": "",
  "TencentIotLinkAppSecret": "",
  "XgAccessId": "",
  "XgAccessKey": ""
}
说明
TencentIotLinkAppkey 和 TencentIotLinkAppSecret 的参数获取，详情请参见 接入指南。
若不使用推送功能，将 XgAccessId 和 XgAccessKey 设置为长度为0的字符串即可。

接入微信登录

步骤1：登录微信开放平台

步骤2：创建应用

在微信开放平台中的移动应用模块下创建应用，填写对应信息，审核通过后，即可获取 AppID 和 AppSecret；请务必保存好 AppID 和 AppSecre，在 SDK 接入配置中需要用到。微信开发平台申请的 AppSecret 需要存放在用户自建的后台服务器中，用于获取 微信登录信息。

步骤3：搭建后台服务

自行搭建后台服务，请求微信开放平台，实现微信登录。

步骤4：填入工程

将配置项 WXAccessAppId 设置为在微信开放平台申请获取的 AppID 和 AppSecre；同时请遵从官方建议自建微信接入服务器，保证 AppSecret 不被泄露；在 app-config.json 文件中修改 WXAccessAppId 配置项，示例代码如下：
{
   "WXAccessAppId": "",
   "TencentIotLinkAppkey": "",
   "TencentIotLinkAppSecret": "",
   "XgAccessId": "",
   "XgAccessKey": "",
   "XgUSAAccessId": "",
   "XgUSAAccessKey": ""
}
说明
若不使用微信授权登录功能，将 WXAccessAppId 设置为长度为0字符串即可。
另外，实现微信授权登录还需：
iOS工程： 将配置项 LinkAPP_WEIXIN_APPID 设置为在微信开放平台申请并获得的 AppID；同时请遵从官方建议自建微信接入服务器，保证 AppSecret 不被泄露；在工程中 Supporting Files 目录下的 LinkApp.xcconfig 文件中修改 LinkAPP_WEIXIN_APPID 配置项，示例代码如下：
 {
   LinkAPP_NAME = 
   LinkAPP_WEIXIN_APPID = ""
   LinkAPP_BUNDLE_TEAM =
   LinkAPP_BUNDLE_SIGN = 
   LinkAPP_BUNDLE_ID = 
   LinkAPP_BUNDLE_PROVISIONING = 
 }
Android工程 ：
1. 将 opensource_keystore.jks文件替换成自己的签名文件并给应用签字。
2. 前往 微信开放平台 下载签名生成工具，使用该工具生成应用的数字签名（需要将该工具和应用同时安装到手机上，打开签名生成工具输入应用包名即可生成数字签名）。
3. 将该数字签名和应用包名登记到微信开放平台，否则微信授权登录将不可用。

接入 Firebase 上报 Crash 信息

接入 Firebase 上报 Crash 信息可方便用户分析和排查问题。具体操作步骤详情请参见如下指引：
iOS： 快速开始 Firebase 部分。
Android：快速开始 Firebase 部分。
中国站