diff --git a/README.md b/README.md new file mode 100644 index 0000000..e71323d --- /dev/null +++ b/README.md @@ -0,0 +1,55 @@ +# iodéOS build instructions + +For the most part, building iodéOS is not much different than building [LineageOS](https://lineageos.org/). You can refer for example to LineageOS build instructions for [Pixel 5](https://wiki.lineageos.org/devices/redfin/build). Please note that these instructions concern devices officially supported by LineageOS: in order to build iodéOS for unsupported devices, you will have to create/modify a device tree for your phone. + +## Obtaining a basic build: differences with LineageOS instructions + +We list here the differences w.r.t. LineageOS build instructions, which are sufficient to obtain a running iodéOS build. + +### Part "Install the build packages" + +We use [Git LFS](https://git-lfs.github.com/) to maintain the `vendor/extra` repository where prebuilt applications are stored. You must install Git LFS on your system, for example the `git-lfs` package on Debian or Ubuntu. + + +### Part "Initialize the LineageOS source repository" + +To initialize the iodéOS source repository, you must replace the Android manifest repository in the `repo init ...` command: +``` +repo init -u https://gitlab.iode.tech/os/public/manifests/android.git -b v6-staging +``` +The branch `v6-staging` corresponds to the latest active development branch of iodéOS v6, and may be subject to deep changes. iodéOS official stable release branches will be added when available. + +### Part "Download the source code" + +After having sucessfully downloaded the sources with the `repo sync` command, you must download the Git LFS stored objects: +``` +cd vendor/extra +git lfs pull iode v6-staging +``` + +### That's all folks + +You can now start building iodéOS, after carefully following LineageOS build instructions. + +## Fine-tune your iodéOS build + +Some iodéOS features need some more work. + +### Make SafetyNet pass + +Due to recent changes in the way iodéOS pass safetynet, no more additionnal config is required: it should work out-of-the-box. + +### Sign your builds + +You can sign your builds with developer keys by creating a directory called `certs` at the root of your source tree, and generating signing keys in it (modify the `subject` variable in the code below). There is no need to modify iodéOS sources, in particular the `PRODUCT_DEFAULT_DEV_CERTIFICATE` variable will be modified accordingly. +``` +subject='/C=US/ST=France/L=Toulouse/O=iodeOS/OU=iodeOS/CN=iodeOS/emailAddress=suport@iode.tech' +mkdir certs +for x in releasekey platform shared media networkstack testkey; do \ + ./development/tools/make_key certs/$x "$subject"; \ +done +``` + +### Configure Smart Charging + +Smart charging has been removed, as there is now the new Charging Control feature in LineageOS. diff --git a/README.mkdn b/README.mkdn deleted file mode 100644 index 387260b..0000000 --- a/README.mkdn +++ /dev/null @@ -1,36 +0,0 @@ -LineageOS -=========== - -Getting started ---------------- - -To get started with Android/LineageOS, you'll need to get familiar with [Source Control Tools](https://source.android.com/setup/develop). - -To initialize your local repository using the LineageOS trees, use a command like this: -``` -repo init -u https://github.com/LineageOS/android.git -b lineage-22.2 --git-lfs -``` -Then to sync up: -``` -repo sync -``` -Please see the [LineageOS Wiki](https://wiki.lineageos.org/) for building instructions, by device. - - -Submitting patches ------------------- -Patches are always welcome! Please submit your patches via LineageOS Gerrit! - -Simply follow our guide on [how to submit patches](https://wiki.lineageos.org/submitting-patch-howto.html). - -To view the status of your and others' patches, visit [LineageOS Gerrit Code Review](https://review.lineageos.org/). - - -Buildbot --------- - -All supported devices are built weekly and periodically as changes are committed to ensure the source trees remain buildable. - -You can view the current build statuses at [LineageOS Buildkite](https://buildkite.com/lineageos). - -Builds produced weekly by the buildbot can be downloaded from [LineageOS downloads](https://download.lineageos.org/). diff --git a/default.xml b/default.xml index 7ac99c1..c87ff01 100644 --- a/default.xml +++ b/default.xml @@ -2,26 +2,31 @@ - - + sync-c="true" + sync-j="10" /> + sync-j="20" /> + + - + @@ -37,14 +42,14 @@ - + - + - + @@ -324,8 +329,6 @@ - - @@ -518,7 +521,7 @@ - + @@ -597,7 +600,7 @@ - + @@ -612,7 +615,7 @@ - + @@ -624,7 +627,7 @@ - + @@ -658,14 +661,14 @@ - + - + @@ -690,7 +693,6 @@ - @@ -712,9 +714,9 @@ - + - + @@ -734,7 +736,7 @@ - + @@ -743,28 +745,27 @@ - + - - + - + - + @@ -774,10 +775,10 @@ - + - + @@ -823,21 +824,18 @@ - - - @@ -889,7 +887,7 @@ - + @@ -926,7 +924,7 @@ - + @@ -1015,4 +1013,5 @@ + diff --git a/snippets/iode.xml b/snippets/iode.xml new file mode 100644 index 0000000..72b15b5 --- /dev/null +++ b/snippets/iode.xml @@ -0,0 +1,20 @@ + + + + + + + + + + + + + + + + diff --git a/snippets/lineage.xml b/snippets/lineage.xml index 6e0a33e..e67ea66 100644 --- a/snippets/lineage.xml +++ b/snippets/lineage.xml @@ -2,10 +2,9 @@ - - + @@ -24,11 +23,11 @@ - + - - + + @@ -37,26 +36,25 @@ - + - - + - + - + - + @@ -203,14 +201,6 @@ - - - - - - - -