開発ツールの設定 set-up-development-tools

Adobe Experience Manager(AEM)開発では、最小限の開発ツールセットを開発者マシンにインストールして設定する必要があります。これらのツールは、AEM プロジェクトの開発と作成をサポートします。

~ は、ユーザーのディレクトリの略記法として使用されます。Windows では、これは %HOMEPATH% に相当します。

Java のインストール

Experience Manager は Java アプリケーションなので、開発と AEM as a Cloud Service SDK をサポートするには Java SDK が必要です。

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

Java

Homebrew のインストール

Homebrew の使用は必須ではありませんが、推奨されます。

Homebrew は、macOS、Windows および Linux 用のオープンソースパッケージマネージャーです。 すべてのサポートツールを個別にインストールできます。Homebrew では、Experience Manager 開発に必要な各種の開発ツールを簡単にインストールおよび更新できます。

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

macOS で Homebrew を使用する場合、Xcode またはコマンドラインツールが必要です。このツールは次のコマンドでインストールできます。

code language-shell
$ xcode-select --install
Windows
Windows 10 Homebrew をインストール
Linux
Linux で Homebrew をインストール
  1. 次のコマンドを実行して、Homebrew がインストールされていることを確認します。 brew --version

Homebrew

Homebrew を使用している場合は、以下の Homebrew を使用してインストール ​の節の手順を参照してください。 Homebrew を使用して​ いない ​場合は、OS 専用のリンクを使用してツールをインストールします。

Git のインストール

GitAdobe Cloud Manager で使用されるソース管理システムで、開発に必要となります。

Homebrew を使用した Git のインストール
  1. ターミナル/コマンドプロンプトを開きます。

  2. 次のコマンドを実行します。 $ brew install git

  3. 次のコマンドを使用して、Git がインストールされていることを確認します。 $ git --version

Git をダウンロードしてインストールする
  1. Git をダウンロードしてインストールする

  2. ターミナル/コマンドプロンプトを開きます。

  3. 次のコマンドを使用して、Git がインストールされていることを確認します。$ git --version

Git

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

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

Homebrew を使用して Node.js をインストールする
  1. ターミナル/コマンドプロンプトを開きます。

  2. 次のコマンドを実行します。$ brew install node

  3. 次のコマンドを使用して、Node.js がインストールされていることを確認します。$ node -v

  4. 次のコマンドを使用して、npm がインストールされていることを確認します。$ npm -v

Node.js をダウンロードしてインストールする
  1. Node.js をダウンロードしてインストールする

  2. ターミナル/コマンドプロンプトを開きます。

  3. 次のコマンドを使用して、Node.js がインストールされていることを確認します。$ node -v

  4. 次のコマンドを使用して、npm がインストールされていることを確認します。$ npm -v

Node.js と npm

TIP
AEM プロジェクトアーキタイプベースの AEM プロジェクトでは、独立したバージョンの Node.js がビルド時にインストールされます。 ローカル開発システムのバージョンを、AEM Maven プロジェクトのリアクター pom.xml で指定された Node.js バージョンと npm バージョンと同期する(またはそれに近い状態に保つ)ことをお勧めします。
Node.js および npm のビルドバージョンの場所については、AEM プロジェクトのリアクター 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 をダウンロードしてインストールする
  1. Maven のダウンロード

  2. Maven のインストール

  3. ターミナル/コマンドプロンプトを開きます。

  4. Maven がインストールされていることを次のコマンドを使用して確認します。$ mvn -v

Maven

Adobe I/O CLI の設定 aio-cli

Adobe I/O CLIaio)を使用すると、Cloud ManagerAsset Compute などの、様々な Adobe サービスにコマンドラインでアクセスできます。Adobe I/O CLI は、AEM as a Cloud Service での開発において不可欠な役割を果たし、開発者に次の機能を提供します。

  • AEM as a Cloud Services サービスからのログの確認
  • CLI からの Cloud Manager パイプラインの管理
  • AEM の迅速な開発環境へのデプロイ

Adobe I/O CLI のインストール

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

Adobe I/O CLI Cloud Manager プラグインの設定 aio-cloud-manager

Adobe I/O Cloud Manager プラグインを使用すると、aio CLI で aio cloudmanager コマンドを通じて Adobe Cloud Manager とやり取りできます。

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

Adobe I/O CLI 認証の設定

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

  1. console.adobe.io にログインする

  2. 接続先の Cloud Manager 製品を含む組織が Adobe 組織スイッチャーでアクティブになっていることを確認する

  3. 既存の Adobe I/O プログラムを開くまたは新規作成する

    • Adobe I/O コンソールプロジェクトは統合を組織的にグループ化したものであり、統合を管理する方法に基づいて、プロジェクトを作成または既存のものを使用します。
    • 新規プロジェクトを作成する場合は、プロンプトが表示されたら「空のプロジェクト」を選択します(「テンプレートから作成」は選択しない)。
    • Adobe I/O コンソールプログラムは、Cloud Manager プログラムと概念が異なります。
  4. 新しい Cloud Manager API 統合を作成する

    • 非推奨の「サービスアカウント (JWT)」認証タイプを選択します(現時点では、CLI で OAuth がサポートされていません)。
    • キーを作成またはアップロードします。
    • 「開発者 - Cloud Service」製品プロファイルを選択します
  5. Adobe I/O CLI の config.json に入力するために必要なサービスアカウント(JWT)資格情報を取得する

    code language-json
    //config.json
    {
       "client_id": "Client ID from Service Account (JWT) credential",
       "client_secret": "Client Secret from Service Account (JWT) credential",
       "technical_account_id": "Technical Account ID from Service Account (JWT) credential",
       "ims_org_id": "Organization ID from Service Account (JWT) credential",
       "meta_scopes": [
         "ent_cloudmgr_sdk"
       ]
    }
    
  6. config.json ファイルを Adobe I/O CLI に読み込む

    • $ aio config:set ims.contexts.aio-cli-plugin-cloudmanager ./path/to/config.json --file --json
  7. private.key ファイルを Adobe I/O CLI に読み込む

    • $ aio config:set ims.contexts.aio-cli-plugin-cloudmanager.private_key ./path/to/private.key --file

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

AEM の迅速な開発環境プラグインのセットアップ rde

AEM の迅速な開発環境プラグインを使用すると、aio CLI が aio aem:rde コマンドで、AEM as a Cloud Service の迅速な開発環境とやり取りできるようになります。

  1. aio plugins:install @adobe/aio-cli-plugin-aem-rde を実行して、AEM の迅速な開発環境プラグインをインストールします。

Adobe I/O CLI Asset Compute プラグインの設定 aio-asset-compute

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

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

開発用 IDE の設定

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

IntelliJ IDEA

IntelliJ IDEA は、Java 開発用の強力な IDE です。IntelliJ IDEA には、無料の Community 版と商用(有料)の Ultimate 版の 2 種類があります。AEM 開発には無料の Community 版でも十分ですが、Ultimate 版ではさらに拡張された一連の機能を利用できます

Microsoft Visual Studio Code

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

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

Eclipse

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

recommendation-more-help
4859a77c-7971-4ac9-8f5c-4260823c6f69