はじめに

対象: 初心者から中級者までの Gradle 開発者

Gradleプラグインの新しいプロジェクトを始めることは恐ろしく見えるかもしれません。幸いなことに、Gradleは強力なインタラクティブなアシスタントを提供します、そのタスクは`init`, このツールは完全で綺麗かつすぐに使えるプロジェクト構造を生成します。このガイドでは、このツールを使って健全なプラグインベースを作成する方法、構造を説明し、そして最初のビルドタスクを実行する方法を示します。

ステップ 1 : プロジェクト アシスタントを起動する

コマンド`gradle init`これは出発点です。これにより、プロジェクトを設定するための質問を一連行うコマンドラインアシスタントが起動されます。

空のフォルダーでターミナルを開き、次のコマンドを実行してください:

gradle init

アシスタントが案内します。Kotlin で書かれた Gradle プラグインの選択肢は次の通りです:

  1. 生成するプロジェクトの種類を選択:選んでください`Gradle plugin`.

  2. 実装言語を選択:選んでください`Kotlin`。

  3. ビルドスクリプトDSLを選択:選んでください`Kotlin`.

  4. プロジェクト名:プロジェクトの名前を入力してください(例:site-baker).

  5. プラグイン ID:あなたのプラグインに一意の識別子を付けてください (例:com.cheroliv.site-baker).

  6. プラグインクラス:実装クラスの名前を指定してください(例:`com.cheroliv.SiteBakerPlugin`).

完了すると、Gradleは完全なファイルツリーを生成します。

初期化プロセスの図
@startuml
start
:Lancer `gradle init`;
:Choisir "Gradle プラグイン";
:Choisir "コトリン" (langage);
:Choisir "コトリン" (DSL);
:Saisir nom, ID, et classe;
:Projet généré;
stop
@enduml

ステップ 2 : 生成された構造を理解する

アシスタントはマルチモジュールのプロジェクト構造を作成し、ルートプロジェクトをプラグインのソースコードから分離します。

.
├── gradle/
│   └── wrapper/
│       ├── gradle-wrapper.jar
│       └── gradle-wrapper.properties
├── gradlew
├── gradlew.bat
├── plugin/
│   ├── build.gradle.kts
│   └── src/
│       ├── main/
│       │   └── kotlin/
│       │       └── com/cheroliv/SiteBakerPlugin.kt
│       ├── test/
│       │   └── kotlin/
│       │       └── com/cheroliv/SiteBakerPluginTest.kt
│       └── functionalTest/
│           └── kotlin/
│               └── com/cheroliv/SiteBakerPluginFunctionalTest.kt
└── settings.gradle.kts

重要なファイルとフォルダー

  • settings.gradle.kts: このルートにあるファイルは、ビルドに含まれるモジュールを定義します。ここでは、サブプロジェクトを含みます。plugin.

[source,kotlin] ---- rootProject.name = "site-baker include("plugin") ----


関連記事