要点

本篇是 KMP 的条目式速查，按用途分七组：Gradle 插件、kotlin{} 目标与产物、sourceSets 依赖、Gradle 属性、命令行任务、多平台库坐标、语法关键字与互操作注解；文末有全量速查表，可只搜表定位条目。版本基线：Kotlin 2.2 稳定线、Compose Multiplatform 1.8 线（iOS 自 1.8.0 稳定）。依赖一律用 version catalog 声明，不钉版本号。机制讲解不重复：定位与工程结构见开山篇，expect/actual 与源集原理见《KMP 语法要点》，完整工程见《用 Compose Multiplatform 写一个双端待办》。

Gradle 插件组

模块级 build.gradle.kts 的 plugins 块五件套：kotlin(“multiplatform”)（KMP 核心）、com.android.application（library 模块换成 com.android.library）、org.jetbrains.kotlin.plugin.compose、org.jetbrains.compose、kotlin(“plugin.serialization”)。版本全写进根工程 version catalog，模块只引用别名；漏配任何一个，对应块不识别。

kotlin{} 目标与产物组

双端工程的最小 kotlin{} 配置：

kotlin {
    androidTarget()                 // Android 目标；打包细节走 AGP
    iosArm64()                      // iOS 真机
    iosSimulatorArm64()             // Apple Silicon 模拟器（M 系列开发机的主力）
    iosX64()                        // Intel 模拟器（老机器才需要）

    listOf(iosArm64(), iosSimulatorArm64(), iosX64()).forEach { target ->
        target.binaries.framework {         // 给 iOS 侧的产物
            baseName = "ComposeApp"         // Swift 侧 import 的模块名，改了要同步 Xcode
            isStatic = true                 // 静态链接产物小
        }
    }
    jvmToolchain(17)                        // 编译 JDK，与 AGP/系统 JDK 对齐
}

sourceSets 与依赖组

依赖按源集声明——这是 KMP 与单端工程最大的行为差异：commonMain 只能放多平台制品，平台专属依赖必须放平台源集。引擎类依赖（Ktor）是典型：

sourceSets {
    commonMain.dependencies {
        implementation(libs.kotlinx.serialization.json)   // 多平台制品才许进这里
        implementation(libs.ktor.client.core)
    }
    androidMain.dependencies {
        implementation(libs.ktor.client.android)          // 平台引擎放平台源集
    }
    iosMain.dependencies {
        implementation(libs.ktor.client.darwin)           // iOS 侧引擎
    }
}

Gradle 属性组

命令行任务组

多平台库坐标组

语法关键字与互操作注解组

速查表

延伸阅读

expect/actual 与源集机制见KMP 语法要点；配置组合成真实工程的全过程见双端待办实战；串起系列的路径见KMP 学习路线；Kotlin 语言层回Kotlin / Compose 基础知识参考字典。

版本核实（以官方文档为准）：基线为 Kotlin 2.2 稳定线与 Compose Multiplatform 1.8 线（截至 2025-07-08，官方发布页口径）；默认层级模板（Kotlin 1.9.20 起）、embedAndSignAppleFrameworkForXcode 与 XCFramework 任务、DataStore 1.1 与 Room 2.7 起多平台均为官方文档现行内容；各库版本不钉号，以官方发布页为准。