Android 25（API 25）+ JDK 17 环境搭建

一、环境搭建前置说明

Android 25 对应 Android 7.1.1 系统版本，JDK 17 是长期支持（LTS）版本，二者搭配需注意 Gradle、Android Gradle Plugin（AGP）的版本兼容性。本文将详细讲解环境搭建的完整步骤，帮助开发者快速完成基础开发环境配置。

环境适配说明

组件	推荐版本	备注
JDK	17（LTS）	需配置系统环境变量
Android SDK	API 25 + Build-Tools 25.0.3	需在SDK Manager中安装
Gradle	7.5+	兼容JDK 17和Android 25
Android Gradle Plugin	7.4+	与Gradle版本匹配

二、JDK 17 安装与环境配置

1. 下载JDK 17

推荐从Oracle官网或OpenJDK下载对应系统版本（Windows/macOS/Linux）的JDK 17安装包，选择稳定的LTS版本（如17.0.9）。

2. 安装JDK 17

Windows系统 ：双击下载的安装包，按照安装向导完成操作，记录好安装路径（示例：C:\Program Files\Java\jdk-17.0.9），建议默认路径安装，减少后续配置问题。
macOS/Linux系统 ：将下载的压缩包解压到指定目录（示例：macOS路径/Library/Java/JavaVirtualMachines/jdk-17.jdk，Linux路径/usr/local/jdk-17.0.9），确保目录权限可读写。

3. 配置系统环境变量

Windows系统

右键「此电脑」→「属性」→「高级系统设置」→「环境变量」，打开环境变量配置面板。
新建系统变量 ：
- 变量名：JAVA_HOME
- 变量值：JDK 17 的实际安装路径（如C:\Program Files\Java\jdk-17.0.9）。
编辑Path系统变量 ：
- 点击「新建」，添加%JAVA_HOME%\bin，并将该条目上移至优先级最高位置。
验证配置：打开CMD命令提示符，输入java -version，若输出JDK 17的版本信息（如java version "17.0.9"），则配置成功。

macOS/Linux系统

打开终端，编辑环境配置文件（根据系统shell选择对应文件）：
bash 复制代码
```
# macOS（zsh）
vi ~/.zshrc
# macOS（bash）/Linux
vi ~/.bashrc
```

在文件末尾添加以下配置内容：

bash 复制代码

# 配置JAVA_HOME
export JAVA_HOME=/Library/Java/JavaVirtualMachines/jdk-17.jdk/Contents/Home
# 配置PATH
export PATH=$JAVA_HOME/bin:$PATH

使配置生效：

bash 复制代码

# 对应编辑的配置文件执行
source ~/.zshrc
# 或
source ~/.bashrc

验证配置：终端输入java -version，输出JDK 17版本信息即配置完成。

三、Android 25 开发环境搭建

1. 安装Android Studio

下载最新稳定版Android Studio，运行安装包后，按照向导完成安装，安装过程中勾选「Android SDK」「Android SDK Platform-Tools」「Android Virtual Device」等核心组件，减少后续手动安装步骤。

2. 安装Android 25（API 25）相关组件

打开Android Studio，点击顶部菜单栏「Tools」→「SDK Manager」，进入SDK管理界面。
SDK Platforms标签页 ：
- 勾选「Show Package Details」（显示详细包），找到「Android 7.1.1 (API 25)」；
- 勾选该版本下的「Android SDK Platform 25」「Sources for Android 25」（可选），点击「Apply」开始安装。
SDK Tools标签页 ：
- 勾选「Show Package Details」，找到「Android SDK Build-Tools」；
- 勾选「25.0.3」版本（与Android 25匹配）；
- 确认「Gradle Plugin Version」为7.4+，点击「Apply」完成组件下载安装。

3. 配置项目级build.gradle（适配JDK 17+Android 25）

项目根目录下的build.gradle是全局配置文件，需按以下内容修改，确保版本兼容和依赖下载顺畅：

gradle 复制代码

