Skip to content

Android Use v0.7.0 — Your environment. Your installation choice

Choose a tag to compare

View all tags
@github-actions github-actions released this 06 Nov 09:03
· 8 commits to main since this release
v0.7.0
a913639
This commit was created on GitHub.com and signed with GitHub’s verified signature.
GPG key ID: B5690EEEBB952194
Verified
Learn about vigilant mode.

Android Use v0.7.0

Your environment. Your installation choice.

Android Use now offers optional native packages for macOS, Linux and Windows alongside the existing source plugin. Your Agent inspects the host, reuses a healthy installation and chooses the appropriate route. A standalone runtime is not required. All 26 MCP tools, keyless host decisions, optional Jev and live-screen integration remain available.

English README · 中文 README · Native installation and rollback · Source upgrades

What's new

  • Optional standalone runtime: includes CPython, locked Python libraries, ADB, minimal FFmpeg, the compiled UI and UiAutomator control JAR. No separate Python/uv, Node.js or JDK setup is needed on this route. Reuse an existing source environment when it already works.
  • Opt-in lightweight Dim plugins: select the matching platform ZIP for first-use installation. Use Android Use in Dim Agent, describe a phone task, and follow the live phone view beside the chat. The README now shows an actual Dim Agent screenshot.
  • Verified updates and rollback: check downloads and archive paths, probe bundled tools and a real MCP session, then promote one atomic pointer. Existing sessions keep running; the next MCP connection uses the new version. Failed updates retain the active version. Rollback rechecks the previous version and pauses automatic updates.
  • Optional macOS OCR: omitted from the default native package. Install the separate precompiled component only when local text recognition is needed; no Swift compiler is needed by its users. Tree interaction, Agent screenshot inspection and Jev do not depend on this helper.
  • Optional interaction variation: bounded timing and selector-point variation with reproducible seeds and existing execution guards. Disabled by default; it does not hide automation or guarantee avoidance of app detection.
  • Cross-platform fixes: Windows preview resources use UTF-8, original license bytes survive CRLF-configured Git checkouts, and the Windows bootstrap hashes/extracts through .NET without depending on optional PowerShell functions.
  • Distribution notices: the project's MIT copyright is attributed to Archship. Dependency licenses remain separate. Archives include CPython/package notices, certifi source form, corresponding FFmpeg source/build options and native inventories; known optional DBM/readline risks are blocked at build time. Thanks to iPhone Use for the inspiration.

Pick a download

Asset Use it for
android-use-0.7.0-plugin.zip Existing source/Codex installation, or any local stdio MCP client using Python/uv. Requires host ADB and ffmpeg for live video.
android-use-0.7.0-PLATFORM-dim-plugin.zip Opt-in native bootstrap plugin for Dim Agent. Choose your platform below.
android-use-runtime-PLATFORM.zip Manual/offline native installation, or a stable local MCP command for other clients.
android-use-ocr-macos-arm64.zip, android-use-ocr-macos-x86_64.zip Optional macOS local OCR components.
SHA256SUMS Checksums for every installation ZIP.

PLATFORM is macos-arm64 (Apple Silicon), macos-x86_64 (Intel Mac), linux-x86_64, or windows-x86_64. Native Linux packages are built on Ubuntu 22.04. These are desktop packages, not Android APKs.

Download the selected ZIP and SHA256SUMS from this release. Compare its SHA256 with the matching line before extracting or running it. The repository may require GitHub authentication; use the browser while signed in or, for example:

gh release download v0.7.0 --repo arcships/android-use \
  --pattern android-use-runtime-macos-arm64.zip --pattern SHA256SUMS
# macOS, verifying only the ZIP downloaded above:
awk '$2=="android-use-runtime-macos-arm64.zip"' SHA256SUMS | shasum -a 256 -c -
# Linux: replace shasum -a 256 with sha256sum.

On Windows, certutil -hashfile FILE.zip SHA256 can display the value to compare with SHA256SUMS.

