垦荒学园
  • 中文

      • 开发环境搭建

      概述

      本章将指导您搭建Kotlin开发环境，包括JDK安装、IDE配置和项目创建。我们将介绍多种开发环境选项，从简单的在线编辑器到完整的IDE配置。

      系统要求

      最低要求

      • 操作系统: Windows 7+, macOS 10.9+, Linux (任何现代发行版)
      • 内存: 4GB RAM (推荐8GB+)
      • 存储: 2GB可用空间
      • Java: JDK 8或更高版本

      推荐配置

      • 内存: 8GB+ RAM
      • 存储: SSD硬盘
      • Java: JDK 11或17 (LTS版本)

      安装Java开发工具包 (JDK)

      1. 检查现有Java版本

      # 检查Java版本
java -version
javac -version

      2. 安装JDK

      Windows

      1. 访问 Oracle JDK 或 OpenJDK
      2. 下载适合您系统的JDK安装包
      3. 运行安装程序并按照提示完成安装
      4. 配置环境变量：
        • 添加 JAVA_HOME 指向JDK安装目录
        • 将 %JAVA_HOME%\bin 添加到 PATH

      macOS

      # 使用Homebrew安装
brew install openjdk@17

# 或者下载安装包手动安装

      Linux (Ubuntu/Debian)

      # 安装OpenJDK
sudo apt update
sudo apt install openjdk-17-jdk

# 验证安装
java -version

      开发环境选择

      1. IntelliJ IDEA (推荐)

      IntelliJ IDEA是Kotlin的官方IDE，提供最佳的Kotlin开发体验。

      安装步骤

      1. 访问 JetBrains官网
      2. 下载Community版本（免费）或Ultimate版本
      3. 安装并启动IDEA
      4. Kotlin插件已预装，无需额外配置

      创建Kotlin项目

      // 1. File -> New -> Project
// 2. 选择 "Kotlin" -> "Kotlin/JVM"
// 3. 配置项目名称和位置
// 4. 选择项目SDK (JDK)
// 5. 点击 "Finish"

      2. Android Studio

      专为Android开发优化，内置Kotlin支持。

      安装步骤

      1. 访问 Android开发者网站
      2. 下载并安装Android Studio
      3. 首次启动时会自动下载Android SDK

      创建Kotlin Android项目

      // 1. Start a new Android Studio project
// 2. 选择项目模板
// 3. 在语言选项中选择 "Kotlin"
// 4. 配置项目详情
// 5. 点击 "Finish"

      3. Visual Studio Code

      轻量级编辑器，适合简单的Kotlin开发。

      安装步骤

      1. 安装 Visual Studio Code
      2. 安装Kotlin扩展：
        • 打开扩展面板 (Ctrl+Shift+X)
        • 搜索 "Kotlin Language"
        • 安装官方Kotlin扩展

      4. 在线编辑器

      适合快速测试和学习。

      Kotlin Playground

      • 访问: https://play.kotlinlang.org/
      • 无需安装，直接在浏览器中编写和运行Kotlin代码
      • 支持多种目标平台（JVM、JS、Native）

      创建第一个Kotlin项目

      使用IntelliJ IDEA

      1. 创建新项目
      File -> New -> Project -> Kotlin -> Kotlin/JVM
      1. 项目结构
      MyKotlinProject/
├── src/
│   └── main/
│       └── kotlin/
│           └── Main.kt
├── .idea/
├── out/
└── MyKotlinProject.iml
      1. 编写Hello World程序
      // Main.kt
fun main() {
    println("Hello, Kotlin!")
}
      1. 运行程序
      • 点击代码左侧的绿色三角形
      • 或使用快捷键 Ctrl+Shift+F10 (Windows/Linux) 或 Cmd+Shift+R (macOS)

      使用命令行

      1. 创建项目目录
      mkdir my-kotlin-project
cd my-kotlin-project
      1. 创建源文件
      // hello.kt
fun main() {
    println("Hello, Kotlin!")
}
      1. 编译和运行
      # 编译
kotlinc hello.kt -include-runtime -d hello.jar

# 运行
java -jar hello.jar

      构建工具配置

      Gradle (推荐)

      build.gradle.kts (Kotlin DSL)

      plugins {
    kotlin("jvm") version "1.9.10"
    application
}

