ご覧のページは、お客様の利便性のために一部機械翻訳されています。また、ドキュメントは頻繁に更新が加えられており、翻訳は未完成の部分が含まれることをご了承ください。最新情報は都度公開されておりますため、必ず英語版をご参照ください。翻訳に問題がある場合は、こちらまでご連絡ください。

Blade CLI

Blade CLIは、コマンドラインインターフェイスまたはグラフィカルインストーラーを使用してインストールできます。プロキシの背後にいる場合は、インストールすると、プロキシを介して動作するように構成できます。 Blade CLIは、新しいバージョンがリリースされたときに通知し、CLIからいつでもアップグレードできます。

Liferay DXP 2024.Q2+/Portal GA120+時点で、Liferay は JDK 17 および 21 をサポートしています。これらのバージョンの Java で開発するには、Workspace 10.1.0 以降の Liferay Workspaces を生成できるように Blade 7.0.0 以降がインストールされている必要があります。

CLIのインストール

Blade CLIのインストール方法に関係なく、Java JDKの実装が最初にインストールされていることを確認してください。

CLIからインストールする

LinuxおよびMacオペレーティングシステム用のBlade CLIのインストールは、1行のコマンドです。

curl -L https://raw.githubusercontent.com/liferay/liferay-blade-cli/master/cli/installers/local | sh

インストールが完了すると、Bladeが正常にインストールされましたというメッセージが表示されます。新しいコマンドラインを開き、bladeと入力します。コマンドが見つからないというエラーが出た場合は、 bladeコマンドをパスに追加する必要があります。

グラフィカルインストーラーからインストールする

インストーラーを使用する場合は、最新の Liferay プロジェクト SDK インストーラーをダウンロードして実行してください。

Javaランタイムを選択します。これは自動検出されます。
イントロダクションの後、 ［Next］をクリックします。
インストール中に Liferay Workspace を初期化できます。 Liferay Workspace は、Liferay プロジェクト用のシステム上の環境 (フォルダーのセット) です。今すぐ初期化する場合は、その場所を設定します。
Liferay Workspaceを初期化する場合は、次にLiferay DXPまたはCommunity Editionを選択する必要があります。

製品タイプを選択し、［Next］をクリックします。
Blade CLI をインストールするには、次へをクリックします。

Windows環境では、blade コマンドがパスに自動的に追加されます（Windowsの場合、またはMacおよびLinuxで bash または zsh を使用している場合）。詳細については、 Blade CLI のトラブルシューティングを参照してください。

プロキシの構成

プロキシサーバーの背後にいる場合は、CLIから構成できます。

jpm command --jvmargs "-Dhttp(s).proxyHost=[your proxy host] -Dhttp(s).proxyPort=[your proxy port]" jpm

これで、BladeはインターネットからLiferayサンプルおよびテンプレートにアクセスするときにプロキシサーバーを使用できます。

Blade CLIの更新

Blade CLIを使用すると、更新があるかどうかが確認されます。更新が利用可能な場合は、コマンドが完了すると次のメッセージが表示されます。

Update available 3.9.1 -> 3.9.2
Run `blade update` to install

Bladeを更新するには、次のコマンドを実行します。

blade update

最先端の機能が必要な場合は、オプションで、より頻繁に更新されるスナップショットバージョンに切り替えることができます。

blade update -s

スナップショットのバージョンは不安定になる可能性があるため、自己責任で使用してください。

Bladeコマンド

以下は、使用可能なBladeコマンドの概要です。 blade help [command]と入力すると、CLIでヘルプを利用できます。

コマンド	Description
`convert`	Plugins SDKプラグインプロジェクトをGradleワークスペースプロジェクトに変換します。
`create`	利用可能なテンプレートから新しいLiferayプロジェクトを作成します。
`deploy`	プロジェクトをビルドしてLiferayにデプロイします。
`extension install`	拡張機能をBlade CLIにインストールします。
`extension uninstall`	Blade CLIから拡張機能をアンインストールします。
`gw`	検出された場合、Gradleラッパーを使用してGradleコマンドを実行します（例： `blade gw tasks`）。
`help`	Blade CLIのコマンドに関する情報を提供します。
`init`	新しいLiferay Workspaceを初期化します。
`samples`	サンプルプロジェクトを生成します。
`server init`	Liferay Workspaceの `gradle.properties` ファイルで構成されたLiferayサーバーを初期化します。 `liferay.workspace.bundle.url` プロパティを設定して、サーバーを初期化するように構成します。
`server start`	Liferayサーバーをバックグラウンドで起動します。 `-d` フラグを追加して、サーバーをデバッグモードで起動できます。デバッグモードをカスタマイズするには、`-p`タグを追加してカスタムリモートデバッグポートを設定したり（デフォルトはTomcatの場合は`8000`、WildFlyの場合は`8787`）、ブール値の`-s`タグを追加してデバッガーが接続されるまで起動したサーバーを一時停止するかどうかを設定したりします。
`server stop`	Liferayサーバーを停止します。
`server run`	フォアグラウンドでLiferayサーバーを起動します。詳細は、 `server start` プロパティを参照してください。
`sh`	Liferay DXPに接続し、Gogoコマンドを実行して、出力を返します。たとえば、 `blade sh lb` は、Gogoシェルを使用するすべてのバンドルをリストします。
`update`	Blade CLIを最新バージョンに更新します。
`upgradeProps`	古い `portal-ext.properties` と新しくインストールされた7.xサーバーを分析して、OSGi構成ファイルに移動されたか、製品から削除されたプロパティを表示します。
`watch`	デプロイされたプロジェクトへの変更を監視し、変更が検出されると自動的に再デプロイします。このコマンドは、変更が検出されるたびにプロジェクトを再ビルドしてインストールにコピーするのではなく、参照としてランタイムにインストールします。つまり、Liferay DXPはプロジェクトのキャッシュコピーを作成しないため、プロジェクトのファイルに加えられた変更をすぐに確認できます。 `watch` タスクをキャンセルすると、モジュールは自動的にアンインストールされます。 `blade deploy -w`コマンドは`blade watch`と同様に機能しますが、変更が検出されるたびにプロジェクトを手動で再コンパイルしてデプロイします。これは遅くなりますが、再起動の間、デプロイされたプロジェクトを保持します。
`version`	Blade CLIのバージョン情報を表示します。