コトリンへようこそ!
これは、JetBrains およびオープンソースの貢献者によってサポートおよび開発されている、オープンソースの静的に型付けされたプログラミング言語です。
いくつかの便利なリンク:
マルチプラットフォーム プログラミングのサポートは、Kotlin の重要な利点の 1 つです。ネイティブ プログラミングの柔軟性と利点を維持しながら、さまざまなプラットフォームで同じコードの作成と保守に費やす時間を削減します。
このリポジトリは、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 Community Edition です。これらの依存関係は非常に大きいため、インターネット接続の品質によっては、依存関係を取得する際にタイムアウトが発生する可能性があります。この場合、最初の実行時に次のコマンド ライン パラメータを指定することでタイムアウトを増やすことができます。
./gradlew -Dhttp.socketTimeout=60000 -Dhttp.connectionTimeout=60000
clean
- クリーンなビルド結果dist
- コンパイラのディストリビューションをdist/kotlinc/
フォルダーにアセンブルしますinstall
- すべてのパブリックアーティファクトをビルドしてローカル Maven リポジトリにインストールしますcoreLibsTest
- stdlib、リフレクト、および kotlin-test テストをビルドして実行しますgradlePluginTest
- gradle プラグイン テストを構築して実行するcompilerTest
- すべてのコンパイラ テストをビルドして実行しますTeamCity ビルドを再現するには、 -Pteamcity=true
フラグを使用します。ローカル ビルドでは proguard が実行されず、jar 圧縮がデフォルトで無効になっています。
オプション:一部のアーティファクト (主に Maven プラグインのもの) は、Maven とは別にビルドされます。詳細については、ライブラリ/ReadMe.mdを参照してください。
Kotlin/Native をビルドするには、kotlin-native/README.md を参照してください。
Intellij IDEA の最新リリース バージョン (コミュニティ エディションまたはアルティメット エディション) を使用することをお勧めします。 IntelliJ IDEA はここからダウンロードできます。
プロジェクトのクローンを作成した後、[プロジェクトを開く] ダイアログでプロジェクト ディレクトリを選択して、IntelliJ にプロジェクトをインポートします。
コンパイラー テストを簡単に行うには、Kotlin Compiler Test Helper を使用することをお勧めします。
すべての Gradle ビルドのリポジトリで依存関係検証機能が有効になっています。 Gradle は、使用されている依存関係のハッシュ (md5 および sha256) をチェックし、ローカル アーティファクトが存在しないか、verification-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
--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
さまざまなプラットフォームの依存関係を含むすべての依存関係を解決する必要があります。local.properties
ファイルがある場合は、それにkotlin.native.enabled=false
が含まれていないことを確認してください。そうしないと、ネイティブ専用の依存関係が検証メタデータに追加されない可能性があります。これは、 local.properties
Gradle コマンドで指定された-Pkotlin.native.enabled=true
よりも優先されるためです。 -dev
バージョンを頻繁に公開します。
-dev
バージョンの場合は、利用可能なバージョンのリストを使用し、次の Maven リポジトリを含めることができます。
maven( " https://maven.pkg.jetbrains.space/kotlin/p/kotlin/bootstrap " )
Kotlin は、Apache ライセンス (バージョン 2.0) の条件に基づいて配布されます。詳細については、ライセンス フォルダーを参照してください。
プロジェクトを支援する方法については、Kotlin のコントリビュート ガイドラインを必ず確認してください。