Red Hat Summit 红帽全球峰会支持控制台（Console）开发人员开始试用联系人

2.2. 对主题的更改

2.2.1. 对 Welcome theme 的更改
复制链接

"welcome"主题已更新为使用新布局，现在使用 PatternFly 5 而不是 PatternFly 3。如果您要扩展主题或自行提供，您可能需要按如下方式进行更新：

2.2.1.1. 从 PatternFly 3 迁移到 PatternFly 5
复制链接

欢迎主题是红帽构建的 Keycloak 中的过期主题之一。它最初基于 PatternFly 3，但现已更新为使用 PatternFly 5，跳过过程中的主要版本。如果您的自定义主题扩展了内置主题，您需要对其进行更新以使用 PatternFly 5 语法。有关详细信息，请参阅 PatternFly 5 文档。

如果您仍然在您自己的自定义主题中使用 PatternFly 3 （没有扩展内置主题），您可以继续使用它，但 PatternFly 3 支持将在以后的版本中删除，因此您应该尽快迁移到 PatternFly 5。

2.2.1.2. 自动重定向到管理控制台
复制链接

如果启用了 Admin 控制台，则欢迎页面将自动重定向到它（如果管理用户已存在）。通过在 主题.properties 文件中设置 redirectToAdmin 来修改此行为。默认情况下，属性设为 false，除非您扩展内置主题，在这种情况下，属性设为 true。

2.2.1.4. 现在，资产已从 'common' 资源加载
复制链接

背景、徽标和 favicon 等镜像现在从 'common' 资源加载，而不是从主题资源加载。此更改意味着，如果您要扩展内置主题，并且覆盖这些镜像，则需要将它们移到主题的"通用"资源，并更新您的 主题.properties 文件使其包含新路径： 

# This defaults to 'common/keycloak' if not set.
import=common/your-theme-name
Copy to Clipboard Toggle word wrap

2.2.2. 对帐户控制台主题自定义的更改
复制链接

如果您之前扩展帐户控制台主题的已弃用版本 2，则需要更新您的主题以使用帐户控制台主题的新版本 3。新版本的帐户控制台主题会做一些关于它自定义方式的更改。要开始清理，您可以遵循新的自定义 快速入门。

要移动您的自定义主题，首先将 父项 改为新的主题： 

# Before
parent=keycloak.v2

# After
parent=keycloak.v3
Copy to Clipboard Toggle word wrap

如果您有任何自定义 React 组件，您将直接导入 React，而不是使用相对路径： 

// Before
import * as React from "../../../../common/keycloak/web_modules/react.js";

// After
import React from "react";
Copy to Clipboard Toggle word wrap

如果您使用 content.json 自定义主题，则对文件结构有一些更改，特别是：

  • content 属性已重命名为 children。
  • id、icon 和 componentName 属性已被删除，因为 modulePath 提供了相同的功能。

2.2.3. 用于它们的默认语言文件到 UTF-8 编码
复制链接

此发行版本现在遵循 Java 及之后的版本的标准机制，它假定要在 UTF-8 中编码资源捆绑包文件。

之前的 Keycloak 版本支持在第一行中指定编码，它带有类似 # encoding: UTF-8 的注释，该注释不再被支持并会被忽略。

现在，sees 的消息属性文件在 UTF-8 编码中读取，自动回退到 ISO-8859-1 编码。如果您使用不同的编码，请将文件转换为 UTF-8。

返回顶部
Red Hat logoGithubredditYoutubeTwitter

学习

尝试、购买和销售

社区

关于红帽文档

通过我们的产品和服务，以及可以信赖的内容，帮助红帽用户创新并实现他们的目标。 了解我们当前的更新.

让开源更具包容性

红帽致力于替换我们的代码、文档和 Web 属性中存在问题的语言。欲了解更多详情，请参阅红帽博客.

關於紅帽

我们提供强化的解决方案，使企业能够更轻松地跨平台和环境（从核心数据中心到网络边缘）工作。

Theme

© 2025 Red Hat