Minimal manifest for building TWRP for devices shipped with Android 5.1 through Android 9.0
Find a file
nkk71 0cdbf72b00 Change 'staging' directory for TWRP extras
* .repo and .git are excluded from an "include
  all subdir makefiles" so use the
  Teamwin/.repo/... to avoid module/lib/etc
  'collisions'.
2017-12-05 19:43:42 +02:00
default.xml Add TWRP repo from omnirom 2017-12-05 16:09:35 +02:00
omni-aosp.xml manifest: add omni system/nfc 2017-09-28 20:58:43 +02:00
omni-caf.xml android: remove qcom interfaces... should be put in dependancies 2017-09-12 22:21:23 +02:00
omni-default.xml remove-minimal.xml: Initial commit (removes everything!) 2017-10-25 12:50:46 +03:00
README.md README: update for android-8.0 2017-08-22 20:35:14 -04:00
remove-minimal.xml Add TWRP repo from omnirom 2017-12-05 16:09:35 +02:00
remove.xml manifest: add omni system/nfc 2017-09-28 20:58:43 +02:00
twrp-extras.xml Change 'staging' directory for TWRP extras 2017-12-05 19:43:42 +02:00

Submitting Patches


Our ROM is open source, and patches are always welcome! You can send patches by using these commands:

cd <project>
<make edits>
git add -A
git commit -m "commit message"
git push ssh://<username>@gerrit.omnirom.org:29418/<project> HEAD:refs/for/android-8.0

Register at <gerrit.omnirom.org> and use the username that you registered there in the above command

Commit your patches in a single commit. Squash multiple commit using this command: git rebase -i HEAD~<# of commits>

If you are going to make extra additions, just repeat steps (Don't start a new patch), but instead of git commit -m use git commit --amend. Gerrit will recognize it as a new patchset.

To view the status of your and others patches, visit OmniROM Code Review

Maintaining Authorship


Maintaining authorship is a very important aspect of working with Open Source code. If you wish to submit a patch/fix from anywhere else (another ROM, project, etc.), it is imperative that you maintain the ownership of the person whose work you are seeking to include. Doing so will ensure that credit is given where it is deserved, and the prinicples of open source are upheld. Your contribution to the project will still be recognized as you will forever be listed as the committer.

If you manually cherry pick a patch/fix then you will need to add the original author prior to pushing to our gerrit. This is a very easy task to perform, and is usually done after you commit a patch/fix locally. This is accomplished after you type in git commit -a , type in the commit message and save. You would then do the following:

git commit --amend --author "Author <email@address.com>"

So it should look like this once you get all of the author's information

git commit --amend --author "Spencer McGillicuddy <spencer.the.bestest@gmail.com>"

Alternatively, adding as part of the original git commit message is preferred and done like the following:

git commit --author="Author <email@address.com>" -m "[commit message]"

This saves time, and when part of your normal routine, prevents the infamous "ermahgerd I forgot to add authorship - let me fix it because I was found out!" message.

Getting Started


To get started with OmniROM, you'll need to get familiar with Git and Repo.

To initialize your local repository using the OmniROM trees, use a command like this:

repo init -u git://github.com/omnirom/android.git -b android-8.0

Then to sync up:

repo sync

Then to build:

 cd <source-dir>; . build/envsetup.sh; brunch <device_name>

If you need more information or a more detailed guide, click here to see our wiki.

Our official IRC Channels are hosted on Freenode:

#omnirom - USERS

#omni - DEVELOPERS