{"action":"created","comment":{"url":"https://api.github.com/repos/mavlink/qgc-dev-guide/pulls/comments/185981521","pull_request_review_id":117483274,"id":185981521,"diff_hunk":"@@ -0,0 +1,96 @@\n+# Getting Started\n+\n+This topic explains how to get the *QGroundControl* source code and build it either natively or within a *Vagrant* environment. \n+It also provides information about optional or OS specific functionality.\n+\n+## Source Code\n+\n+Source code for *QGroundControl* is kept on GitHub here: https://github.com/mavlink/qgroundcontrol.\n+It is [dual-licensed under Apache 2.0 and GPLv3](https://github.com/mavlink/qgroundcontrol/blob/master/COPYING.md).\n+\n+To get the source files:\n+1. Clone the repo (or your fork):\n+   ```\n+   git clone --recursive https://github.com/mavlink/qgroundcontrol.git\n+   ```\n+2. Update submodules (do this each time you pull new source code):\n+   ```\n+   git submodule update\n+   ```\n+\n+> **Tip** Github source-code zip files cannot be used because these do not contain the appropriate submodule source code. You must use git!\n+\n+\n+## Build QGroundControl\n+\n+### Native Builds\n+\n+*QGroundControl* builds are supported for OSX, Linux, Windows, iOS and Android. *QGroundControl* uses [Qt](http://www.qt.io) as its cross-platform support library and uses [QtCreator](http://doc.qt.io/qtcreator/index.html) as its default build environment.\n+\n+- **OSX:** OSX 10.7 or higher, 64 bit, clang compiler\n+  > **Warning** XCode 8 requires a workaround described below.\n+- **Ubuntu:** 64 bit, gcc compiler\n+- **Windows:** Vista or higher, 32 bit, [Visual Studio 2015 compiler](http://www.visualstudio.com/downloads/download-visual-studio-vs#d-express-windows-desktop)\n+- **iOS:** 8.0 and higher\n+- **Android:** Jelly Bean (4.1) and higher. Standard QGC is built against ndk version 19.\n+- <span id=\"qt_version\"></span>**Qt version:** 5.9.3 **only**\n+\n+#### Install Qt\n+\n+You **need to install Qt as described below** instead of using pre-built packages from say, a Linux distribution, because *QGroundControl* needs access to private Qt headers.\n+1. Download the [Qt installer](http://www.qt.io/download-open-source) for the [supported Qt version)[#qt_version]. You will also need to install the *Qt Speech* package.\n+   - **Ubuntu:** Set the downloaded file to executable using:`chmod +x`. Install to default location for use with **./qgroundcontrol-start.sh.** If you install Qt to a non-default location you will need to modify **qgroundcontrol-start.sh** in order to run downloaded builds.\n+   - **Windows:** Make sure to install *VS 2015 32 bit* package.\n+\n+1. Install Additional Packages (Platform Specific)\n+   - **Ubuntu:** `sudo apt-get install speech-dispatcher libudev-dev libsdl2-dev`\n+   - **Fedora:** `sudo dnf install speech-dispatcher SDL2-devel SDL2 systemd-devel`\n+   - **Arch Linux:** `pacman -Sy speech-dispatcher`\n+   - **Windows:** [USB Driver](http://www.pixhawk.org/firmware/downloads) to connect to Pixhawk/PX4Flow/3DR Radio\n+   - **Android:** [Qt Android Setup](http://doc.qt.io/qt-5/androidgs.html)\n+\n+#### Building using Qt Creator\n+\n+1. Launch *Qt Creator* and open the **qgroundcontrol.pro** project.\n+1. Select the appropriate kit for your needs:\n+  - **OSX:** Desktop Qt 5.9.3 clang 64 bit\n+  - **Ubuntu:** Desktop Qt 5.9.3 GCC bit\n+  - **Windows:** Desktop Qt 5.9.3 MSVC2015 32bit\n+  - **Android:** Android for armeabi-v7a (GCC 4.9, Qt 5.9.3)\n+1. *Run Qmake* from the context menu for your target\n+   > **Note** iOS builds must be built using [XCode](http://doc.qt.io/qt-5/ios-support.html).\n+\n+### Vagrant\n+\n+[Vagrant](https://www.vagrantup.com/) can be used to build and run *QGroundControl* within a Linux virtual machine (the build can also be run on the host machine if it is compatible).\n+\n+1. [Download](https://www.vagrantup.com/downloads.html) and [Install](https://www.vagrantup.com/docs/getting-started/) Vagrant\n+1. From the root directory of the *QGroundControl* repository run `vagrant up`\n+1. To use the graphical environment run `vagrant reload`","path":"en/getting_started/README.md","position":69,"original_position":69,"commit_id":"e72a6aa68739ed50c7c946b1aeb9dd86d44fc4ff","original_commit_id":"e72a6aa68739ed50c7c946b1aeb9dd86d44fc4ff","user":{"login":"hamishwillee","id":5368500,"avatar_url":"https://avatars2.githubusercontent.com/u/5368500?v=4","gravatar_id":"","url":"https://api.github.com/users/hamishwillee","html_url":"https://github.com/hamishwillee","followers_url":"https://api.github.com/users/hamishwillee/followers","following_url":"https://api.github.com/users/hamishwillee/following{/other_user}","gists_url":"https://api.github.com/users/hamishwillee/gists{/gist_id}","starred_url":"https://api.github.com/users/hamishwillee/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/hamishwillee/subscriptions","organizations_url":"https://api.github.com/users/hamishwillee/orgs","repos_url":"https://api.github.com/users/hamishwillee/repos","events_url":"https://api.github.com/users/hamishwillee/events{/privacy}","received_events_url":"https://api.github.com/users/hamishwillee/received_events","type":"User","site_admin":false},"body":"I'll leave as is for now - no worse than before. ","created_at":"2018-05-04T02:38:39Z","updated_at":"2018-05-04T02:38:39Z","html_url":"https://github.com/mavlink/qgc-dev-guide/pull/36#discussion_r185981521","pull_request_url":"https://api.github.com/repos/mavlink/qgc-dev-guide/pulls/36","author_association":"COLLABORATOR","_links":{"self":{"href":"https://api.github.com/repos/mavlink/qgc-dev-guide/pulls/comments/185981521"},"html":{"href":"https://github.com/mavlink/qgc-dev-guide/pull/36#discussion_r185981521"},"pull_request":{"href":"https://api.github.com/repos/mavlink/qgc-dev-guide/pulls/36"}},"in_reply_to_id":185978687},"pull_request":{"url":"https://api.github.com/repos/mavlink/qgc-dev-guide/pulls/36","id":185873883,"html_url":"https://github.com/mavlink/qgc-dev-guide/pull/36","diff_url":"https://github.com/mavlink/qgc-dev-guide/pull/36.diff","patch_url":"https://github.com/mavlink/qgc-dev-guide/pull/36.patch","issue_url":"https://api.github.com/repos/mavlink/qgc-dev-guide/issues/36","number":36,"state":"open","locked":false,"title":"Add Developer Environment/Build instructions to devguide","user":{"login":"hamishwillee","id":5368500,"avatar_url":"https://avatars2.githubusercontent.com/u/5368500?v=4","gravatar_id":"","url":"https://api.github.com/users/hamishwillee","html_url":"https://github.com/hamishwillee","followers_url":"https://api.github.com/users/hamishwillee/followers","following_url":"https://api.github.com/users/hamishwillee/following{/other_user}","gists_url":"https://api.github.com/users/hamishwillee/gists{/gist_id}","starred_url":"https://api.github.com/users/hamishwillee/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/hamishwillee/subscriptions","organizations_url":"https://api.github.com/users/hamishwillee/orgs","repos_url":"https://api.github.com/users/hamishwillee/repos","events_url":"https://api.github.com/users/hamishwillee/events{/privacy}","received_events_url":"https://api.github.com/users/hamishwillee/received_events","type":"User","site_admin":false},"body":"","created_at":"2018-05-04T01:03:41Z","updated_at":"2018-05-04T02:38:39Z","closed_at":null,"merged_at":null,"merge_commit_sha":"4948a0b909c56d3e37a79a80bc78b9e1f4f2fef3","assignee":null,"assignees":[],"requested_reviewers":[{"login":"DonLakeFlyer","id":5876851,"avatar_url":"https://avatars3.githubusercontent.com/u/5876851?v=4","gravatar_id":"","url":"https://api.github.com/users/DonLakeFlyer","html_url":"https://github.com/DonLakeFlyer","followers_url":"https://api.github.com/users/DonLakeFlyer/followers","following_url":"https://api.github.com/users/DonLakeFlyer/following{/other_user}","gists_url":"https://api.github.com/users/DonLakeFlyer/gists{/gist_id}","starred_url":"https://api.github.com/users/DonLakeFlyer/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/DonLakeFlyer/subscriptions","organizations_url":"https://api.github.com/users/DonLakeFlyer/orgs","repos_url":"https://api.github.com/users/DonLakeFlyer/repos","events_url":"https://api.github.com/users/DonLakeFlyer/events{/privacy}","received_events_url":"https://api.github.com/users/DonLakeFlyer/received_events","type":"User","site_admin":false}],"requested_teams":[],"labels":[],"milestone":null,"commits_url":"https://api.github.com/repos/mavlink/qgc-dev-guide/pulls/36/commits","review_comments_url":"https://api.github.com/repos/mavlink/qgc-dev-guide/pulls/36/comments","review_comment_url":"https://api.github.com/repos/mavlink/qgc-dev-guide/pulls/comments{/number}","comments_url":"https://api.github.com/repos/mavlink/qgc-dev-guide/issues/36/comments","statuses_url":"https://api.github.com/repos/mavlink/qgc-dev-guide/statuses/e72a6aa68739ed50c7c946b1aeb9dd86d44fc4ff","head":{"label":"hamishwillee:devenv","ref":"devenv","sha":"e72a6aa68739ed50c7c946b1aeb9dd86d44fc4ff","user":{"login":"hamishwillee","id":5368500,"avatar_url":"https://avatars2.githubusercontent.com/u/5368500?v=4","gravatar_id":"","url":"https://api.github.com/users/hamishwillee","html_url":"https://github.com/hamishwillee","followers_url":"https://api.github.com/users/hamishwillee/followers","following_url":"https://api.github.com/users/hamishwillee/following{/other_user}","gists_url":"https://api.github.com/users/hamishwillee/gists{/gist_id}","starred_url":"https://api.github.com/users/hamishwillee/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/hamishwillee/subscriptions","organizations_url":"https://api.github.com/users/hamishwillee/orgs","repos_url":"https://api.github.com/users/hamishwillee/repos","events_url":"https://api.github.com/users/hamishwillee/events{/privacy}","received_events_url":"https://api.github.com/users/hamishwillee/received_events","type":"User","site_admin":false},"repo":{"id":88000995,"name":"qgc-dev-guide","full_name":"hamishwillee/qgc-dev-guide","owner":{"login":"hamishwillee","id":5368500,"avatar_url":"https://avatars2.githubusercontent.com/u/5368500?v=4","gravatar_id":"","url":"https://api.github.com/users/hamishwillee","html_url":"https://github.com/hamishwillee","followers_url":"https://api.github.com/users/hamishwillee/followers","following_url":"https://api.github.com/users/hamishwillee/following{/other_user}","gists_url":"https://api.github.com/users/hamishwillee/gists{/gist_id}","starred_url":"https://api.github.com/users/hamishwillee/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/hamishwillee/subscriptions","organizations_url":"https://api.github.com/users/hamishwillee/orgs","repos_url":"https://api.github.com/users/hamishwillee/repos","events_url":"https://api.github.com/users/hamishwillee/events{/privacy}","received_events_url":"https://api.github.com/users/hamishwillee/received_events","type":"User","site_admin":false},"private":false,"html_url":"https://github.com/hamishwillee/qgc-dev-guide","description":"QGroundControl Developers Guide","fork":true,"url":"https://api.github.com/repos/hamishwillee/qgc-dev-guide","forks_url":"https://api.github.com/repos/hamishwillee/qgc-dev-guide/forks","keys_url":"https://api.github.com/repos/hamishwillee/qgc-dev-guide/keys{/key_id}","collaborators_url":"https://api.github.com/repos/hamishwillee/qgc-dev-guide/collaborators{/collaborator}","teams_url":"https://api.github.com/repos/hamishwillee/qgc-dev-guide/teams","hooks_url":"https://api.github.com/repos/hamishwillee/qgc-dev-guide/hooks","issue_events_url":"https://api.github.com/repos/hamishwillee/qgc-dev-guide/issues/events{/number}","events_url":"https://api.github.com/repos/hamishwillee/qgc-dev-guide/events","assignees_url":"https://api.github.com/repos/hamishwillee/qgc-dev-guide/assignees{/user}","branches_url":"https://api.github.com/repos/hamishwillee/qgc-dev-guide/branches{/branch}","tags_url":"https://api.github.com/repos/hamishwillee/qgc-dev-guide/tags","blobs_url":"https://api.github.com/repos/hamishwillee/qgc-dev-guide/git/blobs{/sha}","git_tags_url":"https://api.github.com/repos/hamishwillee/qgc-dev-guide/git/tags{/sha}","git_refs_url":"https://api.github.com/repos/hamishwillee/qgc-dev-guide/git/refs{/sha}","trees_url":"https://api.github.com/repos/hamishwillee/qgc-dev-guide/git/trees{/sha}","statuses_url":"https://api.github.com/repos/hamishwillee/qgc-dev-guide/statuses/{sha}","languages_url":"https://api.github.com/repos/hamishwillee/qgc-dev-guide/languages","stargazers_url":"https://api.github.com/repos/hamishwillee/qgc-dev-guide/stargazers","contributors_url":"https://api.github.com/repos/hamishwillee/qgc-dev-guide/contributors","subscribers_url":"https://api.github.com/repos/hamishwillee/qgc-dev-guide/subscribers","subscription_url":"https://api.github.com/repos/hamishwillee/qgc-dev-guide/subscription","commits_url":"https://api.github.com/repos/hamishwillee/qgc-dev-guide/commits{/sha}","git_commits_url":"https://api.github.com/repos/hamishwillee/qgc-dev-guide/git/commits{/sha}","comments_url":"https://api.github.com/repos/hamishwillee/qgc-dev-guide/comments{/number}","issue_comment_url":"https://api.github.com/repos/hamishwillee/qgc-dev-guide/issues/comments{/number}","contents_url":"https://api.github.com/repos/hamishwillee/qgc-dev-guide/contents/{+path}","compare_url":"https://api.github.com/repos/hamishwillee/qgc-dev-guide/compare/{base}...{head}","merges_url":"https://api.github.com/repos/hamishwillee/qgc-dev-guide/merges","archive_url":"https://api.github.com/repos/hamishwillee/qgc-dev-guide/{archive_format}{/ref}","downloads_url":"https://api.github.com/repos/hamishwillee/qgc-dev-guide/downloads","issues_url":"https://api.github.com/repos/hamishwillee/qgc-dev-guide/issues{/number}","pulls_url":"https://api.github.com/repos/hamishwillee/qgc-dev-guide/pulls{/number}","milestones_url":"https://api.github.com/repos/hamishwillee/qgc-dev-guide/milestones{/number}","notifications_url":"https://api.github.com/repos/hamishwillee/qgc-dev-guide/notifications{?since,all,participating}","labels_url":"https://api.github.com/repos/hamishwillee/qgc-dev-guide/labels{/name}","releases_url":"https://api.github.com/repos/hamishwillee/qgc-dev-guide/releases{/id}","deployments_url":"https://api.github.com/repos/hamishwillee/qgc-dev-guide/deployments","created_at":"2017-04-12T02:30:54Z","updated_at":"2018-05-04T00:08:42Z","pushed_at":"2018-05-04T01:59:38Z","git_url":"git://github.com/hamishwillee/qgc-dev-guide.git","ssh_url":"git@github.com:hamishwillee/qgc-dev-guide.git","clone_url":"https://github.com/hamishwillee/qgc-dev-guide.git","svn_url":"https://github.com/hamishwillee/qgc-dev-guide","homepage":null,"size":322,"stargazers_count":0,"watchers_count":0,"language":null,"has_issues":false,"has_projects":true,"has_downloads":true,"has_wiki":true,"has_pages":false,"forks_count":0,"mirror_url":null,"archived":false,"open_issues_count":0,"license":{"key":"cc-by-sa-4.0","name":"Creative Commons Attribution Share Alike 4.0","spdx_id":"CC-BY-SA-4.0","url":"https://api.github.com/licenses/cc-by-sa-4.0"},"forks":0,"open_issues":0,"watchers":0,"default_branch":"master"}},"base":{"label":"mavlink:master","ref":"master","sha":"f58df1dbdf49a1641d235386284ea67f3cc89d24","user":{"login":"mavlink","id":961247,"avatar_url":"https://avatars2.githubusercontent.com/u/961247?v=4","gravatar_id":"","url":"https://api.github.com/users/mavlink","html_url":"https://github.com/mavlink","followers_url":"https://api.github.com/users/mavlink/followers","following_url":"https://api.github.com/users/mavlink/following{/other_user}","gists_url":"https://api.github.com/users/mavlink/gists{/gist_id}","starred_url":"https://api.github.com/users/mavlink/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/mavlink/subscriptions","organizations_url":"https://api.github.com/users/mavlink/orgs","repos_url":"https://api.github.com/users/mavlink/repos","events_url":"https://api.github.com/users/mavlink/events{/privacy}","received_events_url":"https://api.github.com/users/mavlink/received_events","type":"Organization","site_admin":false},"repo":{"id":64617974,"name":"qgc-dev-guide","full_name":"mavlink/qgc-dev-guide","owner":{"login":"mavlink","id":961247,"avatar_url":"https://avatars2.githubusercontent.com/u/961247?v=4","gravatar_id":"","url":"https://api.github.com/users/mavlink","html_url":"https://github.com/mavlink","followers_url":"https://api.github.com/users/mavlink/followers","following_url":"https://api.github.com/users/mavlink/following{/other_user}","gists_url":"https://api.github.com/users/mavlink/gists{/gist_id}","starred_url":"https://api.github.com/users/mavlink/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/mavlink/subscriptions","organizations_url":"https://api.github.com/users/mavlink/orgs","repos_url":"https://api.github.com/users/mavlink/repos","events_url":"https://api.github.com/users/mavlink/events{/privacy}","received_events_url":"https://api.github.com/users/mavlink/received_events","type":"Organization","site_admin":false},"private":false,"html_url":"https://github.com/mavlink/qgc-dev-guide","description":"QGroundControl Developers Guide","fork":false,"url":"https://api.github.com/repos/mavlink/qgc-dev-guide","forks_url":"https://api.github.com/repos/mavlink/qgc-dev-guide/forks","keys_url":"https://api.github.com/repos/mavlink/qgc-dev-guide/keys{/key_id}","collaborators_url":"https://api.github.com/repos/mavlink/qgc-dev-guide/collaborators{/collaborator}","teams_url":"https://api.github.com/repos/mavlink/qgc-dev-guide/teams","hooks_url":"https://api.github.com/repos/mavlink/qgc-dev-guide/hooks","issue_events_url":"https://api.github.com/repos/mavlink/qgc-dev-guide/issues/events{/number}","events_url":"https://api.github.com/repos/mavlink/qgc-dev-guide/events","assignees_url":"https://api.github.com/repos/mavlink/qgc-dev-guide/assignees{/user}","branches_url":"https://api.github.com/repos/mavlink/qgc-dev-guide/branches{/branch}","tags_url":"https://api.github.com/repos/mavlink/qgc-dev-guide/tags","blobs_url":"https://api.github.com/repos/mavlink/qgc-dev-guide/git/blobs{/sha}","git_tags_url":"https://api.github.com/repos/mavlink/qgc-dev-guide/git/tags{/sha}","git_refs_url":"https://api.github.com/repos/mavlink/qgc-dev-guide/git/refs{/sha}","trees_url":"https://api.github.com/repos/mavlink/qgc-dev-guide/git/trees{/sha}","statuses_url":"https://api.github.com/repos/mavlink/qgc-dev-guide/statuses/{sha}","languages_url":"https://api.github.com/repos/mavlink/qgc-dev-guide/languages","stargazers_url":"https://api.github.com/repos/mavlink/qgc-dev-guide/stargazers","contributors_url":"https://api.github.com/repos/mavlink/qgc-dev-guide/contributors","subscribers_url":"https://api.github.com/repos/mavlink/qgc-dev-guide/subscribers","subscription_url":"https://api.github.com/repos/mavlink/qgc-dev-guide/subscription","commits_url":"https://api.github.com/repos/mavlink/qgc-dev-guide/commits{/sha}","git_commits_url":"https://api.github.com/repos/mavlink/qgc-dev-guide/git/commits{/sha}","comments_url":"https://api.github.com/repos/mavlink/qgc-dev-guide/comments{/number}","issue_comment_url":"https://api.github.com/repos/mavlink/qgc-dev-guide/issues/comments{/number}","contents_url":"https://api.github.com/repos/mavlink/qgc-dev-guide/contents/{+path}","compare_url":"https://api.github.com/repos/mavlink/qgc-dev-guide/compare/{base}...{head}","merges_url":"https://api.github.com/repos/mavlink/qgc-dev-guide/merges","archive_url":"https://api.github.com/repos/mavlink/qgc-dev-guide/{archive_format}{/ref}","downloads_url":"https://api.github.com/repos/mavlink/qgc-dev-guide/downloads","issues_url":"https://api.github.com/repos/mavlink/qgc-dev-guide/issues{/number}","pulls_url":"https://api.github.com/repos/mavlink/qgc-dev-guide/pulls{/number}","milestones_url":"https://api.github.com/repos/mavlink/qgc-dev-guide/milestones{/number}","notifications_url":"https://api.github.com/repos/mavlink/qgc-dev-guide/notifications{?since,all,participating}","labels_url":"https://api.github.com/repos/mavlink/qgc-dev-guide/labels{/name}","releases_url":"https://api.github.com/repos/mavlink/qgc-dev-guide/releases{/id}","deployments_url":"https://api.github.com/repos/mavlink/qgc-dev-guide/deployments","created_at":"2016-07-31T22:00:46Z","updated_at":"2018-05-04T01:40:27Z","pushed_at":"2018-05-04T01:59:39Z","git_url":"git://github.com/mavlink/qgc-dev-guide.git","ssh_url":"git@github.com:mavlink/qgc-dev-guide.git","clone_url":"https://github.com/mavlink/qgc-dev-guide.git","svn_url":"https://github.com/mavlink/qgc-dev-guide","homepage":"https://dev.qgroundcontrol.com/en/","size":318,"stargazers_count":5,"watchers_count":5,"language":null,"has_issues":true,"has_projects":true,"has_downloads":true,"has_wiki":true,"has_pages":false,"forks_count":6,"mirror_url":null,"archived":false,"open_issues_count":8,"license":{"key":"cc-by-sa-4.0","name":"Creative Commons Attribution Share Alike 4.0","spdx_id":"CC-BY-SA-4.0","url":"https://api.github.com/licenses/cc-by-sa-4.0"},"forks":6,"open_issues":8,"watchers":5,"default_branch":"master"}},"_links":{"self":{"href":"https://api.github.com/repos/mavlink/qgc-dev-guide/pulls/36"},"html":{"href":"https://github.com/mavlink/qgc-dev-guide/pull/36"},"issue":{"href":"https://api.github.com/repos/mavlink/qgc-dev-guide/issues/36"},"comments":{"href":"https://api.github.com/repos/mavlink/qgc-dev-guide/issues/36/comments"},"review_comments":{"href":"https://api.github.com/repos/mavlink/qgc-dev-guide/pulls/36/comments"},"review_comment":{"href":"https://api.github.com/repos/mavlink/qgc-dev-guide/pulls/comments{/number}"},"commits":{"href":"https://api.github.com/repos/mavlink/qgc-dev-guide/pulls/36/commits"},"statuses":{"href":"https://api.github.com/repos/mavlink/qgc-dev-guide/statuses/e72a6aa68739ed50c7c946b1aeb9dd86d44fc4ff"}},"author_association":"COLLABORATOR"}}
{"actor":{"display_login":"hamishwillee"}}