Amper

Amper 是一个项目配置和构建工具。它的目标是提供出色且流畅的用户体验和 IDE 支持。我们相信通过以下方式可以实现这一目标：

提供开发者和 IDE 友好的声明式配置 DSL - 不仅简化初始设置，还能提高可维护性，并让 IDE 可靠地协助自动配置；
捆绑精心策划的兼容工具链和扩展集 - 支持大多数场景，无需寻找兼容插件；
谨慎选择扩展点 - 保持整体配置的心智模型和用户体验的一致性，避免意外执行第三方代码。

本质上，我们旨在实现类似于 JetBrains IDEs 那样经过深思熟虑和充分测试的体验。

我们目前正在关注各个方面，包括项目的构建、打包、发布等配置。然而，在当前阶段，重点主要是配置项目以进行构建。虽然目前的用例是 Kotlin 和 Kotlin Multiplatform，Amper 也支持 Java 和 Swift（作为多平台的要求）。不过，未来这种配置方法也可能适用于其他语言和技术栈。

Amper 既可作为独立的构建工具存在，也可作为现有 Gradle 项目的 Gradle 插件使用。两个版本都提供统一、易用的声明式配置格式。

支持的功能：

创建和运行 JVM、Android、iOS、Linux 和 macOS 应用程序。
创建 Kotlin Multiplatform 库。
运行测试。
混合使用 Kotlin、Java 和 Swift 代码。
在 IntelliJ IDEA 和 Fleet 中为模块文件提供代码辅助。
多模块项目。
使用 Compose Multiplatform。
使用 Compose 多平台资源*。
Gradle 互操作，包括在一个项目中组合 Amper 和 Gradle 模块*。
与 Gradle 版本目录集成*。
兼容 Gradle 的项目布局，便于现有 Gradle 项目平滑迁移*。

* 仅适用于基于 Gradle 的项目

未来方向：

支持更多 Kotlin 和 Kotlin Multiplatform 场景和配置。
更多产品类型和平台，如 watchOS、Windows 等。
平台特定的测试类型，包括 Android 仪器测试。
原生依赖支持，如 CocoaPods、Swift Package Manager。
打包和发布。
构建变体支持。
可扩展性。

快速入门：

设置和使用说明
教程
文档
示例项目
Gradle 迁移指南

问题和反馈

Amper 使用 YouTrack 进行问题跟踪，在那里创建新问题以报告问题或提交想法。

报告问题前，请查看常见问题解答。

您也可以加入 Slack 频道进行讨论，或使用反馈表单分享您的反馈。

如何尝试

有多种方式可以尝试 Amper：

在最新的 IntelliJ IDEA EAP 中，用于 JVM 和 Android 项目（使用说明）。
在最新的 JetBrains Fleet 中，用于 JVM、Android 和多平台项目（使用说明）。
从命令行使用独立的 Amper。
从命令行使用基于 Gradle 的 Amper 来构建基于 Gradle 的 Amper 项目。

示例

基础

这是一个非常基础的 JVM "Hello, World!" 项目：

[图片]

main.kt 和 MyTest.kt 文件只是普通的 Kotlin 文件，没有特别之处。有趣的部分是 module.yaml，它是 Amper 模块配置文件。对于上述项目结构，它只需要：

# 生成一个 JVM 应用程序
product: jvm/app

就这样。Kotlin 和 Java 工具链、测试框架以及其他必要功能都已配置好，可以直接使用。您可以构建它、运行它、编写和运行测试等。有关更详细的信息，请查看完整示例。

[图片]

多平台

现在，让我们看一个包含 Android、iOS 和桌面 JVM 应用的 Compose Multiplatform 项目，在 Fleet 中的项目结构如下：

[图片]

注意 src/ 文件夹如何同时包含 Kotlin 和 Swift 代码。当然，它也可以是 Kotlin 和 Java。另一个需要强调的方面是共享模块，它在 src 文件夹中包含公共代码，在 src@ios 和 src@android 文件夹中包含平台特定代码（了解更多关于项目布局的信息）。

以下是 ios-app/module.yaml 文件的内容：

# 生成一个 iOS 应用程序
product: ios/app

# 依赖共享库模块：
dependencies:
- ../shared

settings:
# 启用 Compose Multiplatform 框架
compose: enabled

这非常直观：它定义了一个 iOS 应用程序，依赖于共享模块，并启用了 Compose Multiplatform 框架。更有趣的例子是 shared/module.yaml：

# 为 JVM、Android 和 iOS 平台生成一个共享库：
product:
  type: lib
  platforms: [jvm, android, iosArm64, iosSimulatorArm64, iosX64]

# 共享 Compose 依赖：
dependencies:
- $compose.foundation: exported
- $compose.material3: exported

# 仅 Android 依赖
dependencies@android:
# Android 特定的 Compose 集成
- androidx.activity:activity-compose:1.7.2: exported
- androidx.appcompat:appcompat:1.6.1: exported

# 仅 iOS 依赖，包括对 CocoaPod 的依赖（尚未实现）
dependencies@ios:
- pod: 'Alamofire'
  version: '~> 2.0.1'

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

# 启用 Compose Multiplatform 框架
compose: enabled

有几点值得一提。首先，注意平台特定的依赖：带有 @<platform> 限定符的部分。平台限定符可以在清单中使用，也可以在文件布局中使用。限定符为特定平台组织代码、依赖和设置。其次，dependencies: 部分不仅允许 Kotlin 和 Maven 依赖，还允许平台特定的包管理器，如 CocoaPods、Swift Package Manager 等。

[图片]

当然，这些示例只展示了 Amper 功能的一小部分。要更深入地了解设计和功能，请查看文档、教程和示例项目。