Install in Dim Agent

Ask your Agent:

Install Android Use from https://github.com/arcships/android-use. Inspect my existing environment and choose source setup or the optional native package. Reuse healthy installations, preserve my settings and other MCP servers, verify the release checksum, register the returned local stdio command, then check READY and open the live phone view. I will handle USB authorization and unlocking. Leave Jev disabled until I configure it.

If choosing the lightweight native plugin, extract the matching android-use-0.7.0-PLATFORM-dim-plugin.zip, then install that directory through Dim's plugin management or:

dim plugin install /absolute/path/to/extracted-dim-plugin

First-use bootstrap needs network access and OS download/unzip utilities. A private release additionally needs GitHub CLI plus ANDROID_USE_GITHUB_TOKEN with asset read access; alternatively install the native archive offline first. Never put tokens in a chat or committed configuration. After native installation, updates use the bundled HTTP client rather than GitHub CLI.

Manual native installation / other MCP clients

macOS example (replace the platform for Intel Mac or Linux):

unzip android-use-runtime-macos-arm64.zip -d android-use-runtime
./android-use-runtime/app/android-use-runtime install \
  --archive android-use-runtime-macos-arm64.zip \
  --sha256 REPLACE_WITH_THE_MATCHING_64_HEX_VALUE_FROM_SHA256SUMS

Windows PowerShell:

Expand-Archive .\android-use-runtime-windows-x86_64.zip .\android-use-runtime
& .\android-use-runtime\app\android-use-runtime.exe install `
  --archive .\android-use-runtime-windows-x86_64.zip `
  --sha256 REPLACE_WITH_THE_MATCHING_64_HEX_VALUE_FROM_SHA256SUMS

Copy the returned mcp_config.command and all mcp_config.args into the client's local stdio MCP settings. Dim can use its MCP management; Claude Desktop/Cursor use mcpServers, while VS Code uses servers. Keep existing env settings and the intended state directory. Disable duplicate Android Use registrations. The native directory defaults to ~/.local/share/android-use/runtime; keep it after deleting the downloaded ZIP/extraction.

Reconnect MCP, discover the 26 tools, then call aua_setup(action="status"), start only if needed, verify aua_ready and open aua_screen. The phone still needs debugging authorization, unlocking and a supported recording capability. Jev remains optional and can be configured in the screen's Jev settings.

Source / Codex installation

Extract android-use-0.7.0-plugin.zip. Prepare uv and ADB; ffmpeg is needed for live video. From the extraction root:

uv run --no-project --python 3.13 python scripts/install.py doctor
uv run --no-project --python 3.13 python scripts/install.py install --source . --codex

For Dim or another MCP client, omit --codex and register the returned mcp_config. For a recognized older manual/Codex registration, review diagnostics and explicitly use --migrate-codex; already-managed installations can use the ordinary install command. Source installation remains supported and does not provision a native runtime automatically.

Update, OCR and rollback

For native macOS/Linux installations:

/bin/sh "$HOME/.local/share/android-use/runtime/launcher.sh" update
/bin/sh "$HOME/.local/share/android-use/runtime/launcher.sh" install-ocr  # optional, macOS only
/bin/sh "$HOME/.local/share/android-use/runtime/launcher.sh" rollback

On Windows, use the returned native command and its --root ROOT arguments; replace the final auto-serve argument with the management command. Automatic checks occur at most once per 24 hours; ANDROID_USE_AUTO_UPDATE=0 disables them. Rollback pauses checks until an explicit successful update. Original runtime versions and settings are retained. Moving from source to native is an explicit installation choice; the source launcher's private environment file is not silently imported.

A full desktop restart is not intrinsic to a runtime upgrade, but an existing MCP process is not hot-replaced. Reconnect/reload tools to start the selected version. Publishing this release does not update an already-running local installation.

Validation and scope

