文档首页/ 云手机服务 KooPhone / 用户指南/ 节点版/ 管理云手机应用库

更新时间：2026-10-28 GMT+08:00

管理云手机应用库

在应用库管理页面，展示租户已创建的应用，并支持租户创建新应用，对已创建的应用进行管理。

用户可自定义表格：任务列表默认展示信息包括“应用名称”、“应用包名”、“最新版本号/版本描述”、“应用属性”、“应用类型”、“用户数据备份路径”、“用户数据备份排除路径”、“状态”、“创建时间”、“更新时间”、“操作”。单击列表右上方设置按钮，可自定义列表展示参数。

表1 参数说明
参数		是否可选	参数说明
自定义列表项	应用名称	否	从上传的apk文件中读取应用名称。
	应用包名	是	上传文件选择本地应用apk文件解析而来。
	最新版本号/版本描述	是	系统默认解析而来。
	应用属性	是	“普通应用”或“共享应用”。
	应用类型	是	支持“其他”、“音视频”、“游戏”，默认选中“其他”。
	用户数据备份路径	是	在使用云应用模式的场景下，用户进行数据备份的路径。
	用户数据备份排除路径	是	在使用云应用模式的场景下，用户进行数据备份时所不需要备份的路径。
	状态	是	闲置：创建成功但未被使用的应用。使用中：被部署至节点组或镜像上的应用，不支持删除。待打包：被手动终止打包任务的共享应用，支持继续打包。打包中：打包环境准备成功后自动进入打包流程的共享应用。异常：打包环境准备或打包失败的共享应用，支持查看失败原因及重试。
	创建时间	是	创建应用的时间。
	更新时间	是	更新应用信息的时间。
	操作	否	可进行“版本管理”、“编辑应用信息”和“删除”等操作。

创建应用

在应用库管理页面，支持创建普通应用和共享应用。

创建普通应用

登录云手机服务管理控制台，进入云手机服务总览页面。

如果当前版本为实例版，请单击“切换至节点版”以切换到节点版页面。
在左侧导航栏选择“应用库”，进入应用库管理页面。

在应用库管理页面单击“创建应用”。在弹出的窗口中，参考表表1 创建普通应用参数说明设置应用相关信息。

图1 创建普通应用

表2 创建普通应用参数说明
参数	说明
应用包	单击“上传文件”，选择本地应用apk文件。上传的apk文件不能超过4GB。上传过程中支持显示解析过程。如果检测存在相同应用包名和应用版本的应用，则为重复应用，会报错提示；如果检测存在相同应用包名但不同版本号的应用，展示“解析完成”和对应文件信息，单击“确定并更新版本”，应用将更新至新版本（不会新增应用）。上传完成后，可单击“替换文件”更新apk文件。
应用名称	从上传的apk文件中读取应用名称。支持修改，长度为1-64个任意字符。应用名称不能重复。
图标	从上传的apk文件中读取应用图标。如果需要更换，在上传apk文件并读取图标后，单击图标上的，选择新图标进行上传。应用图标建议使用正方形。尺寸：216*216px；格式：PNG(500 KB以内)、WEBP(100 KB以内)。
版本描述	选填，上传应用时填写的应用描述，长度为1-100个字符。
应用属性	选择“普通应用”。
应用类型	支持“其他”、“音视频”、“游戏”，默认选中“其他”。
用户数据备份路径	选填，在使用云应用模式的场景下，推荐进行用户数据备份。只能由英文字母、数字、中文字符、短横线（-）、下划线（_）、中英文逗句号、分号、冒号和斜杠组成，且长度为1~1000个字符。格式参考：/data/user/${user_id}/${pkg_name}/account。可使用“；”间隔多个路径。
用户数据备份排除路径	选填，填写应用数据备份后可选填数据备份排除路径，只能由英文字母、数字、中文字符、短横线（-）、下划线（_）、中英文逗句号、分号、冒号和斜杠组成，且长度为1~1000个字符。格式参考：/data/user/${user_id}/${pkg_name}/account。可使用“；”间隔多个路径。

单击“确定”，显示应用上传进度。上传应用需要等待一段时间才能完成，请耐心等待。

上传完成后，可以“应用库管理”页面看到新上传的应用。

创建共享应用

对于界面、功能较复杂的应用（比如微信、QQ等），不建议设置为共享应用。设置为共享应用后，可能会出现编译加速失效导致启动偏慢。

登录云手机服务管理控制台，进入云手机服务总览页面。

如果当前版本为实例版，请单击“切换至节点版”以切换到节点版页面。
在左侧导航栏选择“应用库”，进入应用库管理页面。

在应用库管理页面单击“创建应用”。在弹出的窗口中，参考表3设置应用相关信息。

