Experience League

Exit search

如何使用包

包允许导入和导出存储库内容。例如，您可以使用包来安装新功能、在实例之间传输内容以及备份存储库内容。

可以从以下页面访问和/或维护资源包：

包管理器，用于管理本地AEM实例中的包。
Package Share，一种中央服务器，它既包含公共可用的包，又包含对您公司私有的包。公共资源包可以包含修补程序、新功能、文档等。

可以在包管理器、包共享和文件系统之间传输包。

什么是包？

资源包是一个zip文件，其中包含以文件系统序列化（称为“保管库”序列化）形式存储库内容。这为文件和文件夹提供了易于使用和编辑的表示形式。

包中包含使用过滤器选择的页面内容和项目相关内容。

资源包还包含保管库元信息，包括过滤器定义和导入配置信息。包中可以包含其他内容属性（不用于包提取），例如描述、可视图像或图标；这些属性仅用于内容包使用者和信息目的。

注意

包表示生成包时内容的当前版本。它们不包括AEM保留在存储库中的内容的任何以前版本。

您可以对包或对包执行以下操作：

创建新资源包；根据需要定义包设置和过滤器
预览包内容（在生成之前）
生成包
查看包信息
查看包内容（构建后）
修改现有包的定义
重建现有资源包
重新包装包
将包从AEM下载到文件系统
将包从文件系统上传到本地AEM实例
安装前验证包内容
执行干式运行安装
安装包(AEM在上传后不会自动安装包)
删除资源包
从包共享库中下载包，如修补程序
将包上传到包共享库的公司内部部分

包信息

包定义由各种类型的信息组成：

包设置
包过滤器
包屏幕截图
包图标

包设置

您可以编辑各种包设置来定义一些方面，如包描述、相关错误、依赖项和提供程序信息。

在创建或编辑资源包时，可通过编辑按钮访问资源包设置对话框，并提供三个选项卡进行配置。进行任何更改后，单击确定以保存这些内容。

包编辑

字段	描述
名称	包的名称。
组	要将包添加到的组的名称，用于组织包。键入新组的名称，或选择现有组。
版本号	用于自定义版本的文本。
描述	包的简要描述。 HTML标记可用于格式化。
缩略图	包列表中显示的图标。单击浏览以选择本地文件。

chlimage_1-344

字段	描述	格式/示例
名称	提供商的名称。	AEMGeometrixx
URL	提供商的URL。	https://www.aem-geometrixx.com
链接	指向提供程序页面的特定于包的链接。	https://www.aem-geometrixx.com/mypackage.html
需要	管理员：选择包何时只能由具有管理员权限的帐户安装。重新启动：选择在安装包后需要重新启动服务器的时间。
AC 处理	指定在导入资源包时如何处理资源包中定义的访问控制信息：忽略覆盖合并清除 MergePreserve 默认值为Ignore。	忽略 — 保留存储库中的ACL 覆盖 — 覆盖存储库中的ACL 合并 — 合并两组ACL 清除 — 清除ACL MergePreserve — 通过添加内容中不存在的主体的访问控制项，将内容中的访问控制与包中提供的访问控制项合并

包依赖关系

字段	描述	格式/示例
已通过	此产品包的目标产品名称和版本或与之兼容。	AEM 6
修复了错误/问题	允许您列出使用此包修复的错误详细信息的文本字段。请在单独的行上列出每个错误。	bug-nr摘要
依赖于	列出在需要其他包才能按预期运行当前包时需要遵守的依赖关系信息。使用修补程序时，此字段很重要。	groupId:name:version
替换	此包替换的已弃用包列表。在安装之前，请检查此包是否包含过时包中的所有必需内容，以便不会覆盖任何内容。	groupId:name:version

包过滤器

过滤器标识要包含在包中的存储库节点。 过滤器定义指定以下信息：

要包含的内容的根路径。
包含或排除根路径下特定节点的规则。

过滤器可以包含零个或多个规则。未定义规则时，资源包包含根路径下的所有内容。

