AEM プロジェクトアーキタイプ

AEM プロジェクトのアーキタイプは、最小限のベストプラクティスベースの Adobe Experience Manager プロジェクトを独自の AEM プロジェクトの起点として作成します。このアーキタイプを使用する際に指定する必要があるプロパティにより、このプロジェクトのすべての部分の名前を指定し、特定のオプション機能を制御できます。

アーキタイプを使用する理由

AEM プロジェクトのアーキタイプを使用すると、数回のキー操作で、ベストプラクティスベースの AEM プロジェクトを構築するためのパスが設定されます。アーキタイプを使用すると、すべての要素が配置され、結果として生成されるプロジェクトを最小限に抑えながら、AEM の主要機能すべてが実装されることになります。これにより、必要な作業はその上に構築して拡張するだけとなります。

もちろん、成功する AEM プロジェクトには多数の要素がありますが、AEM プロジェクトのアーキタイプを使用すると健全な基盤を構築できるので、あらゆる AEM プロジェクトで強くお勧めします。

はじめに

プロジェクトのアーキタイプを使用すると、AEM での開発を簡単に開始できます。最初の手順にはいくつかの方法があります。

• WKND チュートリアル - アーキタイプの活用方法など、AEM での開発に関する詳しい概要については、「AEM Sites の概要 - WKND チュートリアル」を参照して、アーキタイプを使用した単純なプロジェクトの実装手順を示す実例を確認してください。
• WKND イベントチュートリアル - AEM でのシングルページアプリケーション（SPA）の開発に特に関心がある場合は、専用の WKND イベントチュートリアルを必ずご覧ください。
• ダウンロードして開始しましょう。- 以下の簡単な手順に従うと、GitHub で利用可能な現在のプロジェクトのアーキタイプを簡単にダウンロードして、最初のプロジェクトを作成できます。

アーキタイプを使用して得られる結果

AEM アーキタイプは、次のモジュールで構成されています。

• core：OSGi サービス、リスナー、スケジューラなどのすべてのコア機能、およびサーブレットや要求フィルターなどのコンポーネント関連の Java コードが含まれる Java バンドル。
• it.tests：Java ベースの統合テスト。
• ui.apps：プロジェクトの /apps と /etc の部分（JS および CSS クライアントライブラリ、コンポーネント、テンプレート）が含まれます。
• ui.content：ui.apps モジュールのコンポーネントを使用するサンプルコンテンツが含まれます。
• ui.config：プロジェクトの実行モード固有の OSGi 設定が含まれます。
• ui.frontend.general：（オプション）​一般的な Webpack ベースのフロントエンドビルドモジュールの使用に必要なアーティファクトが含まれます。
• ui.frontend.react：（オプション）​アーキタイプを使用して React に基づく SPA プロジェクトを作成する場合に必要なアーティファクトが含まれます。
• ui.frontend.angular：（オプション）​アーキタイプを使用して Angular に基づく SPA プロジェクトを作成する場合に必要なアーティファクトが含まれます。
• ui.tests：Selenium ベースの UI テストが含まれます。
• all：ベンダー依存関係を含むすべてのコンパイル済みモジュール（バンドルとコンテンツパッケージ）を組み込んだ単一のコンテンツパッケージ。
• analyse：プロジェクトの分析を実行します。この結果、AEM as a Cloud Service にデプロイするための追加の検証が提供されます。

Maven で表される AEM アーキタイプのモジュールは、アプリケーション、コンテンツ、および必要な OSGi バンドルを表すコンテンツページとして AEM にデプロイされます。

アーキタイプの使用方法

アーキタイプを使用するには、最初にプロジェクトを作成し、前述のとおりにローカルファイル構造でモジュールを生成する必要があります。プロジェクト生成の一環として、プロジェクト名、バージョンなど、プロジェクトの多数のプロパティを定義できます。

Maven でプロジェクトを構築すると、AEM にデプロイできるアーティファクト（パッケージおよび OSGi バンドル）が作成されます。追加の Maven コマンドおよびプロファイルを使用して、プロジェクトのアーティファクトを AEM インスタンスにデプロイできます。

プロジェクトの作成

最初に、最も簡単に AEM Eclipse 拡張機能を使用し、新しいプロジェクトウィザードに従って「AEM Sample Multi-Module Project」を選択し、リリースされたバージョンのアーキタイプを使用できます。

もちろん、Maven を直接呼び出すこともできます。

mvn -B archetype:generate \
 -D archetypeGroupId=com.adobe.aem \
 -D archetypeArtifactId=aem-project-archetype \
 -D archetypeVersion=XX \
 -D aemVersion=cloud \
 -D appTitle="My Site" \
 -D appId="mysite" \
 -D groupId="com.mysite" \
 -D frontendModule=general \
 -D includeExamples=n

• XX を、最新の AEM プロジェクトアーキタイプのバージョン番号に設定します。
• AEM as a Cloud Service の場合は、aemVersion=cloud と設定します。
  Adobe Managed Services またはオンプレミスの場合は、aemVersion=6.5.0 と設定します。AEM as a Cloud Service の場合はコアコンポーネントがすぐに使用できる形で提供されているので、コアコンポーネントの依存関係は、非クラウドバージョンの AEM の場合にのみ追加します。
