Jidr

Jidr (جذر)

在你的 Mac 上运行 Android，一分钟内获取 root 权限。

Jidr 可在 Apple Silicon Mac 上创建并运行虚拟 Android 手机和平板电脑。选择 完整 root，即可自动为你修补并验证 Magisk；选择 Shell root 以使用 adb root；也可以保持设备原样。这是一款免费的开源替代方案，可替代 Genymotion Desktop，使用 Rust 编写，提供桌面应用、CLI 和供 AI Agent 使用的 MCP 服务。

**状态：**预发布。首个版本（v0.1.0）正在准备中；在此之前，请从源代码构建。网站：jidr.ly。

功能

• **设备：**使用 Google 的模拟器映像（API 29–36，arm64）创建、克隆、启动、停止和删除虚拟设备。Jidr 使用自己的 SDK，绝不修改 Android Studio 的 SDK 或 AVD。
• **一键 root：**无、Shell root（adb root）或完整 root（Magisk 会修补到每台设备专属的 ramdisk 副本中，并通过 su -c id 验证）。随时可以还原。Play Store 映像提供引导式 Beta 版。
• **播放器窗口：**设备屏幕，支持鼠标和键盘输入、拖放 APK 和文件，以及 logcat。
• **小组件：**电池、旋转和运动传感器、网络（Wi-Fi、移动数据、速度和延迟配置）、通话、SMS 和信号格、GPS（支持在 OpenStreetMap 地图上回放 GPX/KML 路线）、指纹、将主机摄像头用作摄像头、剪贴板和开发者开关。
• **媒体和状态：**PNG 截图、MP4 录制，以及带有创建时 root 模式标签的快照。
• **构建身份：**在完整 root 设备上设置构建属性（型号、品牌、指纹……）。
• **CLI：**每项操作都可通过 jidr 命令执行，并提供 --json 输出和稳定的退出码，适用于 CI。
• MCP 服务：jidr mcp 让 Claude 和其他 MCP 客户端能够查看和控制设备：截图、点击、输入、UI 树、日志。

无需账号、无需遥测、没有付费版本。

要求

• Apple Silicon Mac，运行 macOS 14 或更高版本。
• SDK 和一个系统映像需要约 10 GB 可用磁盘空间。

从源代码构建

git clone https://github.com/AbdurahmanAlmehdi/jidr
cd jidr
cargo build --release -p jidr -p jidr-gui

你需要 rustup（它会安装 rust-toolchain.toml 中固定的工具链）和 protoc（brew install protobuf）。CONTRIBUTING.md 介绍了完整的设置步骤以及如何运行测试。

快速开始（CLI）

jidr image install 35 --accept-licenses   # download an API 35 image; you accept Google's license
jidr device create Phone --image 35       # create a device
jidr device start Phone                   # boot it and wait until it's ready
jidr root set Phone magisk                # Full root with Magisk, verified

将 Jidr 添加到 Claude Code，作为 MCP 服务：

claude mcp add jidr -- jidr mcp

文档

• CLI 参考
• MCP 工具
• Root 模式
• 控制协议：应用、CLI 和 MCP 服务共用的 JSON-RPC 协议
• 设计系统
• 决策和架构决策记录
• 与 Genymotion Desktop 的功能对等情况
• 洁净室政策

许可

Jidr 采用多许可证授权。桌面应用（crates/jidr-ui、apps/jidr-gui）采用 GPL-3.0-only，因为它链接了 Slint。其他所有部分（CLI、守护进程、MCP 服务、库、网站）均采用 Apache-2.0。请参阅 LICENSE-APACHE、两个 GUI crate 中的 LICENSE-GPL 文件以及 NOTICE。

Jidr 根据 Android SDK License 从 Google 下载 Android Emulator 和系统映像，你需要在应用中接受该许可。只有在选择完整 root 时，它才会下载 Magisk（GPL-3.0）。这些内容均不随软件附带。

贡献

欢迎贡献：请阅读 CONTRIBUTING.md。请按照 SECURITY.md 中的说明报告安全问题。如果你使用 AI 编码 Agent，请让它参考 AGENTS.md。

商标

Android 是 Google LLC 的商标。Genymotion 是其所有者的商标。Jidr 与 Google 或 Genymotion 均无关联。