Esta página apresenta instruções detalhadas para que os assinantes baixem o código-fonte da Unreal Engine (UE) a partir do repositório GitHub da Unreal Engine e comecem a trabalhar com o código.
Antes de acessar o repositório em https://github.com/EpicGames/UnrealEngine, você deve:
ter uma conta da Epic Games;
ter uma conta do GitHub; e
ter associado sua conta do GitHub à sua conta da Epic Games, conforme descrito na página Unreal Engine on GitHub.
Você não precisa baixar o código-fonte para trabalhar com a Unreal Engine. Se preferir simplesmente baixar e instalar a versão binária da Unreal Engine, leia nossa documentação Installing Unreal Engine (Como instalar a Unreal Engine) para saber como obter a Unreal. No entanto, ter acesso ao código-fonte pode ser extremamente valioso para você e seu projeto. Por exemplo:
Você terá acesso a todas as funcionalidades e correções de bugs mais recentes que os engenheiros da Epic fazem todos os dias, praticamente atualizados.
Se encontrar um bug que ainda não corrigimos, mas que é crucial para o seu projeto, você pode desbloquear seu projeto corrigindo a sua versão do código-fonte e recompilando seu próprio conteúdo binário.
Você pode aperfeiçoar a engine e ajudar toda a comunidade Unreal enviando suas correções e funcionalidades para a Epic.
Se for um licenciado da Unreal Engine, pode acessar o código-fonte pelo servidor Perforce em vez do repositório público do GitHub.
Acessando o código-fonte da Unreal Engine no GitHub
A Unreal Engine inclui acesso total ao código-fonte C++ completo, para que você possa estudar, personalizar, estender e depurar toda a Unreal Engine e concluir seu projeto sem obstruções.
Nosso repositório de códigos-fonte no GitHub passa por atualizações contínuas à medida que desenvolvemos funcionalidades em nossa própria linha principal, para que você não precise esperar pela próxima versão do produto para ter o código mais recente em mãos.
Para acessar o código-fonte da Unreal Engine, faça o seguinte:
Acesse o GitHub e crie uma conta.
Inicie uma sessão em UnrealEngine.com com sua conta verificada da Epic Games. Para abrir o painel da conta, focalize o seu nome de usuário e selecione Personal (Pessoal) no menu suspenso.
Com o painel da conta aberto, selecione a aba Connections (Conexões) na barra lateral. Selecione a aba Actors (Atores) e selecione o botão Connect (Conectar) sob o ícone do GitHub.
Se ainda não tiver assinado o Acordo de Licença de Usuário Final (EULA) da Unreal Engine, será necessário ler seus termos e marcar a caixa de seleção e, em seguida, selecionar Link Account (Vincular conta). Se estiver desconectado da sua conta do GitHub, você será direcionado ao GitHub para iniciar uma sessão depois de clicar no botão "Link Account".
Para concluir o processo de autorização do aplicativo OAuth, clique no botão Authorize EpicGames (Autorizar EpicGames). Acesse mais informações sobre esse processo em GitHub's overview on Authorizing OAuth Apps (Visão geral sobre autorização de aplicativos OAuth do GitHub).
O GitHub enviará um e-mail convidando você para se juntar à organização @EpicGames no GitHub. Você deve clicar no botão Join @EpicGames(Participar da @EpicGames) neste e-mail em até sete dias para concluir o processo de vinculação das contas do GitHub e da Epic Games.
Após a conclusão, você receberá um e-mail da Epic Games confirmando que suas contas do GitHub e da Epic Games foram efetivamente vinculadas. Se não receber um e-mail de confirmação ou se sua conta estiver com problemas, obtenha ajuda do Atendimento ao Cliente. Acesse nossa página do GitHub (login necessário) e baixe o código-fonte completo para começar.
Ramificações do Código-fonte
Você perceberá que publicamos o código-fonte da UE em várias ramificações.
As ramificações cujos nomes contêm dev, staging e test normalmente destinam-se a processos internos da Epic e raramente são úteis para usuários finais, outras ramificações de curta duração podem aparecer periodicamente conforme estabilizamos novas versões ou hotfixes.
Ramificação de lançamento
A ramificação Release (Lançamento) sempre reflete a versão oficial atual. Elas foram testadas extensivamente pela equipe de controle de qualidade e são um ótimo ponto de partida para aprender a usar a Unreal Engine e tornar seu projeto proprietário. Trabalhamos arduamente para tornar os lançamentos estáveis e confiáveis, e nosso objetivo é publicar uma nova versão em intervalos de alguns meses.
Ramificação principal
A maior parte do desenvolvimento ativo na UE acontece na ramificação ue5-main. Essa ramificação reflete a versão mais recente da engine e pode apresentar bugs ou pode não ser compilar. Nós a disponibilizamos para desenvolvedores ansiosos para testar novas funcionalidades ou para trabalhar em um desenvolvimento em etapas.
Se você escolher trabalhar nessa ramificação, esteja ciente de que ela provavelmente estará à frente da ramificação para a versão oficial atual e o próximo lançamento futuro. Portanto, o conteúdo e o código criados para funcionar com a ramificação ue5-main podem não ser compatíveis com versões públicas até que criemos uma nova ramificação diretamente da ue5-main para um lançamento oficial futuro.
Consulte o artigo Como configurar o Visual Studio para garantir que tenha uma versão do Visual Studio compatível com a versão desejada da Unreal Engine.
Instale o GitHub para Windows e, em seguida, bifurque e clone nosso repositório.
Para usar o Git pela linha de comando, consulte os artigos Configurar o Git e Criar fork de um repositório.
Se preferir não usar o Git, pode obter o código-fonte clicando no botão "Baixar ZIP" à direita. O utilitário zip integrado do Windows marcará o conteúdo do arquivo zip baixado da internet como não seguro de executar, então clique com o botão direito no arquivo zip e selecione "Propriedades..." e "Desbloquear" antes de descompactá-lo. Utilitários de zip de terceiros não fazem isso.
Instale o Visual Studio.
Todas as edições para desktop do Visual Studio compilar a UE, incluindo o Visual Studio Community, que é gratuito para pequenas equipes e desenvolvedores individuais. Consulte a página Setting Up Visual Studio (Como configurar o Visual Studio) para garantir que tenha baixado todos os componentes necessários do VS para trabalhar com a UE.
Abra a pasta de origem no Explorer e execute
Setup.bat.Isso baixará o conteúdo binário para a engine, além de instalar os pré-requisitos e configurar as associações de arquivos da Unreal. No Windows, pode aparecer um aviso do SmartScreen. Clique em More Info (Mais informações) e depois em Run anyway (Executar mesmo assim) para continuar.
Um download limpo das binárias da engine pode levar algum tempo para ser concluída. Check-outs subsequentes só precisam de downloads incrementais e são muito mais rápidos.
Execute
GenerateProjectFiles.batpara criar arquivos de projeto para a engine. A conclusão deve levar menos de um minuto.Carregue o projeto no Visual Studio clicando duas vezes no arquivo
UE5.sln. Defina a configuração da solução como Development Editor e a plataforma da solução como Win64 e clique com o botão direito no destino da UE e selecione Build (Compilar). A compilação pode levar de 10 a 40 minutos, dependendo das especificações do sistema.Após a conclusão da compilação, você pode carregar o editor do Visual Studio definindo o projeto de inicialização como UE5 e pressionando F5 para depurar.
Essa página que mostra aos licenciados como baixar e compilar a Unreal Engine a partir de nosso repositório de códigos-fonte no GitHub. Se quiser baixar a versão binária da Unreal Engine, leia nossa documentação Como instalar a Unreal Engine para o aprender a obter a Unreal.
Plataformas de destino adicionais
O suporte para Android será baixado pelo código de configuração se o NDK do Android estiver instalado. Consulte o guia Android Quick Start (Início rápido no Android).
O desenvolvimento em iOS requer um Mac. As instruções estão no guia iOS Quick Start (Início rápido no iOS).
O desenvolvimento para consoles e outras plataformas com acesso restrito, como Sony PlayStation, Microsoft Xbox e Nintendo Switch, só é possível se você tiver uma conta de desenvolvedor registrada com esses fornecedores terceiros.
Dependendo da plataforma, pode haver documentação ou orientação adicional no site Epic Pro Support ou como um arquivo para baixar na seção dos Fóruns da Unreal Engine dedicados à sua plataforma.
Se você não tiver acesso a esses recursos, primeiro registre uma conta de desenvolvedor no fornecedor terceiro. Depois, entre em contato com seu gerente de contas da Epic Games se tiver uma ou preencha e envie o formulário Console Development Request (Pedido de desenvolvimento para consoles) para Unreal Engine, caso não tenha. A Epic entrará em contato com você com um acordo formal para assinar digitalmente. Após a aprovação, você receberá instruções sobre como acessar o código-fonte, binários e instruções adicionais para sua plataforma.
Licenciamento e contribuição
Seu acesso e uso da Unreal Engine no GitHub são regidos pelo Acordo de Licença de Usuário Final (EULA) da Unreal Engine. Se você não concordar com os termos, conforme alterados de tempos em tempos, você não terá permissão para acessar ou usar a Unreal Engine.
Qualquer contribuição ao desenvolvimento da Unreal Engine será bem-vinda por meio de solicitações de pull no GitHub. A maior parte do desenvolvimento ativo ocorre na ramificação mestra,
por isso, preferimos fazer solicitações de pull lá (principalmente para novas
funcionalidades). Tentamos garantir que todos os novos códigos sigam ao
Próximas etapas
Agora que você baixou e configurou a Unreal Engine, pode compilar a engine a partir do código-fonte.
Notas de rodapé
A primeira vez que você iniciar o editor a partir de uma nova compilação do código-fonte, o tempo de carregamento pode ser longo. A engine está otimizando o conteúdo para a sua plataforma para o cache de dados derivados, e isso só deve acontecer uma vez.
Suas bifurcações privadas do código da Unreal Engine são associadas às permissões da sua conta do GitHub. Se você cancelar a inscrição ou trocar de nome de usuário no GitHub, precisará bifurcar novamente e fazer o upload das alterações a partir de uma cópia local.