安裝apkInstallApk

 

功能介紹

云手機(jī) 中安裝apk。系統(tǒng)會(huì)將指定的apk文件下載后直接安裝到云手機(jī)中。 支持安裝單apk應(yīng)用和多apk應(yīng)用??墒褂胕nstall命令安裝單apk應(yīng)用,一次只支持安裝一個(gè)apk;可使用install-multiple命令安裝多apk應(yīng)用(多apk應(yīng)用為單個(gè)應(yīng)用拆分成多個(gè)apk),一次只支持同一個(gè)應(yīng)用的多個(gè)apk。該接口為異步接口。接口調(diào)用前請(qǐng)先確保已完成CPH服務(wù)操作OBS桶的委托授權(quán)。委托CPH操作OBS桶請(qǐng)參見(jiàn)委托CPH操作OBS桶

  • 管理面性能有限,對(duì)相同服務(wù)器批量執(zhí)行的ADB命令,將會(huì)阻塞云手機(jī)其他任務(wù)執(zhí)行。
  • 建議通過(guò)開(kāi)發(fā)應(yīng)用市場(chǎng)的方式安裝apk。允許安裝的apk大小限制為2G(即不可將obs桶內(nèi)大于2G的apk安裝到手機(jī)中),超過(guò)限制將返回錯(cuò)誤。

調(diào)試

您可以在API Explorer中調(diào)試該接口,支持自動(dòng)認(rèn)證鑒權(quán)。API Explorer可以自動(dòng)生成SDK代碼示例,并提供SDK代碼示例調(diào)試功能。

URI

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

表1 路徑參數(shù)

參數(shù)

是否必選

參數(shù)類型

描述

project_id

String

項(xiàng)目id。

請(qǐng)求參數(shù)

表2 請(qǐng)求Header參數(shù)

參數(shù)

是否必選

參數(shù)類型

描述

X-Auth-Token

String

用戶Token。 通過(guò)調(diào)用 IAM 服務(wù)獲取用戶Token接口獲取(響應(yīng)消息頭中X-Subject-Token的值)。

表3 請(qǐng)求Body參數(shù)

參數(shù)

是否必選

參數(shù)類型

描述

command

String

安裝單apk場(chǎng)景填寫(xiě)install,多apk場(chǎng)景填寫(xiě)install-multiple。

content

String

指定OBS桶中的apk文件(需要提前上傳到指定桶中)。 只支持大小寫(xiě)字母、數(shù)字、下劃線(_)、點(diǎn)(.)、斜線(/)、冒號(hào)(:)、中劃線(-)。推送的文件只支持apk文件類型。

單apk場(chǎng)景,只能傳一個(gè)apk,最大長(zhǎng)度為1024字節(jié);多apk場(chǎng)景,最多傳50個(gè)apk,中間用空格分開(kāi),最大長(zhǎng)度8100字節(jié)。

phone_ids

Array of strings

云手機(jī)ID列表。 server_ids參數(shù)不存在時(shí)必選,同時(shí)存在只處理phone_ids。

server_ids

Array of strings

云手機(jī)服務(wù)器ID列表。 phone_ids參數(shù)不存在時(shí)必選,同時(shí)存在只處理phone_ids。

響應(yīng)參數(shù)

狀態(tài)碼: 200

表4 響應(yīng)Body參數(shù)

參數(shù)

參數(shù)類型

描述

request_id

String

請(qǐng)求的唯一標(biāo)識(shí)ID。

jobs

Array of PhoneJob objects

任務(wù)列表。

表5 PhoneJob

參數(shù)

參數(shù)類型

描述

phone_id

String

云手機(jī)的唯一標(biāo)識(shí)ID,云手機(jī)相關(guān)任務(wù)包含此字段。

job_id

String

任務(wù)的唯一標(biāo)識(shí)。

error_code

String

錯(cuò)誤碼。

error_msg

String

錯(cuò)誤說(shuō)明。

請(qǐng)求示例

  • 在云手機(jī)中安裝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" ]
    }
  • 在云手機(jī)中安裝多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" ] }

響應(yīng)示例

狀態(tài)碼: 200

OK

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

狀態(tài)碼

狀態(tài)碼

描述

200

OK

錯(cuò)誤碼

請(qǐng)參見(jiàn)錯(cuò)誤碼