ドキュメント

AEMaaCS で Java バージョン 21 にアップグレードする際に問題が発生する – Assets

Last update: Thu Mar 20 2025 00:00:00 GMT+0000 (Coordinated Universal Time)

AEMaaCS 用に Java バージョン 21 にアップグレードしようとすると（Assetsの問題とビルドエラーが発生する）、バンドル設定の確認、依存関係の互換性の確認、ビルド設定の更新、Maven JDK バージョンの設定、検証テストの実行が行われます。

説明 description

環境

Adobe Experience Manager as a Cloud Service - Assets（AEMaaCS - Assets）

問題

Adobe Experience Manager（AEM）as a Cloud Service - Assetsの Java バージョン 21 にアップグレードしようとすると、ビルドエラーが発生します。

  • OSGi 実行環境要件がないことを示すエラーメッセージを含むビルド失敗。
  • 特定のエラーは、開始レベル 20 では osgi.ee; filter:="（osgi.ee=UNKNOWN）" （ただし、この開始レベルで一致する機能を提供しているアーティファクトはありません のようになります。
  • Maven の実行中に追加エラーが発生し、Java バージョンの互換性が必要になる。

解決策 resolution

Java バージョン 21 へのアップグレード時に発生した問題を解決するには、次の手順に従います。

  1. 起動に失敗したバンドルの MANIFEST.MF ファイルを調べます。

    • Bundle-RequiredExecutionEnvironment ヘッダーが有効な Java 実行環境を指定していることを確認します（例：JavaSE-11）。 UNKNOWN と表示される場合は、設定の誤りやバンドルの破損が考えられます。

  2. 推移的な依存関係を含むすべての依存関係に、Java バージョン 21 との互換性があることを確認します。

    • Java をアップグレードすると、サードパーティのライブラリやフレームワークで互換性の問題が発生する可能性があります。それに応じてすべての依存関係が更新されていることを確認してください。

  3. ビルド設定ツール（例：Maven、Gradle）で Java バージョン 21 と整合した正しい設定が確認されていること。

    • 必要に応じてデプロイメントスクリプトを更新し、Java バージョンまたは OSGi コンテナ設定の変更を反映させます。

  4. パイプラインで使用される Git リポジトリーブランチに .cloudmanager/java-version ファイルを作成します。

    • 21 のみを含むように、このファイルを編集します。 これにより、ビルドプロセス中にOracle Java 21 が使用されます。

  5. ブランチを設定し、設定を更新した後、設定済みのブランチを使用してCloud Manager開発パイプラインを通じて検証テストを実行します。

これらの手順に従うと、OSGi 環境や Maven 設定に関連するビルドエラーを引き起こすことなく、Java バージョン 21 で使用するAEM環境を正常にアップグレードし設定できます。

recommendation-more-help
3d58f420-19b5-47a0-a122-5c9dab55ec7f