产品上线操作说明
通知AbleCloud
您可以在技术支持讨论组中将准备发布的产品信息(产品名称、产品型号、产品子域等)通知技术支持人员,AbleCloud将完成该产品从开发环境到某个区域生产环境的云端迁移。
或者您也可以通过电子邮件的方式通知AbleCloud的技术支持,我们的邮箱地址为:support@ablecloud.cn。
厂商管理后台操作
当AbleCloud完成产品迁移之后,您可以登录https://www.ablecloud.com的管理后台,进入所在的区域(当前支持国内、东南亚、欧洲、美洲四个区域)看到上线的产品已经创建完成,并且已经完成了属性设置,还需要您完成以下操作:
操作一、创建账号附加属性
进入“应用组件-用户服务-附加属性”页面创建该产品需要用到的用户帐号系统的附加属性。如果之前已经创建过此附加属性或者您没有用到帐号的附加属性,则忽略此步骤。
操作二、创建数据表
进入 “云端服务-数据表”页面创建该产品需要用到的数据表。(没有则忽略此步骤)
操作三、托管自定义云服务
进入“云端服务-云应用引擎”页面托管该产品的自定义云服务和定时任务,上传服务程序并上线运行。(没有则忽略此步骤)
注:自定义云服务和定时任务不需要进行任何修改,直接将开发环境使用的zip包上传即可。
设备端操作
确认设备端密钥方式
登陆厂商管理后台,进入“产品管理-管理-设备密钥”页面,您可以使用统一密钥(默认密钥)或者独立密钥,以下将分别描述两种情况下的操作。
设备使用统一密钥(默认密钥):
(1)统一密钥可以选择使用系统生成公私钥对,也可以选择手工输入,选择之后不可修改,如下图所示:
(2)这里选择系统生成,如下图所示:
设备使用独立密钥:
(1)在管理后台设备密钥界面下载密钥生成工具,如下图所示:
(2)使用密钥生成工具生成密钥文件,如下图所示,表示生成1000台设备密钥,点击Generate会在桌面上生成两个文件,一个是设备ID和公钥的对应文件夹,一个是设备ID和私钥的对应文件。
(3) 将设备ID和公钥的对应文件上传到管理后台,选择设备密钥文件,上传。云端会记录上传时间和上传数量,如下图所示:
嵌入式系统设备
针对两种情况分别进行说明:(1)对接Ablecloud简化串口协议的情况(2)集成Ablecloud WiFi SDK的情况。
对接Ablecloud简化串口协议的情况
操作、修改串口协议
MCU在对接Ablecloud的简化串口协议时,将“设备注册”消息中的“服务器环境”、“设备密钥”修改为生产环境中的对应值。
设备注册MCU回复设备信息(MCU->WIFI模块)
- 服务器环境说明: 国内开发环境:0xFF,国内生产环境:0x00,美洲生产环境:0x01,欧洲生产环境:0x02,亚太生产环境:0x03。
包头 | 包长度H | 包长度L | 包序号 | 附加码 | 功能码 | 服务器环境 | 设备版本(4Byte) | 主域ID(6Byte) | 子域ID (2Byte) | 设备密钥(112Byte) | 校验和 | 包尾 |
---|---|---|---|---|---|---|---|---|---|---|---|---|
0x5A | 0x00 | 0x85 | 0x00 | 0x00 | 0x07 | 0x?? | 0x?? | 0x?? | 0x?? | 0x???? | 0x?? | 0x5B |
集成Ablecloud WiFi SDK的情况
操作一、修改设备密钥
修改ac_cfg.h文件中的“设备密钥”,修改设备密钥:#define DEFAULT_IOT_PRIVATE_KEY {\
0x68, 0x42, 0x9D, 0xD2\
}
操作二、修改云端地址
云端地址修改成对应的服务器环境。
修改集群服务器地址,原开发环境为:
#define CLOUD_ADDR AC_TEST_SERVER
当需要迁移到国内生产环境下时,修改为:
#define CLOUD_ADDR AC_CH_SERVER
当需要迁移到东南亚生产环境下时,修改为:
#define CLOUD_ADDR AC_EA_SERVER
当需要迁移到美洲生产环境下时,修改为:
#define CLOUD_ADDR AC_US_SERVER
当需要迁移到欧洲生产环境下时,修改为:
#define CLOUD_ADDR AC_EU_SERVER
安卓系统设备
操作一、获取私钥信息
(1)使用每个设备一个密钥的方式,同嵌入式设备进行入库和单独烧制。
(2)采用统一密钥可以选择使用系统生成公私钥对,也可以选择手工输入,选择之后不可修改,如下图所示:
(3)这里选择系统生成,如下图所示:
操作二、修改文件信息
修改objAndroidManifest.xml
文件里objmeta-data
的值。
<!— [Optional] 环境设置,默认值为0(0生产环境 1开发环境) —>
<meta-data android:name="mode" android:value="1"/>
<!— [Optional] 地域设置,默认值为0(0国内地区 1东南亚地区 3美洲地区 4 欧洲地区) —>
<meta-data android:name="region" android:value="0"/>
<!— [Required] 设备私钥,对应"产品管理->产品列表->点击管理->设备密钥->私钥" 若使用AbleCloud默认分配的密钥对,则填写默认密钥里的私钥,如选择设备独立密钥入库,则需要使用密钥生成工具自己生成公私钥并上传文件,务必保证设备ID和密钥的一一对应,否则会出现联网失败。—>
<meta-data android:name="secret-key" android:value="BEADD508A1A0AC77523FA741DD1FF754D5BBBDFC93A32619A77A5B510D3C7F65C65323EEB6951129B79E70E4DE514E49F6217BA4CA80891048114C3EE856183D9F86C8E47F6130C909B61CC13C42D261809C4C6476A0257EC979A872B2AAD22D6821AFB64E1EAB246AB4D7008821CA4E"/>
- 注意:迁移生产环境后需要到对应的生产环境查看正确的secret-key。
客户端操作
手机验证码模板
操作:提交验证码模板
如果test环境开发阶段手机验证码使用的是AbleCloud提供的默认模版ID,切换到生产环境时,需要申请生产环境的以厂商自己名字为标题的验证码的模版。
申请验证码模版需要提交的内容有:
- 验证码标题。
- 验证码内容。
请将以上内容直接发送给技术支持,我们会在一天内为您申请模板内容审核并开通,技术支持会将模版ID反馈给您。
安卓APP
操作:修改云端服务接入地址
修改应用程序初始化代码,原test环境代码为:
AC.init(this, MajorDomain, MajorDomainId, AC.TEST_MODE);
当需要迁移到国内生产环境下时,修改为:
AC.init(this, MajorDomain, MajorDomainId);
当需要迁移到东南亚生产环境下时,修改为:
AC.init(this, MajorDomain,MajorDomainId);
AC.setRegional(AC.REGIONAL_SOUTHEAST_ASIA);
当需要迁移到欧洲生产环境下时,修改为:
AC.init(this, MajorDomain,MajorDomainId);
AC.setRegional(AC.REGIONAL_CENTRAL_EUROPE);
当需要迁移到美洲生产环境下时,修改为:
AC.init(this, MajorDomain,MajorDomainId);
AC.setRegional(AC.REGIONAL_NORTH_AMERICA);
iOS APP
操作:修改云端服务接入地址
修改应用程序初始化代码,原test环境是为:
[ACloudLib setMode:ACLoudLibModeTest Region:ACLoudLibRegionChina];
当需要迁移国内生产环境下时,修改为:
[ACloudLib setMode:ACLoudLibModeRouter Region:ACLoudLibRegionChina];
当需要迁移到东南亚生产环境下时,修改为:
[ACloudLib setMode:ACLoudLibModeRouter Region:ACLoudLibRegionSouthEastAsia];
当需要迁移到欧洲生产环境下时,修改为:
[ACloudLib setMode:ACLoudLibModeRouter Region:ACLoudLibRegionCentralEurope];
当需要迁移到美洲生产环境下时,修改为:
[ACloudLib setMode:ACLoudLibModeRouter Region:ACLoudLibRegionNorthAmerica];
WEB云对接有关操作
Java版
操作一、修改运行模式
将objcom.ablecloud.common.ACConfig
的派生类中对父类抽象方法objgetMode
的实现修改为如下:
public String getMode() {
return com.ablecloud.common.ACConfig.PRODUCTION_MODE;
}
操作二、修改云端服务接入地址
调用objcom.ablecloud.common.ACConfig
派生类的方法objsetRouterAddr
。
国内 :将配置项objrouter_addr
的值修改为:
http://router.ablecloud.cn:5000
东南亚:将配置项objrouter_addr
的值修改为:
http://earouter.ablecloud.cn:5000
欧洲 :将配置项objrouter_addr
的值修改为:
http://eurouter.ablecloud.cn:5000
美洲 :将配置项objrouter_addr
的值修改为:
http://usrouter.ablecloud.cn:5000
PHP版
要上线生产环境,需要修改WEB服务器的配置文件objACConfig.php
中的一些配置项。
操作一、修改运行模式
将运行模式由objtest
修改为objproduction
,只需要修改配置项objACConfig::$RuntimeMode的值为production
。
操作二、修改云端服务接入地址
国内 :将配置项objACConfig::$RouterUrl
的值修改为:
http://router.ablecloud.cn:5000
东南亚:将配置项ACConfig::$RouterUrl的值修改为:
http://earouter.ablecloud.cn:5000
欧洲 :将配置项ACConfig::$RouterUrl的值修改为:
http://eurouter.ablecloud.cn:5000
美洲 :将配置项ACConfig::$RouterUrl的值修改为:
http://usrouter.ablecloud.cn:5000