開発ツールの設定

Adobe Experience Manager(AEM)の開発では、開発者マシンに最低限の開発ツールのセットをインストールして設定する必要があります。 これらのツールは、AEM Projectsの開発と構築をサポートします。

~は、ユーザーのディレクトリの略記法として使用されます。 Windowsの場合、%HOMEPATH%と同じです。

Javaのインストール

Experience ManagerはJavaCloud Serviceです。したがって、開発をサポートするにはJava SDKが必要で、AEM as a Application SDKとして必要です。

  1. 最新リリースのJava 11 SDKをダウンロードしてインストールする
  2. 次のコマンドを実行して、Java 11 SDKがインストールされていることを確認します。
    • Windows:java -version
    • macOS/Linux:java --version

Java

Homebrewのインストール

Homebrewの使用は任意ですが、推奨されます。

Homebrewは、macOS、Windows、Linux用のオープンソースパッケージマネージャーです。 すべてのサポートツールを個別にインストールできます。Homebrewは、Experience Manager開発に必要な様々な開発ツールをインストールおよび更新する便利な方法を提供します。

  1. ターミナルを開く
  2. 次のコマンドを実行して、Homebrewが既にインストールされているかどうかを確認します。brew --version.
  3. Homebrewがインストールされていない場合は、Homebrewをインストールします。
  4. 次のコマンドを実行して、Homebrewがインストールされていることを確認します。brew --version

Homebrew

Homebrewを使用している場合は、以下のセクションの​Homebrew​を使用してインストールする手順に従ってください。 Homebrewを使用して​____​しない場合は、OS固有のリンクを使用してツールをインストールします。

Gitのインストール

🔗 Gitは、AdobeCloud Managerで使用されるソース管理システムなので、開発に必要です。

  • Homebrewを使用したGitのインストール
    1. ターミナル/コマンドプロンプトを開きます。
    2. 次のコマンドを実行します。brew install git
    3. 次のコマンドを使用して、Gitがインストールされていることを確認します。git --version
  • または、Git(macOS、LinuxまたはWindows)をダウンロードしてインストールします。
    1. Gitをダウンロードしてインストールする
    2. ターミナル/コマンドプロンプトを開きます。
    3. 次のコマンドを使用して、Gitがインストールされていることを確認します。git --version

Git

Node.js(およびnpm)のインストール

Node. jsは、AEMプロジェクトの ui.frontendsub-projectのフロントエンドアセットを操作するために使用されるJavaScriptランタイム環境 です。Node.jsはnpmと共に配布され、JavaScriptの依存関係の管理に使用される事実上のNode.jsパッケージマネージャーです。

  • Homebrewを使用したNode.jsのインストール
    1. ターミナル/コマンドプロンプトを開きます。
    2. 次のコマンドを実行します。brew install node
    3. 次のコマンドを使用して、Node.jsがインストールされていることを確認します。node -v
    4. 次のコマンドを使用して、npmがインストールされていることを確認します。npm -v
  • または、Node.js(macOS、LinuxまたはWindows)をダウンロードしてインストールします。
    1. Node.jsのダウンロードとインストール
    2. ターミナル/コマンドプロンプトを開きます。
    3. 次のコマンドを使用して、Node.jsがインストールされていることを確認します。node -v
    4. 次のコマンドを使用して、npmがインストールされていることを確認します。npm -v

Node.jsとnpm

ヒント

AEMプロジェクトアーキタイプベースのAEMプロジェクトでは、ビルド時に分離バージョンのNode.jsがインストールされます。AEM MavenプロジェクトのReactor pom.xmlで指定されているNode.jsとnpmのバージョンを、ローカル開発システムのバージョンと同期(または近い)に保つことをお勧めします。

Node.jsとnpmのビルドバージョンの場所については、この例AEM Project Reactor pom.xmlを参照してください。

Mavenのインストール

Apache Mavenは、AEMプロジェクトMavenアーキタイプから生成されたAEMプロジェクトを構築するために使用されるオープンソースJavaコマンドラインツールです。 主要なIDE(IntelliJ IDEAVisual Studio CodeEclipseなど) 統合Mavenサポートを持っている。

  • Homebrewを使用したMavenのインストール
    1. ターミナル/コマンドプロンプトを開きます。
    2. 次のコマンドを実行します。brew install maven
    3. 次のコマンドを使用して、Mavenがインストールされていることを確認します。mvn -v
  • または、Maven(macOS、LinuxまたはWindows)をダウンロードしてインストールします。
    1. Mavenのダウンロード
    2. Mavenのインストール
    3. ターミナル/コマンドプロンプトを開きます。
    4. 次のコマンドを使用して、Mavenがインストールされていることを確認します。mvn -v

