开发者镜像接口

说明

本页为 自动化接口 / 开发者镜像 模块，对应脚本工具函数 · 开发者镜像（utils.mountDevImage / unmountDevImage / checkDevImage）。

手机重启后开发者镜像通常会失效，需重新加载。USB HID sessionStart 可能为启用 HID 重挂较新镜像，导致随后自动化启动失败时，可先卸载再加载镜像。详见 USB HID · sessionStart。

加载开发者镜像

POST /openapi/mountDevImage

对应 utils.mountDevImage()。加载（挂载/刷入）开发者镜像。

请求 Body

1
{
2
  "deviceId": "6a290cdc0b6db0565955355b157acc090e33f76e"
3
}

请求示例

1
import requests
2

3
body = {"deviceId": "6a290cdc0b6db0565955355b157acc090e33f76e"}
4
r = requests.post("http://127.0.0.1:8019/openapi/mountDevImage", json=body, timeout=180)
5
print(r.json())

1
const body = { deviceId: "6a290cdc0b6db0565955355b157acc090e33f76e" };
2
const res = await fetch("http://127.0.0.1:8019/openapi/mountDevImage", {
3
  method: "POST",
4
  headers: { "Content-Type": "application/json" },
5
  body: JSON.stringify(body),
6
});
7
console.log(await res.json());

1
curl -s -X POST "http://127.0.0.1:8019/openapi/mountDevImage" \
2
  -H "Content-Type: application/json" \
3
  -d '{"deviceId":"6a290cdc0b6db0565955355b157acc090e33f76e"}'

1
using System.Text;
2
using var http = new HttpClient { Timeout = TimeSpan.FromSeconds(180) };
3
var json = "{\"deviceId\":\"6a290cdc0b6db0565955355b157acc090e33f76e\"}";
4
using var content = new StringContent(json, Encoding.UTF8, "application/json");
5
using var res = await http.PostAsync("http://127.0.0.1:8019/openapi/mountDevImage", content);
6
Console.WriteLine(await res.Content.ReadAsStringAsync());

请求参数

名称	位置	类型	必选	说明
deviceId	body	string	是	设备 ID

返回结果

1
{
2
  "code": 0,
3
  "msg": "",
4
  "data": true
5
}

字段	类型	说明
code	number	`0` 成功
data	boolean	是否加载成功

卸载开发者镜像

POST /openapi/unmountDevImage

对应 utils.unmountDevImage()。卸载后依赖镜像的自动化能力不可用，需重新挂载。

请求 Body

1
{
2
  "deviceId": "6a290cdc0b6db0565955355b157acc090e33f76e"
3
}

请求示例

1
import requests
2

3
body = {"deviceId": "6a290cdc0b6db0565955355b157acc090e33f76e"}
4
r = requests.post("http://127.0.0.1:8019/openapi/unmountDevImage", json=body, timeout=180)
5
print(r.json())

1
const body = { deviceId: "6a290cdc0b6db0565955355b157acc090e33f76e" };
2
const res = await fetch("http://127.0.0.1:8019/openapi/unmountDevImage", {
3
  method: "POST",
4
  headers: { "Content-Type": "application/json" },
5
  body: JSON.stringify(body),
6
});
7
console.log(await res.json());

1
curl -s -X POST "http://127.0.0.1:8019/openapi/unmountDevImage" \
2
  -H "Content-Type: application/json" \
3
  -d '{"deviceId":"6a290cdc0b6db0565955355b157acc090e33f76e"}'

1
using System.Text;
2
using var http = new HttpClient { Timeout = TimeSpan.FromSeconds(180) };
3
var json = "{\"deviceId\":\"6a290cdc0b6db0565955355b157acc090e33f76e\"}";
4
using var content = new StringContent(json, Encoding.UTF8, "application/json");
5
using var res = await http.PostAsync("http://127.0.0.1:8019/openapi/unmountDevImage", content);
6
Console.WriteLine(await res.Content.ReadAsStringAsync());

请求参数

名称	位置	类型	必选	说明
deviceId	body	string	是	设备 ID

返回结果

1
{
2
  "code": 0,
3
  "msg": "",
4
  "data": true
5
}

字段	类型	说明
code	number	`0` 成功
data	boolean	是否卸载成功

查看镜像挂载状态

POST /openapi/checkDevImage

对应 utils.checkDevImage()。仅查询是否已挂载及镜像路径，不会自动刷入。

请求 Body

1
{
2
  "deviceId": "6a290cdc0b6db0565955355b157acc090e33f76e"
3
}

请求示例

1
import requests
2

3
body = {"deviceId": "6a290cdc0b6db0565955355b157acc090e33f76e"}
4
r = requests.post("http://127.0.0.1:8019/openapi/checkDevImage", json=body, timeout=60)
5
print(r.json())

1
const body = { deviceId: "6a290cdc0b6db0565955355b157acc090e33f76e" };
2
const res = await fetch("http://127.0.0.1:8019/openapi/checkDevImage", {
3
  method: "POST",
4
  headers: { "Content-Type": "application/json" },
5
  body: JSON.stringify(body),
6
});
7
console.log(await res.json());

1
curl -s -X POST "http://127.0.0.1:8019/openapi/checkDevImage" \
2
  -H "Content-Type: application/json" \
3
  -d '{"deviceId":"6a290cdc0b6db0565955355b157acc090e33f76e"}'

1
using System.Text;
2
using var http = new HttpClient { Timeout = TimeSpan.FromSeconds(60) };
3
var json = "{\"deviceId\":\"6a290cdc0b6db0565955355b157acc090e33f76e\"}";
4
using var content = new StringContent(json, Encoding.UTF8, "application/json");
5
using var res = await http.PostAsync("http://127.0.0.1:8019/openapi/checkDevImage", content);
6
Console.WriteLine(await res.Content.ReadAsStringAsync());

请求参数

名称	位置	类型	必选	说明
deviceId	body	string	是	设备 ID

返回结果

1
{
2
  "code": 0,
3
  "msg": "",
4
  "data": {
5
    "mounted": true,
6
    "result": true,
7
    "path": "/path/to/DeveloperDiskImage.dmg"
8
  }
9
}

字段	类型	说明
code	number	`0` 成功（查询本身成功；是否已挂载看 `data.mounted`）
data.mounted	boolean	是否已挂载
data.result	boolean	与 `mounted` 相同
data.path	string	已挂载时的镜像路径；未挂载为空字符串