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

卡尔特斯
895 阅读3分钟

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

image.png

  • 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

    image.png

  • 如果项目下载中报错 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
}

    iShot_2024-11-14_11.05.06.png

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

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

    iShot_2024-11-14_11.01.58.png

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

    image.png

    image.png

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

    image.png

    image.png

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

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

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

    image.png

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

    image.png

三、确定 gradle 版本

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

    • win 路径：c盘/用户/.gradle/wrapper/dists
    • mac 路径：/Users/你的电脑名称/.gradle/wrapper/dists

    image.png

    如果没有下载，可以手动将 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

avatar
文章
阅读
粉丝