開発ツールの設定 set-up-development-tools
Adobe Experience Manager（AEM）開発では、最小限の開発ツールセットを開発者マシンにインストールして設定する必要があります。これらのツールは、AEM プロジェクトの開発と作成をサポートします。
~ は、ユーザーのディレクトリの略記法として使用されます。Windows では、これは %HOMEPATH% に相当します。
Java のインストール
Experience Manager は Java アプリケーションなので、開発と AEM as a Cloud Service SDK をサポートするには Java SDK が必要です。
- 最新リリースの Java 11 SDK をダウンロードしてインストールする
- 次のコマンドを実行して、Oracle Java 11 SDK がインストールされていることを確認します。
| code language-shell |
|---|
|
| code language-shell |
|---|
|
| code language-shell |
|---|
|
Homebrew のインストール
Homebrew の使用は必須ではありませんが、推奨されます。
Homebrew は、macOS、Windows および Linux 用のオープンソースパッケージマネージャーです。 すべてのサポートツールを個別にインストールできます。Homebrew では、Experience Manager 開発に必要な各種の開発ツールを簡単にインストールおよび更新できます。
- ターミナルを開く
- 次のコマンドを実行して、Homebrew が既にインストールされているかどうかを確認します。
brew --version - Homebrew がインストールされていない場合は、Homebrew をインストールします。
macOS で Homebrew を使用する場合、Xcode またはコマンドラインツールが必要です。このツールは次のコマンドでインストールできます。
| code language-shell |
|---|
|
- 次のコマンドを実行して、Homebrew がインストールされていることを確認します。
brew --version
Homebrew を使用している場合は、以下の Homebrew を使用してインストール の節の手順を参照してください。 Homebrew を使用して いない 場合は、OS 専用のリンクを使用してツールをインストールします。
Git のインストール
Git は Adobe Cloud Manager で使用されるソース管理システムで、開発に必要となります。
-
ターミナル／コマンドプロンプトを開きます。
-
次のコマンドを実行します。
$ brew install git -
次のコマンドを使用して、Git がインストールされていることを確認します。
$ git --version
-
ターミナル／コマンドプロンプトを開きます。
-
次のコマンドを使用して、Git がインストールされていることを確認します。
$ git --version
Node.js （および npm）のインストール node-js
Node.js は、AEM プロジェクトの ui.frontend サブプロジェクトのフロントエンドアセットを操作するために使用される JavaScript ランタイム環境です。Node.js は npm と一緒に配布される、事実上の Node.js パッケージマネージャーで、JavaScript の依存関係の管理に使用されます。
-
ターミナル／コマンドプロンプトを開きます。
-
次のコマンドを実行します。
$ brew install node -
次のコマンドを使用して、Node.js がインストールされていることを確認します。
$ node -v -
次のコマンドを使用して、npm がインストールされていることを確認します。
$ npm -v
-
ターミナル／コマンドプロンプトを開きます。
-
次のコマンドを使用して、Node.js がインストールされていることを確認します。
$ node -v -
次のコマンドを使用して、npm がインストールされていることを確認します。
$ npm -v
Maven のインストール
Apache Maven は、AEM プロジェクトの Maven アーキタイプから生成された AEM プロジェクトを作成するために使用される、オープンソースの Java コマンドラインツールです。 すべての主要な IDE（IntelliJ IDEA、Visual Studio Code、Eclipse など ）に、Maven のサポートが統合されています。
-
ターミナル／コマンドプロンプトを開きます。
-
次のコマンドを実行します。
$ brew install maven -
次のコマンドを使用して、Maven がインストールされていることを確認します。
$ mvn -v
-
ターミナル／コマンドプロンプトを開きます。
-
Maven がインストールされていることを次のコマンドを使用して確認します。
$ mvn -v
Adobe I/O CLI の設定 aio-cli
Adobe I/O CLI（aio）を使用すると、Cloud Manager や Asset Compute などの、様々な Adobe サービスにコマンドラインでアクセスできます。Adobe I/O CLI は、AEM as a Cloud Service での開発において不可欠な役割を果たし、開発者に次の機能を提供します。
- AEM as a Cloud Services サービスからのログの確認
- CLI からの Cloud Manager パイプラインの管理
- AEM の迅速な開発環境へのデプロイ
Adobe I/O CLI のインストール
- Adobe I/O CLI は npm モジュールであるため、Node.js がインストールされていることを確認します。
node --versionを実行して確認する
npm install -g @adobe/aio-cliを実行してaionpm モジュールをグローバルにインストールする
Adobe I/O CLI Cloud Manager プラグインの設定 aio-cloud-manager
Adobe I/O Cloud Manager プラグインを使用すると、aio CLI で aio cloudmanager コマンドを通じて Adobe Cloud Manager とやり取りできます。
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 統合を作成し、正常に認証するために資格情報を取得する必要があります。
-
console.adobe.io にログインする
-
接続先の Cloud Manager 製品を含む組織が Adobe 組織スイッチャーでアクティブになっていることを確認する
-
既存の Adobe I/O プログラムを開くまたは新規作成する
- Adobe I/O コンソールプロジェクトは統合を組織的にグループ化したものであり、統合を管理する方法に基づいて、プロジェクトを作成または既存のものを使用します。
- 新規プロジェクトを作成する場合は、プロンプトが表示されたら「空のプロジェクト」を選択します（「テンプレートから作成」は選択しない）。
- Adobe I/O コンソールプログラムは、Cloud Manager プログラムと概念が異なります。
-
新しい Cloud Manager API 統合を作成する
- 非推奨の「サービスアカウント (JWT)」認証タイプを選択します（現時点では、CLI で OAuth がサポートされていません）。
- キーを作成またはアップロードします。
- 「開発者 - Cloud Service」製品プロファイルを選択します
-
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" ] } -
config.jsonファイルを Adobe I/O CLI に読み込む$ aio config:set ims.contexts.aio-cli-plugin-cloudmanager ./path/to/config.json --file --json
-
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 の迅速な開発環境とやり取りできるようになります。
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 ワーカーを生成および実行できます。
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 インスタンスと同期します。