news 2026/10/6 5:47:53

Android Studio Bumblebee 2021.1.1.23 Windows 安装配置与打包避坑指南

作者头像

张小明

前端开发工程师

1.2k 24
文章封面图
Android Studio Bumblebee 2021.1.1.23 Windows 安装配置与打包避坑指南

简介:Android Studio Bumblebee(android-studio-2021.1.1.23-windows)是面向 Windows x86_64 平台的官方 Android 集成开发环境安装包,可视为 Android Studio 4.3 之后的新一代版本,常被理解为 4.4 版本。它适合 Android 应用开发者、移动端学习者以及需要搭建原生开发环境的技术人员,用于完成项目创建、代码编写、调试与打包等日常开发工作。压缩包为 zip 格式,共收录 2776 个文件,整体约 882.57MB,其中以 jar 库文件、py 脚本、json 配置、ttf 与 otf 字体、webp 与 png 图像资源为主,同时包含 dll、exe、so 等运行组件,以及 license、notice、md 等许可与说明文档,目录结构完整,覆盖 IDE 运行所需的各类依赖。目前已有 619 人学习下载,可作为稳定可用的开发工具版本参考,帮助读者快速获得完整安装包,省去逐项配置与查找依赖的麻烦。

1. 为什么 2026 年还有人专门找 Bumblebee 这个版本

上周帮一个做车载 HMI 的朋友装环境,他甩过来一个文件名:android-studio-2021.1.1.23-windows.exe。我第一反应是"这都哪年的老古董了",结果他一句话把我堵回去——新版本打开他们那个 2019 年的老工程,Gradle 同步直接卡死,AGP 版本对不上,Kotlin 插件报一堆红。换回 Bumblebee,十分钟跑起来。

这就是 Bumblebee(Android Studio 2021.1.1 Patch 3,构建号 2021.1.1.23)在今天的真实价值:它不是最新版,但它是很多存量项目的"舒适区"。这个版本对应 IntelliJ 2021.1 内核,自带 AGP 7.1 时代的工具链适配,对 JDK 11 友好,对老 Gradle 版本的兼容性比后面 Arctic Fox 之后的版本稳得多。如果你手上是 2020~2022 年间立项的安卓工程,或者公司内网锁死了 SDK/AGP 版本,Bumblebee 往往是那个"装上就能用"的版本。

这篇不是版本怀旧,是把这个 Windows 安装包从下载、安装、SDK 配置、Gradle 调优到打包踩坑整条链路拆一遍。适合两类人:一是被新版本兼容性折磨、想回退到稳定版的从业者;二是第一次装 Android Studio、需要一份能照着走完的 Windows 实操记录的新手。下面所有步骤都基于 Windows 10/11 实测,路径和参数可以直接抄。

2. 安装前的环境账:JDK、路径与安装包校验

2.1 先确认 JDK,别让安装器替你决定

Bumblebee 自带的 JDK 是 11(JetBrains Runtime 11),但很多人机器上早就装了 JDK 8 或 JDK 17,环境变量JAVA_HOME指向谁,直接决定 Gradle 用哪个 JVM 跑。我一般会先看一眼:

# Windows CMD 或 PowerShell 里执行 java -version echo %JAVA_HOME%

如果输出是 1.8,而你的工程用的是 AGP 7.x,那 Gradle 同步大概率报Unsupported class file major version。Bumblebee 时代 AGP 7.1 要求 JDK 11,所以要么把JAVA_HOME切到 11,要么在gradle.properties里显式指定:

# gradle.properties org.gradle.java.home=C:\\Program Files\\Java\\jdk-11.0.xx

参数说明:org.gradle.java.home只影响 Gradle 守护进程用的 JDK,不影响 Android Studio 自身运行。这样做的意义是——你系统默认 JDK 可以是 17 给别的项目用,但 Android 工程强制走 11,互不干扰。这是我最推荐的做法,比全局改JAVA_HOME干净。

2.2 安装路径别带中文和空格

安装器默认往C:\Program Files\Android\Android Studio装,这个路径本身没问题。但 SDK 路径我强烈建议单独放,比如D:\Android\Sdk。原因有两个:一是 C 盘空间,SDK 加上模拟器镜像轻松几十 G;二是很多老工程的local.properties里写死了 SDK 路径,路径里一旦有中文或空格,NDK 编译和 CMake 会出各种找不到文件的玄学错误。

安装时选 "Custom" 而不是 "Standard",把 SDK 位置指到D:\Android\Sdk。如果你已经装了,可以在File → Settings → Appearance & Behavior → System Settings → Android SDK里改,但改完记得同步更新每个工程的local.properties:

