软件包规格

本章以边缘管理系统软件包名称om-sdk.tar.gz为例，介绍如何构建自定义软件包。

OM SDK支持用户按照相应的规格，为进行过二次开发的软件构建安装包；同时OM SDK为自身安装包和其他自定义固件提供了通用的升级通道，支持开发者按照本章节指导构建通用升级包。OM SDK构建的软件包会包含以下文件信息。

表1 文件信息
文件名称	文件说明
omsdk.tar.gz	软件包名称。用户可以自定义升级包名称，但是格式必须为tar.gz。
vercfg.xml	软件包完整性校验文件。
version.xml	版本信息配置文件。
vercfg.xml.cms	对应文件的签名文件及吊销列表。
vercfg.xml.crl
version.xml.cms
version.xml.crl
omsdk.tar.gz.cms
omsdk.tar.gz.crl

用户需要自行准备相关文件且文件名称需要与表2中文件名称保持一致（除了升级包名称）。

表2 边缘管理系统软件包中文件
文件名称	文件说明
bin	边缘管理系统软件运行与使用的必要文件
config
lib
scripts
software
tools
install.sh	边缘管理系统安装脚本
uninstall.sh	边缘管理系统卸载脚本
upgrade.sh	边缘管理系统升级脚本
version.xml	版本信息配置文件

关键文件说明

vercfg.xml文件示例如下。

<?xml version="1.0" encoding="utf-8"?>
<Package>
    <File>
        <FilePath>version.xml</FilePath>
        <SHAValue>a28ed14f3bf81b7274ce090efd28dd2bf5313fd8e48809e4cdef27186d6ba654</SHAValue>
    </File>
    <File>
        <FilePath>omsdk.tar.gz</FilePath>
        <SHAValue>5a51030d5e7aead7e4c47408f9af11b4ff59bde0fc801b1290977b0e28322a04</SHAValue>
    </File>
</Package>

表3 参数说明
参数名称	说明
FilePath	表示升级包中文件名，需要带文件格式后缀，取值为version.xml和sdk-upgrade.tar.gz。
SHAValue	表示FilePath字段对应文件的sha256值，可通过sha256sum命令获取。

version.xml文件示例如下：

<?xml version="1.0" encoding="utf-8"?>
<FirmwarePackage version="V1">
<!--Upgrade packages description-->
    <Package>
        <FileName>omsdk.zip</FileName>
        <OutterName>MindXOM</OutterName>
       <Version>SDK-omsdk 1.0</Version>             
        <FileType>Firmware</FileType>
       <Module>SDK-omsdk</Module>                 
        <Vendor>Huawei Technologies Co., Ltd</Vendor>
        <MaxUpgradeTime>3600</MaxUpgradeTime>
        <!--UpgradeTimeout:unit second-->
        <ActiveMode>ResetOS</ActiveMode>
        <MaxActivetime>600</MaxActivetime>
        <SupportModel>Atlas 200I A2</SupportModel>
        <ProcessorArchitecture>ARM</ProcessorArchitecture>
        <UpgradeAgent>OM</UpgradeAgent>
    </Package>
</FirmwarePackage>

表4 参数说明
参数名称	说明
Version	软件包版本，可在构建软件包时进行配置
Module	软件包的固件类型，可在构建软件包时进行配置
Vendor	厂商信息，可在构建软件包时进行配置
FileName	软件包名称，可在构建软件包时进行配置
OutterName	边缘管理系统软件正常运行的必要配置，不可配置与修改
FileType
MaxUpgradeTime
ActiveMode
MaxActivetime
SupportModel
ProcessorArchitecture
UpgradeAgent

父主题： 构建软件包