您可以为包定义一个或多个过滤器定义。使用多个过滤器包含多个根路径中的内容。

chlimage_1-345

下表介绍了这些规则并提供了示例：

规则类型	描述	示例
包括	您可以定义路径，或使用正则表达式指定要包含的所有节点。包含目录将：包括该目录和中该目录（即整个子树）中的所有文件和文件夹不包含指定根路径下的其他文件或文件夹	/libs/sling/install(/)*)?
排除	您可以指定路径或使用正则表达式指定要排除的所有节点。排除目录将排除该目录以及该目录（即整个子树）中的所有文件和文件夹。	/libs/wcm/foundation/components(/)*)?

注意

一个包可以包含多个过滤器定义，因此来自不同位置的节点可以容易地合并到一个包中。

首次创建包时，通常会定义包过滤器，但以后也可以编辑它们（在此之后应重新构建包）。

包屏幕截图

您可以将屏幕截图附加到包中，以直观地呈现内容的外观；例如，通过提供新功能的屏幕截图。

包图标

您还可以向包附加一个图标，以提供包所含内容的快速参考可视表示形式。然后，该代码包会显示在资源包列表中，并有助于您轻松识别资源包或资源包类。

由于包可以包含图标，因此以下约定将用于正式包：

注意

为避免造成混淆，请为包使用描述性图标，而不要使用任何官方图标。

正式修补程序包：

正式的AEM安装或扩展包：

官方功能包：

包管理器

包管理器管理本地AEM安装上的包。为分配了必要的权限后，您可以使用包管理器执行各种操作，包括配置、构建、下载和安装包。要配置的关键元素包括：

包设置
包过滤器

使用包管理器所需的权限

要授予用户创建、修改、上传和安装包的权限，您必须在以下位置为用户授予相应的权限：

/etc/packages （除删除外的完全权限）
包含包内容的节点

有关更改权限的说明，请参阅设置权限。

创建新资源包

要创建新的包定义，请执行以下操作：

在AEM欢迎屏幕上，单击包（或从工具控制台中双击包）。
然后选择包管理器。
单击创建包。

注意

如果您的实例具有许多包，则可能存在一个文件夹结构，因此您可以在创建新包之前导航到所需的目标文件夹。
在对话框中：

输入：
- 组名称
  
  目标组（或文件夹）名称。组将用于帮助您组织包。
  
  如果组不存在，则将为其创建文件夹。如果将组名称留空，它将在主包列表（主页>包）中创建包。
- 包名称
  
  新包的名称。选择一个描述性名称，以帮助您（和其他人）轻松识别包的内容。
- 版本号
  
  用于指示版本的文本字段。此名称将附加到包名称中，以构成zip文件的名称。
  单击确定以创建资源包。
AEM会在相应的组文件夹中列出新包。

单击要打开的图标或包名称。

注意

您可以在以后的阶段（如果需要）返回此页面。
单击编辑以编辑包设置。

在此，您可以添加信息和/或定义某些设置；例如，这些错误包括描述、图标、相关错误和添加提供程序详细信息。

编辑完设置后，单击确定。
根据需要，将Screenshots添加到包中。创建包后，有一个实例可用，如果需要，可使用Sidekick中的包屏幕截图添加更多实例。

双击屏幕截图区域中的图像组件，添加图像，然后单击确定，以添加实际图像。
定义包过滤器，方法是：从Sidekick中拖动过滤器定义的实例，然后双击以打开进行编辑：

指定：
- 根路
  径要打包的内容；这可以是子树的根。
- RulesRules是可选的；对于简单的包定义，无需指定包含或排除规则。
  
  如果需要，您可以定义Include或Exclude规则以准确定义包内容。
  
  使用+符号添加规则，或者使用-符号删除规则。根据规则的顺序应用规则，以便使用Up和Down按钮根据需要定位规则。
  然后，单击确定以保存过滤器。
注意

