Pular para o conteúdo principal

Compilar o Document Builder a partir do código-fonte

Introdução​

O Document Builder é uma ferramenta que permite gerar documentos de texto, planilhas, apresentações e arquivos PDF e automatizar a construção de documentos a partir de modelos. Ele pode ser facilmente integrado ao seu sistema de gerenciamento de documentos utilizando a sua API JavaScript.

Você pode compilar facilmente o Document Builder a partir do código-fonte e implantar a solução no seu servidor local utilizando as build_tools, especialmente projetadas para isso. As build_tools permitem obter e instalar automaticamente todos os componentes necessários para o processo de compilação e todas as dependências exigidas para o funcionamento correto do Document Builder, além de obter a versão mais recente do código-fonte do Document Builder e compilar todos os seus componentes.

Importante

Só podemos garantir o funcionamento correto dos produtos compilados a partir da branch master.

Requisitos de sistema​

Hardware

  • CPU: 4 núcleos
  • RAM: pelo menos 8 GB. Quanto mais, melhor
  • HDD: pelo menos 100 GB de SSD
  • SWAP: pelo menos 4 GB, mas depende do SO host. Quanto mais, melhor

Software

  • Sistema operacional: Ubuntu 24.04
observação

A solução foi testada no Ubuntu 24.04. Outras distribuições podem exigir ações específicas, que não são descritas aqui.

Instalando as dependências​

Talvez seja necessário instalar o Python e o Git, caso ainda não estejam instalados no seu computador. Isso pode ser feito com o seguinte comando:

sudo apt-get install -y python3 git

Compilando o código-fonte do Document Builder​

  1. Clone o repositório build_tools:

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

  2. Navegue até o diretório build_tools/tools/linux:

    cd build_tools/tools/linux

  3. Execute o script automate.py especificando o parâmetro builder para compilar o Document Builder:

    python3 ./automate.py builder
    observação

    Se você executar o script sem nenhum parâmetro, ele compilará o Document Builder junto com o ONLYOFFICE Docs e os Desktop Editors.

    python3 ./automate.py

    Se necessário, você pode compilar vários produtos de uma só vez executando o script com os parâmetros correspondentes aos produtos desejados. Para saber mais sobre a compilação do ONLYOFFICE Docs, leia este artigo. Para saber mais sobre a compilação dos Desktop Editors, consulte este artigo.

Aguarde enquanto o script é executado. Dependendo da capacidade do seu computador, esse processo pode levar um tempo considerável. Por exemplo, ele leva pelo menos 3 horas em 4x2.3GHz vCPUs.

O script compilará todas as dependências e componentes que fazem parte do Document Builder.

A compilação estará disponível no diretório ../../out/linux_64/onlyoffice/documentbuilder/. Agora você pode prosseguir com a execução do Document Builder no seu servidor.

Executando o Document Builder​

Navegue até o diretório ../../out/linux_64/onlyoffice/documentbuilder/:

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

Execute o seguinte comando:

./docbuilder