パッケージの操作方法 how-to-work-with-packages

パッケージを使用すると、リポジトリコンテンツの読み込みと書き出しが可能になります。例えば、パッケージを使用して新しい機能をインストールしたり、インスタンス間でコンテンツを転送したり、リポジトリコンテンツをバックアップしたりできます。

パッケージのアクセスや管理は、次のページからおこなえます。

パッケージマネージャー、パッケージ共有、およびファイルシステム間でパッケージを転送できます。

パッケージとは what-are-packages

パッケージとは、リポジトリコンテンツを格納する zip ファイルで、ファイルシステムのシリアル化（「vault」シリアル化と呼ばれる）の形式です。 これにより、ファイルやフォルダーを使いやすく、編集しやすく表示できます。

パッケージには、フィルターを使用して選択された、ページコンテンツとプロジェクト関連のコンテンツの両方のコンテンツが含まれます。

パッケージには、フィルター定義や読み込み設定情報など、コンテナのメタ情報も含まれています。説明、視覚的な画像、アイコンなど、追加のコンテンツプロパティ（パッケージの抽出には使用されない）をパッケージに含めることができます。これらのプロパティは、コンテンツパッケージコンシューマー向けのもので、情報提供だけを目的としています。

パッケージでは、以下の操作を実行できます。

パッケージ情報 package-information

パッケージ定義は、次の様々なタイプの情報で構成されます。

パッケージ設定 package-settings

様々なパッケージ設定を編集して、パッケージの説明、関連するバグ、依存関係、プロバイダー情報などの側面を定義できます。

この パッケージ設定 ダイアログは、 編集 ボタンを 作成中 または 編集中 1 つのパッケージと、3 つのタブで設定できます。 変更がおこなわれたら、 OK をクリックして保存します。

パッケージフィルター package-filters

フィルターは、パッケージに含めるリポジトリノードを識別します。フィルター定義 ​によって、以下の情報が指定されます。

フィルターにはルールを含めないことも、いくつか含めることもできます。ルールを何も定義しない場合、パッケージにはルートパスの下のすべてのコンテンツが含まれます。

1 つのパッケージに対して 1 つまたは複数のフィルター定義を指定できます。複数のルートパスのコンテンツを含めるには、複数のフィルターを使用します。

次の表に、これらのルールと例を示します。

パッケージフィルターは、最初に パッケージを作成ただし、後から編集することもできます（その後、パッケージを再構築する必要があります）。

パッケージスクリーンショット package-screenshots

パッケージにスクリーンショットを添付して、コンテンツがどのように表示されるかを視覚的に示すことができます。例えば、新機能のスクリーンショットを提供することで、

パッケージアイコン package-icons

また、パッケージにアイコンを付けて、パッケージに含まれる内容を視覚的にすばやく参照できるようにすることもできます。 これがパッケージリストに表示され、パッケージやパッケージのクラスを簡単に識別できます。

パッケージにはアイコンを含めることができるので、公式パッケージには次の規則を使用します。

公式のホットフィックスパッケージ：

公式のAEMインストールまたは拡張機能パッケージ：

公式機能パック：

パッケージマネージャー package-manager

パッケージマネージャーは、ローカルのAEMインストール上のパッケージを管理します。 次の条件が満たされた後 必要な権限を割り当て パッケージマネージャーは、パッケージの設定、構築、ダウンロード、インストールなど、様々なアクションに使用できます。 設定する主な要素は次のとおりです。

パッケージマネージャーの使用に必要な権限 permissions-needed-for-using-the-package-manager

パッケージを作成、変更、アップロード、インストールする権限をユーザーに付与するには、次の場所で適切な権限をユーザーに付与する必要があります。

詳しくは、 権限の設定 権限の変更手順については、を参照してください。

新しいパッケージの作成 creating-a-new-package

新しいパッケージ定義を作成するには：

パッケージのビルド building-a-package

多くの場合、パッケージはユーザーと同時に構築されます パッケージ定義の作成を使用する必要がありますが、後で戻って、パッケージをビルドまたは再構築できます。 これは、リポジトリ内のコンテンツが変更された場合に役立ちます。

パッケージを再度含める rewrapping-a-package

