Skip to content

tencentyun/iot-link-ios

Repository files navigation

产品介绍

腾讯云物联网开发平台(Tencent IoT)是集智能生活、智能制造、智能人居等功能于一体的解决方案。如家庭生活类产品,智能门锁可通过 wifi 设备接入腾讯云 IoT 平台进行管理。

项目工程中包含三大块,App 体验模块、SDK Demo、SDK 模块。 用户可通过 App 体验产品功能,通过现有 App 快速搭建起属于自己的 IoT 应用。 也可通过 SDK 接入到自己的工程来完成与腾讯云物联网开发平台对接功能。

安装包指引

接入的第三方组件

腾讯连连是一个完整的应用项目,集成了业内主流的推送、定位、日志系统、性能统计和微信授权登录等功能。推送集成了信鸽推送,定位使用了腾讯地图,日志系统和性能统计依赖 Firebase,微信授权登录则需要微信的支持。

快速开始

用户需要根据实际情况调整 app-config.json 中的内容,app-config.json 位于项目的/LinkApp/Supporting Files目录下 app-config.json 需要配置的内容,如所示。

{
  "WXAccessAppId": "",
  "TencentIotLinkAppkey": "请输入从物联网开发平台申请的Appkey, 正式发布前务必填写",
  "TencentIotLinkAppSecret": "请输入从物联网开发平台申请的AppSecrect, AppSecrect请保存在服务端,此处仅为演示,如有泄露概不负责",
  "XgAccessId": "",
  "XgAccessKey": "",
  "XgUSAAccessId": "",
  "XgUSAAccessKey": "",
  "TencentMapSDKValue":"",
  "HEweatherKey":""
}

1、物联网平台

  • TencentIotLinkAppkeyTencentIotLinkAppSecret 请使用在物联网开发平台创建应用时生成的 APP KeyAPP SecretApp Key 和 App Secret 用于访问应用端 API 时生成签名串,参见应用端 API 简介。签名算法务必在服务端实现,腾讯连连 App 开源版的使用方式仅为演示,请勿将 App Key 和 App Secret 保存在客户端,避免泄露

2、信鸽(可选)

  腾讯连连开源体验版集成了信鸽推送,用于实现消息推送。

  • 若不使用推送功能,XgAccessIdXgAccessKey 设置为长度为0的字符串即可。
  • 若确认使用推送功能,需要前往信鸽推送平台申请获得的 AccessIDAccessKey申请步骤
  • 将申请获得的 AccessIDAccessKey,填写到物联网开发平台中
  • 将申请获得的 AccessIDAccessKey,写入在app-config.json文件中对应位置。
{
  "WXAccessAppId": "",
  "TencentIotLinkAppkey": "请输入从物联网开发平台申请的Appkey, 正式发布前务必填写",
  "TencentIotLinkAppSecret": "请输入从物联网开发平台申请的AppSecrect, AppSecrect请保存在服务端,此处仅为演示,如有泄露概不负责",
  "XgAccessId": "请输入从信鸽推送平台申请的AccessID",
  "XgAccessKey": "请输入从信鸽推送平台申请的AccessKey",
  "TencentMapSDKValue":"请输入从腾讯位置服务申请的key",
  "HEweatherKey":"请输入从和风天气开发平台申请的key"
}

3、 Firebase (可选)

  腾讯连连开源体验版集成了 Firebase 插件,用于记录应用的异常日志和性能状况。

  • 若用户确认使用 Firebase 插件,需通过 Firebase 官网 创建应用并获取 GoogleService-Info.plist 文件;将 GoogleService-Info.plist 文件放在项目 /LinkApp/Supporting Files 目录下。

4、微信授权登录(可选)

  腾讯连连开源体验版集成了微信授权登录。

  • 若确认使用自定义的微信授权登录,需要在微信开放平台注册开发者帐号,创建移动应用,审核通过后,即可获得相应的 AppID 和 AppSecret,申请步骤;同时需要自行搭建微信授权登录的接入服务器,可参考接入服务器的接口

    使用微信授权登录还需:

    • 将配置项 WXAccessAppId 设置为在微信开放平台申请并获得的 AppID同时请遵从官方建议自建微信接入服务器,保证 AppSecret 不被泄露;在 app-config.json 文件中修改 WXAccessAppId 配置项,如下:
       {
         "WXAccessAppId": "",
         "TencentIotLinkAppkey": "请输入从物联网开发平台申请的Appkey, 正式发布前务必填写",
         "TencentIotLinkAppSecret": "请输入从物联网开发平台申请的AppSecrect, AppSecrect请保存在服务端,此处仅为演示,如有泄露概不负责",
         "XgAccessId": "",
         "XgAccessKey": "",
         "XgUSAAccessId": "",
         "XgUSAAccessKey": "",
         "TencentMapSDKValue":"",
         "HEweatherKey":""
       }
    • 最后将配置项 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 = 
       }
    
  • 若不使用微信授权登录功能,WXAccessAppId 设置为长度为0字符串即可。​

5、 腾讯位置服务 (可选)

  腾讯连连开源体验版集成了腾讯地图位置服务,用于定位选址和搜索周边地点。

  • 若使用自定义接入的腾讯位置服务,需要在腾讯位置服务注册开发者账号,创建移动应用,即可获取应用对的key,申请步骤在编辑key时需要启用产品的 WebServiceAPI 和地图 SDK;将申请的 key 写入 app-config.json 文件中对应位置。
{
  "WXAccessAppId": "",
  "TencentIotLinkAppkey": "请输入从物联网开发平台申请的Appkey, 正式发布前务必填写",
  "TencentIotLinkAppSecret": "请输入从物联网开发平台申请的AppSecrect, AppSecrect请保存在服务端,此处仅为演示,如有泄露概不负责",
  "XgAccessId": "请输入从信鸽推送平台申请的AccessID",
  "XgAccessKey": "请输入从信鸽推送平台申请的AccessKey",
  "TencentMapSDKValue":"请输入从腾讯位置服务申请的key",
  "HEweatherKey":"请输入从和风天气开发平台申请的key"
}
  • 若不使用腾讯位置服务,TencentMapSDKValue 设置为长度为0字符串即可。

6、 和风天气 (可选)

  腾讯连连开源体验版集成了和风天气开发平台,用于设置和显示天气。

  • 若使用自定义的和风天气服务,需要在和风天气开发平台注册开发者账号,创建移动应用,获取应用对应key ,申请步骤

  • 腾讯连连开源体验版集成和风天气对应的 key 类型为 Web API,若创建应用对应 key 类型非 Web API,需要单独接入对应平台的 SDK,SDK 接入和配置

  • 将和风天气开发平台申请的 key 写入 app-config.json 文件中对应位置。

{
  "WXAccessAppId": "",
  "TencentIotLinkAppkey": "请输入从物联网开发平台申请的Appkey, 正式发布前务必填写",
  "TencentIotLinkAppSecret": "请输入从物联网开发平台申请的AppSecrect, AppSecrect请保存在服务端,此处仅为演示,如有泄露概不负责",
  "XgAccessId": "请输入从信鸽推送平台申请的AccessID",
  "XgAccessKey": "请输入从信鸽推送平台申请的AccessKey",
  "TencentMapSDKValue":"请输入从腾讯位置服务申请的key",
  "HEweatherKey":"请输入从和风天气开发平台申请的key"
}
  • 若不适用和风天气服务,HEweatherKey 设置为长度为0字符串即可。

完成上述配置后,依赖 Xcode 的构建,即可在手机上运行。

定制 App 相关指引

第三方服务接入指引