Liferay DXP 7.1にアップグレードするには、インストールとコード（カスタムアプリケーション）を新しいバージョンに移行する必要があります。 このセクションでは、コードをアップグレードする方法を学習します。
アップグレードプロセスの最初のステップは、既存のプラグインのコードをLiferay DXP 7.1のAPIに適合させることです。 LiferayのUpgrade Plannerは、このステップを今まで以上に簡単にします。 コードに影響するLiferay APIの変更を特定し、APIの変更について説明するほか、解決策のステップを示します。 また、ツールは可能な場合に自動修正を提供します。
Liferay DXPが提供する新しい機能を活用するために、既存のプラグインをすぐに最適化したいと思うかもしれませんが、そうすべきではありません。 これらのチュートリアルに従ってプラグインをアップグレードすることをお勧めします。 この方法で、Liferay DXPで可能な限り高速にプラグインを実行させると同時に、後で実装可能な最適化のためのプラグインを準備します。
これらのチュートリアルでは、Liferay Upgrade Plannerの使用を前提としています。 このセクションを実行するには、プランナーをインストールし、アップグレード手順を実行してください。
便宜上、このチュートリアルのセクションでは、コードをマニュアルでアップグレードすることを選択した人向けのドキュメンテーションと手順の概要も参照します。
コードのアップグレード手順は次のとおりです。
-
使用可能なすべての機能を活用するには、以前のプロジェクト環境をLiferay Workspaceの最新バージョンにアップグレードする必要があります。
-
Liferay Workspaceは、Liferayプロジェクトを保持および管理するために構築された、生成された環境です。 ワークスペースを作成/インポートして開始します。
-
既存の7.x Liferay Workspaceがない場合は、作成する必要があります。 既存のワークスペースがある場合は、次の手順にスキップします。
-
既存のLiferay Workspaceをインポートします。 持っていない場合は、前の手順に戻ってください。
-
-
アップグレードするワークスペースの設定でLiferay DXPバージョンを設定します。
-
Liferay DXPバンドルのダウンロード元のバンドルURLを設定します。
-
ターゲットプラットフォームバージョンを設定します。これにより、Liferay DXPリリースに関連付けられた特定のアーティファクトが提供されます。
-
アップグレードするLiferay DXPバンドルをダウンロードします。
-
-
-
プラグインSDKプロジェクトをワークスペースにコピーし、Gradle/Mavenプロジェクトに変換します。
-
既存のプラグインSDKプロジェクトをインポートします。
-
既存のプラグインをワークスペースに移行します。 これには、プラグインをワークスペースに移動し、ワークスペースのビルド環境に変換することが含まれます。
-
-
最も効率的なコードアップグレードエクスペリエンスのために、ワークスペースのビルド環境を最適化します。
-
リポジトリURLを、Liferayの頻繁にアップデートされるCDNリポジトリにアップデートします。
-
Liferay Workspaceの最新機能を活用するには、Workspaceプラグインのバージョンをアップデートしてください。
-
ターゲットプラットフォームを活用しているため、プロジェクトの依存関係バージョンを削除します。
-
-
プロジェクトの依存関係と重大な変更を処理する一般的なアップグレードの問題を修復します。
-
簡単なアップグレードの問題を自動修正します。
-
アップグレードの問題を見つけます。 これらは自動修正できない問題です。重大な変更に関するドキュメンテーションに従って、マニュアルでアップデートできます。
-
アップグレードの問題を解決した後、解決済みとしてマークします。
-
アップグレードの問題を修正したら、問題マーカーを削除します。
-
-
カスタマイゼーションプラグインをアップグレードして、Liferay DXP 7.1にデプロイできるようにします。
-
テーマをアップグレードして、Liferay DXP 7.1にデプロイできるようにします。
-
レイアウトテンプレートをアップグレードして、Liferay DXP 7.1にデプロイできるようにします。
-
-
Liferay DXPのクラスローダーを使用して、アプリケーションサーバーのJNDI APIにアクセスします。
-
Service Builderサービス呼び出しのアップグレード
WARに残っているService Builderロジックの場合、サービスを呼び出すサービストラッカーを実装する必要があります。 OSGiモジュールに分割されたロジックの場合、宣言型サービスを活用できます。
-
Service Builder固有の変更に対応するようにアプリケーションを調整します。
-
Velocityテンプレート使用量は、Liferay DXP 7.1で非推奨になりました。 テンプレートをFreeMarkerに変換する必要があります。
-
-
ポートレットをアップグレードして、Liferay DXP 7.1にデプロイできるようにします。
-
以前のプラグインSDKの
websフォルダにすでに保存されたWebプラグインをアップグレードします。 -
Extプラグインをアップグレードする代わりに、拡張ポイントを活用してみてください。 Extプラグインが必要な場合は、使用していた以前のLiferay PortalインスタンスとLiferay DXP 7.1の間のすべての変更を確認し、Extプラグインをマニュアルで変更して、変更をLiferay DXPにマージする必要があります。
コードのアップグレード手順が完了すると、カスタムアプリケーションはLiferay DXP 7.1\と互換性を持つようになります。