QGroundControl(QGC) 개발자 가이드

- for masOS (7/9)

Part 7. Customization & Custom Builds (커스터마이징 및 맞춤형 빌드)

이 파트에서는 macOS 환경에서 QGroundControl(QGC)을 커스터마이징하고 맞춤형 빌드를 제작하는 방법을 설명합니다. 공식 Developer Guide의 Custom Build 지침을 기반으로 Fork, 플러그인 확장, 리소스 오버라이드, UI 커스터마이징, 브랜칭 전략, MAVLink 커스터마이징까지 포함했습니다.

---

1) Custom Build 개요

macOS 환경에서도 QGC를 브랜드화하거나 기업 전용 버전으로 제작할 수 있습니다

주요 변경: 로고, 색상 테마, Toolbar, Fly View, 첫 실행 프롬프트

2) 저장소 준비 (Fork + custom_example)

GitHub Fork 후 `custom_example`을 `custom`으로 복사

Xcode 또는 Qt Creator에서 해당 custom 폴더를 빌드에 반영

3) Custom Build Plugins 확장

FirmwarePlugin: 펌웨어별 동작

AutoPilotPlugin: 파라미터 관리 및 UI 연동

QGCCorePlugin: 전체 UI/동작 수정

4) 리소스 오버라이드

resources.qrc 수정으로 아이콘, 이미지, 문자열 교체

macOS dmg 빌드에 반영

5) UI 커스터마이징

첫 실행 프롬프트 변경

Toolbar 버튼 추가/삭제

Fly View에 맞춤형 위젯 삽입

6) 브랜칭 전략

Stable Branch 동기화

Out-Of-Band 릴리스

Daily Build 전략

macOS 환경에서는 GitHub Actions 또는 Jenkins를 통해 dmg 패키지 자동화

notarization 및 코드 서명 필수

7) MAVLink 커스터마이징

CustomOptions.cmake에서 dialect 지정

프로젝트 전용 MAVLink 메시지 정의 가능

8) macOS 환경 팁

macdeployqt로 dmg 패키지 생성

notarization 및 Apple Developer ID로 코드 서명해야 배포 가능

CI/CD로 dmg 자동화 배포 가능