# local.properties,每个工程根目录下 sdk.dir=D\:\\Android\\Sdk

注意这里是双反斜杠转义,Properties 文件里反斜杠是转义字符,写单反斜杠会解析失败。这个坑我见过太多次,报错信息是SDK location not found,但路径明明是对的。

2.3 安装包完整性校验

下载完先对一下大小和哈希,避免下到被篡改或没下完的包。Bumblebee Windows 版安装包大概 900MB 出头,具体以你拿到的为准。校验命令:

# PowerShell 里算 SHA256 Get-FileHash .\android-studio-2021.1.1.23-windows.exe -Algorithm SHA256

把结果和来源页面给的哈希对比。这一步不是形式主义——我遇到过下载中断导致安装到一半报corrupted installer的情况,重下才解决。校验通过再双击,能省掉一轮排查。

3. 首次启动配置:SDK、Gradle 与中文界面

3.1 SDK 组件怎么勾,别全选

首次启动会弹 Setup Wizard,让你选 SDK 组件。新手容易全勾,结果下几个小时。实际按需来:

组件是否必装说明
Android SDK Platform必装至少勾一个目标 API,比如 API 33
Android SDK Build-Tools必装选和 AGP 匹配的版本,AGP 7.1 配 30.0.3 或 31.0.0
Android SDK Platform-Tools必装含 adb、fastboot,调试必备
Android Emulator按需不用模拟器可以不装,省几个 G
SDK Platforms 多个版本按需只勾你工程compileSdk对应的那个

Build-Tools 版本和 AGP 是强绑定的。AGP 7.1 官方推荐 Build-Tools 30.0.3,你装 34 也能跑,但偶尔会报Installed Build Tools revision xx is corrupted。稳妥起见按工程build.gradle里声明的来。

3.2 Gradle 配置:离线包和镜像

Bumblebee 默认用 Gradle 7.2(wrapper 里指定)。国内直连services.gradle.org下 wrapper 经常超时,常见做法是手动下好对应版本的 Gradle 压缩包,放到~/.gradle/wrapper/dists/对应目录下,或者改gradle-wrapper.properties指向本地文件:

# gradle/wrapper/gradle-wrapper.properties distributionBase=GRADLE_USER_HOME distributionPath=wrapper/dists distributionUrl=https\://services.gradle.org/distributions/gradle-7.2-bin.zip zipStoreBase=GRADLE_USER_HOME zipStorePath=wrapper/dists

如果内网有镜像,把distributionUrl换成镜像地址即可。另外在工程根build.gradle里把仓库换成国内镜像,能显著加快依赖拉取:

// build.gradle (Project 级) buildscript { repositories { maven { url 'https://maven.aliyun.com/repository/google' } maven { url 'https://maven.aliyun.com/repository/public' } google() mavenCentral() } } allprojects { repositories { maven { url 'https://maven.aliyun.com/repository/google' } maven { url 'https://maven.aliyun.com/repository/public' } google() mavenCentral() } }

参数说明:maven { url ... }的顺序决定查找优先级,镜像放前面,google()和mavenCentral()兜底。这样即使镜像里没有某个冷门依赖,也能回源找到。改完点Sync Now,第一次同步会慢,之后就快了。

3.3 中文界面:装插件而不是改配置

"android studio 怎么设置中文"是高频搜索词。Bumblebee 本身不带中文语言包,官方做法是装 JetBrains 的 Chinese (Simplified) 语言包插件。路径:File → Settings → Plugins → Marketplace,搜 "Chinese",装官方那个Chinese (Simplified) Language Pack,重启即可。

注意:这个插件版本要和 IDE 内核匹配。Bumblebee 是 2021.1 内核,你要装对应 2021.1 的插件版本,装最新版会提示不兼容。Marketplace 一般会自动过滤,如果搜不到,去插件页面手动下对应版本,用Install Plugin from Disk装。装完如果部分菜单还是英文,属于正常——插件覆盖不全,核心菜单汉化就够了,别指望 100%。

4. 工程导入与打包:从 Sync 失败到 APK 产出

4.1 导入老工程的三个必改点

拿一个 2021 年前后的工程往 Bumblebee 里导,大概率要改三处:

第一,build.gradle里的 AGP 版本。Bumblebee 支持 AGP 7.0~7.1,工程如果写的是 4.2 或更低,得升上来:

// build.gradle (Project 级) plugins { id 'com.android.application' version '7.1.3' apply false id 'com.android.library' version '7.1.3' apply false id 'org.jetbrains.kotlin.android' version '1.6.20' apply false }

第二,settings.gradle的仓库声明方式。AGP 7.x 推荐用dependencyResolutionManagement:

