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
。
这些属性以前用于现在不再存在的导航元素。如果要扩展内置主题,则需要从me.properties 文件中删除这些属性
,因为它们不再起作用。
2.2.1.4. 现在,资产已从 'common' 资源加载 复制链接链接已复制到粘贴板!
背景、徽标和 favicon 等镜像现在从 'common' 资源加载,而不是从主题资源加载。此更改意味着,如果您要扩展内置主题,并且覆盖这些镜像,则需要将它们移到主题的"通用"资源,并更新您的 主题.properties
文件使其包含新路径:
This defaults to 'common/keycloak' if not set.
# This defaults to 'common/keycloak' if not set.
import=common/your-theme-name
2.2.2. 对帐户控制台主题自定义的更改 复制链接链接已复制到粘贴板!
如果您之前扩展帐户控制台主题的已弃用版本 2,则需要更新您的主题以使用帐户控制台主题的新版本 3。新版本的帐户控制台主题会做一些关于它自定义方式的更改。要开始清理,您可以遵循新的自定义 快速入门。
要移动您的自定义主题,首先将 父项
改为新的主题:
Before After
# Before
parent=keycloak.v2
# After
parent=keycloak.v3
如果您有任何自定义 React 组件,您将直接导入 React,而不是使用相对路径:
// Before import * as React from "../../../../common/keycloak/web_modules/react.js"; // After import React from "react";
// Before
import * as React from "../../../../common/keycloak/web_modules/react.js";
// After
import React from "react";
如果您使用 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。