Android 老项目新人如何快速入手跑起来

原创已于 2024-11-25 10:56:14 修改 · 1.5k 阅读

16 ·

CC 4.0 BY-SA版权

文章标签：

#android

于 2024-11-14 15:52:39 首次发布

Android 专栏收录该内容

54 篇文章

订阅专栏

零、`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
}

在这里插入图片描述

二、配置项目需要的 `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 用浏览器打开下载，或者迅雷下载都行。
```
下载后可以先尝试运行，不行在根据上面确认一下 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