调用CreateAppVersion创建应用升级版本。

说明 当用户需要进行应用升级时,需要首先调用此接口创建一个应用版本,然后进行后续的版本测试、灰度、发布。

调试

您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。

请求参数

名称 类型 是否必选 示例值 描述
Action String 是 CreateAppVersion

系统规定参数。取值:CreateAppVersion。

ProjectId String 是 P0VFCREU

项目ID

RegionId String 是 cn-shanghai

地域ID

ApkMd5 String 否 34653456wertwe234653retwewer3456

APK的MD5值

AppId String 否 123

应用ID,表示要针对哪个应用进行升级。

AppVersion String 否 1.0

应用版本号

BlackVersionList String 否 10,20,30

版本黑名单,versioncode英文逗号拼接。

DeviceAdapterList String 否 10|2.0.1-R-20180412.1024|3.0.1-R-20180412.1024,11|2.1.1-R-20180412.1024|3.1.1-R-20180412.1024

应用版本的适配机型列表。

格式:deviceModelId1|minOsVersion1|maxOsVersion1,deviceModelId2|minOsVersion2|maxOsVersion2,即设备型号ID|最低的系统版本号|最高的系统版本号。

InstallType String 否 auto

安装类型,取值:auto表示自动,customize表示自定义。

IsAllowNewInstall String 否 N

表示当客户端不存在此应用时,是否允许新安装此应用,相当于后装。

IsForceUpgrade String 否 N

是否强制升级,取值:Y | N。

IsNeedRestart String 否 N

是否需要重启,取值:Y | N。

IsSilentUpgrade String 否 N

是否静默升级,取值:Y | N。

PackageUrl String 否 http://www.oss-server.com/file.zip

升级包地址

ReleaseNote String 否 sample release note

版本发布说明

Remark String 否 sample remark

版本备注

RestartAppParam String 否 {"restartDelay":1}

应用重启时可以由服务端指定的重启参数

RestartAppType String 否 service

如果restartType为应用重启,则这个字段表示应用重启的类型。取值:

  • service:Service重启
  • activity:Activity重启
RestartType String 否 app

应用安装完成后的重启类型。取值:

  • system:系统重启
  • app:应用重启
VersionCode String 否 100

应用版本versioncode

WhiteVersionList String 否 10,20,30

版本白名单,versioncode英文逗号拼接。

返回数据

名称 类型 示例值 描述
RequestId String 6F25F67C-F411-499F-BCE2-67CA563CB064

请求ID

VersionId String 12345

版本ID

示例

请求示例


http(s)://iovcc.cn-shanghai.aliyuncs.com/?Action=CreateAppVersion
&ProjectId=P0VFCREU
&RegionId=cn-shanghai
&<公共请求参数>

正常返回示例

XML 格式

<CreateAppVersionResponse>
	  <RequestId>6F25F67C-F411-499F-BCE2-67CA563CB064</RequestId>
	  <VersionId>12345</VersionId>
</CreateAppVersionResponse>

JSON 格式

{
	"RequestId":"6F25F67C-F411-499F-BCE2-67CA563CB064",
	"VersionId":12345
}

错误码

访问错误中心查看更多错误码。