运行多部手机
给手机命名,用 Python、Node.js、C# 或 shell 并行运行它们,更换移动 IP 地址,并让一整架手机连续多天保持连接。
本页为译文。如与英文版不一致,以英文版为准。 English
一个 droidline serve 能驱动的手机数量,只受你的电脑和网络承载能力的限制。每部手机都有自己的命令队列:发给同一部手机的命令按顺序执行,不同手机之间同时执行。
给每部手机起名字
每部手机都有一个随机 ID,例如 k7d2q9xa。在配对时给它起一个好记的名字,或者之后再重命名:
droidline pair 482913 --name shelf-01
droidline rename k7d2q9xa shelf-02
droidline devices
名称可以使用字母、数字、点、连字符和下划线。在手机上贴一张写着同样名字的标签,能省去很多猜测。
并行运行
向服务器询问哪些手机在线,然后为每部手机分配各自的线程、任务或后台作业:
from concurrent.futures import ThreadPoolExecutor
from droidline import Droidline
dl = Droidline()
def morning(name: str) -> str:
d = dl.device(name)
d.wake()
d.launch("com.example.app")
d.touch("text", "Check in", timeout=20)
return d.get_text("id", "status")
names = [p["name"] for p in dl.devices() if p["online"]]
with ThreadPoolExecutor(len(names) or 1) as pool:
for name, status in zip(names, pool.map(morning, names)):
print(name, status)import { Droidline } from "droidline";
const dl = new Droidline();
const phones = (await dl.devices()).filter((p) => p.online);
const results = await Promise.allSettled(phones.map(async (p) => {
const d = dl.device(p.name);
await d.wake();
await d.launch("com.example.app");
await d.touch("text", "Check in", { timeout: 20 });
return d.getText("id", "status");
}));
results.forEach((r, i) => console.log(phones[i].name, r.status === "fulfilled" ? r.value : r.reason.message));using Droidline;
using var client = new DroidlineClient();
var phones = (await client.DevicesAsync()).Where(p => p.Get<bool>("online")).ToList();
var results = await Task.WhenAll(phones.Select(async p =>
{
try
{
var d = client.Device(p.Get<string>("name"));
await d.WakeAsync();
await d.LaunchAsync("com.example.app");
await d.TouchAsync("text", "Check in", timeout: 20);
return await d.GetTextAsync("id", "status");
}
catch (DroidlineException e)
{
return e.Message;
}
}));
for (var i = 0; i < phones.Count; i++)
Console.WriteLine($"{phones[i].Get<string>("name")} {results[i]}");for name in $(droidline --json devices | jq -r '.value[] | select(.online) | .name'); do
(
droidline -d "$name" wake
droidline -d "$name" launch com.example.app
droidline -d "$name" touch text "Check in" --timeout 20
echo "$name: $(droidline -d "$name" get_text id status)"
) &
done
wait一部手机失败不会让其他手机停下:在 Python 中,异常会在你取到那部手机的结果时从 pool.map 中抛出;在 Node.js 中,allSettled 会记录它;在 C# 中,每个任务里的 catch 会返回它的错误信息;在 shell 中,每部手机都在各自的子 shell 中运行。
在脚本之间共享手机
这是可选功能。多个脚本或多个人使用同一架手机时,两个脚本可能选中同一部手机:它们的命令交错执行,两边都在意想不到的界面上失败。lease 可以避免这种情况。脚本借用一部空闲手机,用完再归还。持有 lease 期间,没有携带该 lease 的请求会以 DEVICE_LEASED 失败。没人租用的手机照常工作。
from droidline import lease
with lease(wait=60) as d: # 任意空闲手机,最多等待 60 秒
d.launch("com.example.shop")
# 在这里归还,即使代码块抛出异常
with lease("shelf-03") as d: ... # 指定这部手机
with lease(min_sdk=33, model="Pixel") as d: ...import { lease } from "droidline";
const d = await lease({ wait: 60 });
try {
await d.launch("com.example.shop");
} finally {
await d.release();
d.close();
}using Droidline;
await using (var d = await DroidlineClient.LeaseAsync(wait: 60)) // 任意空闲手机,最多等待 60 秒
{
await d.LaunchAsync("com.example.shop");
}
// 在这里归还,即使代码块抛出异常
await using var shelf = await DroidlineClient.LeaseAsync("shelf-03"); // 指定这部手机
await using var pixel = await DroidlineClient.LeaseAsync(minSdk: 33, model: "Pixel");droidline lease --wait 60
# {"device":"a1b2c3d4","lease":"l-3f9a1c0d2e4b","name":"shelf-03","ttl":300}
droidline --lease l-3f9a1c0d2e4b touch text "登录"
droidline release l-3f9a1c0d2e4b- 在
wait(默认 30 秒)内没有符合条件的空闲手机时:NO_FREE_DEVICE。 - 调用
release,或ttl秒(默认 300 秒)内没有命令时,lease 结束。耗时较长的命令在运行期间会保持 lease。 droidline devices把被租用的手机显示为online,leased。- 持有手机的脚本崩溃了:用
droidline release -d shelf-03立即释放。 - Appium 桥接通过 capability
droidline:lease租用,pytest 插件通过--droidline-lease租用。
让每部手机使用各自的网络
借助按应用代理,每部手机可以让某个应用通过不同的上游联网。先保存一次上游,然后按名称分配:
droidline proxy add kr1 socks5://user:pass@203.0.113.10:1080
droidline proxy add kr2 socks5://user:pass@203.0.113.11:1080
plan = {"shelf-01": "@kr1", "shelf-02": "@kr2"}
for name, upstream in plan.items():
dl.device(name).proxy(upstream, app="com.android.chrome")const plan = { "shelf-01": "@kr1", "shelf-02": "@kr2" };
for (const [name, upstream] of Object.entries(plan)) {
await dl.device(name).proxy(upstream, { app: "com.android.chrome" });
}var plan = new Dictionary<string, string> { ["shelf-01"] = "@kr1", ["shelf-02"] = "@kr2" };
foreach (var (name, upstream) in plan)
await client.Device(name).ProxyAsync(upstream, app: "com.android.chrome");droidline -d shelf-01 proxy @kr1 --app com.android.chrome
droidline -d shelf-02 proxy @kr2 --app com.android.chrome新的移动 IP 地址
使用移动数据时,开关一次飞行模式通常能从运营商处获得新地址。先用 intent 打开飞行模式页面,再把开和关两个操作放进同一个带 cuts_network 的 batch 发送。手机离线期间无法接收命令,所以由手机自行完成:
d.intent("android.settings.AIRPLANE_MODE_SETTINGS")
d.wait_idle()
switch = {"class": "android.widget.Switch", "visible": True} # 页面上的第一个开关
d.batch([("touch", switch), ("sleep", 3000), ("touch", switch)], cuts_network=True, wait=True)await d.intent("android.settings.AIRPLANE_MODE_SETTINGS");
await d.waitIdle();
const sw = { class: "android.widget.Switch", visible: true }; // 页面上的第一个开关
await d.batch([["touch", sw], ["sleep", 3000], ["touch", sw]], { cuts_network: true, wait: true });await d.IntentAsync("android.settings.AIRPLANE_MODE_SETTINGS");
await d.WaitIdleAsync();
var sw = new { @class = "android.widget.Switch", visible = true }; // 页面上的第一个开关
await d.BatchAsync(new object[] { ("touch", sw), ("sleep", 3000), ("touch", sw) }, cutsNetwork: true, wait: true);droidline -d shelf-01 intent android.settings.AIRPLANE_MODE_SETTINGS
droidline -d shelf-01 wait_idle
SWITCH='["touch",{"class":"android.widget.Switch","visible":true}]'
droidline -d shelf-01 batch "[$SWITCH,[\"sleep\",3000],$SWITCH]" --cuts_network --wait不传 wait 时,调用会立即返回 {"accepted": true},结果稍后作为 result 事件到达。设置页面因手机而异,请先确认你手机上的开关;详细说明和其他网络开关见常用示例。
屏幕熄灭时
手机屏幕熄灭时,点击和滑动会失败。每项任务开始前调用 wake();它会点亮屏幕,并解除没有 PIN 的锁屏。对于无人值守的手机,请在手机设置中移除 PIN、图案或密码锁,因为 Droidline 无法解锁它们。
连续多天保持连接
- 把 Droidline 的电池优化设为不受限制,并在手机品牌额外添加的后台限制中允许它(故障排查列出了常见的位置)。
- 配对之后,手机开机时应用会自动启动。
- 重新连接后,手机会重发电脑漏收的回复,重复的命令不会执行两次。参见概念。
droidline devices显示每部手机的线路和缺少的权限。devices()中的last_seen告诉你离线手机最后一次连接的时间。- 让手机一直充电。USB 充电器就够了,不需要数据连接。
监控整架手机
订阅 device 事件,就能在手机掉线或重新上线的那一刻得知:
from droidline import Droidline
dl = Droidline()
dl.subscribe(["device"])
dl.on("device", lambda e: print(e["name"], e["state"], e.get("route")))
input("Watching. Press Enter to stop.\n")import { Droidline } from "droidline";
import { createInterface } from "node:readline/promises";
const dl = new Droidline();
await dl.subscribe(["device"]);
dl.on("device", (e) => console.log(e.name, e.state, e.route ?? ""));
const rl = createInterface({ input: process.stdin, output: process.stdout });
await rl.question("Watching. Press Enter to stop.\n");
rl.close();
dl.close();using Droidline;
await using var client = new DroidlineClient();
await client.SubscribeAsync(new[] { "device" });
using var watch = client.On("device", e =>
Console.WriteLine($"{e.Get<string>("name")} {e.Get<string>("state")} {e.Get<string>("route")}"));
Console.WriteLine("Watching. Press Enter to stop.");
Console.ReadLine();droidline --json devices | jq -r '.value[] | "\(.name)\t\(if .online then "online" else "offline" end)\t\(.route)"'更新
应用每天检查一次 GitHub Releases,有新版本时显示一条通知。把更新直接安装在旧版应用上,配对会保留。