CARLA 맥 설치 가이드

Carla를 맥에서 돌리기 위한 설치 가이드 문서를 통해 설치 해보고자 한다. Carla는 언리얼 엔진을 활용한 시뮬레이터로 공식적으로는 리눅스와 윈도우를 지원한다. 그러나 실리콘 맥은 자체 칩을 통해 그래픽 가속화를 지원하기 때문에 리눅스 버전의 설치 가이드로는 실행되지 않는다. 따라서 @nveshaan이 작성한 가이드를 통해서 carla를 맥에서 실행시키는 방법을 정리해보고자 한다.

해당 가이드는 wine 이라는 윈도우 실행파일을 macos에서 구동할 수 있도록 하는 레이어를 통해 구동시킨다. 일반적으로는 윈도우에서 돌아가는 게임들을 돌리기 위해 많이 사용하는듯 하다. carla에서 사용하는 unreal engine 이 맥을 지원하기에 나중에는 carla 코드를 mac용으로 수정하는 작업을 어느정도 거치면 가능할지도 native 로 실행시킬수 있을지도 모르겠다.

테스트 환경

가이드의 실행환경

• MacBook M1 Pro, Mac Mini M4,
• CARLA v0.9.11~0.9.15까지 일부 버전 동작 확인 (최신 버전에서 성능 저하 또는 그래픽 렌더링 문제 발생 가능)
• MacOS 15.5 이상, RAM 16GB(권장), v0.9.15+ 또는 v0.10.0은 24GB 권장 나의 실행환경
• MacBook M2 pro
• 32GB RAM
• MacOS: 15.0.1
• CARLA: 0.10.0

설치 및 준비

Winery 설치 및 최신 엔진, 래퍼 업데이트

Wine 을 사용하도록 지원하는 Winery를 설치해야 하는데 가이드는 github release를 보여주지만 해당 버전으로 실행시에 최신 엔진 설치와 래퍼 업데이트가 안되는 문제가 생겼다. 따라서 나는 GitHub - Sikarugir-App/Sikarugir: A user-friendly tool used to make wine wrapped ports of Windows software for macOS.에서 homebrew를 통해 설치하여 실행하였다.

brew upgrade
brew install --cask --no-quarantine Sikarugir-App/sikarugir/sikarugir

해당 설치를 완료하고 나면 응용 프로그램에서 SikarugirCreater.app 이 설치된 것을 볼 수 있다.
이를 실행 시키면 아래와 같이 엔진을 설치할 수 있는 환경이 나오게 된다.
여기서 + 버튼을 통해 최신 엔진을 설치하고 wrapper 를 업데이트 하면
creat new black wrapper가 활성화 되어 wrapper를 생성할 수 있게 된다.
이름을 지어주고 만들고 나서 carla.app을 finder에서 찾아주고 해당 패키지에 대한 내용을 보기를 하고

이에 contents/Configure.app이라는 어플을 열어서 어플 설정을 해주어야 한다.

Windows용 CARLA 설치

해당 wrapper는 윈도우 버전의 실행 파일을 맥에서 돌아가도록 하기 때문에 윈도우용 carla를 설치해야 한다. Releases · carla-simulator/carla 해당 Releases에서 원하는 버전의 carla를 설치한다. carla를 압축해제한 후,KegworksConfig.app에서 Install Software → Move a Folder Inside로 CARLA 폴더 등록 한다.
그런 다음 실행 파일을 C:/Program Files/WindowsNoEditor/CarlaUnreal.exe로 지정한다.

Winetricks에서 vcrun2019, vcrun2022 설치 (Visual Studio 패키지 필요)

실행 및 사용

• D3DMetal 옵션 체크, Test Run 실시 (정상 동작 확인)
• 문제가 없으면 KegworksConfig.app 종료 후, CARLA.app을 일반 맥 앱처럼 실행
• 실행 시 -RenderOffScreen, –ros2, –port 등의 플래그(옵션)를 Windows app: 칸에 넣어 실행 가능
• Tools 메뉴에서 Task Manager, Command Prompt, Control Panel 등 사용 가능
• 문제 발생시 Kill Wine Processes로 강제 종료 가능
• 퍼포먼스 HUD(Performance HUD) 옵션으로 FPS, GPU, 메모리 정보 확인 가능

기타

• Mac에서는 CARLA 서버만 직접 실행 가능
• CARLA Python 클라이언트는 Mac에서 네이티브 빌드 불가 → Docker로 리눅스 에뮬레이션 실행하거나, 다른 랩탑/PC에서 클라이언트 실행

실제 실행 화면

실제 15 프레임 정도로 잘 돌아가는 것을 확이니 할 수 있다. 해당 python 서버를 도커를 통해 실행시키는 방법에 대해서도 나중에 한번 정리해보고자 한다.

References

GitHub - carla-simulator/carla: Open-source simulator for autonomous driving research. M4 is killing it! CARLA is running beautifully on Mac Mini M4 · carla-simulator/carla · Discussion #9037 · GitHub Releases · Sikarugir-App/Creator GitHub - Sikarugir-App/Sikarugir: A user-friendly tool used to make wine wrapped ports of Windows software for macOS.