产品上线操作说明

通知AbleCloud

您可以在技术支持讨论组中将准备发布的产品信息(产品名称、产品型号、产品子域等)通知技术支持人员,AbleCloud将完成该产品从开发环境到某个区域生产环境的云端迁移。
或者您也可以通过电子邮件的方式通知AbleCloud的技术支持,我们的邮箱地址为:support@ablecloud.cn。

厂商管理后台操作

当AbleCloud完成产品迁移之后,您可以登录https://www.ablecloud.cn的管理后台,进入所在的区域(当前支持国内、东南亚、欧洲、美洲四个区域)看到上线的产品已经创建完成,并且已经完成了属性设置,还需要您完成以下操作:
操作一、创建账号附加属性
进入“应用组件-用户服务-附加属性”页面创建该产品需要用到的用户帐号系统的附加属性。如果之前已经创建过此附加属性或者您没有用到帐号的附加属性,则忽略此步骤。 arch
操作二、创建数据表
进入 “云端服务-数据表”页面创建该产品需要用到的数据表。(没有则忽略此步骤)
arch
操作三、托管自定义云服务
进入“云端服务-云应用引擎”页面托管该产品的自定义云服务和定时任务,上传服务程序并上线运行。(没有则忽略此步骤) arch
arch

注:自定义云服务和定时任务不需要进行任何修改,直接将开发环境使用的zip包上传即可。

设备端操作

确认设备端密钥方式

登陆厂商管理后台,进入“产品管理-管理-设备密钥”页面,您可以使用统一密钥(默认密钥)或者独立密钥,以下将分别描述两种情况下的操作。

设备使用统一密钥(默认密钥):

(1)统一密钥可以选择使用系统生成公私钥对,也可以选择手工输入,选择之后不可修改,如下图所示: arch
(2)这里选择系统生成,如下图所示: arch

设备使用独立密钥:

(1)在管理后台设备密钥界面下载密钥生成工具,如下图所示: arch
(2)使用密钥生成工具生成密钥文件,如下图所示,表示生成1000台设备密钥,点击Generate会在桌面上生成两个文件,一个是设备ID和公钥的对应文件夹,一个是设备ID和私钥的对应文件。 arch
(3) 将设备ID和公钥的对应文件上传到管理后台,选择设备密钥文件,上传。云端会记录上传时间和上传数量,如下图所示: arch

嵌入式系统设备

针对两种情况分别进行说明:(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)采用统一密钥可以选择使用系统生成公私钥对,也可以选择手工输入,选择之后不可修改,如下图所示: arch
(3)这里选择系统生成,如下图所示: arch
操作二、修改文件信息
修改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