5.2.0 Service Pack 1版本（2026年9月）的升级说明
本文介绍了适用于Adobe Experience Manager Guides 5.2.0 Service Pack 1版本的升级说明和兼容性矩阵。
有关新增功能和增强功能的详细信息，请查看5.2.0 Service Pack 1版本中的新增功能。
有关此版本中已修复的问题的列表，请查看5.2.0 Service Pack 1版本中已修复的问题。
兼容性矩阵
本部分列出了Experience Manager Guides 5.2.0 Service Pack 1版本支持的软件应用程序的兼容性矩阵。
AEM Guides
AEM 版本
服务包
5.2.0 Service Pack 1 (UUID)
6.5 LTS
2
5.2.0 Service Pack 1 (UUID)
6.5
24, 23, 22
有关更多详细信息，请查看On-Premise Installation and Configuration Guide中的技术要求部分。
Java SDK资源
在开发自定义Java插件或与Experience Manager Guides的集成时，请使用以下资源。 确保SDK版本与您安装的Experience Manager Guides版本匹配。
发行版本
Java SDK版本
Maven Central
Java API参考
有关更多详细信息，请查看从Maven Central存储库配置并使用API JAR。
FrameMaker和FrameMaker Publishing Server
发行版本
FMPS
FM
5.2.0 Service Pack 1 (UUID)
支持
2026或更高版本
氧气连接器
发行版本
氧气连接器窗口
氧气连接器Mac
在氧气窗口中编辑
在氧气Mac中编辑
5.2.0 Service Pack 1 (UUID)
3.8-uuid.1
3.8-uuid.1
2.3
2.3
知识库模板版本
组件包名称
组件版本
模板版本
适用于Cloud Service的Experience Manager Guides组件内容包
guides-components.all-1.4.0
aem-site-template-dxml-1.0.17
新的AEM站点模板版本
AEM Guides
AEM 版本
组件版本
站点版本
5.2.0 Service Pack 1 UUID
6.5 LTS
guides-components.all-1.4.1
NA
5.2.0 Service Pack 1 UUID
6.5
guides-components.all-1.4.0
aemg-sites-template-1.3.0
先决条件
在启动Experience Manager Guides 5.2.0 Service Pack 1升级过程之前，请确保您具有：
- 已升级到Experience Manager Guides版本5.2.0。
- （可选）已关闭所有翻译任务。
- 已将
com.adobe.fmdita.translationservices.TranslationMapUpgradeScript类的日志级别更改为INFO，并将这些日志附加到新的日志文件中，例如logs/translation_upgrade.log。
Experience Manager Guides 5.2.0 Service Pack 1的升级路径
您可以轻松地将当前版本的Experience Manager Guides升级到 AEM 6.5 或 AEM 6.5 LTS 上的5.2.0 Service Pack 1版本。
IMPORTANT
- 对于AEM 6.5 LTS：只有Experience Manager Guides 6.5 LTS Service Pack 2支持AEM 5.2.0 Service Pack 1。
- 对于AEM 6.5：仅Experience Manager Guides 6.5 Service Pack 24、23和22支持AEM 5.2.0 Service Pack 1。
- 如果您当前使用AEM 6.5，并计划迁移到AEM 6.5 LTS，请确保先完成AEM升级，然后再继续进行Experience Manager Guides 5.2.0升级。 有关详细信息，请查看升级到Adobe Experience Manager (AEM) 6.5 LTS。
- 如果您当前使用AEM 6.5，并计划迁移到AEM 6.5 Service Pack 24或更高版本，请确保先完成AEM升级。 完成后，重新安装Experience Manager Guides 5.2.0。 安装Experience Manager Guides 5.2.1之前。
在继续升级到版本5.2.0 Service Pack 1的Experience Manager Guides之前，必须考虑以下几点：
- 如果您使用的是版本5.2.0，则可以直接升级到版本5.2.0 Service Pack 1。
- 如果您使用的是版本5.0.0、5.0.3、5.1.0、5.1.3或5.1.4，则可以直接升级到版本5.2.0。
- 如果您使用的是版本4.6.3、4.6.4、5.0.x，则可以直接升级到版本5.1.0。
- 如果您使用的是版本4.6.0、4.6.1，则需要在升级到版本5.1.0之前升级到版本4.6.3、4.6.4或5.0.0。
- 如果您使用的是版本4.3.x、4.2、4.2.1（修补程序4.2.1.3）、4.1或4.1.x，则需要在升级到版本5.1.0之前升级到版本4.4。
- 如果您使用的是版本4.0，则需要先升级到版本4.2，然后再升级到版本4.3.x。
- 如果您使用的是版本3.8.5，则在升级到版本4.2之前需要升级到版本4.0。
- 如果您使用的版本低于3.8.5，请参阅Adobe Experience Manager Guides帮助Experience Manager Guides存档上提供的产品特定安装指南中的“升级PDF”部分。
Experience Manager Guides 5.2.0 Service Pack 1的升级过程
IMPORTANT
后处理并编制索引可能需要几个小时。 建议在非高峰时间启动升级过程。
- 从Adobe软件分发门户下载5.2.0 Service Pack 1版本包。
- 安装要升级的版本包，然后等待包安装完毕。
- （可选）随要升级到的版本一起发布的升级氧气连接器插件。
- 安装包后清除浏览器缓存。
- 如果已启用设置
Enable markup find and replace来访问先前捕获内容的源视图中的查找和替换功能，则必须重新索引guidesAssetLucene索引。 有关详细信息，请查看重新索引以查找和替换。
recommendation-more-help
experience-manager-guides-help-product-guide