检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
云手机按需安装 应用安装 应用更新 应用卸载 应用批量卸载 父主题： 共享应用使用场景
云手机部署文件 除了共享应用的使用场景外，部分用户业务上需要在云手机中部署文件，部署前需要将这类文件打成tar包，下文中统称这种tar包为配置文件包。 文件预置 文件按需部署 已部署文件更新 取消文件预置 使用多个配置文件包部署文件 父主题： 共享应用使用场景
appctrl clear 批量卸载应用 使用场景 批量卸载所有非预安装的共享应用。 使用指导 调用appctrl clear 例如：云手机中有2个非预安装共享应用，执行appctrl clear，可将2个非预安装应用批量卸载。 父主题： appctrl命令
为单台云手机安装应用 参考《云手机服务器API参考》的“安装apk”章节为单台云手机安装应用。 前提条件 云手机服务器所在Region的OBS桶中已经存放好对应的APK安装包。否则，需要上传安装包，可参考场景二：快速通过OBS Browser+上传下载文件进行上传。 确保已经配置
云手机预装应用 预装应用安装 预装应用更新 预装应用卸载 父主题： 共享应用使用场景
配置共享空间 在购买服务器实例页面，选定区域、服务器类型、实例规格后，配置共享空间大小。 建议在实际业务共享应用所需空间大小的基础上，上浮30%来配置共享空间的大小，以满足后续应用更新对共享空间的需求。 图1 配置共享空间 父主题： 共享空间中的应用包管理
appctrl 命令的执行方法 可通过以下三种方式在云手机中执行appctrl命令： 通过ADB连接云手机执行命令，请参考一键式ADB连接 。 调用API接口在云手机中执行命令，请参考执行异步adb命令 。 云手机中的业务程序或脚本直接调用appctrl命令。 需确保业务程序或脚本具备root用户权限。
appctrl start 安装并启动应用 使用场景 安装应用到云手机，并启动应用。 前置条件 应用的tar包已经推送到云手机服务器。 使用指导 appctrl start {包名} 例如：安装并启动应用：appctrl start com.huawei.xxxx 对于服务类应用
appctrl applyConfig 部署文件 使用场景 直接部署文件至云手机。 前置条件 配置文件tar包已经推送到云手机服务器，并且为固定支持的包名。 仅支持包名为com.cph.config、com.cph.config.level1、com.cph.config.level2。
2022-08-22及之后发布的AOSP7 云手游镜像, 不能与2022-08-22之前发布的AOSP7 云手游镜像在同一服务器上混合部署。 发布时间：2023-11-10 镜像ID 新增特性 BUG修复 适用所有服务器规格镜像ID： 23100120231110f004101b21000004c5 优化音视频出流初始化速度
AOSP9云手游镜像更新记录 发布时间：2023-11-10 镜像ID 新增特性 BUG修复 适用所有服务器规格镜像ID： 23100120231110e003101b2100000cab 优化音视频出流初始化速度 优化音视频触控 调整音视频出流模式为码率优先 提升GPS定位系统稳定性
如果应用存在资源更新，请启动应用并完成资源文件的下载和更新。 参考生成应用版本tar包并推至OBS桶和推送应用tar包至服务器共享空间生成并推送tar包到服务器共享空间。 执行appctrl命令进行更新（参考appctrl命令）。 执行appctrl start 命令，云手机会安装该应用共享空间中最新版本并启动。
应用卸载 操作步骤 在云手机中执行appctrl命令，对已安装在云手机中的共享应用进行卸载（参考appctrl命令）。 使用指导：在云手机中执行appctrl uninstall {包名} 例如：卸载应用 appctrl uninstall com. huawei.xxxx appctrl
文件预置 业务场景示例 需要在服务器上的所有云手机中预置文件。 例如：推流二进制文件、保活脚本文件、应用行为监控文件等。 操作步骤 参考获取云手机列表，从列表中选定一台云手机，将需要打包的文件放入到该云手机的目标路径下。 例如：服务器上云手机需要在/data/local/huaw
检查参数“本地空闲端口”是否被占用了。 确保您获取的是“实例监听端口”而非“服务器监听端口”。 检查“SSH隧道用户名”使用的是项目ID，请参考如何获取项目ID？。 创建新的密钥对，并在“服务器管理”界面更新云手机所在服务器的密钥对，等待1-2分钟至其生效，然后使用新的私钥文件路径再次执行命令。
生成应用版本tar包并推至OBS桶 前提条件 需确保云手机已安装对应的应用。 确保已配置好OBS桶的授权策略，具体操作请参考委托CPH操作OBS桶章节。 接口示例 POST https://{CPH Endpoint}/v1/{project_id}/cloud-phone/phones/batch-storage
准备共享应用tar包 获取云手机列表 为单台云手机安装应用 生成应用版本tar包并推至OBS桶 父主题： 共享空间中的应用包管理
应用批量卸载 业务场景示例 客户分配的云手机时间到期，需要回收进入待分配区，并进行共享应用批量卸载，卸载上一个玩家安装的共享应用。 操作步骤 在云手机中执行appctrl命令，对使用appctrl命令安装的所有共享应用进行卸载（参考appctrl命令）。 使用指导：在云手机中执行appctrl
预装应用安装 业务场景示例 服务器上所有云手机都要安装某些应用，并且云手机重置后默认安装这些应用。 操作步骤 参考推送应用tar包至服务器共享空间，推送需要预装的应用tar包到服务器共享空间，将pre_install_app设置为1。 重置云手机，所有预装应用会自动安装。 预装应用的安装过程会占用一定的手机重置时间。
启动应用更新下载资源。 参考生成应用版本tar包并推至OBS桶，生成共享应用tar包并推送到OBS桶中。 参考推送应用tar包至服务器共享空间，推送需要预装的应用tar包到服务器共享空间，将pre_install_app设置为1。 重启或重置云手机，所有预装应用会自动更新。 预装应用的更新过程会占用一定的手机重启和重置时间。
长按/截图保存，微信识别二维码
或者关注公众号“华为云”