group = "com.example"
version = "1.0-SNAPSHOT"

repositories {
    mavenCentral()
}

dependencies {
    implementation(kotlin("stdlib"))
    testImplementation(kotlin("test"))
}

tasks.test {
    useJUnitPlatform()
}

kotlin {
    jvmToolchain(17)
}

application {
    mainClass.set("MainKt")
}

      运行Gradle项目

      # 编译
./gradlew build

# 运行
./gradlew run

# 测试
./gradlew test

      Maven

      pom.xml

      <?xml version="1.0" encoding="UTF-8"?>
<project xmlns="http://maven.apache.org/POM/4.0.0"
         xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
         xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 
         http://maven.apache.org/xsd/maven-4.0.0.xsd">
    <modelVersion>4.0.0</modelVersion>

    <groupId>com.example</groupId>
    <artifactId>kotlin-project</artifactId>
    <version>1.0-SNAPSHOT</version>

    <properties>
        <maven.compiler.source>17</maven.compiler.source>
        <maven.compiler.target>17</maven.compiler.target>
        <kotlin.version>1.9.10</kotlin.version>
    </properties>

    <dependencies>
        <dependency>
            <groupId>org.jetbrains.kotlin</groupId>
            <artifactId>kotlin-stdlib</artifactId>
            <version>${kotlin.version}</version>
        </dependency>
    </dependencies>

    <build>
        <sourceDirectory>src/main/kotlin</sourceDirectory>
        <plugins>
            <plugin>
                <groupId>org.jetbrains.kotlin</groupId>
                <artifactId>kotlin-maven-plugin</artifactId>
                <version>${kotlin.version}</version>
                <executions>
                    <execution>
                        <id>compile</id>
                        <phase>compile</phase>
                        <goals>
                            <goal>compile</goal>
                        </goals>
                    </execution>
                </executions>
            </plugin>
        </plugins>
    </build>
</project>

      Android开发环境配置

      1. 安装Android Studio

      按照前面的步骤安装Android Studio。

      2. 配置Android SDK

      // 在Android Studio中：
// Tools -> SDK Manager
// 安装最新的Android SDK和构建工具

      3. 创建Android项目

      // 选择 "Empty Activity"
// 语言选择 "Kotlin"
// API Level 选择 21+ (推荐)

      4. 基本Android Kotlin代码

      // MainActivity.kt
class MainActivity : AppCompatActivity() {
    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        setContentView(R.layout.activity_main)
        
        // Kotlin Android扩展
        val textView = findViewById<TextView>(R.id.textView)
        textView.text = "Hello, Kotlin Android!"
    }
}

      常见问题和解决方案

      1. JDK版本问题

      # 错误: Kotlin需要JDK 8+
# 解决: 升级JDK版本
java -version  # 检查当前版本

      2. 环境变量配置

      # Windows
set JAVA_HOME=C:\Program Files\Java\jdk-17
set PATH=%JAVA_HOME%\bin;%PATH%

# macOS/Linux
export JAVA_HOME=/usr/lib/jvm/java-17-openjdk
export PATH=$JAVA_HOME/bin:$PATH

      3. IDE插件问题

      • 确保Kotlin插件已启用
      • 更新到最新版本
      • 重启IDE

      4. 编译错误

      // 常见错误: 找不到kotlinc命令
// 解决: 安装Kotlin编译器
# 使用SDKMAN
sdk install kotlin

# 使用Homebrew (macOS)
brew install kotlin

      验证安装

      创建并运行以下测试程序来验证环境配置：

      // test.kt
fun main() {
    println("Kotlin version: ${KotlinVersion.CURRENT}")
    println("Java version: ${System.getProperty("java.version")}")
    println("Environment setup successful!")
    
    // 测试基本功能
    val numbers = listOf(1, 2, 3, 4, 5)
    val doubled = numbers.map { it * 2 }
    println("Doubled numbers: $doubled")
}

      下一步

      环境搭建完成后，让我们开始编写第一个Kotlin程序，学习基本语法。

      下一章: 快速上手

      练习题

      1. 在您的系统上安装JDK和IntelliJ IDEA
      2. 创建一个新的Kotlin项目
      3. 编写并运行"Hello World"程序
      4. 尝试使用Kotlin Playground在线编辑器
      5. 配置Gradle构建文件并运行项目