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 指纹限制。请注意，所有重复值必须相同；即“全部包含”或“全部排除”这些值可以是 build 指纹的子字符串，例如限制值“ABC”将与包含字符串“ABC”的任何 build 指纹匹配。
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 中使用的属性文件的规范。

软件包类型

此 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。