使用 Amper 进行项目配置

Amper 是 JetBrains 开发的新工具，用于帮助配置项目的构建、打包、发布等流程。通过 Amper，您可以减少在构建系统上花费的时间，转而专注于解决实际的业务挑战。

Amper 允许您为 Kotlin 多平台应用（支持 JVM、Android、iOS、macOS 和 Linux）以及兼容所有这些目标平台的多平台库创建配置文件。

Amper 工作原理

Amper 当前采用 Gradle 作为后端引擎，使用 YAML 作为定义项目配置的前端语言。它支持自定义任务、CocoaPods、发布库到 Maven 仓库，以及通过 Gradle 互操作打包桌面应用。

通过 Amper，您可以配置针对特定平台的应用和共享 Kotlin 库。这些内容通过声明式 DSL 在 .yaml 模块清单文件中定义为模块。

该 DSL 的核心概念是 Kotlin 多平台。Amper 让您无需深入理解复杂的 Gradle 概念，即可快速轻松地配置 Kotlin 多平台项目。Amper DSL 提供特殊语法，支持处理多平台配置，包括依赖项、设置等。

以下是一个 Kotlin 多平台共享库的 Amper 清单文件示例，该库可用于 JVM、Android 和 iOS 应用：

product:
  type: lib
  platforms: [ jvm, android, iosArm64, iosSimulatorArm64, iosX64 ]

# 共享的 Compose 多平台依赖：
dependencies:
  - org.jetbrains.compose.foundation:foundation:1.5.0-rc01: exported
  - org.jetbrains.compose.material3:material3:1.5.0-rc01: exported

# 仅 Android 依赖项  
dependencies@android:
  # 与 Activity 集成的 compose
  - androidx.activity:activity-compose:1.7.2: exported
  - androidx.appcompat:appcompat:1.6.1: exported

# 仅 iOS 依赖项（包含 CocoaPod 依赖）
# 注意：CocoaPods 依赖在当前原型中尚未实现
dependencies@ios:
  - pod: 'FirebaseCore'
    version: '~> 6.6'

settings:
  # 启用 Kotlin 序列化
  kotlin:
    serialization: json

  # 启用 Compose 多平台框架
  compose: enabled

product 部分定义项目类型和目标平台列表
dependencies 部分不仅支持 Kotlin 和 Maven 依赖，还支持平台特定的包管理器（如 CocoaPods 和 Swift Package Manager）
@platform 限定符标记平台特定的部分（包括依赖项和设置）

试用 Amper

您可以通过以下方式体验 Amper：

使用 IntelliJ IDEA 2023.3 及更高版本（从 build 233.11555 开始）开发 JVM 和 Android 项目
使用 Gradle 从命令行或 CI/CD 工具构建 Amper 项目

按照本教程创建您的第一个 Kotlin 多平台 Amper 项目。查阅文档了解更多功能和设计细节。

欢迎通过问题追踪系统提交反馈，您的意见将帮助我们塑造 Amper 的未来。

后续步骤

阅读 JetBrains 博客了解 Amper 的开发动机、用例、当前状态和未来规划
查看 Amper 常见问题解答获取热门问题答案
阅读 Amper 文档了解功能与设计的各个方面

22 四月 2025