パッケージが構築されたら、必要に応じて再ラップできます。

再ラッピングによってパッケージ情報が変更されます — なし パッケージの内容の変更 パッケージ情報は、サムネール、説明などです。つまり、 パッケージ設定 ダイアログ（このクリックを開く） 編集) をクリックします。

再ラップの主な使用例は、パッケージ共有のパッケージを準備する際に発生します。 例えば、既存のパッケージがあり、それを他のユーザーと共有する場合などです。 サムネールを追加し、説明を追加します。 すべての機能を含むパッケージ全体を再作成する代わりに（時間がかかり、パッケージが元のパッケージと同じでなくなる可能性があります）、パッケージを再度ラップして、サムネールと説明を追加するだけで済みます。

パッケージ情報の表示と編集 viewing-and-editing-package-information

パッケージ定義に関する情報を表示または編集するには、次の手順に従います。

パッケージコンテンツの表示とインストールのテスト viewing-package-contents-and-testing-installation

パッケージが構築されたら、次の内容を表示できます。

ファイルシステムへのパッケージのダウンロード downloading-packages-to-your-file-system

この節では、 パッケージマネージャー.

ファイルシステムからのパッケージのアップロード uploading-packages-from-your-file-system

パッケージのアップロードでは、ファイルシステムからAEM Package Manager にパッケージをアップロードできます。

パッケージをアップロードするには：

パッケージの検証 validating-packages

パッケージをインストールする前に、その内容を確認する必要があります。 パッケージは、以下のオーバーレイファイルを変更できるので、 /apps ACL の追加、変更、削除を行う、または、多くの場合、インストール前にこれらの変更を検証すると便利です。

検証オプション validation-options

検証メカニズムは、パッケージの次の特性を確認できます。

これらのオプションについては、以下で詳しく説明します。

検証の実行 performing-validation

パッケージの検証は、次の 2 つの方法で実行できます。

パッケージマネージャーを使用したパッケージの検証

HTTP POST リクエストを介したパッケージ検証

POST リクエストの形式は以下のとおりです。

https://<host>:<port>/crx/packmgr/service.jsp?cmd=validate&type=osgiPackageImports,overlays,acls

以下は、cURL を使用してパッケージ検証を実行する例です。

パッケージのインストール installing-packages

パッケージをアップロードした後、コンテンツをインストールする必要があります。 パッケージコンテンツをインストールして機能させるには、次の両方にする必要があります。

ファイルシステムベースのアップロードおよびインストール file-system-based-upload-and-installation

別の方法で、パッケージをインスタンスにアップロードしてインストールすることもできます。 ファイルシステムに、 crx-quicksart jar と一緒にフォルダーと license.properties ファイル。 次の名前のフォルダーを作成する必要があります： install under crx-quickstart. その後、次のような情報が表示されます。 <aem_home>/crx-quickstart/install

この install フォルダーで、パッケージを直接追加できます。 追加したパッケージは、インスタンスに自動的にアップロードおよびインストールされます。完了したら、パッケージマネージャーにパッケージが表示されます。

インスタンスが実行中の場合、 install フォルダーは直接アップロードとインスタンスへのインストールを開始します。 インスタンスが実行されていない場合は、に配置するパッケージ install フォルダーは起動時にアルファベット順にインストールされます。

パッケージのアンインストール uninstalling-packages

AEMでは、パッケージをアンインストールできます。 この操作により、パッケージのインストール直前に行われたスナップショットに影響を与えたリポジトリの内容が元に戻されます。

パッケージの削除 deleting-packages

パッケージマネージャーリストからパッケージを削除するには：

パッケージのレプリケーション replicating-packages

パッケージのコンテンツをレプリケートして、パブリッシュインスタンスにインストールします。

パッケージ共有 package-share

パッケージ共有は、コンテンツパッケージを共有するために公開された一元化されたサーバーです。

がに置き換えられました。 ソフトウェア配布。

ソフトウェア配布 software-distribution

ソフトウェア配布 は、AEMパッケージの検索とダウンロードを簡素化する新しいユーザーインターフェイスです。

詳しくは、 ソフトウェア配布ドキュメント。