您可以根据需要使用任意数量的过滤器定义，但必须谨慎确保它们不会发生冲突。使用预览确认包内容。
要确认包将包含哪些内容，可以使用Preview。此操作将执行构建过程的练习，并列出在实际构建包时将添加到包中的所有内容。
您现在可以生成您的包。

注意

此时不强制构建包，可以在稍后的时间点完成。

构建包

通常，在创建包定义的同时构建包，但您可以在稍后的时间点返回以生成或重建包。如果存储库中的内容发生更改，则此功能会非常有用。

注意

在生成包之前，预览包的内容会非常有用。要执行此操作，请单击预览。

从包管理器中打开包定义（单击包图标或名称）。
单击Build。此时会出现一个对话框，要求您确认是否确实要构建包。

注意

当您重建资源包时，这特别重要，因为资源包内容将被覆盖。
单击确定。AEM将生成包，并列出添加到包中的所有内容。完成AEM时，会显示一条确认消息，确认已生成资源包，并且（关闭对话框时）会更新资源包列表信息。

重新封装包

构建包后，可以根据需要重新包装该包。

重新封装会更改包信息 — 而不更改包内容。包信息是缩略图、描述等，换句话说，您可以通过包设置对话框（要打开此单击编辑）编辑的所有内容。

重新包装的主要用例是在为包共享准备包时。例如，您可能已拥有一个现有资源包，并决定与他人共享该资源包。添加缩略图并添加描述。您无需使用其所有功能重新创建整个资源包（可能需要一些时间，并且可能会面临资源包不再与原始资源包相同的风险），而是可以重新包装资源包，并只添加缩略图和描述。

从包管理器中打开包定义（单击包图标或名称）。
单击编辑并根据需要更新包设置。单击确定进行保存。
单击重新换行，将出现一个对话框要求进行确认。

查看和编辑包信息

要查看或编辑有关资源包定义的信息，请执行以下操作：

在包管理器中，导航到要查看的包。
单击要查看的包的包图标。此时将打开包页面，其中列出了有关包定义的信息：

注意

您还可以通过此页面对资源包进行编辑和执行某些操作。

可用的按钮取决于包是否已构建。
如果已经生成包，请单击Contents ，将打开一个窗口并列出包的整个内容：

查看包内容和测试安装

生成包后，您可以查看内容：

在包管理器中，导航到要查看的包。
单击要查看的包的包图标。这将打开包页面，其中列出了有关包定义的信息。
要查看内容，请单击Contents，将打开一个窗口并列出包的整个内容：
要执行安装的干式运行，请单击测试安装。确认操作后，将打开一个窗口，并列出与执行安装一样的结果：

将包下载到文件系统

本节介绍如何使用Package Manager将包从AEM下载到文件系统。

注意

有关从公共区域和您公司内部的包共享区域下载修补程序、功能包和包的信息，请参阅包共享。

从包共享中，您可以：

从包共享直接下载包到本地AEM实例中。
下载后，包会导入到您的存储库中，之后，您可以使用包管理器立即将其安装到本地实例上。这些包包括修补程序和其他共享包。
从将包共享下载到文件系统。

在AEM欢迎屏幕上，单击包，然后选择包管理器。
导航到要下载的包。
单击要下载的包的zip文件名称（带下划线）所形成的链接；例如export-for-offline.zip。

AEM会将包下载到您的计算机（使用标准的浏览器下载对话框）。

从文件系统上载包

包上传允许您将包从文件系统上传到AEM包管理器。

注意

请参阅将包上传到公司内部包共享，以将包上传到公司的包共享专用区域。

要上传资源包，请执行以下操作：

导航到包管理器。然后，转到要将包上传到的组文件夹。
单击上传包。
- 文件
  
  您可以直接键入文件名，也可以使用Browse…对话框，从本地文件系统中选择所需的包（选择后，单击确定）。
- 强制上传
  
  如果具有此名称的包已存在，则可以单击此名称以强制上传（并覆盖现有包）。
  单击确定，以便上载新包并将其列在包管理器列表中。
