|

Kotlin Android 环境搭建

作者likuolei

Kotlin Android 环境搭建（2025年中文讲解）

在 Android 开发中使用 Kotlin 是主流选择，因为 Kotlin 是 Google 官方推荐的 Android 开发语言，2025年占 Android 项目 80%+（Google I/O 数据）。Kotlin 提供简洁语法、空安全和协程支持，开发效率比 Java 高 30%。本教程聚焦在 Android Studio 中搭建 Kotlin 开发环境，基于 2025 年最新 Android Studio Koala Feature Drop（2025.1.1） 和 Kotlin 2.0（K2 编译器），适合初学者和开发者。教程覆盖环境配置、项目创建、运行测试和常见问题，参考官方文档、CSDN 和知乎实践。

一、前置要求

  • 操作系统：Windows 10/11、macOS 12+、Linux（Ubuntu 20.04+）。
  • 硬件：16GB RAM（推荐 32GB），10GB 磁盘空间，1920×1080 分辨率。
  • JDK：Android Studio 内置 JetBrains Runtime（基于 OpenJDK 17），或手动安装 JDK 17+。
  • 网络：稳定连接，下载 Android Studio、SDK 和依赖。
  • 2025年建议：
  • 用 Android Studio 2025.1.1（支持 Kotlin 2.0 和 Jetpack Compose）。
  • 优先 KMP（Kotlin Multiplatform）项目，支持 Android/iOS 跨平台。
  • 安装 AI 插件（如 Codeium）提速编码。

二、详细步骤（以 Windows 10/11 为例，macOS/Linux 类似）

以下是分步指南，约 20-40 分钟完成。

步骤 1：下载并安装 Android Studio
  1. 访问官网：
  • 打开 Android Developer 官网：https://developer.android.com/studio
  • 下载 Android Studio Koala Feature Drop（2025.1.1）：
    • Windows：.exe（约 1GB）。
    • macOS：.dmg。
    • Linux：.tar.gz。
  1. 安装：
  • Windows：运行 .exe，勾选“Android Virtual Device”和其他默认组件，安装到 C:\Program Files\Android\Android Studio。
  • macOS：拖动 .dmg 到 Applications 文件夹。
  • Linux：解压 .tar.gz 到 /opt，运行 ./studio.sh。
  1. 首次启动：
  • 打开 Android Studio，选择“Do not import settings”。
  • 接受许可协议，选择主题（浅色/深色）。
  • 运行 Setup Wizard，下载 Android SDK（约 2-5GB，需网络）。
步骤 2：验证 Kotlin 插件
  • 内置支持：Android Studio 自带 Kotlin 插件（版本 2.0.0+），无需手动安装。
  • 检查插件：
  1. 打开 File > Settings（macOS：Android Studio > Preferences）。
  2. 进入 Plugins > Installed，搜索“Kotlin”，确认状态为“Enabled”。
  3. 若缺失，点击 Marketplace，搜索“Kotlin”安装，重启 IDE。
  • 2025年更新：Kotlin 2.0 集成 K2 编译器，速度提升 50%，默认支持 Jetpack Compose。
步骤 3：配置 JDK 和 Android SDK
  1. JDK 配置：
  • Android Studio 内置 JetBrains Runtime（OpenJDK 17），通常无需手动配置。
  • 若需自定义：
    • 下载 JDK 17（https://adoptium.net/）。
    • 配置：File > Project Structure > SDKs > + > JDK，选择路径（如 C:\Program Files\Eclipse Adoptium\jdk-17）。
    • 验证：File > Settings > Appearance & Behavior > System Settings > Android SDK > SDK Tools，确保“Android SDK Build-Tools”选中。
  1. Android SDK 配置：
  • 打开 File > Settings > Appearance & Behavior > System Settings > Android SDK。
  • 选择 SDK Platforms，勾选 Android 15.0（API 35，2025年最新）。
  • 选择 SDK Tools，勾选：
    • Android SDK Build-Tools。
    • Android Emulator。
    • Android SDK Platform-Tools。
  • 点击 Apply 下载（约 1-2GB）。
  1. 验证：
  • 打开 Terminal（IDE 底部），输入：
    bash java -version adb --version
  • 输出示例：openjdk 17.0.8 和 Android Debug Bridge version 1.0.41。
