本文档为您介绍开源版 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:配置工程文件
{"WXAccessAppId": "","TencentIotLinkAppkey": "","TencentIotLinkAppSecret": "","XgAccessId": "","XgAccessKey": ""}
说明
TencentIotLinkAppkey 和 TencentIotLinkAppSecret 的参数获取,详情请参见 接入指南。
若不使用推送功能,将 XgAccessId 和 XgAccessKey 设置为长度为0的字符串即可。
接入微信登录
步骤1:登录微信开放平台
步骤2:创建应用
在微信开放平台中的移动应用模块下创建应用,填写对应信息,审核通过后,即可获取 AppID 和 AppSecret;请务必保存好 AppID 和 AppSecret,在 SDK 接入配置中需要用到。微信开发平台申请的 AppSecret 需要存放在用户自建的后台服务器中,用于获取 微信登录信息。
步骤3:搭建后台服务
自行搭建后台服务,请求微信开放平台,实现微信登录。
步骤4:填入工程
将配置项 WXAccessAppId 设置为在微信开放平台申请获取的 AppID 和 AppSecret;同时请遵从官方建议自建微信接入服务器,保证 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 部分。