4. Android Studio 与插件配置：安装指定版本 Studio 及 Compose 相关插件

JetBrains 的 Compose Multiplatform 和 Google 的 Jetpack Compose 都对 IDE 版本和 Kotlin 编译器有严格的版本绑定。本章围绕“为什么必须锁定版本来配置环境”这一原理，讲解如何下载指定版本的 Android Studio、安装并验证 Compose 相关插件，以及在配置过程中常见的问题排查方法。

4.1 版本依赖原理

Compose 编译器插件（org.jetbrains.kotlin.plugin.compose 或 androidx.compose.compiler）与 Kotlin 编译器内部约定（如 IR 后端）深度耦合。Kotlin 版本升级会改变编译器内部的数据结构，因此 Compose 插件必须与 Kotlin 版本一一对应。Android Studio 内置的 Kotlin 插件版本决定了 IDE 能够识别的 Compose 代码提示、预览渲染和代码补全。

4.2 实现流程：安装指定版本 Studio

本流程覆盖从下载、安装到首次启动验证的完整步骤，确保 IDE 版本与 Compose 课程环境一致。

1. 清除旧版本：卸载之前安装的 Android Studio，确保不残留旧版配置文件。
   macOS:

   rm -rf /Applications/Android\ Studio.app
   rm -rf ~/Library/Application\ Support/Google/AndroidStudio*
   rm -rf ~/Library/Preferences/Google/AndroidStudio*
   rm -rf ~/Library/Caches/Google/AndroidStudio*

   Windows: 通过“控制面板 → 卸载程序”移除后，手动删除 %USERPROFILE%\.android 和 %APPDATA%\Google 下的 AndroidStudio 相关文件夹。
2. 下载指定版本：访问 Android Studio 归档页面，选择 2024.2.1 (Ladybug) 或 2024.1.2 (Koala) 版本。下载对应操作系统的安装包。
   例如：android-studio-2024.2.1.28-mac_arm.dmg（Apple Silicon）或 android-studio-2024.2.1.28-windows.exe。
3. 安装并跳过初始配置：运行安装程序，安装到默认路径。启动时，IDE 会提示“Import Settings”，选择不导入，使用纯净配置。在首次向导中，选择“Custom”安装类型，确保勾选 Android SDK、Android Virtual Device 和 Performance (Intel HAXM / Apple Hypervisor)。
4. 验证 IDE 版本：打开 Android Studio，进入 Help → About（macOS 为 Android Studio → About Android Studio）。确认 Build Number 符合目标版本。
   

   验证命令（macOS / Linux 终端）：

   # 检查安装路径
   ls /Applications/Android\ Studio.app/Contents/
   # 查看版本信息
   plutil -p /Applications/Android\ Studio.app/Contents/Info.plist | grep CFBundleShortVersionString

   输出应显示 2024.2.1 或对应的 Ladybug 版本号。

4.3 Compose 相关插件安装与验证

除 Android Studio 内置的 Android 支持外，Compose Multiplatform 项目需要额外安装 JetBrains 官方插件。Jetpack Compose 通常使用 Android Studio 自带的支持，无需手动安装额外插件。

4.3.1 插件清单

4.3.2 安装步骤

1. 打开 Android Studio，进入 Settings → Plugins（macOS：Preferences → Plugins）。
2. 在 Marketplace 搜索“Compose Multiplatform”，点击 Install。安装完成后，IDE 会提示重启。
3. 检查 Kotlin 插件版本：进入 Settings → Languages & Frameworks → Kotlin，确认 Kotlin 版本为 2.0.21 或更高（与 Compose 1.7.0+ 兼容）。如果版本过低，将光标移到此处，IDE 会提示更新，或手动在 build.gradle.kts 中指定版本。
4. 验证插件状态：重启后，在项目创建向导中应能看到 Compose Multiplatform → Compose Multiplatform App 模板。
   
   检查要点： 如果模板未出现，说明插件安装失败或版本冲突。此时应检查 Kotlin 插件版本，使用早期版本的 Studio 需要手动降级 Kotlin 插件。

4.4 内联流程图：版本匹配与配置决策

4.5 验证配置：项目创建测试

配置完成后，新建一个空项目来验证环境完整性。

1. 在欢迎界面点击 New Project，选择 Compose Multiplatform App（如果使用 Compose Multiplatform）或 Empty Views Activity（Jetpack Compose 使用 Empty Compose Activity）。
2. Min SDK 设定为 24，Language 选择 Kotlin。
3. 项目打开后，检查 build.gradle.kts 中的 Kotlin 版本和 Compose BOM 版本是否与插件一致。典型配置片段：
   

   plugins {
       alias(libs.plugins.kotlinMultiplatform)
       alias(libs.plugins.composeMultiplatform)
       ...
   }
   kotlin {
       sourceSets {
           androidMain.dependencies {
               implementation(compose.runtime)
               implementation(compose.material3)
               implementation(androidx.compose.ui:ui-tooling-preview)
           }
       }
   }

4. 点击 Sync Now，确保 Gradle 同步成功。如果出现 Unsupported Kotlin plugin version 错误，回到步骤 4.3.2 检查 Kotlin 插件版本。

4.6 常见错误与调试

4.7 性能与稳定性优化

• Gradle JDK 独立配置：在 gradle.properties 中声明 org.gradle.jvmargs=-Xmx2048m 和 org.gradle.caching=true，避免 IDE 与 Gradle 的 JDK 不一致引发编译异常。
• 禁用不必要的插件：在 Settings → Plugins 中禁用未使用的插件（如 Git Integration、TeamCity），减小 IDE 内存占用，提升 Compose 预览的渲染速度。
• Kotlin Daemon 配置：在 ~/.gradle/gradle.properties 中添加 kotlin.daemon.jvmargs=-Xmx1024m，防止 Kotlin 编译器因内存不足而崩溃，尤其在多模块 Compose 项目中。
• 定期清理 IDE 缓存：每月执行一次 File → Invalidate Caches and Restart，清理过期的 Compose 编译器缓存和插件元数据。