// Top-level build file where you can add configuration options common to all sub-projects/modules.
ext {
    kotlin_version = '1.8.22' // 统一管理Kotlin版本（按需配置）
    compile_sdk_version = 25 // 对应Android 25
    build_tools_version = "25.0.3"
    min_sdk_version = 16
    target_sdk_version = 25
}

buildscript {
    repositories {
        // 国内镜像加速依赖下载
        maven { url 'https://maven.aliyun.com/repository/google' }
        maven { url 'https://maven.aliyun.com/repository/jcenter' }
        maven { url 'https://maven.aliyun.com/repository/public' }
        google()
        jcenter()
    }
    dependencies {
        classpath "com.android.tools.build:gradle:7.4.2" // AGP版本适配Gradle 7.5+
        classpath "org.jetbrains.kotlin:kotlin-gradle-plugin:$kotlin_version" // 按需配置Kotlin插件
    }
}

allprojects {
    repositories {
        maven { url 'https://maven.aliyun.com/repository/google' }
        maven { url 'https://maven.aliyun.com/repository/jcenter' }
        maven { url 'https://maven.aliyun.com/repository/public' }
        google()
        jcenter()
    }
}

task clean(type: Delete) {
    delete rootProject.buildDir
}

4. 配置模块级build.gradle（app模块）

app模块下的build.gradle是核心业务模块配置文件，需适配JDK 17和Android 25：

gradle 复制代码

apply plugin: 'com.android.application'
// 若使用Kotlin开发，添加以下插件
// apply plugin: 'kotlin-android'

android {
    namespace "com.example.demo" // 替换为自己的项目包名
    compileSdkVersion rootProject.ext.compile_sdk_version
    buildToolsVersion rootProject.ext.build_tools_version

    defaultConfig {
        applicationId "com.example.demo"
        minSdkVersion rootProject.ext.min_sdk_version
        targetSdkVersion rootProject.ext.target_sdk_version
        versionCode 1
        versionName "1.0"

        testInstrumentationRunner "androidx.test.runner.AndroidJUnitRunner"
    }

    // 适配JDK 17编译
    compileOptions {
        sourceCompatibility JavaVersion.VERSION_17
        targetCompatibility JavaVersion.VERSION_17
    }
    // Kotlin项目需添加以下配置
    // kotlinOptions {
    //     jvmTarget = '17'
    // }

    buildTypes {
        release {
            minifyEnabled false
            proguardFiles getDefaultProguardFile('proguard-android-optimize.txt'), 'proguard-rules.pro'
        }
    }
}

dependencies {
    implementation fileTree(dir: 'libs', include: ['*.jar'])
    // 基础依赖库
    implementation 'androidx.appcompat:appcompat:1.6.1'
    implementation 'androidx.constraintlayout:constraintlayout:2.1.4'
    // 测试依赖
    testImplementation 'junit:junit:4.13.2'
    androidTestImplementation 'androidx.test.ext:junit:1.1.5'
    androidTestImplementation 'androidx.test.espresso:espresso-core:3.5.1'
}

四、验证环境是否搭建成功

打开Android Studio，点击「New Project」新建项目，选择「Empty Activity」模板，填写项目名称、包名等信息。
按照上述配置修改项目的build.gradle（项目级+模块级），点击右上角「Sync Now」同步项目。
同步完成后，若没有报错提示，说明基础配置无误。
启动Android模拟器（或连接真机），选择对应设备后点击「Run 'app'」按钮。
若APP能正常安装并启动，显示默认的空白Activity界面，说明Android 25 + JDK 17开发环境搭建完成。

总结

Android 25与JDK 17搭配的核心是版本匹配，需确保Gradle（7.5+）、AGP（7.4+）与二者兼容；
配置国内镜像仓库可有效解决依赖下载慢或失败的问题，是环境搭建的关键优化步骤；
环境变量配置和build.gradle版本统一是基础，验证环节需通过实际运行项目确认配置有效性。