--- url: 'https://dxpr.com/zh-hans/hc/documentation/learn-dxpr-builder/getting-started/installation' title: '在 Drupal 站点安装 DXPR Builder | DXPR' author: name: Jurriaan url: 'https://dxpr.com/users/jurriaan' date: '2026-10-24T13:50:18+00:00' updated: '2026-10-24T17:19:22+00:00' copyright: 'Copyright DXPR. All rights reserved.' type: article summary: |- 在已运行的 Drupal 站点安装 DXPR Builder，添加产品密钥，把一个内容类型切换到构建器。最后得到显示构建器的已保存页面，等您放第一个元素。新站请改参阅安装 DXPR CMS：一次装好构建器、主题和内容类型。 视频见在已有内容类型上安装：演示本页末尾检查的第 2 到 8 步。 tags: - 'Install and update' image: 'https://dxpr.com/themes/custom/dxpr_com/images/dxpr-share-card.jpg' published: true og: site_name: DXPR updated_time: '2026-10-24T17:19:22+0000' 'image:alt': 'DXPR, powered by Drupal: AI-powered Drupal for marketers.' schema: '@context': 'https://schema.org' '@graph': - mainEntity: { } - '@type': TechArticle headline: '在 Drupal 站点安装 DXPR Builder' description: |- 在已运行的 Drupal 站点安装 DXPR Builder，添加产品密钥，把一个内容类型切换到构建器。最后得到显示构建器的已保存页面，等您放第一个元素。新站请改参阅安装 DXPR CMS：一次装好构建器、主题和内容类型。 视频见在已有内容类型上安装：演示本页末尾检查的第 2 到 8 步。 image: '@type': ImageObject url: 'https://dxpr.com/themes/custom/dxpr_com/images/dxpr-share-card.jpg' width: '1200' height: '630' datePublished: '2026-10-24T13:50:18+0000' dateModified: '2026-10-24T17:19:22+0000' author: '@type': Organization '@id': 'https://dxpr.com/#organization' name: DXPR url: 'https://dxpr.com/' logo: '@type': ImageObject url: 'https://dxpr.com/themes/custom/dxpr_com/dxpr-logo-dark.svg' width: '1348' height: '501' publisher: '@type': Organization '@id': 'https://dxpr.com/#organization' name: DXPR url: 'https://dxpr.com/' logo: '@type': ImageObject url: 'https://dxpr.com/themes/custom/dxpr_com/dxpr-logo-dark.svg' width: '1348' height: '501' mainEntityOfPage: 'https://dxpr.com/zh-hans/hc/documentation/learn-dxpr-builder/getting-started/installation' articleSection: 安装与更新 - '@type': WebPage '@id': 'https://dxpr.com/zh-hans/hc/documentation/learn-dxpr-builder/getting-started/installation' description: |- 在已运行的 Drupal 站点安装 DXPR Builder，添加产品密钥，把一个内容类型切换到构建器。最后得到显示构建器的已保存页面，等您放第一个元素。新站请改参阅安装 DXPR CMS：一次装好构建器、主题和内容类型。 视频见在已有内容类型上安装：演示本页末尾检查的第 2 到 8 步。 breadcrumb: '@type': BreadcrumbList itemListElement: - '@type': ListItem position: 1 name: 首页 item: 'https://dxpr.com/zh-hans' publisher: '@type': Organization '@id': 'https://dxpr.com/#organization' name: DXPR inLanguage: zh-hans --- [帮助中心](/zh-hans/node/75)/[文档](/zh-hans/hc/documentation) /[学习 DXPR Builder](/zh-hans/hc/documentation/learn-dxpr-builder) /[从这里开始](/zh-hans/hc/documentation/learn-dxpr-builder/start-here) /[安装与更新](/zh-hans/hc/documentation/learn-dxpr-builder/start-here/install) # 在 Drupal 站点安装 DXPR Builder. 学习 DXPR Builder从这里开始安装与更新 ## 本指南内容 相关指南 - [构建您的第一个页面](/zh-hans/hc/documentation/learn-dxpr-builder/getting-started/first-page) - [在内容类型上使用 DXPR Builder](/zh-hans/hc/documentation/learn-dxpr-builder/getting-started/installing-on-existing-content-types) - [更新 DXPR Builder](/zh-hans/hc/documentation/learn-dxpr-builder/getting-started/updating) 在已运行的 Drupal 站点安装 DXPR Builder，添加产品密钥，把一个内容类型切换到构建器。最后得到显示构建器的已保存页面，等您放第一个元素。新站请改参阅[安装 DXPR CMS](/zh-hans/hc/documentation/learn-dxpr-builder/getting-started/installing-dxpr-cms)：一次装好构建器、主题和内容类型。 视频见[在已有内容类型上安装](/zh-hans/hc/documentation/learn-dxpr-builder/getting-started/installing-on-existing-content-types)：演示本页末尾检查的第 2 到 8 步。 ## Before you start - Drupal 10.2 及以上（含 Drupal 11），PHP 8.1 及以上。[系统要求](/zh-hans/hc/documentation/learn-dxpr-builder/getting-started/requirements)列出其余要求。 - 项目中有 Composer 和 Drush。 - 产品密钥。DXPR Builder 需要密钥才能工作；到[dxpr.com/getting-started](/getting-started) 查找您的密钥。 ## 安装模块 1. 用 Composer 下载 DXPR Builder 3.x。第 3 版以 beta 发布，请允许： ```bash composer require 'drupal/dxpr_builder:^3.0@beta' ``` 普通的 `composer require drupal/dxpr_builder` 装的是稳定 2.x 系列。 2. 启用模块： ```bash drush en dxpr_builder ``` Drush 同时启用 Key 模块和 DXPR Builder 需要的核心模块：Field、Field UI、Views、Image 和 Block。 ## 添加产品密钥 1. 前往 **DXPR Studio** > **DXPR Builder** > **General Settings** (`/admin/dxpr_studio/dxpr_builder/settings`)。 2. 在 **License** 分区选择 **Storage method**。 3. 对于 **Configuration storage**，把密钥粘贴到 **Product key**。对于 **Key module**，在 **Key** 下选择您的密钥。 4. Click **Save settings**. **Configuration storage** 把密钥存放在站点配置中，因此会进入配置导出。**Key module** 从您先在 `/admin/config/system/keys` 创建的密钥读取。给该密钥指定 **File** 或 **Environment** 提供者，让它也不进入导出。 ## 添加子模块（可选） DXPR Builder 附带三个子模块。用 `drush en` 加名称启用。 | 子模块 | 带来什么 | 需要 | |---|---|---| | `dxpr_builder_page` | 现成的 **Drag and drop Page** 内容类型，已设为构建器 | 所需的 [Field Group](https://www.drupal.org/project/field_group) 模块 | | `dxpr_builder_block` | 新增的 **Drag and Drop Block** 区块类型，用于区块区域中的构建器内容 | 先启用的核心 **Block Content** 模块 | | `dxpr_builder_media` | 基于 Entity Browser 的旧版媒体浏览器；在 **Extend** 页面隐藏 | Entity Browser 和 Inline Entity Form | 大多数站点不需要媒体子模块。安装时启用了核心 **Media Library**，构建器就用它。否则之后在设置页面的 **Media** > **Browser type** 下选择。[子模块架构](/zh-hans/hc/documentation/learn-dxpr-builder/development/submodules)有详情。 ## 启用 AI 功能（可选） AI 页面创建、AI 文本和 AI 图像通过[AI](https://www.drupal.org/project/ai) 模块和[DXPR AI Provider](https://www.drupal.org/project/ai_provider_dxpr) 运行。 1. 下载两个模块： ```bash composer require drupal/ai drupal/ai_provider_dxpr ``` 2. 启用它们： ```bash drush en ai ai_provider_dxpr ``` 3. 前往 `/admin/config/ai/providers/dxpr`，在 **DXPR API Key** 下选择存放您产品密钥的密钥并保存。 4. 前往 `/admin/dxpr_studio/dxpr_builder/ai_settings`。**AI Features** 下三个框默认全勾选。不需要的功能取消勾选。 The [AI 功能指南](/hc/documentation/learn-dxpr-builder/ai)解释每个设置。 ## 验证安装 文本字段使用 **DXPR Builder** 格式的内容显示构建器。以下步骤在带 **Body** 字段的内容类型上设置。**Drag and drop Page** 类型（来自 `dxpr_builder_page`）已设好，可跳过第 2 到 5 步。 1. 前往 **DXPR Studio** > **DXPR Builder** > **General Settings**，在 **License** 分区检查产品密钥。 2. 前往 **Structure** > **Content types**。打开带 **Body** 字段的内容类型旁的菜单，点击 **Manage display**。 3. 如果打开视图模式总览，点击 **Default** 的 **Manage**。 4. 将 Body 的 **Format** 改为 **DXPR Builder**。 5. Click **Save**. 6. 创建该类型的内容并输入 **Title**。 7. Click **Save**. 8. 悬停内容区，出现 DXPR Builder 工具栏。 ## What you see 已保存的页面在正文处显示空白构建器：AI 提示（设置 AI 前灰显），加 **Choose a template** 和 **Add Elements**。点击 **Add Elements**：元素选择器打开，含 **Layout** 和 **Content** 选项卡。DXPR Builder 正常工作。 ## If you don't see the builder - **页面显示正文但没有构建器。** 字段仍用其他格式。请到 **Structure** > **Content types** > **Manage display**，在 **Default** 视图模式将 **Format** 设为 **DXPR Builder**。 - **编辑表单显示纯文本区。** DXPR Builder 在已保存页面上工作，不在编辑表单上。请保存内容并打开其页面。 - **构建器只对管理员显示。** 其他角色缺少 **Edit with DXPR Builder** 权限。请到 **People** > **Permissions** (`/admin/people/permissions`) 授予。 - **第二位编辑看到 "Only one account can use DXPR Builder on the DXPR Free tier"。** 免费版只允许一位编辑。请在 **License** 下输入付费订阅的产品密钥。 - **报错 "Your product key is not valid"。** DXPR CDN 拒绝了密钥。请在 **License** 下重新粘贴完整密钥（`/admin/dxpr_studio/dxpr_builder/settings`）。 - **报错 "DXPR Builder cloud assets could not be loaded"。** 浏览器连不上 `cdn2.dxpr.com` 或 `cdn.dxpr.com`。请放行两个主机，如[防火墙与数据驻留](/zh-hans/hc/documentation/learn-dxpr-builder/getting-started/behind-a-firewall)所述。 - **AI 提示称 "AI features require the AI module"。** AI 模块尚未设置。请参阅[启用 AI 功能](#turn-on-ai-features-optional)，或在 **AI Features** 下取消勾选（`/admin/dxpr_studio/dxpr_builder/ai_settings`）。 - **Save settings 报告 "Invalid product key"。** 粘贴的不是完整密钥，或是 DXPR Builder 1.x 的密钥。请重新复制当前密钥，不带空格和换行。 [编辑器不出现](/zh-hans/hc/documentation/learn-dxpr-builder/troubleshooting/editor-not-loading)涵盖更多原因。 ## What's next? - [您的第一页](/zh-hans/hc/documentation/learn-dxpr-builder/getting-started/first-page)：从版块、行和元素搭建页面。 - [在已有内容类型上安装](/zh-hans/hc/documentation/learn-dxpr-builder/getting-started/installing-on-existing-content-types)：切换更多内容类型，或添加构建器字段。 - [更新 DXPR Builder](/zh-hans/hc/documentation/learn-dxpr-builder/getting-started/updating)：保持模块最新，每次更新后运行 `drush updatedb`。 - [测试变体](/hc/documentation/learn-dxpr-builder/integrations/ab-testing-overview)：用 [强化学习](https://www.drupal.org/project/rl)模块做 A/B 测试。