Liferay Workspaceは、お使いのLiferayプロジェクトを保持し管理するために構築されている、生成された環境です。 さまざまなビルドスクリプトと設定されたプロパティを提供することにより、Liferayプロジェクトの管理を支援することを目的としています。
Liferay Workspaceは、コード移行向けに推奨された環境です。そのため、このセクションで想定される開発環境になります。
ワークスペースのセットアップに進みます。
Liferay Workspaceのセットアップ
カスタムアプリケーションのアップグレードを開始する前に、ワークスペース開発環境をセットアップする必要があります。 既存のワークスペースがない場合は、作成する手順に従ってください。 既存のワークスペースがある場合は、Upgrade Plannerにインポートする手順に従ってください。
新しいLiferay Workspaceの作成
Upgrade Plannerでこのステップを開始すると、Liferay Workspaceプロジェクトウィザードがロードされます。
-
新しいワークスペースに名前を付けます。
-
ワークスペース環境と今後のLiferayプロジェクトに適したビルドタイプ（GradleまたはMaven）を選択します。
-
完了をクリックします。
これで、Upgrade Plannerで新しいLiferay Workspaceが利用可能になりました。
Liferay Workspaceをプランナー以外で作成する方法の詳細については、Creating a Liferay Workspaceセクションを参照してください。
既存のLiferay Workspaceのインポート
既存の7.x Liferay Workspaceが既にある場合は、プランナーにインポートする必要があります。 この手順を開始すると、既存のワークスペースを選択するためのFile Explorer/Managerが表示されます。 選択すると、ワークスペースがProject Explorerにインポートされます。
お使いのIDEにワークスペースをインポートする方法の詳細については、こちらの記事をご覧ください。
Liferay Workspaceの設定方法
アップグレードするLiferay DXPバージョンでワークスペースを構成する必要があります。 ワークスペースに関する以下の項目を確認してください。
- バンドルURL
- ターゲットプラットフォームバージョン
バンドルURLバージョンとターゲットプラットフォームバージョンは一致する必要があります。
これらの手順に沿って実行してください。
バンドルURLの設定方法
バンドルURLは、ワークスペースでダウンロードするLiferay DXPバージョンを指示します。 このステップを開始すると、ワークスペースのバンドルURLプロパティがLiferay DXP 7.1の最新リリースにアップデートされます。
ワークスペースのバンドルURLの設定方法については、記事Adding a Liferay Bundle to Liferay Workspaceで詳細をご覧ください 。
ターゲットプラットフォームバージョンの設定方法
ターゲットプラットフォームは、ワークスペースで開発するLiferay DXPバージョンです。 これは、特定のリリースに関連付けられた依存関係を指定するために使用されます。 ターゲットプラットフォームを設定して依存関係を定義すると、ワークスペースが設定された規定のLiferay DXPバージョンに基づいて、依存関係バージョンを自動的に割り当てます。 この手順を開始すると、ワークスペースのターゲットプラットフォームプロパティがLiferay DXP 7.1の最新リリースにアップデートされます。
詳細については、記事Managing the Target Platformをご覧ください。
サーバーバンドルの初期化
アップグレードするLiferay DXPバージョン用にワークスペースを構成したら、サーバーバンドルを初期化できます。 これには、バンドルのダウンロードとそのフォルダへ展開することが含まれます（例: bundles）。 既存のワークスペースに古いLiferayバンドルが既に装備されている場合、古いバンドルが削除され、新しいバンドルが初期化されます。
コードをマニュアルでアップグレードして開発スタジオで作業している場合は、ワークスペースプロジェクトを右クリックしてLiferay→Initialize Server Bundleを選択することで、これを行うことができます。 IntelliJを使用している場合は、記事Installing a Server in IntelliJをご覧ください。 コマンドラインを介してこれを行う方法については、記事Managing Your Liferay Server with Blade CLIを参照してください。