Guia de início rápido de desenvolvimento com Linux

A Unreal Engine (UE) oferece suporte ao desenvolvimento em dispositivos Linux usando versões criadas a partir do código-fonte ou versões instaladas pré-compiladas. Esta página fornece instruções sobre como configurar a Unreal Engine no Linux, incluindo seu ambiente de desenvolvimento e pipeline de compilação. Ao concluir este tutorial, você terá o conhecimento necessário para desenvolver aplicativos na Unreal Engine usando sua máquina Linux.

1. Software e hardware recomendados

A Unreal Engine é compatível com diversas distribuições e IDEs do Linux, desde que atendam aos seguintes requisitos mínimos:

Recomendamos que seu sistema atenda ao seguinte padrão para um desempenho fluido do Unreal Editor:

Para configurar seu ambiente de desenvolvimento, recomendamos os seguintes softwares, que testamos com mais frequência:

Consulte a documentação da sua distribuição ou IDE do Linux para obter mais informações sobre como configurá-los. Embora a configuração do SO e do hardware esteja fora do escopo deste documento, a configuração do IDE para funcionar com a Unreal Engine é abordada a seguir.

2. Instalação da Unreal Engine.

Você pode configurar a Unreal Engine no Linux instalando uma versão pré-compilada ou compilando a engine a partir do código-fonte.

2a. Baixar uma versão instalada

A opção mais simples para executar a Unreal Engine é usar uma versão instalada. Para baixar e instalar uma dessas versões, siga estas etapas:

A Unreal Engine no Linux suporta versões instaladas pré-compiladas, bem como compilações de código-fonte. Consulte informações sobre o uso de versões fonte em Building Unreal Engine from Source (Compilando a Unreal Engine a partir do código-fonte).

Para usar uma versão pré-compilada, siga estas etapas:

1. Abra a página Unreal Engine para Linux. Ela solicitará que você crie ou faça login em uma conta da Epic Games. Se você já possui uma, faça login para acessar a página. Se não tiver uma conta, clique em Inscrever-se para criar uma.

   

   Você pode registrar-se para uma conta da Epic Games com seu e-mail ou com uma conta de mídia social ou plataforma de jogos compatível.

   

2. Baixe o arquivo .zip que contém a versão da Unreal Engine que você precisa.

   

3. Descompacte o conteúdo do arquivo .zip no diretório de instalação desejado.

4. Execute Engine/Binaries/Linux/UnrealEditor no Terminal para inicializar a Unreal Engine.

2b. Compilar a Unreal Engine a partir do código-fonte

Para instalar a Unreal Engine a partir do código-fonte, confira Como baixar o código-fonte da Unreal Engine. Depois de compilar a engine, execute Engine/Binaries/Linux/UnrealEditor no terminal para iniciar o Unreal Editor.

3. Como configurar um novo projeto

Consulte as instruções em Como criar um projeto na Unreal Engine para obter informações sobre como configurar um projeto. Você não precisa de um modelo ou tipo de projeto específico para este tutorial, mas certifique-se de que C++ esteja habilitado se estiver configurando seu ambiente para C++.

4. Configure o ambiente de desenvolvimento (C++)

Se você planeja desenvolver projetos em C++, precisa definir o conjunto de ferramentas do Clang e um IDE para trabalhar com a Unreal Engine. Embora não exijamos um IDE específico, recomendamos usar o Visual Studio Code ou o Rider. Esta segmentar fornece instruções específicas para o Visual Studio Code, que é um ambiente de desenvolvimento comum também para outros sistemas operacionais.

1. Instale o conjunto de ferramentas do Clang personalizado para a configuração. Confira Requisitos de desenvolvimento para Linux para obter mais informações.

2. Encontre o diretório de instalação da Unreal Engine, abra Build/BatchFiles/Linux e execute SetupToolchain.sh.

3. Baixar e instalar o VS Code, bem como o pacote oficial de extensões de C/C++ e a extensão de C#. Eles são necessários para a leitura do código-fonte da Unreal Engine e de suas ferramentas de compilação.

4. Abra o Unreal Editor, abra as Preferências do Editor e defina o editor de código-fonte como Visual Studio Code, ou modifique BaseEngine.ini para incluir o seguinte:

   C++

   [/Script/SourceCodeAccess.SourceCodeAccessSettings]
            PreferredAccessor=VisualStudioCode

   Copy full snippet(2 lines long)

5. Execute GenerateProjectFiles.sh -vscode para gerar o espaço de trabalho do VS Code para sua distribuição da engine (no caso de uma compilação de código-fonte) ou seu projeto. Adicione -project=(caminho para o seu projeto) para escolher um projeto específico.

Para obter informações sobre como configurar o VS Code com o IntelliSense e outras ferramentas úteis, confira Como configurar o VS Code para a Unreal Engine.

5. Compile um projeto

Agora que o ambiente está totalmente configurado, execute uma compilação de teste do projeto para garantir que o fluxo de trabalho esteja funcionando.

5a. Compile um projeto no Unreal Editor

Abra o projeto no Unreal Editor, clicar no menu suspenso Platformas e clique em Linux> Empacotar projeto. Se o sistema estiver configurado corretamente, a Unreal Engine irá compilar, preparar e empacotar o projeto.

5b. Compile um projeto pela linha de comando

Para compilar um projeto pela linha de comando, use o comando BuildCookRun do script RunUAT, detalhado no guia Operações de compilação. Este é um exemplo de um comando BuildCookRun funcional:

[UE Root Directory]/RunUAT BuildCookRun -Build -Cook -Stage -Package -Run -Project=[ProjectName]

Como alternativa, você também pode usar a linha de comando Turnkey para iniciar o mesmo processo.

[UE Root Directory]/RunUAT Turnkey -command=ExecuteBuild -platform=Linux -Project=[ProjectName]