更新时间:2022-03-31 GMT+08:00
分享

安装apk

功能介绍

  • 接口名称

    InstallApk

  • 功能描述

    在云手机中安装apk。系统会将指定的apk文件下载后直接安装到云手机中。

    支持安装单apk应用和多apk应用。可使用install命令安装单apk应用,一次只支持安装一个apk;可使用install-multiple命令安装多apk应用(多apk应用为单个应用拆分成多个apk),一次只支持同一个应用的多个apk。

    该接口为异步接口,可调用查询任务执行状态查询任务执行状态列表查询任务执行结果。

  • 注意事项

    已给云手机服务系统账号授权OBS桶的只读权限,详情请参考用户指南中的“批量控制”。

    管理面性能有限,对相同服务器批量执行的ADB命令,将会阻塞云手机其他任务执行。建议通过开发应用市场的方式安装apk。允许安装的apk大小限制为2G(即不可将obs桶内大于2G的apk安装到手机中),超过限制将返回错误。

URI

POST /v1/{project_id}/cloud-phone/phones/commands

参数说明请参见表1
表1 参数说明

参数

是否必选

参数类型

描述

project_id

String

项目ID

获取方式请参见获取项目ID

请求消息

  • 请求参数

    参数

    是否必选

    参数类型

    描述

    command

    String

    ADB命令,安装单apk场景填写install,多apk场景填写install-multiple。

    content

    String

    指定OBS桶中的apk文件(需要提前上传到指定桶中)

    ,只支持大小写字母、数字、下划线(_)、点(.)、斜线(/)、冒号(:)、中划线(-)。推送的文件只支持apk文件类型。文件格式:obs://obs-bucket-name/obs-file-path/file.apk;单apk场景,只能传一个apk,最大长度为1024字节;多apk场景,最多传10个apk,中间用空格分开,最大长度8100字节。

    server_ids

    phone_ids参数不存在时必选

    Array of strings

    云手机服务器ID列表

    可通过查询云手机服务器列表获取。

    phone_ids

    server_ids参数不存在时必选

    Array of strings

    云手机ID列表

    可通过查询云手机列表获取。

  • 单apk场景请求样例
    POST https://{CPH Endpoint}/v1/{project_id}/cloud-phone/phones/commands
    {
        "command": "install",
        "content": "-t -r obs://push-bucket/my_apps/test.apk",
        "phone_ids": [
            "1234567b8bab40ffb711234cb80d0234",
            "1678567b8bab40f93711234cb80d0764"
        ]
    }
  • 多apk场景请求样例
    POST https://{CPH Endpoint}/v1/{project_id}/cloud-phone/phones/commands
    {
        "command": "install-multiple",
        "content": "-t -r obs://push-bucket/my_apps/test_part1.apk obs://push-bucket/my_apps/test_part_2.apk obs://push-bucket/my_apps/test_part3.apk",
        "phone_ids": [
            "1234567b8bab40ffb711234cb80d0234",
            "1678567b8bab40f93711234cb80d0764"
        ]
    }

响应消息

  • 响应参数

    参数

    参数类型

    描述

    request_id

    String

    请求的唯一标识ID

    jobs

    Array of objects

    任务信息,详情请参见表2

    表2 job数据结构说明

    参数

    参数类型

    描述

    phone_id

    String

    云手机的唯一标识,云手机相关任务包含此字段。

    job_id

    String

    任务的唯一标识

  • 响应样例
    {
        "request_id": "6837531fd3f54550927b930180a706bf",
        "jobs": [
            {
                "phone_id": "1234567b8bab40ffb711234cb80d0234",
                "job_id": "1564567b8bab40f34711234cb80d0123"
            },
            {
                "phone_id": "1678567b8bab40f93711234cb80d0764",
                "job_id": "1564567b8bab40f34711234cb80d5678"
            }
        ]
    }

返回值

请参考返回值

错误码

请参考错误码

分享:

    相关文档

    相关产品

关闭导读