从本地构建运行编辑器.
默认情况下,编辑人员的浏览器从 DXPR CDN 加载 DXPR Builder 编辑器,您无需设置任何内容。本页面向从源码构建编辑器的开发人员,用于调试或测试更改。完成后,编辑器从模块文件夹中的文件运行,压缩或可读版本均可。要让 CDN 通过防火墙,请改参阅 防火墙和数据驻留。
开始之前
- 您需要 DXPR Builder 的 git 检出,并装好 Node 依赖。drupal.org 的发行版不含本地构建。
- 您需要 Administer DXPR Builder configuration 权限。
设置
- 在模块文件夹中运行
npx grunt build。它将编辑器写入dxpr_builder/,压缩和未压缩版本都有。 - 前往 DXPR Studio > DXPR Builder > General Settings (
/admin/dxpr_studio/dxpr_builder/settings)。 - 展开 Editor Assets。该部分只在存在本地构建时出现。
- 在 Asset source 下选择 Local (minified) 或 Local (unminified)。
- 点击 Save settings。
您会看到的内容
在构建器中重新加载页面。浏览器现在从您自己网站上模块的 dxpr_builder/ 文件夹加载编辑器脚本,不带 CDN 请求所带 jwt 参数。Local (unminified) 加载可读的 .js 文件,Local (minified) 加载更小的 .min.js 文件。
设置
| 选项 | 加载内容 | 用于 |
|---|---|---|
| Cloud(默认) | 来自 cdn2.dxpr.com 的编辑器,cdn.dxpr.com 为备用。每个请求都带上您的产品密钥。 |
从发行版安装的每个网站 |
| Local (minified) | dxpr_builder/*.min.js,模块文件夹中的文件 |
按生产运行方式测试构建 |
| Local (unminified) | dxpr_builder/*.js,模块文件夹中的文件 |
调试 |
本地构建始终胜过 Cloud。选中 Cloud 时,网站加载未压缩文件,只有压缩文件时加载压缩文件。DXPR 只为发行版发布云端文件,因此开发检出本来也用不了它们。
如果您看不到本地构建
- 没有 Editor Assets 部分。 模块的
dxpr_builder/文件夹中没有构建。请在 git 检出中运行npx grunt build,再重新加载设置页面。 - 只提供一个 Local 选项。 只有压缩或只有未压缩文件存在。请运行完整的
npx grunt build,它会写入两者。 - 选中了 Cloud,但加载的还是本地文件。 存在构建时这是设计使然。请删除
dxpr_builder.js和dxpr_builder.min.js(dxpr_builder/中),并在/admin/config/development/performance清除缓存。 - 编辑器不出现,对
cdn2.dxpr.com的请求失败。 防火墙或内容安全策略屏蔽了 CDN。请放行两个 CDN 主机;请参阅 防火墙和数据驻留。