OpenDroid开发环境搭建教程:JDK 21+Gradle 9构建你的第一个APK
【免费下载链接】opendroidYour Open Autonomous Android Agent — A production-ready, self-planning AI assistant powered by local/remote LLMs and accessibility-driven screen automation.项目地址https://gitcode.com/gh_mirrors/op/opendroid点击查看免费下载OpenDroid 是一款运行在 Android 上的开源自主 AI 智能体本教程带你完成OpenDroid 开发环境搭建从安装 JDK 21、配置 Android SDK到用 Gradle 9 构建出第一个可安装的 OpenDroid APK全程约 30 分钟新手可直接照做。一、OpenDroid 是什么为什么要自己构建OpenDroid 是一个真正动手干活的自规划 AI 助手它基于本地/远程 LLM 进行任务规划并通过无障碍Accessibility驱动的屏幕自动化操作你的设备——比如查明天是否下雨如果是给家人发消息并设置闹钟这样的多步指令它能自动拆解、执行、验证并动态重规划。想要修改它的动作系统、接入新的 LLM 提供商或研究计划引擎从源码构建 APK 就是第一步。项目整体介绍见 README.md 与 docs/architecture.md。二、环境需求清单JDK 21、Android SDK 与版本要求开始之前先对照下面这张表确认你的机器支持 Linux / macOS / Windows依赖项版本要求说明JDK21严格 21项目锁定 Java 21 工具链更新版本不能替代Android SDKAPI 36app/build.gradle 中compileSdk 36、targetSdk 36Gradle9.7.0已内置 wrapper无需手动安装Kotlin2.4.0随 AGP 自动拉取minSdk26Android 8.0真机需满足此版本为什么必须是 JDK 21构建脚本声明了jvmToolchain(21)并且 gradle/gradle-daemon-jvm.properties 会把 Gradle 守护进程锁定在 Java 21 上——./gradlew会自动挑选本机已安装的 JDK 21但前提是它已经安装Gradle 不会替你下载。三、第一步安装并验证 JDK 21Ubuntu / Debian 一键安装sudo apt-get update sudo apt-get install -y openjdk-21-jdkmacOSbrew install openjdk21验证 JDK 21 是否生效java -version # 期望输出openjdk version 21.x ...⚠️ 如果机器上已装有 JDK 17 / 23 等其他版本请务必把JAVA_HOME指向 JDK 21否则后续构建会报Unsupported class file major version错误。四、第二步Android SDK 快速安装两种方式方式 AAndroid Studio 图形界面新手推荐安装最新 Android StudioIguana / Jellyfish 或更新版本首次启动时选择Install Android SDK Command Line Tools在 SDK Manager 中安装API 36Android 16平台与最新 Build-Tools进入Settings Build, Execution, Deployment Build Tools Gradle确认Gradle JDK已选为 JDK 21方式 B命令行安装Linux / macOS从官方渠道下载 Command-line Tools 压缩包解压到~/Android/Sdk/cmdline-tools/latest接受许可并安装 API 36sdkmanager --licenses sdkmanager platform-tools platforms;android-36 build-tools;36.0.0配置环境变量export ANDROID_HOME$HOME/Android/Sdk export PATH$ANDROID_HOME/platform-tools:$PATH捷径仓库自带 Debian/Ubuntu 一键环境脚本 install_packages.sh可一次装好 JDK 21、Android SDK 并写好~/.bashrc环境变量。在项目根目录直接执行它即可装完记得source ~/.bashrc。五、第三步克隆 OpenDroid 代码仓库git clone https://gitcode.com/gh_mirrors/op/opendroid cd opendroid项目结构很清晰settings.gradle 只声明了一个:app模块而 gradle/wrapper/gradle-wrapper.properties 已将 Gradle 锁定为9.7.0并附带 SHA-256 校验。首次执行./gradlew时会自动下载对应版本的 Gradle无需单独安装 Gradle。六、第四步用 Gradle 构建你的第一个 APK3 步走1执行构建命令./gradlew assembleDebug首次运行需要解析全部依赖Hilt、Room、Compose、LiteRT 等耗时数分钟属正常现象看到终端输出BUILD SUCCESSFUL即构建成功。2找到你的 APKapp/build/outputs/apk/debug/app-debug.apk3安装到真机adb install app/build/outputs/apk/debug/app-debug.apk安装后首次启动Onboarding 流程会引导你开启无障碍服务、通知使用权等必要权限进入Settings配置一个 LLM 提供商支持 Gemini、Groq、Ollama 等十余种你的 AI 智能体就正式上岗了。七、常见构建报错与快速修复方法报错信息原因修复方法Unsupported class file major version 65守护进程跑在非 JDK 21 上将JAVA_HOME指向 JDK 21重开终端再构建SDK location not found未配置ANDROID_HOME设置环境变量或在项目根目录新建local.properties写入sdk.dir...Gradle wrapper 下载失败/校验失败网络问题检查网络连接wrapper 内置 SHA-256 校验请勿绕过更推荐使用 Android Studio 开发File Open打开 opendroid 根目录等待 Gradle Sync 完成后直接点 Run 即可部署调试。完整开发流程可参考 docs/development_guide.md。八、总结开发环境搭建自查清单✅ JDK 21 已安装并通过java -version验证✅ Android SDK API 36 平台 Build-Tools 已安装✅JAVA_HOME/ANDROID_HOME指向正确✅./gradlew assembleDebug输出BUILD SUCCESSFUL✅app/build/outputs/apk/debug/下生成app-debug.apk至此OpenDroid 开发环境搭建全部完成下一步你可以研究动作扩展机制docs/agents/actions-contribution-guide.md或接入自己的 LLM 提供商祝构建顺利 赞分享【免费下载链接】opendroidYour Open Autonomous Android Agent — A production-ready, self-planning AI assistant powered by local/remote LLMs and accessibility-driven screen automation.项目地址https://gitcode.com/gh_mirrors/op/opendroid点击查看免费下载相关推荐Jasminum插件开发环境搭建从零开始构建你的第一个Zotero插件想要为Zotero开发中文元数据抓取插件Jasminum插件为你提供了完美的起点这个终极指南将带你从零开始快速搭建专业的Zotero插件开发环境让你轻松科研90DaysOfDevOps 第 8 天搭建 Go 开发环境并运行你的第一个 Hello World90DaysOfDevOps 第 8 天搭建 Go 开发环境并运行你的第一个 Hello World 本篇是 90DaysOfDevOps 挑战计划中 Go文档/教程用 Angular 构建你的第一个应用first-app 入门教程导读与本地开发环境搭建指南用 Angular 构建你的第一个应用first app 入门教程导读与本地开发环境搭建指南 本教程导读基于 Angular 官方仓库 a.dev 站点源码中前端Web框架创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考