检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
检查参数“本地空闲端口”是否被占用了。 确保您获取的是“实例监听端口”而非“服务器监听端口”。 检查“SSH隧道用户名”使用的是项目ID，请参考如何获取项目ID？。 创建新的密钥对，并在“服务器管理”界面更新云手机所在服务器的密钥对，等待1-2分钟至其生效，然后使用新的私钥文件路径再次执行命令。
配置共享空间 在购买服务器实例页面，选定区域、服务器类型、实例规格后，配置共享空间大小。 建议在实际业务共享应用所需空间大小的基础上，上浮30%来配置共享空间的大小，以满足后续应用更新对共享空间的需求。 图1 配置共享空间 父主题： 共享空间中的应用包管理
操作步骤 参考获取云手机列表、为单台云手机安装应用在单台手机上安装应用最新的版本。 如果应用存在资源更新，请启动应用并完成资源文件的下载和更新。 参考生成应用版本tar包并推至OBS桶和推送应用tar包至服务器共享空间生成并推送tar包到服务器共享空间。 执行appctrl命令进行更新（参考appctrl命令）。
预装应用安装 业务场景示例 服务器上所有云手机都要安装某些应用，并且云手机重置后默认安装这些应用。 操作步骤 参考推送应用tar包至服务器共享空间，推送需要预装的应用tar包到服务器共享空间，将pre_install_app设置为1。 重置云手机，所有预装应用会自动安装。 预装应用的安装过程会占用一定的手机重置时间。
云手机内管理程序保活方案 管理程序形态分类 在云手机内的管理程序，基本分为两类： Android APK Service 形态，即以Android无UI的Service的形式在云手机后台运行。 Android JNI Native 形态，即用Android JNI开发的Executable的二进制可执行程序。
共享应用使用场景 共享应用tar包推送到共享空间后，可通过共享应用命令实现共享应用的快速安装、更新、卸载。 云手机按需安装 云手机预装应用 云手机部署文件 父主题： 云手机共享应用管理最佳实践
appctrl uninstall 卸载应用 使用场景 云手机中不再使用某款共享应用时，从云手机中卸载该应用。 使用指导 在云手机中执行appctrl uninstall {包名} 例如：卸载应用：appctrl uninstall com.huawei.xxxx 父主题： appctrl命令
appctrl start 安装并启动应用 使用场景 安装应用到云手机，并启动应用。 前置条件 应用的tar包已经推送到云手机服务器。 使用指导 appctrl start {包名} 例如：安装并启动应用：appctrl start com.huawei.xxxx 对于服务类应用
取消文件预置 业务场景示例 服务器上的所有云手机重置时均不再需要部署文件。 操作步骤 参考文件预置的1、2、3，将配置文件tar包推送到目标云手机服务器。 推送时将3中的"pre_install_app"参数设置为0。 重置云手机，该包中文件将不再部署。 父主题： 云手机部署文件
} 其中， CPH Endpoint、project_id、${token}、bucket_name、object_path等参数可以参考为单台云手机安装应用章节的说明获取。 phone_id为安装了对应应用的云手机ID。 include_files中的三个元素需要填写手机中的绝对路径。
准备共享应用tar包 获取云手机列表 为单台云手机安装应用 生成应用版本tar包并推至OBS桶 父主题： 共享空间中的应用包管理
云手机预装应用 预装应用安装 预装应用更新 预装应用卸载 父主题： 共享应用使用场景
已部署文件更新 业务场景示例 该服务器上云手机需要更新已部署过的文件。 如：/data/local/tmp/test.sh脚本有更新，云手机需要部署最新的脚本。 操作步骤 参考文件预置的1、2、3，将新配置文件打成tar包并推送到服务器共享空间。 更新文件。 方式一：重启云手机，自动更新文件。
appctrl clear 批量卸载应用 使用场景 批量卸载所有非预安装的共享应用。 使用指导 调用appctrl clear 例如：云手机中有2个非预安装共享应用，执行appctrl clear，可将2个非预安装应用批量卸载。 父主题： appctrl命令
应用卸载 操作步骤 在云手机中执行appctrl命令，对已安装在云手机中的共享应用进行卸载（参考appctrl命令）。 使用指导：在云手机中执行appctrl uninstall {包名} 例如：卸载应用 appctrl uninstall com. huawei.xxxx appctrl
云手机按需安装 应用安装 应用更新 应用卸载 应用批量卸载 父主题： 共享应用使用场景
云手机部署文件 除了共享应用的使用场景外，部分用户业务上需要在云手机中部署文件，部署前需要将这类文件打成tar包，下文中统称这种tar包为配置文件包。 文件预置 文件按需部署 已部署文件更新 取消文件预置 使用多个配置文件包部署文件 父主题： 共享应用使用场景
appctrl 命令的执行方法 可通过以下三种方式在云手机中执行appctrl命令： 通过ADB连接云手机执行命令，请参考一键式ADB连接 。 调用API接口在云手机中执行命令，请参考执行异步adb命令 。 云手机中的业务程序或脚本直接调用appctrl命令。 需确保业务程序或脚本具备root用户权限。
业务场景示例一 所有服务器需要预置公共文件，某些服务器需要预置特殊配置文件，处理不同业务。 例如：1.txt、2.txt为公共配置文件，需要预置到所有服务器的云手机中。同时需要预置特定配置文件a.txt，仅对服务器组A生效；特定配置文件b.txt，仅对服务器组B生效。 此时需将1
应用批量卸载 业务场景示例 客户分配的云手机时间到期，需要回收进入待分配区，并进行共享应用批量卸载，卸载上一个玩家安装的共享应用。 操作步骤 在云手机中执行appctrl命令，对使用appctrl命令安装的所有共享应用进行卸载（参考appctrl命令）。 使用指导：在云手机中执行appctrl
长按/截图保存，微信识别二维码
或者关注公众号“华为云”
