Repository navigation
v0.2.7
English
Upgrade notes
- Phones on iOS 27 and later switch to native control. To keep WebDriverAgent, set
ICTL_IOS_BACKEND=wdain~/.config/iphone-control/env(#123). - Building from source needs Rust 1.89 (#119).
ICTL_WDA_DETACHEDis gone: WDA is always launched in the background now. Left in the settings file, it does nothing (#125).
New
- iOS 27 and later work without WebDriverAgent: no Apple ID, no signing, ready in seconds. iOS 26 and earlier are unchanged (#123).
- Chinese and other non-ASCII text can be typed while WebDriverAgent is down. Tap "Allow Paste" when the phone asks (#118).
- Actions with
thensay whether the screen changed, so an agent can tell when a tap did nothing (#121).
Improvements
- WDA starts on a locked phone too, and keeps running across daemon restarts and updates (#125).
- Dependencies updated (#119).
Fixes
- Ctrl+C in setup menus is no longer ignored after a half-typed key on a busy machine (#131).
iphone-control statuson a phone under native control shows "native" instead of asking you to install WDA (#127).service stopandservice uninstallalso end a WDA launched in the background, and each phone keeps its own (#124).- Text pasted on the phone no longer reaches your Mac through Universal Clipboard (#122).
- With a notification banner up, elements are read from the app instead of the banner (#121).
- Arrow keys in setup menus no longer turn into letters on a busy machine (#120).
- A tap or key that WDA didn't answer in time no longer lands on the screen later (#118).
- Screens with very many elements read faster, and the result says when the list was cut short (#118).
- The first tap after a pause no longer waits for the screen size to be measured (#110).
- The control page retries H.264 or the phone's video after a slow start instead of staying on MJPEG (#109).
- Swipes on the control page return sooner (#108).
- The first Home after a daemon restart is no longer slow on some devices (#107).
中文
升级注意事项
- iOS 27 及以上的手机改用原生控制。想继续用 WebDriverAgent,在
~/.config/iphone-control/env里设ICTL_IOS_BACKEND=wda(#123)。 - 从源码编译需要 Rust 1.89(#119)。
- 去掉了
ICTL_WDA_DETACHED:WDA 现在总在后台启动,设置文件里留着这一项也不起作用(#125)。
新功能
- iOS 27 及以上不再需要 WebDriverAgent:不用 Apple ID、不用签名,几秒就绪。iOS 26 及以下不变(#123)。
- WebDriverAgent 不可用时也能输入中文等非 ASCII 文字,手机询问时点「允许粘贴」(#118)。
- 带
then的操作会说明界面变没变,Agent 能看出点击没生效(#121)。
改进
修复
- 机器很忙时,引导菜单里在半个按键之后按的 Ctrl+C 不再被忽略(#131)。
- 原生控制的手机上,
iphone-control status显示「原生」,不再提示去装 WDA(#127)。 service stop、service uninstall也会结束后台启动的 WDA,每台手机各用各的(#124)。- 粘贴到手机上的文字不再经「通用剪贴板」传到 Mac(#122)。
- 弹着通知横幅时,读到的是 App 的元素,不再是横幅的(#121)。
- 机器很忙时,引导菜单里的方向键不再变成字母(#120)。
- WDA 没及时应答的点击、按键,不会过一阵又落到屏幕上(#118)。
- 元素特别多的界面读得更快,列表被截短时会说明(#118)。
- 停一会儿后的第一次点按不再等重新读屏幕尺寸(#110)。
- 控制台的 H.264 或手机视频启动慢时会再试,不再一直停在 MJPEG(#109)。
- 控制台上的滑动返回更快(#108)。
- 守护进程重启后,部分设备第一次按 Home 不再慢(#107)。
Binaries / 二进制: macOS macos-arm64 (11+, Apple Silicon) · Linux linux-x86_64, linux-aarch64 (glibc 2.34+) · .deb amd64, arm64 (Debian 12+, Ubuntu 22.04+)
- Script / 脚本:
curl -fsSL https://github.com/Derrors/iphone-control/releases/download/v0.2.7/install.sh | sh - Homebrew:
brew install Derrors/tap/iphone-control - Debian / Ubuntu:
sudo apt install ./iphone-control_0.2.7_amd64.deb(or / 或_arm64.deb)
Already installed? Run iphone-control update. / 已安装的运行 iphone-control update 升级。