ドキュメントExperience Cloud KCS

AEMaaCSでのJava バージョン 21へのアップグレードに関する問題 – Assets

最終更新日： 2026年7月9日

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）"と同様に発生しますが、この開始レベルで一致する機能を提供しているアーティファクトはありません。
  • Java バージョンの互換性を必要とするMavenの実行中に、追加のエラーが発生します。

解決策 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
experience-cloud-kcs-help-kbarticles