Esse repositório irá te ajudar a realizar a instalação de maneira correta direto no código fonte do Windows. Então possui duas parte diferentes, a primeira é a do requisitos do sistema e como instalar os softwares necessários, a segunda é a da compilação do CARLA no sistema. Antes de dar inicio siga essas etapas que sua instalação será bem sucedida.
O processo de instalação leva em torno de (4 horas ou mais) por isso é interessante ler com atenção o guia, pois exige varios software important, então precisa analisisar cada processo da instalação.
Caso precise de mais informação tem o Documento do CARLA que pode ajudar, porém aqui será adicionado algumas informações que não possui na documentação, caso possua algum erro de instalação terá o tópico falando a respeito.
- Primeiro Passo: Pré-Requisitos
- Segundo Passo: Construção do CARLA
- Clonar o repositório
- Obter os ativos
- Definição da variável de ambiente da Unreal Engine
- Contrução do CARLA
- Compilação do Servidor
- Primeiros Testes
Nessa processo vai ser instalados pequenos softwares e essenciais para o sistema e as principais dependencias do Python, sendo necessárias antes de contruir o CARLA.
Aqui será mostrado quais os requisitos precisam ter em sua máquina:
- sistema x64: O simulador precisa executar em qualquer Windows com 64 bits.
- 165 GB de disco livre: Somente o CARLA levará 32 GB, e os outros principais softwares que estão relacionados (incluindo a Unreal Engine) utilizarão pelo menos 133 GB.
- GPU adequada: Nesse caso será necessário uma GPU dedicada para rodar as simulações realistas, ou de minimo 6 GB, porém o mais recomendado seria uma de 8 GB.
- Conexão de Internet e 2 portas TCP: Ter uma boa conexão com a internet para rodar melhor as simulações e não ter problemas de conexão.
Essa parte seria interessanter possuir os softwares adequados instalados em seu computador para que não haja algúm problema de compilação, o caminho de ambiente devem estar dentro da variável de ambiente utilizando o diretóriobin
- CMake: tem a finalidade de gerar arquivos de compilação a partir de arquivos de compilação simples.
- Git: seria um controle de versões para gerenciar o repositório CARLA.
- Make: ele gera os executáveis, sendo necessário utilizar a versão 3.81, ou a compilação pode ocorrer falhas. E se for preciso verificar a versão que você está utilizando em seu PATH, através desse comando.
make --version - 7Zip: seria um software de compressão de arquivos, descompactando automaticamente arquivos de ativos evitando erros de compilação de arquivos grandes sendo extraídos incorretamentes.
- Python3 x64: seria a principal linguagém de scripts do CARLA. Instale a versão x64, pois ter a versão x32 pode dar conflito e ocorrer erros, então é aconselhável desinstalar.
Apartir de algumas versões, pode ser instalado o PythonAPI no CARLA, como as versões do CARLA 0.9.12 ou superior, é preciso ter atualização do pip tendo uma verção mais atualizado acima da 20.3. Para verificar se possui essa versão adequada, utilize o seguinte comando:
pip3 -V
Se for preciso atualizar:
pip3 install --upgrade pip
Sendo preciso intalar algumas dependências do Python:
pip3 install --user setuptools
pip3 install --user wheel
Será preciso ter a versão do Visual Studio 2019, pois as versões antigas podem conflitar com versões do CARLA 0.9.12 ou superior. Clique aqui para acessar o site oficial, e escolha a versão Comunidade que seria a gratuita. E utilize o instalador do Visual Studio para instalar 3 elementos importantes:
- SDK Windows 8.1 ou Superior Selecione essa opção na parte de Detalhes da Instalação ou até mesmo vá em Componentes Individuais e procure a opção de SDKs, bibliotecas e estruturas. No nosso caso utilizamos o Windows 11, e selecionamos todos os SDKs Windows 10 e 11, para não ocorrer algum erro na instalação.
- X64 Conjunto de ferramentas do Visual C++. Na sessão de Cargas de Trabalho, escolha Desenvolvimento de área de trabalho com C++. Com isso será habilitado um prompt comando x64 usado para a compilação. Veja com atenção se foi instalado o correto, tome cuidado para não abrir o
x86_x64. - .NET Framework 4.6.2. La na sesão Cargas de trabalho, selecione .NET desktop development e em Painel de instalação, esse processo será essencial para contruir o Unreal Engine.
.NET Framework 4.6.2 development tools
Windowsx64
O CARLA apartir da versão 0.9.12 utiliza a versão da Unreal Engine 4.26, esse patch que seria uma forma de atualização melhorada, o CARLA ja possui esse sistema específico. Antes de começar o processo de baixar a Unreal, é preciso ter uma conta vinculada ao GitHub da Unreal Engine, caso tenha uma dúvida siga esse guia antes de iniciar a instalação. E se precisar saber mais de tutorial, siga esse vídeo tutorial.
Para compilar a versão da Unreal Engine, utilize esse comando:
-
Entre no Prompt de Comando e acesse o caminho do sistema C:\>, e clone a Unreal neste caminho:
git clone https://github.com/EpicGames/UnrealEngine.git
Ou se precisar, utilize a versão da documentação, caso ocorra algum erro, entre no GitHub e pegue o link da versão da Unreal 4.26.2 e faça o mesmo precesso acima dando o git clone.
-
Dentro do caminho da Unreal Engine você vai precisar executar os scripts de configuração, então utilize esses comando no 'Prompt de Comando' dentro da pasta Unreal Engine:
Setup.bat GenerateProjectFiles.bat -
Despois desses passos terem sido concluido, na pasta raiz da Unreal abra no Visual Studio 2019 o arquivo
UE4.sln -
Assim que abrir o Visual Studio, vai na aba de compilação e selecione as opções, 'Editor de Desenvolvimento', 'Win64' e 'UnrealBiuldTool', tem que estar igual a imagem abaixo, se precisar de mais informações use esse guia.
-
No gerenciador de soluções clique com o botão direito em UE4 e selecione Build, a imagem abaixo vai te mostrar caso tenha dúvidas.
-
Assim que for compilado pela primeira vez, acesse a pasta Unreal Engine e procure pelo 'UE4Editor.exe'. Caso não encontre siga esse caminho.
Engine\Binaries\Win64\UE4Editor.exe
Important
Antes de dar inicio a segunda parte da instalação, é recomendado reiniciar o computador.
| Repositório CARLA |
|---|
Caso queira escolher sua versão do CARLA, clique nesse repositório acima e terá acesso a todas as versões, no nosso caso utilizamos a versão 0.9.15.2 que acabou dando certo a instalação, e os erros que derem terá um tópico em específico.
Na imagem acima mostra aonde você pode estar pegando o link e clonando o repositório, e clone em um terminal o repositório e seguindo o mesmo caminho deixando dessa maneira assim que concluir a instalação C:\carla utilizando o seguinte comando:
git clone https://github.com/carla-simulator/carla.git
Para ter a versão mais recente é importante obter os ativos atualizados para que não ocorra nenhum conflito na execuções futuras e poder trabalhar com as versões atuais do CARLA. Execute o seguinte comando dentro da pasta raiz CARLA para adquirir os ativos
Update.bat
Para poder enxergar comando para executar, a imagem mostra dea melhor forma para visualizar.
Esses ativos serão baixados e extraídos no local adequado se tiver o 7zip instalado corretamente
Essa parte seria muito importante, o CARLA precisa encontrar a pasta de instalação da Unreal Engine. E com isso permite qual a versão o usuário irá usar, se ele não encontra, se o CARLA não encontrar, ele vai procurar o Unreal Engine no registro do Windows e usará a primeira versão que aparecer.
Para definir essa variável de ambiente, siga o passo a passo:
- Na tela inicial de pesquisa do Windows em pesquisar, digite "Editar as Variável de Ambiente do Sistema" e em seguida "Variáveis de Ambiente.
- No painel abra a seguinte opção "Variável do Sistema" e clique em "Novo" e crie uma nova Variável chamada "UE4_ROOT", e na parte de valor da variável coloca o caminho que vai encontrar o arquivo, como mostra a imagem.
C:\UnrealEngine\ - Aproveitando que está mexendo na variável de ambiente, verifique se todos os requisitos necessários estão dentro do PATH do sistema. Clique em "path" da variável de ambiente não a do sistema, em seguida em "Editar, se todos os caminhos estiverem adicionaods corretamente de "OK em tudo, está pronto para a próxima etapa.
Essa parte seria uma das mais importantes para realizar a construção do CARLA:
- Todos os comandos dever ser executados dentro da pasta raiz do CARLA, para conseguir realizar a compilação com sucesso:
- É necessário realizar os comandos dentro do x64 Native tools command prompt for vs 2019, escreva em Pesquisar
x64 e vai aparecer, não utilize o x86_64.
Existem duas partes da compilação do CARLA, a do cliente e a do servidor.
Antes de realizar a instalação do CARLA, verfique se as pasta selecionadas nessa imagem, estão iguais as que você fez, se não tiver realize o processos anteriores Unreal Engine e do CARLA, é importante tudo estar dentro do Sistema Principal C:\
O cliente PythonAPI concede o controle das simulações, essa parte da compilação é realizada apenas uma vez por isso é a mais demorada, sendo essencial que compile corretamente, e que todos as dependências estejam instaladas de forma correta, então verifique antes todos os passos anteriores se estão no caminho certo. Assim que for concluido a compilação, poderá interagir com qualquer scripts para ter a interação com as simulações.
Este comando irá compilar o cliente PythonAPI:
make PythonAPI
Assim que o PythonAPI termina de compilar a primeira vez ocorre um erro que não especifica na documentação e estarei adcionando nesse tópico. Este erro referece que o não está conseguindo compilar o arquivo, pois não está encontrando o diretório no caminho especificado, acompanhe a seguinte imagem:
Atraves desse erro, foi realizado o seguinte processo:
- Vai haver uma seguinte correção no código, que seria no arquivo BuildOSM2ODR, na seguinte imagem :
- Nesse processo abra o arquivo para editar no VS Code, e mudar a seguinte linha do código
.\Util\BuildTools\BuildOSM2ODR.bat
cmake -G %GENERATOR %PLATFORM%^
Para a seguinte modifição, que no nosso caso deu certo a compilação sem nenhum erro:
cmake -G %GENERATOR% -A x64^
Se precisar acessar mais respostas entre nesse guia ou se for o caso ter mais dúvidas entre no grupo do Discord, la possui vários canais e tira dúvidas importantes.
Important
Assim que fizer isso, reinicie novamente o computador e refaça a compilação do make PythonAPI, dentro da pasta raiz do CARLA.
Assim que realizar essa correção realize a compilação do make PythonAPI, a seguinte mensagem deve surgir depois de terminado a compilação:
Assim que foi compilado o PythonAPI, dentro da pasta raiz CARLA, vai ser compiladop o servidor, aonde vai ser realizado alterações de mapas, veículos e outros modelos. Dentro dele abrirá o servidor na Unreal Engine 4 Editor, com o ambiente CARLA.
Para realizar essa compilação execute o seguinte comando:
make launch
Dentro do x64 e na pasta raiz CARLA, espere ele compilar até o fim, abrindo a UE4Editor:
Essa primeira compilação é demorada, mas não se preocupe, depois de feito uma vez nas próximas serão mais rapidos para abrir o servidor. Agora você ja pode estar realizando suas primeiras simulações
Em um prompt de comando, no x64 ou dentro do Visual Code com o servidor aberto dando Play para poder o ambiente, realize os primeiros testes de simulação:
C:\carla\PythonAPI\examples> python generate_trafic.py
Nesse comando você pode realizar a geração de tráfegos de pedestres e veículos.
C:\carla\PythonAPI\examples> python manual_control_steeringwheel.py
A espécificação desse comando, realiza como dirigir com o Volante G29 Logitech e os pedais.
C:\carla\PythonAPI\examples> python automatic_control.py
Dando esse comando mostra dentro do servidor o veículo pilotando automaticamnte.