表3 创建共享应用参数说明
参数	说明
应用包	单击“上传文件”，选择本地应用apk文件。上传的apk文件不能超过4GB。上传过程中支持显示解析过程。如果检测存在相同应用包名和应用版本的应用，则为重复应用，会报错提示；如果检测存在相同应用包名但不同版本号的应用，展示“解析完成”和对应文件信息，单击“确定并更新版本”，应用将更新至新版本（不会新增应用）。上传完成后，可单击“替换文件”更新apk文件。
应用名称	从上传的apk文件中读取应用名称。支持修改，长度为1-64个字符。应用名称不能重复。
图标	从上传的apk文件中读取应用图标。如果需要更换，在上传apk文件并读取图标后，单击图标上的，选择新图标进行上传。应用图标建议使用正方形。尺寸：216*216px；格式：PNG(500 KB以内)、WEBP(100 KB以内)。
版本描述	选填，上传应用时填写的应用描述，长度为1-100个字符。
应用属性	选择“共享应用”，支持更新资源。
应用类型	支持“其他”、“音视频”、“游戏”，默认选中“其他”。
版本描述	选填，上传应用时填写的应用描述，长度为1-100个字符。
用户数据备份路径	选填，在使用云应用模式的场景下，推荐进行用户数据备份。只能由英文字母、数字、中文字符、短横线（-）、下划线（_）、中英文逗句号、分号、冒号和斜杠组成，且长度为1~1000个字符。格式参考：/data/user/${user_id}/${pkg_name}/account。可使用“；”间隔多个路径。
用户数据备份排除路径	选填，填写应用数据备份后可选填数据备份排除路径，只能由英文字母、数字、中文字符、短横线（-）、下划线（_）、中英文逗句号、分号、冒号和斜杠组成，且长度为1~1000个字符。格式参考：/data/user/${user_id}/${pkg_name}/account。可使用“；”间隔多个路径。

（可选）单击“下一步：更新资源”，选择资源的展示方式，支持“横屏”和“竖屏”视图的切换，勾选确认已完成更新资源。

单击“刷新”更新云手机画面。
单击“确定”，显示应用上传进度。上传应用需要等待一段时间才能完成，请耐心等待。

上传完成后，可以“应用库”页面看到新上传的应用。

管理已创建的应用

在应用库管理页面，您可以进行新增应用版本、更新共享应用资源、编辑应用信息、查看应用详情或删除应用等操作。

新增普通应用的版本

登录云手机服务管理控制台，进入云手机服务总览页面。

如果当前版本为实例版，请单击“切换至节点版”以切换到节点版页面。
在左侧导航栏选择“应用库”，进入应用库管理页面。
在应用库管理页面，单击普通应用操作列的“版本管理”，进入版本管理页面。

单击“新增版本”，参照表4填写参数。

图2 新增版

表4 新增版本参数说明
参数	说明
应用名称	默认显示上传应用时填写的应用名称，不可修改。
应用属性	默认显示普通应用，不可修改。
应用类型	默认显示当初创建应用时的类型，不可修改。
应用包	单击“上传文件”，选择本地应用apk文件。上传的apk文件不能超过4GB。上传过程中支持显示解析过程。如果检测存在相同应用包名和应用版本的应用，则为重复应用，会报错提示；如果检测存在相同应用包名但不同版本号的应用，展示“解析完成”和对应文件信息，单击“确定并更新版本”，应用将更新至新版本（不会新增应用）。上传完成后，可单击“替换文件”更新apk文件。
图标	从上传的apk文件中读取应用图标。如果需要更换，在上传apk文件并读取图标后，单击图标上的，选择新图标进行上传。应用图标建议使用正方形。尺寸：216*216px；格式：PNG(500 KB以内)、WEBP(100 KB以内)。
版本描述	选填，上传应用时填写的应用描述，长度为1-100个字符。

填写完成后单击“确定”。
- 单击操作列的“删除”，可删除历史应用版本。
- 上传完成后，可以在“版本管理”页面看到新增的版本。

更新共享应用

“打包”中的共享应用不支持更新操作。

登录云手机服务管理控制台，进入云手机服务总览页面。

如果当前版本为实例版，请单击“切换至节点版”以切换到节点版页面。
在左侧导航栏选择“应用库”，进入应用库管理页面。

在应用库的应用列表中，单击共享应用操作列的“更新版本”，参照表5填写参数。

图3 更新共享应用

