REST Resource: deployments.packages

资源：软件包

OTA 配置中的软件包。

JSON 表示法 
{
  "name": string,
  "title": string,
  "disabled": boolean,
  "deviceBuildRestrictions": [
    {
      object (IncludeExclude)
    }
  ],
  "details": {
    object (PackageDetails)
  }
}
字段
name

string

仅供输出。存储的软件包的名称。请注意，这是 Package 对象的唯一标识符；在创建新的 Package 时，服务器会生成此标识符。
title

string

软件包的标题；即显示名称。
disabled

boolean

是否针对给定部署停用了软件包。
deviceBuildRestrictions[]

object (IncludeExclude)

可选。表示可能仅适用于完整软件包的 build 指纹限制。请注意，所有重复值必须相同；即全部包含或全部排除。这些值可以是版本指纹的子字符串，例如，限制值“ABC”将与包含字符串“ABC”的任何版本指纹匹配。
details

object (PackageDetails)

软件包的更多详情。此字段为只读字段。

IncludeExclude

包含或排除某些模式。

JSON 表示法 
{

  // Union field include_exclude can be only one of the following:
  "include": string,
  "exclude": string
  // End of list of possible types for union field include_exclude.
}
字段
联合字段 include_exclude。包含或排除规则。include_exclude 只能是下列其中一项：
include

string

包含的模式。
exclude

string

已排除的格式。

PackageDetails

OTA 软件包的详细信息。

JSON 表示法 
{
  "sizeBytes": string,
  "originalFilename": string,
  "preConditions": [
    {
      object (Condition)
    }
  ],
  "postConditions": [
    {
      object (Condition)
    }
  ],
  "properties": {
    object (PackageProperties)
  },
  "webDownloadUrl": string,
  "updateTime": string,
  "uploadState": enum (PackageUploadState),
  "uploadError": string,
  "uploadUser": string,
  "uploadTime": string,
  "approved": boolean,
  "beta": boolean,
  "versionTag": {
    object (VersionTag)
  }
}
字段
sizeBytes

string (int64 format)

软件包大小（以字节为单位）。
originalFilename

string

上传的原始文件名。
preConditions[]

object (Condition)

软件包前提条件。
postConditions[]

object (Condition)

软件包后置条件。
properties

object (PackageProperties)

软件包属性。
webDownloadUrl

string

用于直接从 Google 下载软件包的链接。用于信息中心 / 控制台。
updateTime

string (Timestamp format)

上次修改软件包条目的时间。

时间戳，采用 RFC3339 世界协调时间 (UTC)（即“祖鲁时”）格式，具有纳秒级分辨率，最多包含九个小数位。示例："2014-10-02T15:01:23Z" 和 "2014-10-02T15:01:23.045123456Z"。
uploadState

enum (PackageUploadState)

软件包的上传状态。
uploadError

string

上传软件包时出错。仅当 uploadState 为 FAILURE 时，系统才会设置该字段。
uploadUser

string

上传软件包的用户的电子邮件地址
uploadTime

string (Timestamp format)

软件包的上传时间。这可能并不适用于所有软件包。

时间戳，采用 RFC3339 世界协调时间 (UTC)（即“祖鲁时”）格式，具有纳秒级分辨率，最多包含九个小数位。示例："2014-10-02T15:01:23Z" 和 "2014-10-02T15:01:23.045123456Z"。
approved

boolean

软件包是否已在 APFE 中获得批准。
beta

boolean

软件包是否被标记为 Beta 版软件包。
versionTag

object (VersionTag)

软件包的版本。

PackageProperties

OTA 软件包的属性。

JSON 表示法 
{
  "type": enum (PackageType),
  "requiredCache": string,
  "downgrade": boolean,
  "wipe": boolean,
  "streamingPropertyFiles": string
}
字段
type

enum (PackageType)

OTA 软件包类型，例如基于块。
requiredCache

string (int64 format)

OTA 所需的缓存大小（以字节为单位）。
downgrade

boolean

OTA 软件包是否为降级软件包。
wipe

boolean

OTA 软件包是否会应用擦除操作。
streamingPropertyFiles

string

流式 OTA 中使用的属性文件的规范。

PackageType

此 OTA 中的软件包类型。

枚举
PACKAGE_TYPE_UNSPECIFIED 未指定。
FILE 文件级 OTA。
BLOCK 基于块的 OTA。
AB A/B OTA。

PackageUploadState

软件包上传的状态。

软件包文件完全传输后，系统会创建一个 package，服务器将开始处理该文件，以从中读取软件包属性。在处理完成之前，上传状态将设为 IN_PROGRESS。处理完毕后，上传状态将设置为 SUCCESS 或 FAILURE。

枚举
PACKAGE_UPLOAD_STATE_UNSPECIFIED 未指定。
SUCCESS 上传成功。
FAILURE 上传失败。最可能的原因是文件包无效（例如，由于各种原因无法解压缩文件）。
IN_PROGRESS 文件包仍在处理中。

方法

delete

 删除 package。

get

 获取 package。

list

 列出 packages。

listBatchGet

 列出使用指定软件包的所有配置。

update

 更新 package。