Skip to content

Development Environments

Jump to bottom Edit New page
hernick-qc edited this page Dec 17, 2015 · 14 revisions

Development Environments

The following pages provide OS-specific instructions for setting up a development environment:

All of these platforms are fully supported and are expected to be viable environments in which to develop and test software for this project.

If you have any issues setting up a development environment, please let us know so that we can correct any mistakes and get you up and running.

Getting the code

The code for this project is stored in github. There are various ways to get the code depending on what your level of involvement is.

If you are not planning to contribute, just want to use it

You can grab a read-only clone of the source like this:

git clone git://github.com/d-ronin/dronin.git

If you would like to contribute back to the project

  • Create an account on github.
  • Go to the dRonin github page.
  • Follow the github instructions for forking the repository into your account.
    • Forks the repository
    • Shows you how to get a local clone of your fork
    • Adds a remote called upstream so you can keep up to date with the main repository

Code submissions are made easy by github's interface. Github encourages forks, so the process is easy and straightforward. If necessary, first make a new github account, and then click the "Fork" button in the top right corner. A new fork of TauLabs will be generated in your user account.

You may also want to take a look at some of the other articles in the BootCamp series at github.

If you have direct commit access to the dRonin project

NOTE: This section only applies to a few people who are admins of the project. If you aren't an admin for dRonin, you should skip this section.

If you have direct commit to the dRonin repo, you can clone like this to get a read-write copy:

git clone [email protected]:d-ronin/dRonin.git

Adding git remotes for other developers

The github workflow for contributing means that most developers will work primarily in their own fork of the source tree. To see their feature branches, you'll need to add their fork as a "remote" in your git clone.

You can see a list of all github forks of the source tree here on the Network Members Page.

Here are the git commands to add remotes for the recently active forks (alphabetical order):

git remote add gh-mlyle git://github.com/mlyle/dronin.git
git remote add gh-tracernz git://github.com/tracernz/dronin.git
git remote add gh-mluessi git://github.com/mluessi/dronin.git
git remote add gh-dustin git://github.com/dustin/dronin.git
git remote add gh-fujin git://github.com/fujin/dronin.git
git remote add gh-BrainFPV git://github.com/BrainFPV/dronin.git

You can update all of your remotes like this:

git remote update

You can create a branch from one of these remotes like this:

git checkout -tb myfeaturebranch gh-mlyle/somebranch

Submitting Code To dRonin

Found a bug? Want to add a new feature? Please read over the Contributing Page for some helpful advice before you start coding.

ARM

Clone this wiki locally