kotlin

Kotlin 程式語言

歡迎來到科特林！
它是一種開源靜態類型程式語言，由 JetBrains 和開源貢獻者支援和開發。

一些方便的連結：

• 科特林網站
• 入門指南
• 嘗試科特林
• Kotlin 標準庫
• 問題追蹤器
• Kotlin YouTube 頻道
• 論壇
• Kotlin 博客
• 訂閱 Kotlin YouTube 頻道
• 在 Twitter 上關注 Kotlin
• 公共 Slack 頻道
• TeamCity CI 建置

Kotlin 多平台功能

支援多平台程式設計是 Kotlin 的主要優勢之一。它減少了為不同平台編寫和維護相同程式碼所花費的時間，同時保留了本機程式設計的靈活性和優勢。

• Kotlin Multiplatform Mobile 用於在 Android 和 iOS 之間共用程式碼
• Kotlin 多平台行動裝置入門指南
• Kotlin 多平台優勢
• 在所有平台上共享程式碼
• 在類似平台上共享程式碼

編輯科特林

• Kotlin IntelliJ IDEA 外掛程式（原始碼）
• Kotlin Eclipse 插件
• Kotlin Sublime Text 套件

建造環境需求

此儲存庫使用 Gradle 工具鏈功能從 AdoptOpenJdk 專案中選擇並自動配置所需的 JDK。

或者，仍然可以透過環境變數僅提供所需的 JDK（有關支援的變數名稱，請參閱 gradle.properties）。為了確保 Gradle 僅使用環境變數中的 JDK - 透過傳遞-Porg.gradle.java.installations.auto-detect=false選項（或將其放入$GRADLE_USER_HOME/gradle.properties ）來停用 Gradle 工具鏈自動檢測。

在 Windows 上，您可能需要為儲存庫新增長路徑設定：

 git config core.longpaths true 

大樓

該專案是使用 Gradle 建構的。在 Unix/macOS 上使用以下命令執行 Gradle 來建置專案並執行測試：

 ./gradlew <tasks-and-options>

或在 Windows 上使用下列命令：

 gradlew <tasks-and-options>

在第一個專案配置中，gradle 將下載並設定依賴項

• intellij-core是命令列編譯器的一部分，僅包含必要的 API。
• idea-full是一個完整的 IntelliJ IDEA 社群版，可在插件模組中使用。

這些依賴項非常大，因此根據您的網路連線質量，您可能會面臨獲取它們的逾時。在這種情況下，您可以透過在首次運行時指定以下命令列參數來增加逾時：

 ./gradlew -Dhttp.socketTimeout=60000 -Dhttp.connectionTimeout=60000

重要的 Gradle 任務

• clean - 乾淨的建置結果
• dist - 將編譯器發行版組裝到dist/kotlinc/資料夾中
• install - 建置所有公共工件並將其安裝到本機 Maven 儲存庫中
• coreLibsTest - 建置並執行 stdlib、reflect 和 kotlin-test 測試
• gradlePluginTest - 建置並執行 gradle 插件測試
• compilerTest - 建置並執行所有編譯器測試

若要重現 TeamCity 構建，請使用-Pteamcity=true標誌。本地建置不運行 proguard 並且預設禁用 jar 壓縮。

可選：一些工件（主要是 Maven 插件）是使用 Maven 單獨建置的。詳細資訊請參閱libraries/ReadMe.md。

要建置 Kotlin/Native，請參閱 kotlin-native/README.md。

在 IntelliJ IDEA 中處理項目

建議使用最新發布的Intellij IDEA版本（社群版或旗艦版）。您可以在此下載 IntelliJ IDEA。

複製專案後，透過在「開啟專案」對話方塊中選擇專案目錄將專案匯入 IntelliJ 中。

為了方便地進行編譯器測試，建議使用 Kotlin 編譯器測試助手

依賴驗證

我們在儲存庫中為所有 Gradle 建置啟用了相依性驗證功能。 Gradle 將檢查所用依賴項的雜湊值（md5 和 sha256），並且當本機工件不存在或在 verify-metadata.xml 檔案中列出不同的雜湊值時，建置會失敗並出現Dependency verification failed錯誤。

預計verification-metadata.xml應該只使用修改建置的提交進行更新。有一些關於如何執行此類更新的提示：

• 刪除verification-metadata.xml的components部分，以避免堆積舊的未使用的依賴項。您可以使用以下命令：

 # macOS
sed -i ' ' -e ' /<components>/,/</components>/d ' gradle/verification-metadata.xml
# Linux & Git for Windows
sed -i -e ' /<components>/,/</components>/d ' gradle/verification-metadata.xml

• 使用 Gradle 的--write-verification-metadata指令重新產生依賴項（驗證更新與您的變更相關）

./gradlew --write-verification-metadata sha256,md5 -Pkotlin.native.enabled=true resolveDependencies

resolveDependencies任務解析所有平台的依賴項，包括插件下載的依賴項。

您也可以使用./scripts/update-verification-metadata.sh腳本，其中包含這兩個步驟

記住：

• 如果您要新增工件名稱中提到的作業系統的依賴項（ darwin 、 mac 、 osx 、 linux 、 windows ），請記住將它們新增至implicitDependencies配置或更新resolveDependencies任務（如果需要）。 resolveDependencies應該解決所有依賴關係，包括不同平台的依賴關係。
• 如果您的 Kotlin 專案資料夾中有local.properties文件，請確保它不包含kotlin.native.enabled=false 。否則，純本機依賴項可能不會新增到驗證元資料中。這是因為local.properties優先權高於 Gradle 指令中指定的-Pkotlin.native.enabled=true 。

使用 -dev 版本

我們經常發布-dev版本。

對於-dev版本，您可以使用可用版本清單並包含此 Maven 儲存庫：

maven( " https://maven.pkg.jetbrains.space/kotlin/p/kotlin/bootstrap " )

執照

Kotlin 根據 Apache 授權（版本 2.0）的條款進行分發。有關詳細信息，請參閱許可證資料夾。

貢獻

請務必查看 Kotlin 的貢獻指南，以了解如何協助該專案。