QGroundControl(QGC) 개발자 가이드

- for masOS (2/9)

Part 2. Installation & Setup (설치 및 설정)

이 파트에서는 macOS 환경에서 QGroundControl(QGC)을 설치하고 실행하는 방법을 설명합니다. dmg 파일을 통한 기본 설치부터 Homebrew를 활용한 개발 환경 준비, 소스코드 빌드까지 단계별로 안내합니다.

---

1) 시스템 요구사항

운영체제: macOS 11(Big Sur) 이상 권장

메모리: 최소 4GB (권장 8GB 이상)

저장공간: 최소 1GB 여유 공간

GPU: OpenGL 3.2 이상 지원 필요

인터넷 연결: dmg 다운로드 및 지도 데이터 사용에 필요

2) dmg 파일 설치

가장 간단한 방법은 dmg 파일을 다운로드하여 설치하는 것입니다.

QGC 공식 GitHub Releases 페이지 접속:
https://github.com/mavlink/qgroundcontrol/releases

최신 버전 dmg 파일 다운로드

dmg 파일을 열고 QGroundControl.app을 Applications 폴더로 드래그

실행 시 보안 경고가 나오면 '시스템 환경설정 → 보안 및 개인정보 보호 → 열기'를 선택

3) Homebrew를 통한 개발 환경 준비

소스코드를 빌드하려면 Qt, CMake, Ninja 등의 도구가 필요합니다.

Homebrew를 활용하면 간단히 설치할 수 있습니다.
```bash
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
brew install cmake ninja git qt@5 gstreamer
```

4) 소스코드 빌드

QGC 저장소 클론:
```bash
git clone --recursive https://github.com/mavlink/qgroundcontrol.git
cd qgroundcontrol
git submodule update --init --recursive
```

Qt Creator에서 `qgroundcontrol.pro` 열기 → Desktop Qt 5.15.x kit 선택 → Build & Run

CMake 빌드:
```bash
mkdir build && cd build
cmake .. -GNinja -DCMAKE_PREFIX_PATH=$(brew --prefix qt@5)
ninja
./release/qgroundcontrol.app/Contents/MacOS/QGroundControl
```

5) 첫 실행 및 초기 설정

펌웨어 유형 선택 (PX4 또는 ArduPilot)

조종기(USB 조이스틱/RC) 연결 및 보정

지도 데이터 다운로드

로그 저장 위치: `~/Library/Application Support/QGroundControl/Logs`

6) 트러블슈팅

앱 실행이 차단되면 보안 설정에서 허용 필요

Qt 라이브러리 충돌 시 Homebrew로 설치된 Qt 버전 확인

USB 드론 연결 시 인식되지 않으면 `시스템 리포트 → USB`에서 장치 확인

---

7) 다음 단계

이제 설치와 실행을 완료했으므로, Part 3에서는 QGC의 소스코드 구조를 살펴보고 macOS 개발 환경에서 코드 탐색 및 개발 방법을 배워봅니다.