| `--clear-settings` | Clears the app settings (reverts _QGroundControl_ back to default settings). |
| `--clear-settings` | Clears the app settings (reverts _QGroundControl_ back to default settings). |
| `--logging:full` | Turns on full logging. See [Console Logging](https://docs.qgroundcontrol.com/en/settings_view/console_logging.html#logging-from-the-command-line). |
| `--logging:full` | Turns on full logging. See [Console Logging](../../qgc-user-guide/settings_view/console_logging.html#logging-from-the-command-line). |
| `--logging:full,LinkManagerVerboseLog,ParameterLoaderLog` | Turns on full logging and turns off the following listed comma-separated logging options. |
| `--logging:full,LinkManagerVerboseLog,ParameterLoaderLog` | Turns on full logging and turns off the following listed comma-separated logging options. |
| `--logging:LinkManagerLog,ParameterLoaderLog` | Turns on the specified comma separated logging options |
| `--logging:LinkManagerLog,ParameterLoaderLog` | Turns on the specified comma separated logging options |
| `--unittest:name` | (Debug builds only) Runs the specified unit test. Leave off `:name` to run all tests. |
| `--unittest:name` | (Debug builds only) Runs the specified unit test. Leave off `:name` to run all tests. |
This topic explains how to get the _QGroundControl_ source code and build it either natively or within a _Vagrant_ environment.
This topic explains how to get the _QGroundControl_ source code and build it either natively or within a _Vagrant_ environment.
It also provides information about optional or OS specific functionality.
It also provides information about optional or OS specific functionality.
## Daily Builds
## Daily Builds
If you just want to test (and not debug) a recent build of _QGroundControl_ you can use the [Daily Build](https://docs.qgroundcontrol.com/en/releases/daily_builds.html). Versions are provided for all platforms.
If you just want to test (and not debug) a recent build of _QGroundControl_ you can use the [Daily Build](../../qgc-user-guide/releases/daily_builds.md).
Versions are provided for all platforms.
## Source Code
## Source Code
@ -19,11 +20,14 @@ It is [dual-licensed under Apache 2.0 and GPLv3](https://github.com/mavlink/qgro
To get the source files:
To get the source files:
1. Clone the repo (or your fork) including submodules:
1. Clone the repo (or your fork) including submodules:
- **[Onboard Files](https://docs.qgroundcontrol.com/en/app_menu/onboard_files.html)** - Navigate vehicle file system and upload/download files.
- **[HIL Config Widget](https://docs.qgroundcontrol.com/en/app_menu/hil_config.html)** - Settings for HIL simulators.
- **[MAVLink Console](https://docs.qgroundcontrol.com/en/analyze_view/mavlink_console.html)** (PX4 Only) - Connect to the PX4 nsh shell and send commands.
@ -23,5 +23,5 @@ _QGroundControl_을 이용하여 PX4나 ArduPilot 구동 차량을 설정하고
:::
:::
:::tip
:::tip
_QGroundControl_에 관련된 개발, 아키텍처, 기여 및 번역에 관련한 정보는 [개발자 가이드](https://dev.qgroundcontrol.com/en/)를 참고하십시오.
Information about _QGroundControl_ development, architecture, contributing, and translating can be found in the [Developer Guide](../qgc-dev-guide/index.md) section.
@ -47,7 +47,7 @@ _비행 후 텔레메트리 로그 저장_을 켠 경우 더 이상 차량이
이전 버전의 _QGroundControl_은 미션, 지오펜스 및 집회 지점을 별도의 파일(**.mission**, **.fence**, **.rally**)에 저장하였습니다 . QGroundControl은 이제 비행 계획과 관련된 모든 정보를 파일 확장자를 **.plan**인 _계획 파일_을 사용합니다.
이전 버전의 _QGroundControl_은 미션, 지오펜스 및 집회 지점을 별도의 파일(**.mission**, **.fence**, **.rally**)에 저장하였습니다 . QGroundControl은 이제 비행 계획과 관련된 모든 정보를 파일 확장자를 **.plan**인 _계획 파일_을 사용합니다.
형식에 대한 정보는 [계획 파일 형식](https://dev.qgroundcontrol.com/en/file_formats/plan.html)(QGroundControl 개발자 안내서)을 참고하십시오.
Information about the format can be found in [Plan File Format](../../qgc-dev-guide/file_formats/plan.md) (QGC Developer Guide).
| `--clear-settings` | Clears the app settings (reverts _QGroundControl_ back to default settings). |
| `--clear-settings` | Clears the app settings (reverts _QGroundControl_ back to default settings). |
| `--logging:full` | Turns on full logging. See [Console Logging](https://docs.qgroundcontrol.com/en/settings_view/console_logging.html#logging-from-the-command-line). |
| `--logging:full` | Turns on full logging. See [Console Logging](../../qgc-user-guide/settings_view/console_logging.html#logging-from-the-command-line). |
| `--logging:full,LinkManagerVerboseLog,ParameterLoaderLog` | Turns on full logging and turns off the following listed comma-separated logging options. |
| `--logging:full,LinkManagerVerboseLog,ParameterLoaderLog` | Turns on full logging and turns off the following listed comma-separated logging options. |
| `--logging:LinkManagerLog,ParameterLoaderLog` | Turns on the specified comma separated logging options |
| `--logging:LinkManagerLog,ParameterLoaderLog` | Turns on the specified comma separated logging options |
| `--unittest:name` | (Debug builds only) Runs the specified unit test. Leave off `:name` to run all tests. |
| `--unittest:name` | (Debug builds only) Runs the specified unit test. Leave off `:name` to run all tests. |
This topic explains how to get the _QGroundControl_ source code and build it either natively or within a _Vagrant_ environment.
This topic explains how to get the _QGroundControl_ source code and build it either natively or within a _Vagrant_ environment.
It also provides information about optional or OS specific functionality.
It also provides information about optional or OS specific functionality.
## Daily Builds
## Daily Builds
If you just want to test (and not debug) a recent build of _QGroundControl_ you can use the [Daily Build](https://docs.qgroundcontrol.com/en/releases/daily_builds.html). Versions are provided for all platforms.
If you just want to test (and not debug) a recent build of _QGroundControl_ you can use the [Daily Build](../../qgc-user-guide/releases/daily_builds.md).
Versions are provided for all platforms.
## Source Code
## Source Code
@ -19,11 +20,14 @@ It is [dual-licensed under Apache 2.0 and GPLv3](https://github.com/mavlink/qgro
To get the source files:
To get the source files:
1. Clone the repo (or your fork) including submodules:
1. Clone the repo (or your fork) including submodules:
- **[Onboard Files](https://docs.qgroundcontrol.com/en/app_menu/onboard_files.html)** - Navigate vehicle file system and upload/download files.
- **[HIL Config Widget](https://docs.qgroundcontrol.com/en/app_menu/hil_config.html)** - Settings for HIL simulators.
- **[MAVLink Console](https://docs.qgroundcontrol.com/en/analyze_view/mavlink_console.html)** (PX4 Only) - Connect to the PX4 nsh shell and send commands.
@ -23,5 +23,5 @@ The information provided should be correct, but you may find missing information
:::
:::
:::tip
:::tip
Information about _QGroundControl_ development, architecture, contributing, and translating can be found in the [Developers Guide](https://dev.qgroundcontrol.com/en/).
Information about _QGroundControl_ development, architecture, contributing, and translating can be found in the [Developer Guide](../qgc-dev-guide/index.md) section.
@ -47,7 +47,7 @@ This is now supported from the Copy Trims button on the Radio setup page.
Previous version of _QGroundControl_ saved missions, geo-fences and rally points in separate files (**.mission**, **.fence**, **.rally**). QGC now save all information related to a flight plan into a single file called a _Plan File_ with a file extension of **.plan**.
Previous version of _QGroundControl_ saved missions, geo-fences and rally points in separate files (**.mission**, **.fence**, **.rally**). QGC now save all information related to a flight plan into a single file called a _Plan File_ with a file extension of **.plan**.
Information about the format can be found in [Plan File Format](https://dev.qgroundcontrol.com/en/file_formats/plan.html) (QGC Developer Guide).
Information about the format can be found in [Plan File Format](../../qgc-dev-guide/file_formats/plan.md) (QGC Developer Guide).
@ -27,27 +27,37 @@ An alternate mechanism for logging is using the `--logging` command line option.
How you do this and where the traces are output vary by OS:
How you do this and where the traces are output vary by OS:
- Windows
- Windows
- You must open a command prompt, change directory to the **qgroundcontrol.exe** location, and run it from there:
- You must open a command prompt, change directory to the **qgroundcontrol.exe** location, and run it from there:
bash
bash
cd "\Program Files (x86)\qgroundcontrol"
cd "\Program Files (x86)\qgroundcontrol"
qgroundcontrol --logging:full
qgroundcontrol --logging:full
```bash
```sh
cd "\Program Files (x86)\qgroundcontrol"
cd "\Program Files (x86)\qgroundcontrol"
qgroundcontrol --logging:full
qgroundcontrol --logging:full
```
```
- When _QGroundControl_ starts you should see a separate console window open which will have the log output
- When _QGroundControl_ starts you should see a separate console window open which will have the log output
- OSX
- OSX
- You must run _QGroundControl_ from Terminal. The Terminal app is located in Applications/Utilities. Once Terminal is open paste the following into it:
- You must run _QGroundControl_ from Terminal. The Terminal app is located in Applications/Utilities. Once Terminal is open paste the following into it:
```bash
```sh
Once Terminal is open paste the following into it:
Once Terminal is open paste the following into it:
bash
bash
cd /Applications/qgroundcontrol.app/Contents/MacOS/
cd /Applications/qgroundcontrol.app/Contents/MacOS/
./qgroundcontrol --logging:full
./qgroundcontrol --logging:full
```
```
- Log traces will output to the Terminal window.
- Log traces will output to the Terminal window.
- ## Linux
```bash
- Linux
```sh
bash
bash
./qgroundcontrol-start.sh --logging:full
./qgroundcontrol-start.sh --logging:full
```
```
- Log traces will output to the shell you are running from.
- Log traces will output to the shell you are running from.
| `--clear-settings` | Clears the app settings (reverts _QGroundControl_ back to default settings). |
| `--clear-settings` | Clears the app settings (reverts _QGroundControl_ back to default settings). |
| `--logging:full` | Turns on full logging. See [Console Logging](https://docs.qgroundcontrol.com/en/settings_view/console_logging.html#logging-from-the-command-line). |
| `--logging:full` | Turns on full logging. See [Console Logging](../../qgc-user-guide/settings_view/console_logging.html#logging-from-the-command-line). |
| `--logging:full,LinkManagerVerboseLog,ParameterLoaderLog` | Turns on full logging and turns off the following listed comma-separated logging options. |
| `--logging:full,LinkManagerVerboseLog,ParameterLoaderLog` | Turns on full logging and turns off the following listed comma-separated logging options. |
| `--logging:LinkManagerLog,ParameterLoaderLog` | Turns on the specified comma separated logging options |
| `--logging:LinkManagerLog,ParameterLoaderLog` | Turns on the specified comma separated logging options |
| `--unittest:name` | (Debug builds only) Runs the specified unit test. Leave off `:name` to run all tests. |
| `--unittest:name` | (Debug builds only) Runs the specified unit test. Leave off `:name` to run all tests. |
It also provides information about optional or OS specific functionality.
It also provides information about optional or OS specific functionality.
## 每日构建
## 每日构建
如果您只是想测试 (而不是调试) 最近生成的 _QGroundControl_ ,那么请使用[Daily build](https://docs.qgroundcontrol.com/en/releases/daily_builds.html)。 官方提供了适用于所有平台的版本。 Versions are provided for all platforms.
If you just want to test (and not debug) a recent build of _QGroundControl_ you can use the [Daily Build](../../qgc-user-guide/releases/daily_builds.md).
Versions are provided for all platforms.
## 源代码
## 源代码
@ -19,11 +20,14 @@ It is [dual-licensed under Apache 2.0 and GPLv3](https://github.com/mavlink/qgro
要获取源文件, 请执行以下操作:
要获取源文件, 请执行以下操作:
1. Clone the repo (or your fork) including submodules:
1. Clone the repo (or your fork) including submodules:
- Airmap: Create a file named **user\_config.pri** (in the repo root directory) containing the text `DEFINES += DISABLE_AIRMAP`.
- Airmap: Create a file named **user\_config.pri** (in the repo root directory) containing the text `DEFINES += DISABLE_AIRMAP`.
This can be done in a bash terminal using the command:
This can be done in a bash terminal using the command:
```
```sh
This can be done in a bash terminal using the command: `echo -e "DEFINES += DISABLE_AIRMAP\r\n" | tee user_config.pri`
This can be done in a bash terminal using the command: `echo -e "DEFINES += DISABLE_AIRMAP\r\n" | tee user_config.pri`
```
```
@ -168,25 +174,28 @@ To install Qt:
Example commands to build a default QGC and run it afterwards:
Example commands to build a default QGC and run it afterwards:
1. Make sure you cloned the repository and updated the submodules before, see chapter _Source Code_ above and switch into the repository folder: `cd qgroundcontrol`
1. Make sure you cloned the repository and updated the submodules before, see chapter _Source Code_ above and switch into the repository folder: `cd qgroundcontrol`
```
```sh
cd qgroundcontrol
cd qgroundcontrol
```
```
2. Create and enter a shadow build directory:
2. Create and enter a shadow build directory:
```
```sh
mkdir build
mkdir build
cd build
cd build
```
```
3. Configure the build using the qmake script in the root of the repository: `qmake ../`
3. Configure the build using the qmake script in the root of the repository: `qmake ../`
```
```sh
入门指南
入门指南
```
```
4. Run make to compile and link.
4. Run make to compile and link.
To accelerate the process things you can use the `-j{number of threads}` parameter.
To accelerate the process things you can use the `-j{number of threads}` parameter.
```
```sh
`make -j12`
`make -j12`
```
```
@ -194,14 +203,15 @@ Example commands to build a default QGC and run it afterwards:
You can also specify build time flags here.
You can also specify build time flags here.
For example, you could disable airmap inclusion using the command:
For example, you could disable airmap inclusion using the command:
```
```sh
DEFINES+=DISABLE_AIRMAP make build
DEFINES+=DISABLE_AIRMAP make build
```
```
:::
:::
5. Run the QGroundcontrol binary that was just built: `./staging/QGroundControl`
5. Run the QGroundcontrol binary that was just built: `./staging/QGroundControl`
Information about _QGroundControl_ development, architecture, contributing, and translating can be found in the [Developer Guide](../qgc-dev-guide/index.md) section.
@ -47,7 +47,7 @@ This is now supported from the Copy Trims button on the Radio setup page.
Previous version of _QGroundControl_ saved missions, geo-fences and rally points in separate files (**.mission**, **.fence**, **.rally**). QGC now save all information related to a flight plan into a single file called a _Plan File_ with a file extension of **.plan**.
Previous version of _QGroundControl_ saved missions, geo-fences and rally points in separate files (**.mission**, **.fence**, **.rally**). QGC now save all information related to a flight plan into a single file called a _Plan File_ with a file extension of **.plan**.
Information about the format can be found in [Plan File Format](https://dev.qgroundcontrol.com/en/file_formats/plan.html) (QGC Developer Guide).
Information about the format can be found in [Plan File Format](../../qgc-dev-guide/file_formats/plan.md) (QGC Developer Guide).
@ -27,27 +27,37 @@ An alternate mechanism for logging is using the `--logging` command line option.
How you do this and where the traces are output vary by OS:
How you do this and where the traces are output vary by OS:
- Windows
- Windows
- You must open a command prompt, change directory to the **qgroundcontrol.exe** location, and run it from there:
- You must open a command prompt, change directory to the **qgroundcontrol.exe** location, and run it from there:
bash
bash
cd "\Program Files (x86)\qgroundcontrol"
cd "\Program Files (x86)\qgroundcontrol"
qgroundcontrol --logging:full
qgroundcontrol --logging:full
```bash
```sh
cd "\Program Files (x86)\qgroundcontrol"
cd "\Program Files (x86)\qgroundcontrol"
qgroundcontrol --logging:full
qgroundcontrol --logging:full
```
```
- When _QGroundControl_ starts you should see a separate console window open which will have the log output
- When _QGroundControl_ starts you should see a separate console window open which will have the log output
- OSX
- OSX
- You must run _QGroundControl_ from Terminal. The Terminal app is located in Applications/Utilities. Once Terminal is open paste the following into it:
- You must run _QGroundControl_ from Terminal. The Terminal app is located in Applications/Utilities. Once Terminal is open paste the following into it:
```bash
```sh
Once Terminal is open paste the following into it:
Once Terminal is open paste the following into it:
bash
bash
cd /Applications/qgroundcontrol.app/Contents/MacOS/
cd /Applications/qgroundcontrol.app/Contents/MacOS/
./qgroundcontrol --logging:full
./qgroundcontrol --logging:full
```
```
- Log traces will output to the Terminal window.
- Log traces will output to the Terminal window.
- ## Linux
```bash
- Linux
```sh
bash
bash
./qgroundcontrol-start.sh --logging:full
./qgroundcontrol-start.sh --logging:full
```
```
- Log traces will output to the shell you are running from.
- Log traces will output to the shell you are running from.