23.4.3 C++ 헤더 포함(Include) 내보내기 규칙 및 라이브러리 가시성 제어 매크로 역학

ROS2의 C++ 패키지는 단일 실행 파일(Executable)로 제한 종결되기도 하지만, 다수의 계층 노드가 공통으로 의존해야 하는 독자적 메시지 구조체나 고도화된 제어 알고리즘이 내포된 경우 공유 라이브러리(Shared Library, .so) 형태로 타 패키지 생태계에 노출(Export)되어야 한다. 멀티 패키지 분산 워크스페이스 체제에서 A 패키지의 헤더 세트와 바이너리 라이브러리를 B 패키지가 메모리 상에서 안전하고 모듈화된 방식으로 링킹(Linking)할 수 있도록 보장하는 전체 파이프라인 메커니즘의 핵심은 CMake 기반의 헤더 내보내기 규칙 정합성과 심볼 가시성(Symbol Visibility) 제어 매크로 역학에 있다.

1. Ament 환경의 추상 인터페이스 내보내기 매크로 메커니즘

ament_cmake 체제 하에서, 단순히 특정 패키지 내부에 헤더(Header) 파일을 올바르게 작성하고 라이브러리를 무결하게 빌드하는 것만으로는 여타 패키지가 이를 즉각적으로 탐색(Find)하고 의존망에 결합할 수 없다. 외부 컴포넌트 소비 패키지(Consumer package) 생태계를 위해 툴체인 상에 명시적이고 규격화된 내보내기(Export) 선언적 서술이 엄격히 요구된다.

• ament_export_include_directories(): 빌드 로직이 완료된 후 설치 공간(install/)의 include/ 종착 디렉터리에 노출될 공용 헤더들의 절대 경로 지표를 Colcon 전역 시스템 인덱스 및 OS 환경 변수(AMENT_PREFIX_PATH)에 개방 명시적으로 등록한다. 이를 통해 외부 타 패키지는 C++ 소스 코드 최상단에서 별도의 복잡한 상대 경로 지정 지시 없이도 #include "my_package/my_header.hpp" 형태의 모듈형 네임스페이스 기법으로 간결하고 정확하게 링킹 대상 경로를 참조할 수 있다.
• ament_export_dependencies(): 현재의 패키지가 바이너리 링킹 절차 과정에서 선행적으로 의존성을 가졌던 3rd-party 패키지나 ROS2 코어 라이브러리(예: rclcpp, std_msgs) 목록 체인을 선언한다. 이는 전치적이고 전이적인 런타임 의존성(Transitive dependency)을 확고히 성립시켜, 결과적으로 이 패키지를 재사용하는 자식 및 외부 노드가 기초 백엔드 의존성들을 번거롭게 무한 중복으로 코드 상에 재선언하지 않도록 툴체인 파이프라인 링킹 오버헤드 부담을 극적으로 경감(Mitigating)시킨다.
• ament_export_targets(): CMake 구조 레벨에서 빌드 완료 정의된 정적/동적 라이브러리 머신 코드의 타겟 링킹 레퍼런스 포인터를 외부로 노출시켜, 의존 타 패키지에서 target_link_libraries() 링커 지시어 수행 시 추상화된 단일 타겟 명칭만으로 복잡한 디스크 상의 라이브러리 심볼릭 주소를 올바르게 바인딩하도록 강제 유도한다.

2. CMake 타겟 가시성(Visibility) 통제 제어 속성

C++ 정적 컴파일 파이프라인 구역 내부에서 핵심 라이브러리 타겟 산출물과 헤더 포함(Include) 디렉터리 경로를 상호 연결할 때, CMake 툴체인이 지원하는 계층적 가시성 제어 키워드 프레임워크는 소프트웨어 아키텍처의 은닉성(Encapsulation) 및 캡슐화를 결정짓는 매우 중요한 보안 설계 역학이다.