表5 更新共享应用参数说明
参数	说明
应用名称	默认显示上传应用时填写的应用名称，不可修改。
当前版本号	默认显示当前应用创建时的版本号，不可修改。
应用属性	默认显示共享应用，不可修改。
应用类型	默认显示当初创建应用时的类型，不可修改。
应用包	单击“上传文件”，选择本地应用apk文件。上传的apk文件不能超过4GB。上传过程中支持显示解析过程。如果检测存在相同应用包名和应用版本的应用，则为重复应用，会报错提示；如果检测存在相同应用包名但不同版本号的应用，展示“解析完成”和对应文件信息，单击“确定并更新版本”，应用将更新至新版本（不会新增应用）。上传完成后，可单击“替换文件”更新apk文件。
图标	从上传的apk文件中读取应用图标。如果需要更换，在上传apk文件并读取图标后，单击图标上的，选择新图标进行上传。应用图标建议使用正方形。尺寸：216*216px；格式：PNG(500 KB以内)、WEBP(100 KB以内)。
描述	选填，上传应用时填写的应用描述，长度为1-100个字符。
资源更新	面向大型游戏，提供资源包预加载能力，方便最终用户即开即玩。选择“需要”更新资源时，执行4。

单击“ 下一步：更新资源”，选择资源的展示方式，支持“横屏”和“竖屏”视图的切换，勾选确认已完成更新资源。

单击“刷新”更新云手机画面。
单击“确定”，显示应用上传进度。上传应用需要等待一段时间才能完成，请耐心等待。

上传完成后，可以“应用库”页面看到更新后的应用。

^{编辑普通应用的应用信息}

登录云手机服务管理控制台，进入云手机服务总览页面。

如果当前版本为实例版，请单击“切换至节点版”以切换到节点版页面。
在左侧导航栏选择“应用库”，进入应用库管理页面。
在应用库管理页面，单击共享应用操作列的“更多”下拉选择“编辑应用信息”，进入编辑信息页面。
在弹框中可以更改应用类型，编辑版本描述、数据备份路径和数据备份排除路径，编辑完成后单击“确定”。

^{编辑共享应用的应用信息}

登录云手机服务管理控制台，进入云手机服务总览页面。

如果当前版本为实例版，请单击“切换至节点版”以切换到节点版页面。
在左侧导航栏选择“应用库”，进入应用库管理页面。
在应用库管理页面，单击普通应用操作列的“编辑应用信息”，进入编辑信息页面。
在弹框中可以更改应用类型，编辑数据备份路径和数据备份排除路径，编辑完成后单击“确定”。

更新共享应用资源

“打包”中的共享应用不支持更新资源。

登录云手机服务管理控制台，进入云手机服务总览页面。

如果当前版本为实例版，请单击“切换至节点版”以切换到节点版页面。
在左侧导航栏选择“应用库”，进入应用库管理页面。
在应用库的应用列表中，单击共享应用操作列的“更新资源”。
支持“横屏”和“竖屏”视图的切换，单击“刷新”更新云机画面。
勾选确认完成资源更新后单击“确定”。

重新打包异常共享应用

用户可以通过“重试”重新打包异常的共享应用。

登录云手机服务管理控制台，进入云手机服务总览页面。

如果当前版本为实例版，请单击“切换至节点版”以切换到节点版页面。
在左侧导航栏选择“应用库”，进入应用库管理页面。
在应用库的应用列表中，单击异常的共享应用状态列的“重试”。

单击“重试”后，应用将重新进入安装流程。

查看普通应用部署详情

登录云手机服务管理控制台，进入云手机服务总览页面。

如果当前版本为实例版，请单击“切换至节点版”以切换到节点版页面。
在左侧导航栏选择“应用库”，进入应用库管理页面。
在应用库管理页面，单击普通应用操作列的“版本管理”，进入应用版本管理页面。
在版本管理页面，单击操作列的“部署详情”，可查看自定义镜像的部署详情。
- 自定义镜像：展示了镜像名称/ID、基础镜像、镜像描述、镜像大小和部署详情。
图4 部署详情

查看共享应用部署详情

登录云手机服务管理控制台，进入云手机服务总览页面。

如果当前版本为实例版，请单击“切换至节点版”以切换到节点版页面。
在左侧导航栏选择“应用库”，进入应用库管理页面。
在应用库管理页面，单击共享应用操作列的“更多 > 部署详情”，可查看自定义镜像的部署详情。
- 自定义镜像：展示了镜像名称/ID、基础镜像、镜像描述、镜像大小和部署详情。

删除应用

应用部署到节点组或镜像后，状态将更新为“使用中”，不支持删除。

登录云手机服务管理控制台，进入云手机服务总览页面。

如果当前版本为实例版，请单击“切换至节点版”以切换到节点版页面。
在左侧导航栏选择“应用库”，进入应用库管理页面。
在应用库的应用列表中，通过以下方式删除共享应用或普通应用。
- 删除普通应用：单击应用操作列的“删除”。
- 删除共享应用：单击应用操作列的“更多 > 删除”。
检查应用名称等信息后，在删除确认框中，单击“确定”。

删除成功后，将弹出删除成功提示框。

父主题： 节点版

上一篇：购买云手机

下一篇：管理云手机镜像