4. 环境搭建与工具链

Baseline Profile 编译与验证过程依赖完整的 Android 开发工具链。错误的版本组合或缺少系统组件会导致配置无法生效、插件报错甚至编译失败。本章按最低要求 → 推荐配置 → 平台差异 → 验证方法的路径梳理环境搭建全流程。

4.1 系统与 SDK 前提

4.2 Android Studio 安装与插件集

除了标准 Android 开发插件外，Baseline Profile 功能还依赖以下内嵌组件：

• App Inspection — 用于本地运行 Profile 验证
• Build Analyzer — 分析编译过程中 Profile 生成错误
• Android SDK Build-Tools 34+ — 提供 profbin 工具

4.3 AGP 与 Gradle 插件配置

在项目级 build.gradle.kts（或 build.gradle）中声明 AGP 版本及 baselineprofile 插件：

// 项目级 build.gradle.kts
plugins {
    id("com.android.application") version "8.5.1" apply false
    id("com.android.library")     version "8.5.1" apply false
    id("org.jetbrains.kotlin.android") version "1.9.22" apply false
}

// 模块级 build.gradle.kts
plugins {
    id("com.android.application")
    id("org.jetbrains.kotlin.android")
    id("androidx.baselineprofile") version "1.2.0" apply true
}

android {
    compileSdk = 34
    ...
}

baselineProfile {
    // 指定生成 Profile 的变体（默认 release）
    variantName = "release"
    // 是否自动注册 Profile 文件到 manifest
    automaticRegistration = true
}

如果使用 Groovy（build.gradle），格式对照如下：

// 项目级 build.gradle
buildscript {
    ext.kotlin_version = '1.9.22'
    repositories {
        google()
        mavenCentral()
    }
    dependencies {
        classpath 'com.android.tools.build:gradle:8.5.1'
        classpath "org.jetbrains.kotlin:kotlin-gradle-plugin:$kotlin_version"
        classpath 'androidx.baselineprofile:baselineprofile-gradle-plugin:1.2.0'
    }
}

// 模块级 build.gradle
plugins {
    id 'com.android.application'
    id 'org.jetbrains.kotlin.android'
    id 'androidx.baselineprofile'
}

android {
    compileSdk 34
    ...
}

baselineProfile {
    variantName = "release"
    automaticRegistration = true
}

4.4 跨平台差异化配置

Baseline Profile 工具链在三个主要桌面系统中的差异集中在 系统工具路径、权限模型 和 adb 可用性 上。

平台环境变量设置示例

# macOS / Linux (bash/zsh)
export ANDROID_HOME=$HOME/Android/Sdk
export PATH=$ANDROID_HOME/tools:$ANDROID_HOME/platform-tools:$PATH

# Windows PowerShell
$env:ANDROID_HOME = "$env:LOCALAPPDATA\Android\Sdk"
$env:Path += ";$env:ANDROID_HOME\tools;$env:ANDROID_HOME\platform-tools"

4.5 工具链关系概览

下图展示从源代码到 Baseline Profile 产物的关键工具层次和交互关系：

4.6 环境验证脚本

运行以下命令快速确认关键组件是否就绪：

# 1. 检查 JDK
java -version

# 2. 检查 adb
adb --version | grep "Android Debug Bridge"

# 3. 检查 Gradle Wrapper
gradle wrapper --version

# 4. 检查 AGP 版本（在项目根目录下执行）
./gradlew properties | grep android.injected.build.density

# 5. 验证 Baseline Profile 插件是否识别
./gradlew tasks | grep baselineProfile

如果最后一步输出中包含 baselineProfile 相关任务（如 generateBaselineProfile、mergeBaselineProfile），则工具链搭建完成。

4.7 常见环境错误排查