QGroundControl(QGC) 개발자 가이드

- for Ubuntu(Linux) (2/9)

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

이 파트에서는 Ubuntu 환경에서 QGroundControl(QGC)을 설치하고 실행하는 방법을 설명합니다.

초보자도 쉽게 따라할 수 있도록 AppImage 실행, apt/snap 설치, 그리고 소스코드 빌드 방법을 단계별로 안내합니다.

---

1. 시스템 요구사항

- 운영체제: Ubuntu 20.04 LTS 이상 권장
- 메모리: 최소 4GB (권장 8GB 이상)
- 저장공간: 최소 1GB 여유 공간
- GPU: OpenGL 3.2 이상 지원 그래픽 카드 필요
- 인터넷 연결: 설치 파일 다운로드 및 지도 데이터 사용에 필요

2. AppImage 설치

가장 간단한 설치 방법은 AppImage 파일을 다운로드하여 실행하는 것입니다.
1) QGC 공식 GitHub Releases 페이지 접속:
� https://github.com/mavlink/qgroundcontrol/releases
2) `QGroundControl.AppImage` 파일 다운로드
3) 실행 권한 부여 및 실행:

```bash
chmod +x QGroundControl.AppImage
./QGroundControl.AppImage
```

3. apt/snap 설치

Ubuntu에서는 apt 또는 snap을 통해 QGC를 설치할 수도 있습니다.
- snap 설치:
```bash
sudo snap install qgroundcontrol
```

- apt 설치(ppa 필요):
일부 배포판에서는 ppa를 추가한 후 apt로 설치할 수 있습니다.

4. 소스코드 빌드

소스코드를 직접 빌드하면 커스터마이징이 가능합니다.

1) 필수 패키지 설치:
```bash
sudo apt update
sudo apt install build-essential cmake ninja-build git qtcreator qtbase5-dev qtdeclarative5-dev gstreamer1.0* -y
```

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

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

4) 또는 CMake/Ninja 빌드:
```bash
mkdir build && cd build
cmake .. -GNinja
ninja
./release/qgroundcontrol
```

5. 첫 실행 및 초기 설정

- 첫 실행 시 펌웨어 유형 선택 (PX4 또는 ArduPilot)
- 조종기(USB 조이스틱/RC) 연결 및 보정 진행
- 지도 데이터 다운로드 (Google Satellite, Bing Maps 지원)
- 로그 저장 위치 확인: `~/Documents/QGroundControl/Logs`

6. 트러블슈팅

- 실행 시 UI가 보이지 않으면 GPU 드라이버를 업데이트하세요.
- GStreamer 관련 오류가 발생하면 `gstreamer1.0*` 패키지가 올바르게 설치되었는지 확인하세요.
- 드론이 연결되지 않으면 USB 포트 권한을 확인하세요:
```bash
sudo usermod -a -G dialout $USER
reboot
```

---

7. 다음 단계

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