Liferay Workspaceでのコード作成
Liferay Workspaceは、Liferay開発プロジェクトを作成および管理するための開発者向けツールです。
プロジェクトの作成
Blade CLIを使用すると、事前に作成されたプロジェクトテンプレートを提供することで、Liferay Workspaceでプロジェクトを簡単に作成できます。 または、プロジェクトを手動で作成することもできます。
Blade CLIを使用したプロジェクトの作成
ワークスペース内から、次のコマンドを使用して、実行したい内容に最も近いプロジェクトテンプレートを見つけます。
blade create -l
使用するテンプレートを特定したら、プロジェクトを生成します。 たとえば、MVCポートレットを作成するには、次のコマンドを使用します。
blade create -t mvc-portlet -p com.acme.z3x1.portlet -c MyPortlet myproject-web
これにより、MVCポートレットテンプレート(
-t mvc-portlet
)を使用してプロジェクトが作成され、指定したJavaパッケージにポートレットクラスが生成され(-p com.acme.z3x1.portlet
)、ポートレットクラスの名前が指定され(-c MyPortlet
)、プロジェクトにmyproject-web
という名前が付けられます。
手動でプロジェクトを作成する
プロジェクトの作成にBlade CLIは必要ありません。 必要に応じて、プロジェクトフォルダを手動で作成できます。
ワークスペース内から、プロジェクトを格納するフォルダを作成します。
cd [my project name]
プロジェクトの
build.gradle
スクリプトを作成します。 Liferay Workspaceを使用しているため、ほとんどの場合、必要な依存関係は1つだけです。dependencies { compileOnly group: "com.liferay.portal", name: "release.portal.api" }
プロジェクトのフォルダ構造を作成します。
Liferay DXPで実行するコードを作成するには、それをデプロイするLiferayランタイムが必要です。 したがって、Liferay Workspaceをインストールした後の最初のタスクは、Liferayバンドルをワークスペースに追加することです。
Liferay WorkspaceでThemes Generatorを使用する
Liferay Themes Generatorは、サイトのルック&フィールを変更するためのテーマを作成するためのnode.jsベースのツールです。 これらのプロジェクトは、Liferay Workspaceで管理することもできます。 テーマプロジェクトは、Bladeを使用するか手動で作成できます。
Bladeを使用してTheme Generatorプロジェクトを作成するには、次のコマンドを使用します。
blade create -t js-theme [project-name]
これにより、Node.JSとyo
がダウンロードされ、yo liferay-theme
が実行されます。
ワークスペースの外部で作成するのと同じ方法で、ワークスペースでテーマプロジェクトを作成することもできます。
Themes Generatorをインストールしたと仮定して、Liferay Workspaceに移動します。 他のプロジェクトと同様に、テーマプロジェクトはどこにでも配置できます。 次のコマンドを実行して、テーマプロジェクトを作成します。
yo liferay-theme
新しいテーマフォルダに移動して実行します
../gradlew build
上記のコマンドは、ワークスペースのルートから1つ下のフォルダにいることを前提としています。プロジェクトを(おそらく
themes
フォルダで)ネストした場合は、それに応じてgradlew
の呼び出しを調整します。 このコマンドは、LiferayのノードGradleプラグインを使用してフロントエンドテーマを構築します。
Workspaceがプロジェクトを認識していることを確認するには、次のコマンドを使用してすべてのプロジェクトを表示します。
./gradlew projects
Liferayバンドルをワークスペースに追加する
ワークスペースは、コードのランタイムのダウンロードとセットアップを自動化します。 サーバーでコードを実行する準備ができたら、ほんの数ステップでダウンロードできます。
対象となるLiferayリリースを見つけます。
DXP: [Liferay Workspace Target Versions] ページに移動し、バンドルURLをクリップボードにコピーします。
CE: releases-cdn.liferay.com/portal を閲覧し、必要なバンドルを見つけて、そのURLをクリップボードにコピーします。
ワークスペースのルートフォルダから
gradle.properties
を開き、バンドルURLプロパティを設定します。liferay.workspace.bundle.url=[paste the URL from your clipboard]
Liferay DXPを使用している場合は、次のプロパティも設定します。
liferay.workspace.bundle.token.download=true liferay.workspace.bundle.token.email.address=[enter the email address registered on liferay.com] liferay.workspace.bundle.token.password=[enter your liferay.com password]
ファイルを保存して閉じます。
バンドルをダウンロードする準備はできましたか。 次のコマンドを実行します。
./gradlew initBundle
または、Bladeの場合は、次のコマンドを実行します。
blade server init
DXPの場合、セキュリティ上の理由から、バンドルのダウンロード後にプロパティファイルからパスワードを削除する必要があります。
Liferay Workspaceを介したコードのデプロイ
上記の手順で追加したLiferayバンドル、またはLiferayを実行しているDockerコンテナにコードをデプロイできます。
Liferayバンドルへのコードのデプロイ
Liferay Workspaceに追加されたバンドルにコードをデプロイするのは簡単です。 プロジェクトフォルダから、次のGradleタスクを実行します。
../gradlew deploy
これにより、WorkspaceルートフォルダのGradleラッパースクリプトが呼び出され、ワークスペースに追加されたLiferayバンドルにプロジェクトがデプロイされます。
Liferay Dockerコンテナへのコードのデプロイ
すでにLiferay Dockerコンテナを作成している場合は、ローカルバンドルにデプロイするのと同じくらい簡単にデプロイできます。 同じGradleタスクを実行します。
../gradlew deploy