检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
appctrl applyConfig 部署文件 使用场景 直接部署文件至云手机。 前置条件 配置文件tar包已经推送到云手机服务器，并且为固定支持的包名。 仅支持包名为com.cph.config、com.cph.config.level1、com.cph.config.level2。
文件预置 业务场景示例 需要在服务器上的所有云手机中预置文件。 例如：推流二进制文件、保活脚本文件、应用行为监控文件等。 操作步骤 参考获取云手机列表，从列表中选定一台云手机，将需要打包的文件放入到该云手机的目标路径下。 例如：服务器上云手机需要在/data/local/huaw
预装应用安装 业务场景示例 服务器上所有云手机都要安装某些应用，并且云手机重置后默认安装这些应用。 操作步骤 参考推送应用tar包至服务器共享空间，推送需要预装的应用tar包到服务器共享空间，将pre_install_app设置为1。 重置云手机，所有预装应用会自动安装。 预装应用的安装过程会占用一定的手机重置时间。
文件按需部署 业务场景示例 服务器上只有某些云手机需要部署文件，云手机正在运行状态，直接部署文件到云手机。 操作步骤 参考文件预置的1和2，将配置文件打成配置文件tar包并上传到OBS桶。 参考推送应用tar包至服务器共享空间，将配置文件tar包推送到目标云手机服务器。 推送时将"pac
appctrl uninstall 卸载应用 使用场景 云手机中不再使用某款共享应用时，从云手机中卸载该应用。 使用指导 在云手机中执行appctrl uninstall {包名} 例如：卸载应用：appctrl uninstall com.huawei.xxxx 父主题： appctrl命令
取消文件预置 业务场景示例 服务器上的所有云手机重置时均不再需要部署文件。 操作步骤 参考文件预置的1、2、3，将配置文件tar包推送到目标云手机服务器。 推送时将3中的"pre_install_app"参数设置为0。 重置云手机，该包中文件将不再部署。 父主题： 云手机部署文件
启动应用更新下载资源。 参考生成应用版本tar包并推至OBS桶，生成共享应用tar包并推送到OBS桶中。 参考推送应用tar包至服务器共享空间，推送需要预装的应用tar包到服务器共享空间，将pre_install_app设置为1。 重启或重置云手机，所有预装应用会自动更新。 预装应用的更新过程会占用一定的手机重启和重置时间。
已部署文件更新 业务场景示例 该服务器上云手机需要更新已部署过的文件。 如：/data/local/tmp/test.sh脚本有更新，云手机需要部署最新的脚本。 操作步骤 参考文件预置的1、2、3，将新配置文件打成tar包并推送到服务器共享空间。 更新文件。 方式一：重启云手机，自动更新文件。
appctrl clear 批量卸载应用 使用场景 批量卸载所有非预安装的共享应用。 使用指导 调用appctrl clear 例如：云手机中有2个非预安装共享应用，执行appctrl clear，可将2个非预安装应用批量卸载。 父主题： appctrl命令
云手机预装应用 预装应用安装 预装应用更新 预装应用卸载 父主题： 共享应用使用场景
如果应用存在资源更新，请启动应用并完成资源文件的下载和更新。 参考生成应用版本tar包并推至OBS桶和推送应用tar包至服务器共享空间生成并推送tar包到服务器共享空间。 执行appctrl命令进行更新（参考appctrl命令）。 执行appctrl start 命令，云手机会安装该应用共享空间中最新版本并启动。
云手机按需安装 应用安装 应用更新 应用卸载 应用批量卸载 父主题： 共享应用使用场景
云手机部署文件 除了共享应用的使用场景外，部分用户业务上需要在云手机中部署文件，部署前需要将这类文件打成tar包，下文中统称这种tar包为配置文件包。 文件预置 文件按需部署 已部署文件更新 取消文件预置 使用多个配置文件包部署文件 父主题： 共享应用使用场景
appctrl 命令的执行方法 可通过以下三种方式在云手机中执行appctrl命令： 通过ADB连接云手机执行命令，请参考一键式ADB连接 。 调用API接口在云手机中执行命令，请参考执行异步adb命令 。 云手机中的业务程序或脚本直接调用appctrl命令。 需确保业务程序或脚本具备root用户权限。
业务场景示例一 所有服务器需要预置公共文件，某些服务器需要预置特殊配置文件，处理不同业务。 例如：1.txt、2.txt为公共配置文件，需要预置到所有服务器的云手机中。同时需要预置特定配置文件a.txt，仅对服务器组A生效；特定配置文件b.txt，仅对服务器组B生效。 此时需将1
准备共享应用tar包 获取云手机列表 为单台云手机安装应用 生成应用版本tar包并推至OBS桶 父主题： 共享空间中的应用包管理
应用卸载 操作步骤 在云手机中执行appctrl命令，对已安装在云手机中的共享应用进行卸载（参考appctrl命令）。 使用指导：在云手机中执行appctrl uninstall {包名} 例如：卸载应用 appctrl uninstall com. huawei.xxxx appctrl
应用安装 业务场景示例 云游戏场景：用户接入后直接进入某款游戏。 个人云手机场景：用户接入后先看到云手机画面，按需选择安装共享空间中已有的应用。 操作步骤 在云手机中执行appctrl命令（参考appctrl命令）。 使用appctrl install命令安装应用 使用指导：appctrl
生成应用版本tar包并推至OBS桶 前提条件 需确保云手机已安装对应的应用。 确保已配置好OBS桶的授权策略，具体操作请参考委托CPH操作OBS桶章节。 接口示例 POST https://{CPH Endpoint}/v1/{project_id}/cloud-phone/phones/batch-storage
应用批量卸载 业务场景示例 客户分配的云手机时间到期，需要回收进入待分配区，并进行共享应用批量卸载，卸载上一个玩家安装的共享应用。 操作步骤 在云手机中执行appctrl命令，对使用appctrl命令安装的所有共享应用进行卸载（参考appctrl命令）。 使用指导：在云手机中执行appctrl
长按/截图保存，微信识别二维码
或者关注公众号“华为云”
