나무모에 미러 (일반/밝은 화면)
최근 수정 시각 : 2026-09-30 03:37:37

Autoware Universe



#!if top = 문서명1 != null ? 문서명1 : calleeTitle != null ? (i = calleeTitle.lastIndexOf("/")) != -1 ? calleeTitle.substr(0, i) : '상위 문서' : '상위 문서'
[[파일:상위 문서 아이콘.svg|align=left&width=21.6px]] {{{#!html  }}} 상위 문서: [[]]


1. 개요2. 배경3. Autoware Core와의 관계4. 저장소 구조
4.1. 주요 패키지
5. 저장소 이름 변경6. 빌드 및 개발
6.1. ROS 2 Jazzy 전환
7. 한계8. 관련 문서9. 외부 링크

1. 개요

Autoware Universe
개발 Autoware Foundation 및 커뮤니티
분류 Autoware 확장 패키지 저장소
지원 언어 C++, Python
동작 환경 Ubuntu 22.04 / ROS 2 Humble
라이선스 Apache License 2.0
링크 GitHub · 문서

Autoware Universe(오토웨어 유니버스)는 오픈 소스 자율주행 소프트웨어 Autoware의 확장 패키지 저장소다. 품질이 검증된 기반 패키지를 모아 둔 Autoware Core와 짝을 이루며, 개인·기업·연구기관이 기여한 실험적이고 최신 기술을 담은 패키지들을 관리한다.

저장소는 Autoware Universe를 두고 "Autoware 생태계의 기초가 되는 기둥으로서, 자율주행 기술의 핵심 기능을 강화하는 데 핵심적인 역할을 한다"고 설명하고 있다.[1]


2. 배경

파일:상세 내용 아이콘.svg   Autoware의 배포판 변천사에 대한 자세한 내용은 Autoware 문서
#!if (문단 == null) == (앵커 == null)
를
#!if 문단 != null & 앵커 == null
의 [[Autoware#s-2|2]]번 문단을
#!if 문단 == null & 앵커 != null
{{{#!if 문서명 = 문서명 != null ? 문서명 : calleeTitle
의 [[Autoware#|]] 부분을}}}
참고하십시오.

Autoware의 두 번째 배포판인 Autoware.Auto는 ROS 2 기반으로 코드베이스를 처음부터 다시 작성하면서 아키텍처 설계와 테스트 작성 같은 엔지니어링 관행을 도입했다. 그러나 품질 기준이 엄격한 만큼 신규 개발자가 기여하기 어려웠고, 대규모 아키텍처 변경을 반영하기도 힘들었다. 실제 기여자도 대부분 Autoware Foundation 소속 기업 인력에 한정되었다.[2]

이 문제를 풀기 위해 2020년 TIER IV는 저장소를 안정성 계층과 혁신 계층으로 나누는 Core/Universe 구조를 제안했고, 2022년 Bus ODD 작업에 적용되면서 공식 체제가 되었다.[3] Universe는 이 중 혁신 계층에 해당한다.

3. Autoware Core와의 관계

<rowcolor=#ffffff>구분 Autoware Core Autoware Universe
성격 품질 보증 기반 계층 커뮤니티 혁신 계층
유지보수 Autoware Foundation 커뮤니티 공동
품질 기준 단위·통합·성능 테스트 및 실차 검증 기여자가 자체 기준 설정
API 안정성 일관된 API, 안정적 버전 관리 상대적으로 유동적
목적 신뢰할 수 있는 기반 제공 빠른 프로토타이핑과 실험

두 계층은 서로 배타적이지 않다. 사용자는 Core의 특정 컴포넌트를 Universe의 동등 기능으로 교체해 사용할 수 있으며, 이는 Autoware가 채택한 마이크로자율성(microautonomy) 아키텍처 덕분에 가능하다. 각 모듈이 명확히 정의된 입출력을 갖는 빌딩 블록으로 설계되어 있어, 인터페이스만 지키면 구현을 갈아끼울 수 있기 때문이다.[4]

또한 Universe에서 성숙도와 안정성이 입증된 패키지는 Core로 승격될 수 있다. 재단은 이를 혁신 → 표준화 → 운영 환경으로 이어지는 상향식 진화 경로로 설명한다. 실제로 NDT 스캔 매칭 기반 위치 추정기인 autoware_ndt_scan_matcher와 확장 칼만 필터 기반 autoware_ekf_localizer는 현재 Autoware Core에 포함되어 있다.

4. 저장소 구조

저장소 최상위는 자율주행 스택의 기능 영역에 대응하는 디렉터리로 나뉜다.
<rowcolor=#ffffff>디렉터리 내용
common 여러 컴포넌트가 공유하는 공통 유틸리티
sensing 센서 데이터 수신 및 전처리
localization 자차 위치·자세 추정
map 포인트 클라우드 맵, Lanelet2 벡터 맵 처리
perception 객체 검출·추적·예측, 신호등 인식
planning 경로 및 속도 계획
control 궤적 추종 및 차량 제어 명령 생성
vehicle 차량 인터페이스 관련 패키지
system 시스템 감시, 진단, 페일세이프
simulator 시뮬레이션 지원 패키지
evaluator 주행 성능 평가
visualization RViz 플러그인 등 시각화
e2e 엔드투엔드 모델 관련 패키지

4.1. 주요 패키지

공식 문서에 등재된 대표 패키지는 다음과 같다.[5]

5. 저장소 이름 변경

2025년 1월 23일, ROS 패키지 명명 규칙에 맞추기 위해 저장소 이름에서 점을 밑줄로 바꾸자는 제안이 올라왔다. 당시 Autoware Foundation의 다른 저장소는 모두 밑줄을 쓰고 있었는데 autoware.universe와 autoware.core 둘만 점을 쓰고 있었다.

2025년 3월 19일 변경이 완료되어 autoware.universe는 autoware_universe로, autoware.core는 autoware_core로 바뀌었다.[6] 이는 apt install ros-$ROS_DISTRO-autoware-core 형태로 ROS 빌드팜을 통해 배포하기 위한 사전 작업이기도 했다. GitHub의 리다이렉트가 동작하므로 기존에 클론해 둔 저장소는 영향을 받지 않는다.

6. 빌드 및 개발

Universe는 단독으로 쓰이기보다 Autoware 메타 저장소를 통해 함께 내려받아 빌드한다. 메타 저장소의 repositories/autoware.repos 파일이 Universe를 포함한 하위 저장소 목록을 정의하며, vcs import로 내려받은 뒤 colcon build로 빌드하는 방식이다.

#!syntax bash
vcs import src < repositories/autoware.repos
colcon build --symlink-install --cmake-args -DCMAKE_BUILD_TYPE=Release


실행 설정과 파라미터는 별도의 autoware_launch 저장소가 담당하며, 이 안에 autoware_universe_launch 디렉터리가 포함되어 있다.

6.1. ROS 2 Jazzy 전환

2026년 9월 기준 동작 환경은 Ubuntu 22.04와 ROS 2 Humble이다. Autoware 전체 차원에서 Ubuntu 24.04·ROS 2 Jazzy로의 전환이 진행 중이며, 2026년 2월 Jazzy Docker 베타, 2026년 4월 Jazzy 정식 지원, 2027년 1월 Humble 소프트 프리즈, 2027년 5월 Jazzy 전용 전환의 일정이 공개되어 있다.[7] Universe 역시 Humble 호환성을 유지하면서 Jazzy 지원을 추가하는 방향으로 작업이 이루어지고 있다.

7. 한계

8. 관련 문서

9. 외부 링크



[1] autowarefoundation/autoware_universe, GitHub. 원문은 "Autoware Universe serves as a foundational pillar within the Autoware ecosystem, playing a critical role in enhancing the core functionalities of autonomous driving technologies".[2] How is Autoware Core/Universe different from Autoware.AI and Autoware.Auto?, Autoware Documentation.[3] Past, Present and the Future of Autoware, Autoware Foundation.[4] Concepts, Autoware Documentation.[5] Autoware Universe Documentation.[6] The renaming of the repositories autoware.universe and autoware.core, GitHub Discussions.[7] Support ROS 2 Jazzy Jalisco, GitHub Issues.