• appTitle="My Site" を調整して、Web サイトのタイトルやコンポーネントグループを定義します。
• appId="mysite" を調整して、Maven アーティファクト ID、コンポーネントフォルダー名、設定フォルダー名、コンテンツフォルダー名、およびクライアントライブラリ名を定義します。
• groupId="com.mysite" を調整して、Maven グループ ID と Java ソースパッケージを定義します。
• 使用可能なプロパティのリストを調べて、調整が必要なプロパティが他にあるかどうかを確認します。

プロパティ

アーキタイプを使用してプロジェクトを作成する場合は、次のプロパティを使用できます。

プロファイル

生成された Maven プロジェクトは、mvn install の実行時に様々なデプロイメントプロファイルをサポートします。

ビルドとインストール

プロジェクトのルートディレクトリで実行するすべてのモジュールを構築するには、次の Maven コマンドを使用します。

mvn clean install

実行中の AEM インスタンスがある場合は、次の Maven コマンドを使用して、プロジェクト全体を構築およびパッケージ化し、AEM にデプロイできます。

mvn clean install -PautoInstallPackage

パブリッシュインスタンスにデプロイするには、次のコマンドを実行します。

mvn clean install -PautoInstallPackagePublish

または、パブリッシュインスタンスにデプロイするには、次のコマンドを実行します。

mvn clean install -PautoInstallPackage -Daem.port=4503

または、オーサーにバンドルのみをデプロイするには、次のコマンドを実行します。

mvn clean install -PautoInstallBundle

親 POM

プロジェクトのルートにある pom.xml（<src-directory>/<project>/pom.xml）は親 POM と呼ばれ、プロジェクトの構造を駆動し、プロジェクトの依存関係と特定のグローバルプロパティを管理します。

グローバルプロジェクトプロパティ

親 POM の <properties> セクションでは、ユーザー名／パスワード、ホスト名／ポートなど、AEM インスタンスにプロジェクトをデプロイする際に重要なグローバルプロパティを定義します。

これらのプロパティは、ローカルの AEM インスタンスにデプロイするために設定されています。これは、開発者が行う最も一般的なビルドです。オーサーインスタンスにデプロイするためのプロパティおよびパブリッシュインスタンスにデプロイするためのプロパティが存在することに注意してください。ここでは AEM インスタンスを認証するための認証も設定されます。デフォルトの admin:admin 認証が使用されています。

これらのプロパティは、より上位の環境にデプロイされる際には上書きされるよう設定されています。そうすることで、POM ファイルを変更する必要がなく、aem.host および sling.password などの変数をコマンドライン引数で上書きできます。

mvn -PautoInstallPackage clean install -Daem.host=production.hostname -Dsling.password=productionpasswd

モジュール構造

親 POM の <modules> セクションは、プロジェクトが構築するモジュールを定義します。デフォルトでは、プロジェクトは以前に定義された標準モジュール（core、ui.apps、ui.content、ui.tests および it.launcher）を構築します。プロジェクトの拡大に合わせて、いつでもモジュールを追加できます。

依存関係

親 POM の <dependencyManagement> セクションは、プロジェクトで使用される API のすべての依存関係とバージョンを定義します。バージョンは親 POM 内で管理する必要があり、コアや ui.apps などのサブモジュールにはバージョン情報を一切含めてはなりません。

Uber-Jar

主要な依存関係の 1 つに AEM Java API Jar があります。これにより、AEM のバージョンに対して、すべての AEM API が単一の依存関係のエントリで含められます。

コアコンポーネント

もちろん、AEM プロジェクトのアーキタイプはコアコンポーネントを活用します。

コアコンポーネントは、デフォルトの実行モードで AEM に自動的にインストールされます。また、サンプルの WKND サイトで使用されます。実稼動実行モード（nosamplecontent）では、コアコンポーネントは使用できません。

そのため、すべてのデプロイメントでコアコンポーネントを使用するには、それらを Maven プロジェクトの一部に組み込むことが推奨されます。

テスト

プロジェクトには 3 つのレベルのテストが含まれており、テストのタイプが異なるので、実行方法も場所も異なります。

• コアでの単体テスト：バンドルに含まれるコードの従来のユニットテストを示しています。テストするには、次のコマンドを実行します。
  • mvn clean test
• サーバーサイド統合テスト：これらのテストは、AEM 環境（AEM サーバー上など）で実行されます。テストするには、次のコマンドを実行します。
  • mvn clean verify -PintegrationTests
• クライアントサイドの Hobbes.js テスト：ブラウザー側の動作を検証する JavaScript ベースのブラウザーサイドテストです。テストするには：
  1. ページの作成時と同様に、ブラウザーに AEM を読み込みます。
  2. ページを開発者モードで開きます。
  3. 左のパネルを開き、「Tests」タブに切り替えます。
  4. 生成された MyName Tests を見つけ、実行します。

次の手順

AEM プロジェクトアーキタイプを構築し、インストールしました。次は何をすればよいでしょうか。アーキタイプは小さいとはいえ、推奨ベストプラクティスに従って設定された、多数の強力な AEM 機能の例で構成されています。これらを使用すれば、プロジェクトで機能をどのように活用できるかがわかります。どのプロジェクトでも、次の作業が必要になる可能性があります。

• 既存のコアコンポーネントを拡張するコンポーネントのカスタマイズ
• テンプレートの追加
• ローカリゼーション構造の適応
• フロントエンドビルドモジュールの詳細