如何添加 OTA 升级包_云市场(Marketplace)-阿里云帮助中心

物联网设备进行OTA升级，需先在阿里云物联网平台为对应产品添加升级包。本文介绍添加升级包的具体操作步骤。

前提条件

设备端已支持OTA升级功能。具体内容，请参见设备端Link SDK的OTA升级。

若添加包含多个文件的OTA升级包，设备端必须支持使用多个升级包文件发起的升级任务，进行OTA升级。具体内容，请参见多个文件的OTA升级。

重要

目前，仅C语言的设备端Link SDK支持开发多个文件的OTA升级功能。

背景信息

OTA升级的使用说明，请参见OTA升级概述。设备端进行OTA升级的流程，请参见设备端OTA升级。

操作步骤

在左侧导航栏，选择监控运维 > OTA升级。
（可选）自定义OTA模块。 OTA模块是同产品下设备的不同可升级模块，例如固件、软件、驱动等。默认（default）模块表示整个设备的固件，支持自定义其他OTA模块。在模块列表页签，单击添加模块，配置模块信息，单击确认。

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

在OTA升级页面，单击升级包列表页签，单击添加升级包。
配置升级包信息，上传升级包文件，单击确认。

参数	描述
升级包类型	整包：您上传的升级包文件是完整的升级包文件，会推送整包升级包给设备进行升级。
升级包名称	设置升级包名称，创建后不可修改。支持中文、英文字母、数字、短划线（-）、下划线（_），必须以中文、英文或数字开头，长度限制为1~40个字符。
所属产品	选择升级包所属产品。
升级包模块	选择升级包所属OTA模块。您可以单击添加模块，在弹出的对话框中新增一个模块。
升级包版本号	设置该升级包的版本号。版本号支持英文字母、数字、半角句号（.）、短划线（-）和下划线（_），长度限制为1~64个字符。升级包类型选择为整包时，需设置的参数。
签名算法	支持MD5和SHA256算法。
选择升级包	上传升级包文件。仅支持上传 1 个，总文件大小不能超过1,000 MB。文件格式仅支持`.bin`、`.dav`、`.tar`、`.gz`、`.zip`、`.gzip`、`.apk`、`.tar.gz`、`.tar.xz`。
升级包是否需要平台验证	选择是否在批量升级前，使用少量测试设备对升级包进行验证。是：必须进行验证，验证通过后，才能进行批量升级。否：无需验证，直接进行批量升级。
升级包描述	可描述该升级包的功能等信息。描述长度不超过1024个字符，一个中文计为一个字符。
推送给设备的自定义信息	添加该升级包完成，并创建升级任务后，物联网平台向设备推送升级通知时，会下发该自定义信息给设备。自定义信息的长度不超过4096个字符，内容和格式没有限制。

执行结果

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

后续操作

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

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

可选：删除升级包

警告

OTA升级包被删除后，升级包对应的文件立即无法下载，会导致相关业务中断。请谨慎操作。

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