更新 DXPR Builder.

更新 DXPR Builder 以获取错误修复、新功能和安全修复。 您先用 Composer 更新代码，再让 Drupal 通过 drush updatedb 转换设置与内容。本页适用于 3.x 系列内的更新。如果您还在使用 1.x 或 2.x，请改为参阅 从 DXPR Builder 1.x 或 2.x 迁移。

开始之前

• 备份数据库：

  drush sql:dump > backup-$(date +%Y%m%d).sql
  

• 阅读更新日志和 GitHub 发布页面 ，留意需要您处理的变更，例如迁移到 Font Awesome 7。

• 请先在站点的预发布副本上试运行更新。

更新模块

1. 更新代码：

   composer update drupal/dxpr_builder --with-dependencies
   

2. 运行数据库更新。您也可以改为访问 /update.php：

   drush updatedb
   

   某些更新会分批转换每一个 DXPR Builder 字段值。在大型站点上， 这需要几分钟，而不是几秒钟。

3. 重建缓存，以便浏览器获取新的样式表和脚本：

   drush cache:rebuild
   

您会看到的内容

包含 DXPR Builder 内容的页面外观与之前一致。以编辑人员身份将鼠标悬停在页面上， 即会显示控制栏；请做一处小改动并点击 Save，确认保存功能正常。General Settings 的 License 下仍会显示您的产品密钥。

然后打开 Reports > Status report（/admin/reports/status）。 在 DXPR Builder content migrations 旁边会显示 All migrations completed。

如果您没有看到新版本

• 编辑器的行为仍与旧版本一致。浏览器保留了旧的编辑器文件。请用 Ctrl+Shift+R 重新加载，在 Mac 上则用 Cmd+Shift+R。
• 状态报告显示 "Some DXPR Builder content migrations have not been completed"。仍有内容等待转换。请在该消息中打开 View migration status，或前往 /admin/dxpr_studio/dxpr_builder/migration-status，然后点击 Run all pending migrations。
• 页面显示异常或缺少元素。请参阅更新后出现的问题，了解原因与解决方法。

如果更新破坏了站点，且上述方法都无效，请回滚：

1. 恢复数据库备份：

   drush sql:cli < backup-20260901.sql
   

2. 恢复您之前的版本，例如 3.0.0-beta19：

   composer require 'drupal/dxpr_builder:3.0.0-beta19'
   

3. 重建缓存：

   drush cache:rebuild
   

接下来做什么？

• 备份与恢复：在重大更新前为构建器内容建立备份流程。
• 更新日志：每个版本的变化。
• 更新后出现的问题：最常见更新问题的解决方法。