• PRIVATE 속성: 특정 헤더 인터페이스 폴더나 의존성 링크 라이브러리가 대상 시스템 타겟을 내부적으로 컴파일할 때(보안된 내부 구현부: .cpp)만 일시적으로 스코프(Scope)가 한정 적용되며, 이 완성 타겟을 후속으로 링킹하는 외부 타 패키지 환경에게는 절대 참조 노출되지 않도록 헤더 접근 권한을 철저히 단절 차단한다.
• INTERFACE 속성: 라이브러리 타겟 자신을 자체 컴파일하는 빌드 과정에서는 해당 헤더 코드가 전혀 필요치 않고 사용되지 않으나, 이 라이브러리 타겟을 결과적으로 가져다 소비(Consume)하는 대상 외부 패키지 생태계들에게는 링킹 단계 진입 시점부터 반드시 100% 노출 및 전이되어야만 하는 특수한 헤더-온리(Header-only) 라이브러리 등의 제한적 링킹 환경을 역설적으로 명시한다.
• PUBLIC 속성: 가시성 계층 제어 중 PRIVATE과 INTERFACE의 완벽한 합집합 개념으로서, 제공 타겟 시스템 자신의 독립적 내부 컴파일을 위한 기초 시점뿐만 아니라 이를 릴레이 상속하여 링킹하는 제3의 외부 패키지들의 전역(Global) 구동 환경 양쪽 모두로 해당 헤더 구조와 라이브러리 코드 의존성을 전면 개방 노출하여 자유로운 상속을 허가한다.

3. 크로스-운영체제 플랫폼 포팅(Porting) 안전형 심볼 가시성 링커 매크로

ROS2 코어 프레임워크는 POSIX 계열(Linux/Ubuntu) 표준 내장뿐만 아니라 이질적인 Windows/Mac OS 시스템 컴퓨팅 환경과의 크로스 플랫폼 포팅 아키텍처를 원초적으로 깊게 지향한다. 따라서 C++ 객체 지향 기반 언어로 컴파일되는 시스템 공유 라이브러리(.so 또는 .dll) 빌드 도중, 라이브러리 메모리 내부에 존재하는 수십만 개의 구현 함수와 클래스 인스턴스 심볼(Symbol) 중 정확히 어떠한 식별자 표식만을 외부 노드 응용 프로그램(Consumer Node) 링커 체인에 선별 노출할 것인지를 운영체제 컴파일러(Compiler) 수준 영역에서 명확하게 엄격히 제어 지시하는 가시성 제어 전처리 매크로(Visibility Control Pre-processor Macro) 기술 표준 템플릿이 무조건 강제된다.

일반적으로 C++ ROS2 패키지는 템플릿 스캐폴딩 터미널 초기 생성 시 include/<package_name>/visibility_control.h 헤더 트리 계층을 최우선적으로 자동 전개한다. 이 내부 매크로 모음은 구동 중인 OS 컴파일러 지시자를 동적으로 즉시 판별 검증한다. 만약 대상 시스템이 Linux/GCC/Clang 환경의 경우 __attribute__((visibility("default"))) 또는 __attribute__((visibility("hidden"))) 어셈블리 지시문 포맷으로 가변 변환되어 외부 노출 및 은닉 타겟 심볼의 런타임 링킹 메모리 오버헤드를 제어하며, 이질적인 Windows/MSVC 환경에서는 라이브러리의 자체 컴파일 소요 단계(Building)일 경우 __declspec(dllexport) 심볼 추출 구문으로, 역으로 외부 OS 노드에서 시스템 내장 라이브러리를 소비(Consuming) 결합할 경우 __declspec(dllimport) 심볼 로드 구문으로 삼단 논리 역학에 기반하여 실시간 동적 치환 결합을 강제 실행한다. 이 정밀하고 엄밀한 하드웨어 컴파일러 매크로 제어 프레임워크를 통해 ROS2 아키텍처 개발자는 의미 없는 심볼 찌꺼기 테이블의 기하급수적 폭증을 선단 방어하고, 런타임 링킹 프로세스의 지연을 막는 경량화 부스터와 상이한 구조의 크로스 이종 플랫폼 바이너리 이식성 통과 안정성을 동시에 포괄적으로 보장받는다.