The standalone implementation passed 481 Python regressions, 24 browser tests and Ruff. Native acceptance passed 15 scenarios on each macOS architecture and 13 each on Linux and Windows: real stdio MCP/UI resources, install/upgrade/rollback, active sessions during promotion, bad-update preservation, private settings, bundled H.264 decoding, optional Mac OCR and packaged public/private bootstrap. The release pipeline repeats acceptance with the v0.7.0 binaries before publication.

These package checks perform no phone actions or model calls. Earlier device/Jev acceptance is separate. Bootstrap transport was stubbed in CI; live release-download smoke checks are reported separately. Packages are unsigned: new-user OS security prompts and OEM USB drivers are outside CI acceptance. Forced termination can leave a lock; verify the process has exited before cleaning it. SHA256 protects transfer integrity, not a compromised publisher. See the validation record and license audit for the exact boundaries.

Post-publication verification

On macOS ARM64, downloaded the published source/native/Dim packages and verified their checksums. All 11 ZIP digests match GitHub's uploaded-asset records. The source plugin, native GitHub API download/install and real private Dim bootstrap each initialized v0.7.0 / 26 tools and served the embedded UI. The optional OCR component also downloaded and passed its native health check. The supplied README screenshot is present unchanged. No phone actions or model calls were made.

CI native build/acceptance environments: macOS 15 (ARM64/Intel), Ubuntu 22.04 x86_64 and Windows Server 2022 x86_64. Other host OS versions were not accepted in this release run. Native archives and their acceptance reports are retained in the successful release workflow.

发布后已在 macOS ARM64 完成真实 Release 下载和校验：源码插件、原生 GitHub API 安装、Dim 私有首次引导均返回 v0.7.0 / 26 工具，可选 OCR 实际下载与健康检查通过。你提供的 README 截图保持原样。此验收不操作手机、不调用模型。

中文

v0.7.0 新增四平台可选独立运行包、轻量 Dim 插件、后台校验更新与回滚。runtime 不是必需项：Agent 根据已有安装、依赖、平台和网络选择源码方式或独立包，复用健康环境，不重复注册。README 已换成 Dim Agent 实际操作截图；项目 MIT 版权归属为 Archship，第三方声明与对应分发材料保留。

下载选择： 已有 Python/uv 环境可继续用 android-use-0.7.0-plugin.zip；希望减少依赖安装时，选匹配平台的 android-use-runtime-PLATFORM.zip，或在 Dim 中使用 android-use-0.7.0-PLATFORM-dim-plugin.zip。macOS OCR 单独按需安装，不默认携带；Jev 与本地 OCR 均可选。先下载对应 ZIP 和 SHA256SUMS 校验，再按上面的命令安装。私有仓库需要下载权限，可在已登录的浏览器下载；首次私有自动安装需要 GitHub CLI 与私有令牌，也可先离线安装运行包。

配置使用： 将安装返回的 mcp_config.command 和全部参数填入客户端本地 stdio 配置，保留原 env、设备与 Jev 设置，移除重复入口。源码方式用 scripts/install.py；Codex 加 --codex，其他客户端省略。完成后重连 MCP，确认工具、READY 与实时画面。USB 调试授权、手机解锁及系统权限由用户完成；Jev Key 可在画面的 Jev 设置里自行配置。

升级回滚： 原生固定入口支持 update、可选 install-ocr 和 rollback。后台最多每天检查一次，校验与真实 MCP 握手通过才切换；当前任务继续执行，下次连接使用新版。失败保留旧版；回滚先验证旧版并暂停自动更新，显式成功执行 update 后恢复。不会自动替换当前 MCP 进程，也不会因发布新版本自动更新本机插件。

481 项 Python、24 项浏览器测试及四平台安装、升级、回滚验收通过；发布流水线对 v0.7.0 产物再验收后上传。包验收不操作手机、不调用 Jev；CI 中的下载传输桩不等于真实 Release 下载验收。原生包未签名、驱动与新用户系统提示等范围见上文。所有包不是 Android APK。

Assets 14
Loading