注意

要使内容可供AEM使用，请务必安装包。

验证包

在安装包之前，您可能希望验证其内容。由于包可以修改/apps下叠加的文件和/或添加、修改和删除ACL，因此在安装前验证这些更改通常非常有用。

验证选项

验证机制可以检查包的以下特征：

OSGi包导入
叠加
ACL

下面详细介绍了这些选项。

验证 OSGi 包的导入情况

已检查的内容

此验证会检查所有JAR文件（OSGi包）的包，提取其manifest.xml（其中包含所述OSGi包所依赖的版本化依赖项），并验证AEM实例使用正确的版本导出所述依赖项。

报告方式

AEM实例无法满足的任何版本化依赖项都列在包管理器的活动日志中。

错误状态

如果不满足依赖关系，则包中具有这些依赖关系的OSGi包将不会启动。这会导致应用程序部署中断，因为任何依赖未启动的OSGi包的部署都将无法正常工作。

错误解决

要解决由于未满足要求的OSGi包而导致的错误，需要调整包中具有未满足的导入的依赖项版本。
验证覆盖

已检查的内容

此验证可确定所安装的包是否包含目标AEM实例中已叠加的文件。

例如，在/apps/sling/servlet/errorhandler/404.jsp处给定一个现有叠加，该叠加包含/libs/sling/servlet/errorhandler/404.jsp，这样它将更改位于/libs/sling/servlet/errorhandler/404.jsp处的现有文件。

报告方式

包管理器的活动日志中介绍了任何此类叠加。

错误状态

错误状态表示资源包尝试部署的文件已经覆盖，因此资源包中的更改将被覆盖（并因此被“隐藏”），且不会生效。

错误解决

要解决此问题，/apps中叠加文件的维护人员必须查看/libs中叠加文件的更改，并根据需要将更改合并到叠加中(/apps)，然后重新部署叠加文件。

注意

请注意，如果叠加的内容已正确纳入叠加文件中，则验证机制无法进行协调。因此，即使进行了必要的更改，此验证仍将继续报告冲突。
验证 ACL

已检查的内容

此验证会检查添加的权限、处理权限的方式（合并/替换），以及当前权限是否会受到影响。

报告方式

包管理器的活动日志中对权限进行了描述。

错误状态

无法提供显式错误。验证仅指示是否将通过安装包来添加或影响任何新ACL权限。

错误解决

使用验证提供的信息，可以在CRXDE中查看受影响的节点，并且可以根据需要在包中调整ACL。

注意

作为最佳实践，建议软件包不要影响AEM提供的ACL，因为这可能会导致意外的产品行为。

执行验证

可以采用两种不同的方式来验证包：

通过包管理器UI
通过HTTPPOST请求（例如使用cURL）

注意

上传包后但安装包之前，应始终进行验证。

通过包管理器进行包验证

在https://<server>:<port>/crx/packmgr打开包管理器
在列表中选择包，然后从标题中选择更多下拉列表，然后从下拉菜单中选择验证。

注意

这应在上传内容包之后、安装包之前完成。
在随后显示的模式对话框中，使用复选框选择验证类型，并通过单击Validate开始验证。或者，单击取消。
随后将运行所选验证。结果显示在包管理器的活动日志中。

通过HTTPPOST请求进行包验证

POST请求采用以下形式。

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

注意

type参数可以是任何以逗号分隔的无序列表，包括：

osgiPackageImports
overlays
acls

如果未传递，则值type默认为osgiPackageImports。

以下是使用cURL执行包验证的示例。

如果使用cURL，则执行类似于以下语句：

curl -v -X POST --user admin:admin -F file=@/Users/SomeGuy/Desktop/core.wcm.components.all-1.1.0.zip 'http://localhost:4502/crx/packmgr/service.jsp?cmd=validate&type=osgiPackageImports,overlays,acls'

将运行所请求的验证，并将响应作为JSON对象发送回来。

注意