// settings.gradle dependencyResolutionManagement { repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS) repositories { google() mavenCentral() } }

第三,compileSdk和targetSdk。Bumblebee 时代主流是 32,你工程如果写 28,能跑但会提示升级。改不改看需求,不改也能编译。

4.2 打包 APK:签名配置和常见报错

打包走Build → Generate Signed Bundle / APK。签名配置写在build.gradle里更省事:

// app/build.gradle android { signingConfigs { release { storeFile file("../keystore/release.jks") storePassword "your_store_password" keyAlias "your_key_alias" keyPassword "your_key_password" } } buildTypes { release { signingConfig signingConfigs.release minifyEnabled true proguardFiles getDefaultProguardFile('proguard-android-optimize.txt'), 'proguard-rules.pro' } } }

参数说明:minifyEnabled true开启代码混淆和压缩,能显著减小 APK 体积,但前提是你的proguard-rules.pro写全了,否则反射调用的类会被裁掉,运行时崩。第一次打包建议先设false,确认能出包再开混淆。

打包常见报错Duplicate resources(资源重复),多半是依赖库里带了和你res目录同名的资源。解决办法是在app/build.gradle里加:

android { packagingOptions { resources { excludes += ['META-INF/DEPENDENCIES', 'META-INF/LICENSE'] } } }

或者用resourcePrefix给模块资源加前缀,从源头避免冲突。

4.3 移植工程时的 Gradle 版本对齐

"移植 android studio 项目"这个场景,最容易翻车的是 Gradle 版本和 AGP 版本不匹配。规则是:AGP 7.1 要求 Gradle 7.2 及以上。你工程 wrapper 里如果写的是 6.7,同步直接报Minimum supported Gradle version is 7.2。改gradle-wrapper.properties里的distributionUrl到 7.2,再同步。

如果工程里还有jcenter(),Bumblebee 会警告但能用。jcenter 已经停服,建议换成mavenCentral(),否则某些依赖拉不下来。这一步在移植老项目时几乎必做。

5. 避坑排查:Bumblebee 在 Windows 上的五个血泪经验

5.1 现象:Sync 卡在 "Download gradle-7.2-bin.zip"

原因:wrapper 下载走的是国外源,网络不稳定或超时。 解决:手动下载 Gradle 7.2 压缩包,放到C:\Users\你的用户名\.gradle\wrapper\dists\gradle-7.2-bin\下一个随机字符串目录里,解压好,重启 IDE。或者直接改distributionUrl指向内网镜像。

5.2 现象:模拟器启动报 "HAXM is not installed"

原因:Bumblebee 时代模拟器默认用 Intel HAXM 加速,新机器或 AMD 平台没装。 解决:AMD 平台改用 Windows Hypervisor Platform(WHPX),在Windows 功能里开启 "Windows 虚拟机监控程序平台" 和 "虚拟机平台",然后在模拟器设置里把加速方式改成 WHPX。Intel 平台去 SDK Manager 的 SDK Tools 里勾选 HAXM 安装。

5.3 现象:中文插件装了但菜单还是英文

原因:插件版本和 IDE 内核不匹配,或者装的是第三方非官方汉化包。 解决:确认装的是 JetBrains 官方Chinese (Simplified) Language Pack的 2021.1 版本。装完File → Settings → Appearance & Behavior → System Settings → Language里选中文,重启。部分深层菜单不汉化是正常的。

5.4 现象:打包报 "Keystore was tampered with, or password was incorrect"

原因:签名密码错,或者 keystore 文件路径写错(相对路径基准是模块目录不是工程根目录)。 解决:storeFile file("../keystore/release.jks")里的..是相对app模块的,不是工程根。用绝对路径最稳。密码确认无误后还报,检查 keystore 是不是被其他工具改过。

5.5 现象:adb 连不上设备,adb devices列表为空

原因:USB 驱动没装,或者设备没开 USB 调试,或者 adb 版本和 SDK Platform-Tools 不匹配。 解决:先adb kill-server再adb start-server。设备端开发者选项里撤销 USB 调试授权再重新授权。Windows 上装厂商 USB 驱动,或者用Google USB Driver(SDK Manager 里勾)。还不行就换根数据线——我遇到过线只能充电不能传数据的。

6. 进阶技巧:用命令行和离线模式把 Bumblebee 用透

装好只是开始,真正提效的是把 Bumblebee 的构建能力从 IDE 里解放出来。我现在的习惯是:IDE 只用来写代码和调试,打包和 CI 全走命令行。

Bumblebee 自带的 Gradle wrapper 可以直接在工程根目录跑:

# Windows 下用 gradlew.bat gradlew.bat assembleRelease --offline --stacktrace

