跳到主要内容

编译文档生成器

简介​

文档生成器是一个工具，允许您生成文本文档、电子表格、演示文稿和 PDF 文件，并使用模板自动化文档构建。它可以使用其 JavaScript API 轻松集成到您的文档管理系统中。

您可以使用专门设计的 build_tools 轻松从源代码编译文档生成器，并将解决方案部署在本地服务器上。build_tools 允许自动获取和安装编译过程所需的所有组件、文档生成器正确工作所需的所有依赖项，以及获取最新版本的文档生成器源代码并构建其所有组件。

重要

我们只能保证从 master 分支构建的产品的正确工作。

系统要求​

硬件

  • CPU：4 核
  • RAM：至少 8 GB。越多越好
  • HDD：至少 100 GB SSD
  • SWAP：至少 4 GB，但取决于主机操作系统。越多越好

软件

  • OS：Ubuntu 24.04
备注

该解决方案已在 Ubuntu 24.04 上测试。其他发行版可能需要一些特定操作，此处未描述。

安装依赖项​

如果您的计算机上尚未安装 Python 和 Git，您可能需要安装它们。可以使用以下命令完成：

sudo apt-get install -y python3 git

构建文档生成器源代码​

  1. 克隆 build_tools 仓库：

    git clone https://github.com/ONLYOFFICE/build_tools.git

  2. 转到 build_tools/tools/linux 目录：

    cd build_tools/tools/linux

  3. 运行 automate.py 脚本，指定 builder 参数以编译文档生成器：

    python3 ./automate.py builder
    备注

    如果您运行脚本时没有任何参数，这将构建文档生成器以及 ONLYOFFICE 文档和桌面编辑器。

    python3 ./automate.py

    如有必要，您可以通过运行带有对应必要产品参数的脚本一次性构建多个产品。要了解更多关于编译 ONLYOFFICE 文档的信息，您可以阅读这篇文章。要了解更多关于编译桌面编辑器的信息，请参考这篇文章。

等待脚本执行。根据您的计算机能力，此过程可能需要相当长的时间。例如，在 4x2.3GHz vCPUs 上至少需要 3 小时。

脚本将编译所有属于文档生成器的依赖项和组件。

构建结果将在 ../../out/linux_64/onlyoffice/documentbuilder/ 目录中可用。现在您可以继续在服务器上运行文档生成器。

运行文档生成器​

转到 ../../out/linux_64/onlyoffice/documentbuilder/ 目录：

cd ../../out/linux_64/onlyoffice/documentbuilder

执行以下命令：

./docbuilder