添加升级包

操作步骤

1. 登录物联网平台控制台。

2. 在实例概览页面，选择目标环境，找到对应的实例，单击实例ID或备注名称。
   重要 目前仅开通企业版实例服务的地域下，执行此步骤。其他地域，请跳过此步骤。地域及实例的支持说明，请参见实例概述。

   

3. 在左侧导航栏，选择监控运维 > OTA升级。

   说明

   为提供更好的服务，物联网平台改版了原OTA升级，新增了升级包版本统计功能。首次进入改版后的OTA升级页面时，您需要手动将之前上传的升级包与产品进行关联。升级包与产品一一对应，一个升级包只能关联一个产品。详情请参见控制台指引。

4. （可选）若您的设备搭载了AliOS Things芯片，可以开启安全升级功能。

   安全升级是保证升级包完整性、机密性的一种方式，建议打开。使用安全升级功能，设备端需配合对升级包和升级包的签名进行验证。具体操作，请参见AliOS Things技术文档。

   1. 在OTA升级页面，单击安全升级。

   2. 在对话框中，设置待升级产品对应的安全升级按钮为开。

      当安全升级功能为开时，可单击对应的复制按钮，复制公钥，用于设备端验证签名。

5. （可选）自定义OTA模块。

   OTA模块是同产品下设备的不同可升级模块，例如固件、软件、驱动等。默认（default）模块表示整个设备的固件，支持自定义其他OTA模块。

   在模块列表页签，单击添加模块，配置模块信息，单击确认。

   参数	说明
   所属产品	选择模块所属产品。
   模块名称	设置模块名称。模块名称需要在产品下唯一，创建后不可修改。支持英文字母、数字、半角句号（.）、短划线（-）和下划线（_），长度限制为1~64个字符。
   模块别名	设置模块别名。支持英文字母、数字、半角句号（.）、短划线（-）和下划线（_），长度限制为4~64个字符。
   模块描述	可描述该模块的用途等信息。描述长度不超过100个字符，一个中文计为一个字符。

6. 在OTA升级页面，单击升级包列表页签，单击添加升级包。

7. 配置升级包信息，上传升级包文件，单击确认。

   参数	描述
   升级包类型	整包：您上传的升级包文件是完整的升级包文件，会推送整包升级包给设备进行升级。 差分：您上传的升级包文件仅包含新版本升级包与之前版本的差异部分，仅推送差异部分至设备，设备进行差分还原，还原为完整升级包。差分升级可有效减少升级对设备资源的占用，和减少下发升级包的流量消耗。 使用AliOS Things芯片的设备，阿里云提供差分包生成方法和差分还原算法，请参见OTA差分工具使用指南。您也可以自行生成差分包并完成差分还原算法开发。
   升级包名称	设置升级包名称，需在阿里云账号下唯一，创建后不可修改。支持中文、英文字母、日文、数字、短划线（-）、下划线（_）和半角圆括号（()），必须以中文、英文、日文或数字开头，长度限制为1~40个字符。 添加升级包成功后，可在升级包详情页面的升级包信息页签，单击编辑，修改升级包名称。
   所属产品	选择升级包所属产品。
   升级包模块	选择升级包所属OTA模块。 您可以单击添加模块，在弹出的对话框中新增一个模块。
   升级包版本号	设置该升级包的版本号。版本号支持英文字母、数字、半角句号（.）、短划线（-）和下划线（_），长度限制为1~64个字符。 升级包类型选择为整包时，需设置的参数。
   待升级版本号	输入或选择待升级设备的OTA模块版本号。下拉列表中，会展示当前产品下所有设备的OTA模块版本号，选择一个待升级的版本。 升级包类型选择为差分时，需设置的参数。
   升级后版本号	设置该升级包的版本号。 升级包类型选择为差分时，需设置的参数。
   签名算法	支持MD5和SHA256算法。 当设备使用阿里云提供的Android SDK，且升级包类型选择为差分时，请选择MD5算法。
   上传升级包	上传升级包文件。最多支持上传20个文件，总文件大小不能超过1,000 MB。文件格式仅支持.bin、.dav、.tar、.gz、.zip、.gzip、.apk、.tar.gz、.tar.xz、.pack。 上传多个升级包文件时，需注意： 文件名称不能重复，单个文件名称长度不能超过32个字符。 物联网平台会校验多个文件的签名是否一致，若文件签名一致，则视其为重复的文件。
   升级包是否需要平台验证	选择是否在批量升级前，使用少量测试设备对升级包进行验证。 是：必须进行验证，验证通过后，才能进行批量升级。 否：无需验证，直接进行批量升级。
   升级包描述	可描述该升级包的功能等信息。描述长度不超过1024个字符，一个中文计为一个字符。 添加升级包成功后，可在升级包详情页面的升级包信息页签，单击编辑，修改升级包描述。
   推送给设备的自定义信息	添加该升级包完成，并创建升级任务后，物联网平台向设备推送升级通知时，会下发该自定义信息给设备。 自定义信息的长度不超过4096个字符，内容和格式没有限制。 添加升级包成功后，可在升级包详情页面的升级包信息页签，单击编辑，修改推送给设备的自定义信息。
   升级包安全检测服务	检测您上传的升级包的安全性。目前仅华东2（上海）的公共实例支持该服务。 选择使用检测服务后，需输入您的邮箱地址，用于接收检测报告。 完成添加升级包后，开始执行检测。在升级包详情页面的升级包信息页签下，升级包安全检测服务模块会展示检测状态和安全风险数。 重要 若升级包中有多个文件，则不支持安全检测服务。

执行结果

升级包添加完成后，可在升级包列表查看，如图所示。

后续操作

若升级包中升级包是否需要平台验证选择了是，需先验证升级包。具体操作，请参见（可选）验证升级包。

否则，可直接向设备发起批量升级。具体操作，请参见发起升级批次任务。

可选：删除升级包

1. 在升级包列表页签，单击升级包对应操作列的删除。

2. 单击确认。

相关API

OTA相关API的更多信息，请参见OTA升级API。