步骤 4：创建第一个 Kotlin Android 项目
  1. 新建项目：
  • 打开 Android Studio，点击 New Project。
  • 选择模板：Empty Activity（适合初学者）。
  • 配置：
    • Name：MyKotlinApp。
    • Package name：com.example.mykotlinapp。
    • Language：Kotlin（默认）。
    • Minimum API：API 24（Android 7.0，覆盖 95%+设备）。
    • Build Configuration Language：Kotlin DSL（build.gradle.kts，推荐）。
  • 点击 Finish，自动生成项目。
  1. 检查 Gradle 配置：
  • 打开 build.gradle.kts (Module :app)，确认 Kotlin 依赖：
    kotlin plugins { id("com.android.application") id("org.jetbrains.kotlin.android") version "2.0.0" } dependencies { implementation("androidx.core:core-ktx:1.13.1") implementation("androidx.appcompat:appcompat:1.7.0") }
  • 点击右上角 Sync Project with Gradle Files（约 1-2 分钟）。
  1. 编写 Kotlin 代码：
  • 打开 app/src/main/java/com/example/mykotlinapp/MainActivity.kt：
    kotlin package com.example.mykotlinapp import android.os.Bundle import android.widget.Button import android.widget.Toast import androidx.appcompat.app.AppCompatActivity class MainActivity : AppCompatActivity() { override fun onCreate(savedInstanceState: Bundle?) { super.onCreate(savedInstanceState) setContentView(R.layout.activity_main) val button: Button = findViewById(R.id.button) button.setOnClickListener { Toast.makeText(this, "Hello, Kotlin Android!", Toast.LENGTH_SHORT).show() } } }
  • 布局文件（res/layout/activity_main.xml）添加按钮：
    xml <Button android:id="@+id/button" android:layout_width="wrap_content" android:layout_height="wrap_content" android:text="Click Me" android:layout_gravity="center" />
步骤 5：运行与测试
  1. 配置模拟器：
  • 点击 Device Manager（右上角手机图标）。
  • 创建虚拟设备：选择 Pixel 7，系统镜像 Android 15 (API 35)，下载并创建。
  1. 运行程序：
  • 选择模拟器或真机（连接 USB，开启开发者模式）。
  • 点击 Run > Run ‘app’（绿色三角按钮）。
  • 输出：模拟器显示按钮，点击弹出 “Hello, Kotlin Android!”。
  1. 验证测试：
  • 在 app/src/test/kotlin 创建单元测试：
    kotlin import org.junit.Test import kotlin.test.assertEquals class ExampleUnitTest { @Test fun addition_isCorrect() { assertEquals(4, 2 + 2) } }
  • 右键 > Run ‘ExampleUnitTest’，确认通过。

三、常见问题与解决

  1. Gradle 同步失败：
  • 原因：网络或配置问题。
  • 解决：
    • 添加国内镜像（settings.gradle.kts）：
      kotlin dependencyResolutionManagement { repositories { maven { url = uri("https://maven.aliyun.com/repository/public") } google() } }
    • File > Invalidate Caches / Restart。
  1. 模拟器卡顿/无法启动：
  • 原因：硬件加速未启用或内存不足。
  • 解决：
    • 启用 HAXM（Intel）或 Hypervisor Framework（macOS）：File > Settings > Appearance & Behavior > System Settings > Android SDK > SDK Tools，安装 HAXM。
    • 增加模拟器内存：Device Manager > Edit > Advanced Settings。
  1. Kotlin 插件未加载：
  • 解决：File > Settings > Plugins，启用 Kotlin，重启。
  1. “No JDK specified”：
  • 解决：File > Project Structure > SDKs，添加 JDK 17。

四、进阶配置（可选）

  1. Jetpack Compose（2025主流 UI 框架）：
  • 新建项目选 Empty Compose Activity。
  • 修改 MainActivity.kt：
    kotlin import androidx.compose.material3.* import androidx.compose.runtime.* @Composable fun Greeting() { var count by remember { mutableStateOf(0) } Button(onClick = { count++ }) { Text("Clicked $count times") } }
  • 添加依赖：implementation("androidx.compose.material3:material3:1.3.0")。
  1. Kotlin Multiplatform (KMP)：
  • 新建 KMP 项目：New Project > Kotlin Multiplatform App。
  • 配置共享代码，适用于 Android/iOS。
  1. AI 插件：
  • 安装 Codeium（File > Settings > Plugins > Marketplace，搜索“Codeium”）。
  • 功能：代码补全、生成测试用例。
  1. 优化 Android Studio：
  • 增加内存：Help > Change Memory Settings，设为 4GB。
  • 启用 Gradle 离线模式：File > Settings > Build, Execution, Deployment > Gradle。

五、学习与实践建议

  • 快速上手：搭建后，练习简单 App（如计数器、To-Do 列表）。
  • 官方资源：
  • Android Developer：https://developer.android.com/kotlin
  • Kotlin 官网：https://kotlinlang.org/docs/android-overview.html
  • 国内资源：
  • B站：搜索“尚硅谷 Kotlin Android”（20+小时免费）。
  • CSDN：搜索“Kotlin Android 教程”。
  • 2025年趋势：
  • Jetpack Compose 占 Android UI 开发 70%，优先学习。
  • KMP 支持跨平台，适合职业开发者。
  • AI 辅助（如 Android Studio 的 Gemini 集成）提速 30%。

六、总结

Kotlin Android 环境搭建的核心是安装 Android Studio 和配置 SDK/JDK，必知 Kotlin 插件和 Gradle 配置，必会创建/运行项目。2025年，Android Studio 2025.1.1 是最佳选择，支持 Kotlin 2.0 和 Compose。搭建约 20-40 分钟，初学者可 1 小时跑通第一个 App。相比 Eclipse，Android Studio 更现代，调试效率高。

如果有具体问题（如 Gradle 报错、Compose 示例）或需 KMP 配置，告诉我，我可以提供代码或调试步骤！

类似文章

发表回复

您的邮箱地址不会被公开。 必填项已用 * 标注