ALTER APPLICATION PACKAGE ... MODIFY RELEASE CHANNEL¶
修改现有应用程序包定义的发布通道。使用此命令修改发布通道、变更分配给发布通道的版本或补丁,或设置发布通道的发布指令。
备注
本主题的语法仅适用于使用发布通道的应用程序包。有关更多信息,请参阅 使用版本渠道发布应用程序。若要为不使用发布通道的应用程序包设置发布指令,请参阅 ALTER APPLICATION PACKAGE ...RELEASE DIRECTIVE。
- 另请参阅:
ALTER APPLICATION PACKAGE , ALTER APPLICATION PACKAGE ...VERSION, ALTER APPLICATION PACKAGE ...RELEASE DIRECTIVE SHOW RELEASE DIRECTIVES
语法¶
ALTER APPLICATION PACKAGE <name>
MODIFY RELEASE CHANNEL <release_channel>
SET DEFAULT RELEASE DIRECTIVE
VERSION = <version_identifier>
PATCH = <patch_num>
[ UPGRADE_AFTER = '<timestamp>' ]
ALTER APPLICATION PACKAGE <name>
MODIFY RELEASE CHANNEL <release_channel>
SET RELEASE DIRECTIVE <release_directive>
ACCOUNTS = ( <organization_name>.<account_name> [ , <organization_name>.<account_name> , ... ] )
VERSION = <version_identifier>
PATCH = <patch_num>
[ UPGRADE_AFTER = '<timestamp>' ]
ALTER APPLICATION PACKAGE <name>
MODIFY RELEASE CHANNEL <release_channel>
MODIFY RELEASE DIRECTIVE <release_directive>
VERSION = <version_identifier>
PATCH = <patch_num>
[ UPGRADE_AFTER = '<timestamp>' ]
ALTER APPLICATION PACKAGE <name>
MODIFY RELEASE CHANNEL <release_channel>
UNSET RELEASE DIRECTIVE <release_directive>
参数¶
name指定应用程序包的标识符。如果标识符包含空格、特殊字符或大小写混合字符,则整个字符串必须放在双引号内。放在双引号内的标识符也区分大小写。
MODIFY RELEASE CHANNEL release_channel指定此发布指令适用的发布通道。如果未指定,则发布指令适用于所有发布通道。
支持的值为:
ALPHA
QA
DEFAULT
有关发布通道的更多信息,请参阅 使用版本渠道发布应用程序。
VERSION = version_identifier.PATCH = patch_num修改指定自定义发布指令的版本和补丁级别。
SET指定一个或多个要为应用程序包设置的属性,可用空格、逗号或换行分隔。有关可设置的属性的更多详细信息,请参阅 CREATE APPLICATION。
DEFAULT RELEASE DIRECTIVE VERSION = version_identifier PATCH = patch_num设置默认情况下应为使用者安装的应用程序包的版本和补丁级别。
RELEASE DIRECTIVE release_directive.ACCOUNTS = ( organization_name.account_name [ , organization_name.account_name , ... ] ).VERSION = version_identifier.PATCH = patch_num为指定账户创建自定义发布指令。
使用 ACCOUNTS 子句指定此发布指令适用的账户列表。
使用 VERSION 和 PATCH 子句指定要为这些账户安装的版本标识符和补丁编号。
UPGRADE_AFTER = 'timestamp'指定自动升级过程开始的日期和时间。使用者可在此日期之前手动将应用程序升级到新版本或补丁。
此值可为任何有效日期和时间格式。
UNSET指定一个或多个要为应用程序包取消设置的属性和/或会话参数,将其重置为默认值。
UNSET RELEASE DIRECTIVE release_directive从应用程序包中移除指定的自定义发布指令。
使用说明¶
修改发布指令需要具有应用程序 OWNERSHIP 权限或全局 MANAGE VERSIONS 权限。
如未为可选属性指定值,该命令将使用应用程序清单文件中指定的值。
如果在命令和应用程序清单文件中均指定了属性值,则优先采用命令中指定的值。
示例¶
以下示例将版本 V1 添加到默认发布通道:
ALTER APPLICATION PACKAGE my_app_package
MODIFY RELEASE CHANNEL DEFAULT
ADD VERSION V1;
+---------------------------------------------------------------------------------------------------------+
| status |
|---------------------------------------------------------------------------------------------------------|
| Version V1 added to release channel DEFAULT in application package my_app_package |
+---------------------------------------------------------------------------------------------------------+
以下示例修改默认发布通道的默认发布指令,将版本设置为 V1,补丁设置为 0:
ALTER APPLICATION PACKAGE my_app_package
MODIFY RELEASE CHANNEL DEFAULT
SET DEFAULT RELEASE DIRECTIVE
VERSION = V1
PATCH=0;
+---------------------------------------------------------------------------------------------------------+
| status |
|---------------------------------------------------------------------------------------------------------|
| Version V1 added to release channel DEFAULT in application package my_app_package |
+---------------------------------------------------------------------------------------------------------+
ALTER APPLICATION PACKAGE my_app_package
MODIFY RELEASE CHANNEL ALPHA
ADD ACCOUNTS=(PM.CONNECTORS);
+---------------------------------------------------------------------------------------+---------+-------+
| status | version | patch |
|---------------------------------------------------------------------------------------+---------+-------|
| TBD | | |
+---------------------------------------------------------------------------------------+---------+-------+