如何修改AdminBro v1.6.6版本的登录页欢迎文本及排查修改失效问题

版本兼容性说明 #

你之前参考相关issue的方法修改不生效，和当前使用的v1.6.6版本直接相关：你提到的issue#347对应的自定义登录页、覆写默认页面组件的能力，是在v1.6.6后续发布的版本中才正式落地的功能，v1.6.6本身不支持该方案提及的新版配置参数，因此无法通过对应方法完成修改。

v1.6.6版本可行的修改方案 #

• 方案1：通过内置i18n本地化配置覆写文案
  v1.6.6自带多语言本地化能力，登录页显示的“Welcome!”文本属于默认语言包内的固定字段，不需要改动源码即可直接通过配置覆盖：
  在初始化AdminBro实例的配置项中，新增locale配置块：

  const adminBro = new AdminBro({
    // 保留你原有的所有配置项
    locale: {
      translations: {
        // 替换为你项目当前使用的语言标识，如默认英文就填en，中文环境填zh
        en: {
          messages: {
            // 替换为你需要的自定义欢迎文本
            welcomeOnPage: '自定义欢迎内容'
          }
        }
      }
    }
  })
  

  注意：如果你的项目同时配置了其他自定义翻译，需要把这段配置合并到已有的translations结构中，避免覆盖原有自定义翻译内容。

• 方案2：直接修改依赖内的组件源码
  如果需要对登录页做更复杂的自定义修改，可以直接调整本地依赖包内的登录页组件：
  1. 定位到依赖路径下的登录页文件：
     • 生产环境编译后版本：node_modules/admin-bro/lib/login.js
     • TypeScript 源码版本：node_modules/admin-bro/src/frontend/login/login.tsx
  2. 搜索文件内硬编码的Welcome!字符串，替换为自定义内容即可

  注意：直接修改node_modules内的文件，会在执行npm install重装依赖后被重置。建议搭配patch-package工具保存对admin-bro的源码修改补丁，保证重装依赖后自定义内容不会丢失。

后续升级提示 #

如果项目允许升级AdminBro版本，可以升级到v1.6.6之后的稳定版本，届时就可以通过官方提供的组件覆写API实现登录页的完全自定义，灵活性远高于上述两个适配老版本的方案。

内容的提问来源于stack exchange，提问作者Ritik Saxena