参数说明:assembleRelease是打包 release 变体;--offline强制离线模式,只用本地缓存,适合内网或断网环境,前提是依赖都下过了;--stacktrace在报错时打印完整堆栈,排查 Sync 和编译错误必加。这三个参数组合是我排查构建问题的起手式。

离线模式要真正可用,得先把依赖缓存全。做法是先联网跑一次gradlew.bat assembleDebug,把所有依赖拉到~/.gradle/caches/,之后就能断网构建。如果换机器,把整个caches目录拷过去,能省大量下载时间。注意caches目录可能好几个 G,拷之前清一下caches/modules-2/files-2.1里的临时文件。

另一个技巧是用gradlew.bat dependencies看依赖树,排查版本冲突:

gradlew.bat :app:dependencies --configuration releaseRuntimeClasspath

输出会列出所有依赖及其传递依赖,冲突的地方会标->指向最终选中的版本。遇到Duplicate class报错时,用这个命令定位是哪个库重复引入,然后在build.gradle里exclude掉。

还有一个容易被忽略的点:Bumblebee 的Build Analyzer。Build → Analyze Build能看每个任务的耗时,找出拖慢构建的元凶。我见过一个工程因为minifyEnabled配错,每次打包多花三分钟,用 Build Analyzer 一眼就看出来了。

最后说个习惯。从那以后我每次拿到一个新工程,第一件事不是点 Sync,而是先看三个文件:gradle-wrapper.properties确认 Gradle 版本,根build.gradle确认 AGP 版本,local.properties确认 SDK 路径。这三个对齐了,Sync 基本一次过;对不齐,后面全是坑。这套检查流程帮我省下的时间,比任何"一键配置"工具都多。希望帮到你。

本文还有配套的精品资源,点击获取

版权声明: 本文来自互联网用户投稿,该文观点仅代表作者本人,不代表本站立场。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。如若内容造成侵权/违法违规/事实不符,请联系邮箱:809451989@qq.com进行投诉反馈,一经查实,立即删除!
网站建设 2026/10/6 5:47:53

电荷泵原理与实战:倍压、稳压、反压拓扑全解析

做模拟电源这些年,电荷泵一直是个容易被低估的小角色。很多人一提它,第一反应就是“拿电容升个压”,但真到选型、画板、调测的时候才发现,倍压、稳压、反压三种拓扑各有各的脾气:要么带载就垮,要么纹波大得…

作者头像 李华
网站建设 2026/10/6 5:47:53

四线开尔文法详解:如何精准测量毫欧级电阻

有次修一个ATX电源,保险管炸了。换新之前我不放心,拿万用表蜂鸣档测了一下新保险管,滴滴响,通。切到电阻档再测,读数0.3Ω出头。我心里咯噔一下,新管子也是坏的?拆了一盒子保险管挨个测&#xf…

作者头像 李华
网站建设 2026/10/6 5:47:38

Minecraft Replay Mod 安装与深度使用指南

1. 这不是普通录屏——Replay Mod 是 Minecraft 世界的时间胶囊你有没有过这样的时刻:在生存模式里千辛万苦打完末影龙,镜头刚切到末地传送门炸开的瞬间,朋友喊你吃饭;或者在创造模式搭了一整天的空中城堡,最后一步红石…

作者头像 李华
网站建设 2026/10/6 5:47:12

Altium Designer多通道PCB布局复制:Room复制功能详解

先把话放前面:如果你手里的板子是多通道、多模块、多路电源这一类结构,布局阶段最磨人的不是“画一块板”,而是“同一套电路画四遍、摆四遍、走四遍”。AD22里有一个被很多人忽略的功能——Room复制。它能把一个通道的元件摆放和走线结果直接…

作者头像 李华
网站建设 2026/10/6 5:46:45

计网课设DNS服务器实验:BIND9配置、Python实现与答辩技巧

简介:计算机网络课程设计中的DNS服务器实验资料包,面向北邮大二下学生及计算机网络初学者,用于完成DNS服务器搭建与域名解析实验。资料围绕域名系统展开,详细介绍DNS分布式数据库、根域到子域的层次结构,以及A、AAAA、…

作者头像 李华
网站建设 2026/10/6 5:46:28

贴片器件丝印识别实战:SOT-23与SOD-523反查思路

上周帮朋友修一块烧坏的 LED 驱动板,故障管旁边躺着一颗三脚小黑粒,激光打标只有两个字符:“72”。现场没有原理图,板子上连位号都被高温烤糊了一半。这颗东西到底是三极管、MOS 管还是稳压芯片?如果是 MOS&#xff0c…

作者头像 李华