| Contributing to the Android NDK |
| =============================== |
| |
| This guide will help you contribute to the Android NDK, whether by reporting |
| issue or submitting a patch. |
| |
| Reporting Issues |
| ---------------- |
| |
| Our bug tracker is hosted on GitHub: https://github.com/android-ndk/ndk/issues. |
| |
| **Note:** Bugs against Android Studio or Gradle should be filed at |
| http://b.android.com, not here. |
| |
| Before filing a bug, check that you are using the latest version of the NDK. The |
| latest stable version and the preview release of the next stable version are |
| listed on our wiki: https://github.com/android-ndk/ndk/wiki#downloads. |
| |
| Submitting Patches |
| ------------------ |
| |
| While we use GitHub for our bug tracking and documentation, we do not manage our |
| code in GitHub. Like the rest of Android, we are hosted in AOSP. This means that |
| patches are uploaded to and submitted via Gerrit. |
| |
| Follow the [contribution instructions for |
| AOSP](http://source.android.com/source/submit-patches.html). When you run `repo |
| init`, follow the instructions in the NDK's [README.md]. We have a different set |
| of dependencies than AOSP, also noted in our [README.md]. |
| |
| Instructions for building the NDK and running our tests are documented in |
| [README.md] and [Testing.md](docs/Testing.md). Note that the NDK cannot be built |
| on Windows; only Linux and Darwin hosts are supported. |
| |
| Check the [OWNERS file](OWNERS) for reviewers. |
| |
| The NDK uses TreeHugger as a presubmit service (think of it as Travis for |
| Gerrit). If you're a Googler, TreeHugger will check your change automatically |
| when you upload it. If you're not a Googler, you'll need to get a Googler to |
| approve the change for you before TreeHugger will run it. |
| |
| [README.md]: README.md |