使用 Amper 進行專案配置
Amper 是 JetBrains 創建的一個新工具,旨在協助您配置專案以進行建置、打包、發佈等。透過 Amper,您可以花費更少的時間處理建置系統,而將重心放在解決實際的業務挑戰上。
Amper 允許您為 Kotlin 多平台應用程式建立配置檔案,這些應用程式可在 JVM、Android、iOS、macOS 和 Linux 上運行,也可用於支援所有這些目標平台的多平台函式庫。
Amper 目前為 實驗性質。 歡迎您在 Kotlin 多平台專案中嘗試使用它。 我們將感謝您在 YouTrack 中提供回饋。
Amper 的運作方式
Amper 目前使用 Gradle 作為後端,並使用 YAML 作為定義專案配置的前端。它透過 Gradle 互通性支援自訂任務、CocoaPods、將函式庫發佈到 Maven,以及打包桌面應用程式。
透過 Amper,您可以為特定平台應用程式和共享 Kotlin 函式庫設定配置。它們被宣告為 .yaml
模組清單檔案中的模組,使用特殊的宣告式 DSL。
此 DSL 的核心概念是 Kotlin Multiplatform。Amper 允許您快速輕鬆地配置 Kotlin 多平台專案,而無需深入複雜的 Gradle 概念。Amper DSL 提供一種特殊語法,讓您可以處理多平台配置,包括依賴項、設定等。
以下是一個 Amper 清單檔案的範例,用於 Kotlin 多平台共享函式庫,可與 JVM、Android 和 iOS 應用程式搭配使用:
yaml
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:
# 將 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:
- 在 JVM 和 Android 專案中(從建置版本 233.11555 開始)使用 IntelliJ IDEA 2023.3 及更高版本。
- 使用 Gradle 從命令列或您的 CI/CD 工具建置 Amper 專案。
依照 本教學課程 建立您的第一個 Kotlin 多平台專案。探索 說明文件 以了解更多關於 Amper 的功能和設計。
歡迎隨時向我們的 問題追蹤器 提交任何回饋。您的意見將幫助我們塑造 Amper 的未來。
下一步
- 查看 JetBrains 部落格 以了解更多關於我們創建 Amper 的動機、其使用案例、專案的當前狀態及其未來。
- 查看 Amper 常見問題 以尋找最常見問題的答案。
- 閱讀 Amper 說明文件,其中涵蓋了 Amper 功能和設計的不同方面。