零、app/build.gradle 与 最外层 build.gradle 与 gradle/wrapper/gradle-wrapper.properties 三者之间的区别与作用

• app/build.gradle：在这个里面可以看到当前项目的版本号、构建变体、签名信息、依赖库、插件、SDK 版本。

• 最外层 build.gradle：配置一些全局的构建配置、插件的版本、仓库的声明（如 Maven 仓库），以及各个子模块的依赖关系等，还可以在此文件中指定配置项目使用的 Android Gradle 插件（AGP） 版本。

  AGP 是 Gradle 的一个插件，它为构建过程添加了 Android 特有的功能。Android 项目通过这个插件来定义构建配置、依赖和任务，而 Gradle 则负责执行构建任务。

  例如文件中的 classpath 'com.android.tools.build:gradle:7.0.2' 具体指定的是 AGP 版本，而不是 Gradle 版本。

  这行代码配置了 Android Gradle 插件（AGP）的版本，具体来说，是指定项目使用 版本 7.0.2 的 AGP。它告诉 Gradle 在构建过程中需要使用哪个版本的 Android 构建插件来处理 Android 项目的构建任务。

  虽然 classpath 'com.android.tools.build:gradle:7.0.2' 是指定 AGP 版本，但 AGP 版本要求使用特定版本的 Gradle。不同版本的 AGP 对 Gradle 版本有一定的要求。例如：

  • AGP 7.x 需要 Gradle 6.7 或更高版本，通常使用 Gradle 7.x 版本。
  • AGP 4.x 需要 Gradle 5.x 或 6.x 版本。

• gradle/wrapper/gradle-wrapper.properties：

  在 gradle-wrapper.properties 中，distributionUrl 配置的是 Gradle 的版本，即该项目构建时使用的 Gradle 工具的版本，这个版本不要轻易动，除非很熟悉。

  项目使用 Gradle 版本其实对 java sdk 也是有要求的，可以在设置中搜搜 Gradle 更换对应的 java 版本，下面配置的就是当前项目 Gradle 需要的 java jdk 版本。附：Android Gradle 版本对应的 Java JDK

  

• 如果项目下载中报错 Android Studio Plugin id: ‘com.android.application‘, version: ‘8.5.1‘, apply xx 或者什么下载失败，代理问题可以看篇文章。

一、确定项目需要的 java 版本

• 打开 app/build.gradle 文件，搜搜 compileOptions 字段，确定 java 版本 1.8

  compileOptions {
      sourceCompatibility JavaVersion.VERSION_1_8
      targetCompatibility JavaVersion.VERSION_1_8
  }
  

  • 1
  • 2
  • 3
  • 4

  

二、配置项目需要的 java 版本

• 右键项目点击 Open Module Settings 打开 Project Structure 找到 Project

  

• 在 Project 中如果展示的是这样的，说明项目 sdk 没配置好，需要指定 java 1.8 版本，如果本地没有，可以点击下面的 Add SDK -> Download SDK。

  

  

• 选好版本，供应商可以根据自己电脑 cpu 类型选择，带了 aarch64 标识的是 arm 处理器架构的 64 位版本，没有带 aarch64 通常是 x86-64 或 amd64 架构，也就是最常见的 Intel/AMD 64 位处理器架构。

  

  

• 点击下载保存后，可以刷新一下项目，下载成功后下次打开这个弹窗，可能有两种展示结果：

  一种是保持上面现状，可以选择 SDK，但我认为这是还没有设置成功的状态。

  另一种就是下面这种，设置好重新编译成功后，就是这种展示面板。

  

  每次保存操作后都需要 刷新一下项目，或者重启工具也行。

  

三、确定 gradle 版本

• 找到 gradle/wrapper/gradle-wrapper.properties 文件，distributionUrl 配置的就是 Gradle 的版本，可以先去下面路径中确认一下 gradle 版本是否有下载成功：

  • win 路径：c盘/用户/.gradle/wrapper/dists

  • mac 路径：/Users/你的电脑名称/.gradle/wrapper/dists

    

  如果没有下载，可以手动将 distributionUrl 链接拷贝出来，自行下载，然后将下载包丢到这里面解压即可。

  distributionUrl=https://services.gradle.org/distributions/gradle-8.7-bin.zip
  
  拷贝 https://services.gradle.org/distributions/gradle-8.7-bin.zip 用浏览器打开下载，或者迅雷下载都行。
  

  • 1
  • 2
  • 3

  下载后可以先尝试运行，不行在根据上面确认一下 Android Gradle 版本对应的 Java JDK 修改一下对应的 Gradle JDK 版本。附：Android Your build is currently configured to use Java 17.0.11 and Gradle 6.5. 错误解决方案。

• 到这主要的项目初始化问题应该就差不多了，其他更多的是各自代码问题了。

  附：Android NDK at xxx/sdk/ndk-bundle did not have a source.properties file