Maven

Adobe I/OCLIの設定

Adobe I/OCLI(aio)は、Cloud ManagerAsset computeなど、様々なAdobe サービスに対するコマンドラインアクセスを提供します。 Adobe I/OCLIは、開発者に次の機能を提供するので、Cloud ServiceとしてAEMの開発に不可欠です。

  • AEM as a Cloud Servicesサービスからのテールログ
  • CLIからのCloud Managerパイプラインの管理

Adobe I/OCLI

  1. Node.jsがインストールされていることを確認します。Adobe I/OCLIはnpmモジュールです。
    • node --versionを実行して確定
  2. npm install -g @adobe/aio-cliを実行して、aio npmモジュールをグローバルにインストールします。

Adobe I/OCLI Cloud Managerプラグインの設定

Adobe I/OCloud Managerプラグインを使用すると、aio CLIはaio cloudmanagerコマンドを使用してAdobeCloud Managerとやり取りできます。

  1. aio plugins:install @adobe/aio-cli-plugin-cloudmanagerを実行して、aio Cloud Managerプラグインをインストールします。

Adobe I/OCLIAsset computeプラグインの設定

Adobe I/OCloud Managerプラグインを使用すると、aio CLIでaio asset-computeコマンドを使用してAsset computeワーカーを生成し、実行できます。

  1. aio plugins:install @adobe/aio-cli-plugin-asset-computeを実行して、aioAsset computeプラグインをインストールします。

Adobe I/OCLI認証の設定

Adobe I/OCLIとCloud Managerとの通信を行うには、Adobe I/OコンソールでCloud Manager統合を作成し、認証を正常におこなうために資格情報を取得する必要があります。

  1. console.adobe.ioにログインします。
  2. Adobe組織切り替えボタンで、接続先のCloud Manager製品を含む組織がアクティブになっていることを確認します。
  3. 新しいAdobe I/Oプログラムを作成するか、既存のを開きます。
    • Adobe I/Oコンソールプログラムは、統合の管理方法に基づいて、統合、作成または使用および既存のプログラムの単なる組織的なグループです
    • 新しいプロジェクトを作成する場合は、「空のプロジェクト」を選択します(「テンプレートから作成」)
    • Adobe I/Oコンソールプログラムは、Cloud Managerプログラムとは異なる概念です
  4. 「開発者 —Cloud Service」プロファイルを使用した、新しいCloud Manager API統合の作成
  5. Adobe I/OCLIのconfig.jsonに入力する必要があるサービスアカウント(JWT)資格情報を取得します
  6. config.jsonファイルをAdobe I/OCLIに読み込む
    • $ aio config:set ims.contexts.aio-cli-plugin-cloudmanager PATH_TO_CONFIG_JSON_FILE --file --json
  7. private.keyファイルをAdobe I/OCLIに読み込む
    • $ aio config:set ims.contexts.aio-cli-plugin-cloudmanager.private_key PATH_TO_PRIVATE_KEY_FILE --file

Adobe I/OCLIを使用して、Cloud Managerのコマンドの実行を開始します。

開発IDEの設定

AEMの開発は、主にJavaおよびフロントエンド(JavaScript、CSSなど)の開発とXML管理で構成されます。 次に、AEM開発で最も一般的なIDEを示します。

IntelliJ IDEA

IntelliJ IDEA は、Java開発用の強力なIDEです。IntelliJ IDEAは、無料のコミュニティ版と、商用(有料)の究極版の2種類に分かれています。 AEMの開発には無料のコミュニティバージョンで十分ですが、Ultimateのは機能セットを拡張します。

Microsoft Visual Studio Code

Visual Studio Code (VS Code)は、フロントエンド開発者向けの無料のオープンソースツールです。Visual Studio Codeは、Adobeツール​repo​を使用して、AEMとのコンテンツ同期を統合するように設定できます。

Visual Studio Codeは、主にフロントエンドコードを作成するフロントエンド開発者に最適な選択肢です。JavaScript、CSSおよびHTML。 VS Codeは拡張を介してJavaをサポートしていますが、よりJavaに特有の高度な機能の一部が欠落している可能性があります。

Eclipse

Eclipse IDE は、Java開発向けの一般的なIDEで、 AEM Developer Toolsplug-inをサポートし、Adobeが提供する、オーサリング用のIDE内GUIを提供し、JCRコンテンツをローカルAEMインスタンスと同期します。

このページ