对验证HTTPPOST请求的响应将是一个JSON对象，其验证结果为。

安装包

上传包后，您需要安装内容。要安装包内容并使其正常工作，它需要同时满足以下条件：

加载到AEM中（从您的文件系统上传的或从包共享下载的的）
已安装

注意

安装资源包可能会覆盖或删除现有内容。仅当您确定包不会删除或覆盖您需要的内容时，才上传包。

要查看包的内容或影响，您可以：

在不修改任何内容的情况下，对包执行测试安装：
打开包（单击包图标或名称），然后单击测试安装。
请参阅包内容列表：
打开包，然后单击Contents。

注意

在安装包之前，将立即创建一个快照包，以包含将被覆盖的内容。

如果/当您卸载包时，将重新安装此快照。

注意

如果要安装数字资产，您必须：

首先，停用WorkflowLauncher。
使用OSGi控制台的“组件”菜单选项停用com.day.cq.workflow.launcher.impl.WorkflowLauncherImpl。
接下来，安装完成后，重新激活WorkflowLauncher。

取消激活WorkflowLauncher可确保资产导入器框架不会（无意中）在安装时处理资产。

在包管理器中，导航到要安装的包。

Install按钮显示在尚未安装的软件包的侧面。

注意

或者，您也可以通过单击包的图标打开包，以访问Install按钮。
单击Install以开始安装。对话框将请求确认并列出所做的所有更改。完成后，单击对话框上的关闭。

安装包后，包旁边会显示单词Installed。

基于文件系统的上传和安装

有另一种方法可以将包上载并安装到实例。在文件系统中，您的jar和license.properties文件旁边有一个crx-quicksart文件夹。您需要在crx-quickstart下创建名为install的文件夹。然后，您将获得如下内容：<aem_home>/crx-quickstart/install

在此安装的文件夹中，您可以直接添加包。系统将自动在您的实例上传和安装这些组件。完成后，您可以在包管理器中看到包。

如果您的实例正在运行，则将包添加到install文件夹中将直接启动上传和实例上的安装。如果您的实例未运行，则放置在install文件夹中的包将在启动时按字母顺序进行安装。

注意

您还可以在首次启动实例之前执行此操作。为此，您需要手动创建crx-quickstart文件夹，在其下创建install文件夹，然后将包放置到此处。然后，当您首次启动实例时，将按字母顺序安装包。

正在卸载包

AEM允许您卸载包。此操作会还原受到在安装软件包之前立即生成的快照影响的存储库的内容。

注意

安装后，将创建一个快照包，其中包含将被覆盖的内容。

卸载该包时，将重新安装该包。

在包管理器中，导航到要卸载的包。
单击要卸载的包的包图标。
单击Uninstall可从存储库中删除此包的内容。对话框将请求确认并列出所做的所有更改。完成后，单击对话框上的关闭。

删除包

要从包管理器列表中删除包，请执行以下操作：

注意

包中已安装的文件/节点将删除不。

在Tools控制台中，展开Packages文件夹，以在右侧窗格中显示您的包。
单击要删除的包，以将其突出显示，然后执行以下任一操作：
- 单击工具栏菜单中的删除。
- 右键单击并选择Delete。
AEM会要求您确认是否要删除该包。单击确定以确认删除。

注意

如果此包已安装，则installed内容将删除not。

复制包

复制包的内容以将其安装到发布实例：

在包管理器中，导航到要复制的包。
单击要复制的资源包的图标或名称以展开该资源包。
在工具栏的更多下拉菜单中，选择复制。

Package Share是一个可公开共享内容包的中央服务器。

它已被Software Distribution替换。

Software Distribution

Software Distribution是新的用户界面，旨在简化AEM Packages的搜索和下载。

有关更多信息，请参阅Software Distribution文档。

注意

AEM包管理器当前不适用于Software Distribution。将包下载到本地磁盘。

Business.Adobe.com 资源

Automated Onboarding Auto Form Fill Targeted Content Asset Collections Embedded Charts Version History