ARTICLE · 1123886
零配置便携安卓CLI开发环境|内置国内镜像,AI驱动一键开发
玩安卓命令行开发、设备调试的朋友，最大的卡点往往不是写代码，而是下载依赖：sdkmanager拉取SDK组件、Gradle下载包的时候，官方源速度极慢，经常超时、中断、下载失败。很多人环境搭好了，卡在依赖下载这一步，等于白忙活。
今天这套基于豆包方案打造的单文件夹便携安卓CLI环境，U盘随便拷贝、换电脑双击就能用；内置国内镜像，解决SDK、Gradle下载慢的痛点。
✨ 支持自定义安卓版本，可单独下载一个SDK版本，也能一次性批量下载多个版本，模拟器镜像也可以一并安装。✨ 进阶玩法：搭配AI全自动开发安卓项目，你只需要提需求，AI全程完成开发、编译打包，几乎不用手动干预。
一、这套便携环境的核心优势
✅ 纯便携，整文件夹迁移：JDK、SDK、脚本全部封装，不用安装软件、不改动系统环境变量，U盘拷贝就能在别的电脑直接跑✅ 国内镜像预置：提前写好SDK Manager镜像 + Gradle国内镜像，下载SDK、模拟器、Gradle依赖全部加速，不用每次新建项目手动改配置✅ 多版本SDK自由选择：搭建时按需指定Android版本，支持单个/多个平台SDK批量下载，模拟器系统镜像可同步安装✅ 临时环境变量：批处理脚本仅对当前CMD窗口生效，关闭窗口就清除，不影响电脑原有Android Studio、JDK环境✅ 只保留CLI工具：不装笨重的Android Studio，只保留命令行编译、调试、模拟器管理工具，体积可控✅ 不修改系统：无注册表写入，绿色免安装，办公电脑也能用✅ 适配AI自动开发：环境独立隔离，AI可以直接调用这套CLI完成新建项目、写代码、编译打包
二、整体搭建思路（豆包工作模式）
1. 拆解需求：便携单目录 + 免系统环境变量 + SDK国内镜像 + Gradle国内镜像 + 支持多Android版本+模拟器下载 + 对接AI自动化开发2. 组件选型：精简便携JDK + Android cmdline-tools + platform-tools（ADB/fastboot）3. 预置镜像配置文件：把sdkmanager镜像、Gradle镜像写进环境目录里，随文件夹一起打包迁移4. 编写启动批处理：自动加载路径，同时把镜像相关的环境变量一并注入当前终端5. 按需拉取组件：使用 sdkmanager ，自定义安卓版本，支持批量下载多个平台SDK，同步下载模拟器镜像6. 跨电脑拷贝测试：复制到另一台电脑，验证adb、java、sdkmanager、模拟器、gradle下载，确认镜像生效7. AI开发流程调试：固定项目目录规范，让AI识别这套CLI环境，实现需求驱动全自动开发
三、目录结构（完整打包文件夹 Android-CLI-Portable）
plaintextAndroid-CLI-Portable├─ jdk
便携JDK├─ sdk│ ├─ platform-tools # adb、fastboot│ ├─ cmdline-tools # sdkmanager等命令行工具│ ├─ emulator # 安卓模拟器程序（下载模拟器镜像后生成）│ ├─ system-images # 模拟器系统镜像存放目录│ ├─ platforms # 各Android版本SDK平台文件│ ├─ build-tools # 对应版本编译工具链│ └─ .android # Android全局配置目录（放sdkmanager镜像配置，重点！）├─ gradle│ ├─ init.d # Gradle全局初始化脚本（配置国内镜像，重点！）│ └─ caches # Gradle依赖缓存，跟着文件夹一起迁移，复用下载包└─ 启动环境.bat # 一键加载环境脚本
镜像配置存放在 .android 和 gradle/init.d ，拷贝到其他电脑镜像自动生效。模拟器镜像、Gradle缓存全部保存在当前文件夹，换电脑无需重复下载。
四、分步搭建教程
步骤1：准备基础工具（JDK、cmdline-tools、platform-tools）
新建总文件夹 Android-CLI-Portable ，内部新建 jdk 、 sdk 目录。将绿色便携版JDK解压放入 jdk 文件夹；Android cmdline-tools、platform-tools解压放到 sdk 对应目录。
步骤2：配置SDK Manager国内镜像（解决下载Android SDK、模拟器镜像慢）
在 sdk 目录下新建 .android 文件夹，里面新建文件 repositories.cfg
文件路径： Android-CLI-Portable\sdk.android\repositories.cfg
ini
中科大Android SDK镜像
sdk.manager.repoUrl=https://mirrors.ustc.edu.cn/android/repository/addon-6.xmlsdk.manager.repoUrl=https://mirrors.ustc.edu.cn/android/repository/addon-2.xmlsdk.manager.repoUrl=https://mirrors.ustc.edu.cn/android/repository/repository2-1.xml
sdkmanager读取该配置，优先走国内镜像拉取平台SDK、build-tools、模拟器镜像。
步骤3：配置Gradle全局国内镜像（解决项目编译时下载依赖卡死）
在根目录新建 gradle\init.d ，新建文件 mirror.gradle 路径： Android-CLI-Portable\gradle\init.d\mirror.gradle
groovyallprojects { repositories { maven { url 'https://maven.aliyun.com/repository/google' } maven { url 'https://maven.aliyun.com/repository/jcenter' } maven { url 'https://maven.aliyun.com/repository/public' } maven { url 'https://maven.aliyun.com/repository/gradle-plugin' } }}
// Gradle插件镜像settingsEvaluated { settings -> settings.pluginManagement { repositories { maven { url 'https://maven.aliyun.com/repository/gradle-plugin' } mavenCentral() } }}
全局初始化脚本，只要在这个环境运行gradle/gradlew，自动加载阿里云镜像，不用每个项目修改仓库地址。
步骤4：编写【启动环境.bat】
bat@echo offchcp 65001title 便携安卓CLI开发环境（国内镜像+AI开发+模拟器版）:: 当前文件夹根路径set "ROOT=%~dp0":: JDKset "JAVA_HOME=%ROOT%jdk"set "Path=%JAVA_HOME%\bin;%Path%":: Android SDKset "ANDROID_SDK_ROOT=%ROOT%sdk"set "ANDROID_HOME=%ROOT%sdk":: 模拟器需要把emulator目录加入PATHset "Path=%ANDROID_SDK_ROOT%\emulator;%ANDROID_SDK_ROOT%\platform-tools;%ANDROID_SDK_ROOT%\cmdline-tools\latest\bin;%Path%"
:: ========== Gradle镜像相关环境变量 ==========:: 指定Gradle全局初始化脚本目录，缓存全部保存在便携文件夹内set "GRADLE_USER_HOME=%ROOT%gradle"
echo ==============================================echo ✅ 便携安卓CLI环境加载完成（国内镜像已启用）echo SDK Manager、Gradle自动使用国内镜像echo 支持多Android版本、模拟器镜像下载，可配合AI全自动开发安卓项目echo ==============================================echo 验证命令：echo java -versionecho adb versionecho sdkmanager --listecho emulator -list-avdsecho gradle -vecho ==============================================cmd
步骤5：下载SDK与模拟器（可选单版本 / 多版本批量下载）
双击 启动环境.bat 打开终端，执行sdkmanager命令下载组件。
示例1：只下载单个安卓版本 Android 34
bashsdkmanager "platforms;android-34" "build-tools;34.0.0" "system-images;android-34;google_apis;x86_64" "emulator"
platforms;android-34 ：Android34平台SDK build-tools;34.0.0 ：对应版本编译工具 system-images;android-34;google_apis;x86_64 ：Android34模拟器镜像 emulator ：模拟器主程序
示例2：一次性下载Android33 + Android34两个版本，附带模拟器镜像
bashsdkmanager ^"platforms;android-33" "build-tools;33.0.2" "system-images;android-33;google_apis;x86_64" ^"platforms;android-34" "build-tools;34.0.0" "system-images;android-34;google_apis;x86_64" ^"emulator"
下载完成后，创建模拟器AVD并启动：
bash
创建模拟器
avdmanager create avd -n test34 -k "system-images;android-34;google_apis;x86_64"
启动模拟器
emulator -avd test34
输入 sdkmanager --list 可以查看全部可用Android版本、系统镜像，按需挑选。
五、完整使用教程（手动调试 + AI全自动开发）
整套环境迁移、使用非常简单，把整个 Android-CLI-Portable 文件夹复制到U盘、移动硬盘，拷贝到任意Windows电脑即可使用。环境文件夹、项目文件夹路径不要带中文、空格。
方式一：手动使用环境（调试、打包、设备测试）
1. 将 Android-CLI-Portable 文件夹拷贝到目标电脑；2. 双击根目录 启动环境.bat ，弹出命令行窗口，环境自动加载、镜像自动启用；3. 验证基础工具是否正常：
bashjava -versionadb versionsdkmanager --list
4. 按需下载对应版本SDK、build-tools、模拟器镜像（前面的sdkmanager命令）；5. 模拟器操作：创建AVD、启动模拟器； adb devices 查看连接设备（真机/模拟器）；6. 进入安卓项目目录执行编译打包：
bash
编译debug包
gradlew assembleDebug
编译完成，APK输出在项目 app/build/outputs/apk/debug 目录。
方式二：搭配AI全自动开发（重点）
这个是这套环境最省心的玩法，流程固定：
1. 在电脑任意位置新建独立空文件夹作为项目工作目录（例如 D:\MyAndroidApp ），项目目录和CLI环境目录分开，多个项目互不干扰；2. 告诉AI两个关键信息：
便携安卓CLI环境完整路径； APP开发需求：功能、页面、权限、目标Android版本，是否需要模拟器用于测试；3. AI会全程自主完成：新建安卓项目骨架、编写源码、修改Gradle配置、调用sdkmanager补全对应版本SDK/模拟器镜像，执行编译打包；4. 你只需要等待AI输出代码和命令，全程几乎不用手动干预，编译完成直接拿到APK。
AI提示词模板（直接复制发给AI使用）
你现在使用我本地这套便携安卓CLI开发环境，环境路径：D:\Android-CLI-Portable，项目工作目录：D:\MyAndroidApp。请基于安卓命令行工具完成安卓应用开发，使用环境内置国内镜像拉取SDK和Gradle依赖。目标Android版本为android-34，准备好对应模拟器用于测试。按照标准安卓CLI流程，创建项目、编写源码、配置文件，输出可直接复制执行的命令和代码，不需要我手动操作。需求：【填写你的APP需求】。
六、关键说明 & 注意事项
1. 两套镜像各司其职
repositories.cfg ：管 sdkmanager ，下载Android平台、build-tools、模拟器system-image init.d/mirror.gradle ：管Gradle，编译项目时下载google、jcenter、plugin依赖包2. 缓存跟随文件夹 GRADLE_USER_HOME 指向便携文件夹内gradle目录，第一次下载的依赖缓存保存在本地文件夹。拷贝到其他电脑，SDK、模拟器镜像、Gradle缓存一起迁移，不用重复下载。3. 模拟器硬件前提Windows电脑BIOS需要开启CPU虚拟化（VT-x），否则x86_64模拟器无法正常启动。4. 镜像备选SDK镜像除中科大，也可选用清华镜像；Maven除阿里云，也可选用中科大maven镜像，修改配置文件内url即可。5. 局限性 仅Windows系统可用 镜像仅加速下载，少数特殊闭源依赖仍然需要原始网络6. 迁移维护后续想要新增SDK版本、更新镜像地址，直接修改 .android 或者 gradle/init.d 下的文件，修改完成整个文件夹继续拷贝复用。
七、总结
传统安卓CLI环境最大痛点就是SDK和Gradle下载缓慢，多版本SDK、模拟器安装操作繁琐，新建项目、写代码、编译打包都要手动敲大量命令。
这套便携环境，预置SDK镜像与Gradle全局镜像，批处理脚本临时注入环境变量，所有工具、配置、缓存全部打包在一个文件夹。一次搭建，整文件夹复制到任意Windows电脑，双击即用。支持按需选择安卓版本，可单版本或批量下载多个SDK，模拟器镜像一并安装。
更强大的是支持AI驱动开发：新建项目目录，告知AI环境路径和产品需求，AI自动完成项目创建、代码编写、依赖下载、编译打包。大幅降低安卓开发门槛，适合安卓命令行编译、自动化打包、模拟器测试、批量设备调试，团队统一分发开发环境，也适合想用AI快速开发安卓小工具的朋友。
其实上面写那么多也没什么用，只是让了解一下这个过程而已。就两个指令下给豆包，第一个是生成 CLI 环境，第二个就是告诉他软件需求以及 CLI 环境所在的文件夹，然后坐等收获成果就行了。