知识库
Design System Publisher
您可能会在使用 Design System Publisher 时遇到一些问题。以下是一些常见问题以及排查方法建议。
Bug 报告和功能请求可以提交至 Design System Publisher GitHub 仓库。
浏览器内容与文件系统内容不一致
为了加快启动过程，Design System Publisher 在内部缓存了一些资源。有时，缓存可能会不同步而需要清理。请执行以下命令来清除内部缓存并重新启动开发服务器，查看是否可以修复问题：
Source code
terminal
npm run dspublisher:clean该问题也可能与浏览器缓存有关。如果上述方法无效，请尝试同时清除您浏览器的缓存。
页面标题更改未被渲染
关于页面标题有一个特殊情况。在普通页面中，如果您更改了 AsciiDoc 中的主标题（即，= 页面标题），标题会按预期更新。但若您在页面的 front matter 中使用了 layout: tabbed-page，则标签页的标题实际上是从 front matter 的 title 字段中获取。因此，您可能需要修改该字段。
应用在 Linux 上无法启动
当应用在 Linux 上无法启动时，请确保已安装必要的依赖项。在命令行中运行以下命令完成依赖安装：
Source code
terminal
sudo apt install build-essential autoconf automake libtool pkg-config libpng-dev nasm zlib1g-dev开发服务器启动失败
启动开发服务器的脚本 npm run dspublisher:start 有一些对开发环境的特定预期条件。如果条件未满足，可能会导致服务器无法正常启动，其原因如下：
npm 忽略脚本
如果您配置了 npm 为 ignore-scripts=true，则启动会失败。因此可能得到的错误信息类似如下：
Source code
Error in "/Users/[username]/.npm/_npx/c089b35bd0e8ac07/node_modules/@vaadin/dspublish
er/node_modules/gatsby-transformer-sharp/gatsby-node.js":
Something went wrong installing the "sharp" module
Cannot find module '../build/Release/sharp-darwin-arm64v8.node'要修复该问题，请删除 ignore-scripts 的配置，并清除主目录下的 /.npm/_npx。
缺少 Xcode 命令行工具
在 macOS 上，您需要安装 Xcode 命令行工具。否则当启动时您可能会看到以下类型的错误：
Source code
dsp@[version]:start ████████████████████ Initializing
npx,concurrently,--kill-others,--raw,"npx @vaadin/dspublisher@[version] --develop","mvn -C" failed with code 1Gatsby 在 Windows 上的问题
Design System Publisher 是基于 Gatsby 的，而 Gatsby 在 Windows 上存在一些已知问题。如果您正在使用 Windows，请参阅 Gatsby 在 Windows 上使用 了解更多信息。
建议将 Linux 或 macOS 作为开发平台。在 Windows 上，您可以使用 Windows 子系统 Linux（WSL） 来运行 Design System Publisher。
许可证相关问题
您可通过向以下邮箱联系获取进一步帮助：license@vaadin.com。
我已有有效许可证，但仍然收到试用版提示
请前往以下网址确认您的许可证是否有效：http://vaadin.com/pro/validate-license。 如若无效，可能是贵公司的许可证管理员尚未为您分配许可证席位，或许可证已过期。
使用 Multiplatform Runtime 时出现 SSLHandshakeException 错误
在 Docker 下使用 WebSphere Liberty 和 WildFly 时，有用户 报告过名为 SSLHandshakeException 的已知错误。
详情请参阅以下讨论：http://vaadin.com/forum/t/running-mpr-project-on-websphere-liberty-fails-with-suncertpathbuilderexcep/160675。