Android Studio Bumblebee 插件未找到问题解决方案

问题描述

在升级到 Android Studio Bumblebee (2021.1.1) 版本后，许多开发者遇到了以下错误提示：

Plugin [id: 'com.android.application', version: '7.1.0', apply: false] was not found in any of the following sources:

这个错误通常出现在项目同步过程中，导致无法正常构建和运行项目。问题的根源可能涉及多个方面，包括 Gradle 配置、网络设置、JDK 版本等。

解决方案概览

根据社区反馈，这个问题有多种可能的解决方案，以下是按优先级排列的解决方案：

1. 检查 Gradle 离线模式

首要检查项

确保 Gradle 没有启用离线模式。点击 Android Studio 右上角的「大象」图标，确保「Toggle Offline Mode」未激活。

2. 配置正确的设置文件

对于 Android Gradle Plugin (AGP) 7.1.0 及更高版本，需要在 settings.gradle 文件中正确配置插件管理：

pluginManagement {
    repositories {
        gradlePluginPortal()
        google()
        mavenCentral()
    }
}

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

rootProject.name = 'YourProjectName'
include ':app'

3. 检查并更新 JDK 版本

Android Studio Bumblebee 要求使用 JDK 11 或更高版本：

1. 点击 File > Project Structure
2. 在 SDK Location 选项卡中确认 JDK 版本为 11+
3. 或者通过 File > Settings > Build, Execution, Deployment > Build Tools > Gradle 检查 Gradle JDK 设置

4. 检查网络和代理设置

网络连接问题是最常见的导致插件无法下载的原因之一：

gradle.properties

# 检查并移除可能错误的代理设置
# systemProp.http.proxyHost=
# systemProp.http.proxyPort=80
# systemProp.https.proxyHost=
# systemProp.https.proxyPort=80

正确的代理设置

# 如果确实需要代理，请使用HTTP而非SOCKS
systemProp.http.proxyHost=127.0.0.1
systemProp.https.proxyHost=127.0.0.1
systemProp.https.proxyPort=1081
systemProp.http.proxyPort=1081

5. 清理 Gradle 缓存

尝试删除以下目录然后重新同步项目：

• 项目目录下的 .gradle 文件夹
• 全局 Gradle 缓存目录（通常在 ~/.gradle）
• 删除 init.d 文件夹（如果存在）

进阶解决方案

解决企业网络安全问题

对于使用企业网络（如ZScaler）的用户：

1. 导出企业安全证书
2. 使用 KeyTool 将证书添加到 JRE 信任库
3. 默认密钥库密码通常是 changeit

处理混合项目配置

当项目同时存在 settings.gradle 和 settings.gradle.kts 时：

1. 删除多余的设置文件
2. 将所有模块引用统一到一个文件中

// settings.gradle.kts
include(":app", ":your-library-module")

验证插件版本兼容性

确保使用的插件版本与 Android Studio 版本兼容。可以暂时降级插件版本测试：

plugins {
    id 'com.android.application' version '7.0.0' apply false
    id 'com.android.library' version '7.0.0' apply false
}

调试技巧

如果以上方案均无效，可以启用详细日志模式：

./gradlew assembleDebug --debug

查看日志输出，寻找具体的网络连接错误或下载失败信息。

预防措施

1. 定期更新 Android Studio 和 Gradle 插件
2. 保持稳定的网络连接 或配置正确的代理设置
3. 统一项目配置，避免混合使用 Groovy 和 Kotlin DSL
4. 备份 gradle.properties 文件中的重要配置

总结

Android Studio Bumblebee 插件未找到问题通常源于网络连接、配置错误或环境设置问题。通过系统性地检查离线模式、网络设置、JDK 版本和 Gradle 配置，大多数情况下都能解决这一问题。

建议

按照本文列出的顺序尝试解决方案，从最简单的网络检查开始，逐步深入到更复杂的配置调整。

如果问题仍然存在，建议查看 Android Studio 的 idea.log 文件获取更详细的错误信息，或在开发者社区寻求帮助。