| Jackeagle | ba27098 | 2025-03-18 02:35:26 -0400 | [diff] [blame] | 1 | <img src="banner.png"> |
| 2 | <p align="center"> |
| 3 | <a href="https://blissroms.org">Website</a> | |
| 4 | <a href="https://downloads.blissroms.org">Download</a> | |
| 5 | <a href="https://www.paypal.com/donate/?hosted_button_id=J5SLZ7MQNCT24">Donate</a> | |
| 6 | <a href="https://docs.blissroms.org">Documentation</a> | |
| 7 | <a href="https://www.instagram.com/blissroms">Instagram</a> | |
| 8 | <a href="https://t.me/BlissROM_Updates">Telegram</a> |
| Chris Soyars | 878bc02 | 2011-11-14 21:41:03 -0500 | [diff] [blame] | 9 | |
| Jackeagle | ba27098 | 2025-03-18 02:35:26 -0400 | [diff] [blame] | 10 | ## BlissRoms |
| Chris Soyars | 878bc02 | 2011-11-14 21:41:03 -0500 | [diff] [blame] | 11 | |
| Jackeagle | ba27098 | 2025-03-18 02:35:26 -0400 | [diff] [blame] | 12 | Download the BlissRoms source code, based on [AOSP](https://android.googlesource.com) & [LineageOS](https://github.com/LineageOS/android) |
| Chris Soyars | 878bc02 | 2011-11-14 21:41:03 -0500 | [diff] [blame] | 13 | |
| Jackeagle | ba27098 | 2025-03-18 02:35:26 -0400 | [diff] [blame] | 14 | --------------------------------------------------- |
| 15 | |
| 16 | Please read the [AOSP building instructions](http://source.android.com/source/index.html) before proceeding. |
| 17 | |
| 18 | ----------------------- |
| 19 | ## What you need to build [BlissRoms](https://github.com/BlissROMs/platform_manifest) |
| 20 | |
| 21 | |
| 22 | Latest Ubuntu LTS Releases https://www.ubuntu.com/download/server |
| 23 | Decent CPU (Dual Core or better for a faster performance) |
| 24 | 8GB RAM (16GB for Virtual Machine) |
| 25 | 250GB Hard Drive (about 170GB for the Repo and then building space needed) |
| 26 | |
| 27 | ----------------------- |
| 28 | |
| 29 | Installing Java 8 |
| 30 | |
| 31 | sudo add-apt-repository ppa:openjdk/ppa |
| 32 | sudo apt-get update && upgrade |
| 33 | sudo apt-get install openjdk-8-jdk |
| 34 | update-alternatives --config java (make sure Java 8 is selected) |
| 35 | update-alternatives --config javac (make sure Java 8 is selected) |
| 36 | reboot |
| 37 | |
| 38 | ----------------------- |
| 39 | |
| 40 | ## Grabbing Dependencies |
| 41 | |
| 42 | sudo apt-get install git-core gnupg flex bison gperf build-essential zip curl zlib1g-dev gcc-multilib g++-multilib libc6-dev-i386 lib32ncurses5-dev x11proto-core-dev libx11-dev lib32z-dev ccache libgl1-mesa-dev libxml2-utils xsltproc unzip squashfs-tools python-mako libssl-dev ninja-build lunzip syslinux syslinux-utils gettext genisoimage gettext bc xorriso xmlstarlet git-lfs |
| 43 | |
| 44 | ## Initializing Repository |
| 45 | |
| 46 | **Repo initialization** |
| 47 | |
| 48 | repo init -u https://github.com/BlissRoms/platform_manifest.git -b voyager-qpr2 --git-lfs |
| 49 | |
| 50 | **Sync repo** |
| 51 | |
| 52 | repo sync -c --force-sync --no-tags --no-clone-bundle -j10 --optimized-fetch --prune |
| 53 | |
| 54 | ## Options |
| 55 | |
| 56 | BLISS_BUILD_VARIANT - (vanilla, foss, microg) - We currently use this to specify what type of extra apps and services to include in the build. |
| 57 | ***Note: Default BLISS_BUILD_VARIANT is VANILLA.*** |
| 58 | |
| 59 | ## Building |
| 60 | |
| 61 | . build/envsetup.sh |
| 62 | blissify options deviceCodename |
| 63 | |
| 64 | |
| 65 | **Options:** |
| Bruno Martins | 23b40d0 | 2018-07-24 12:14:36 +0100 | [diff] [blame] | 66 | ``` |
| Jackeagle | ba27098 | 2025-03-18 02:35:26 -0400 | [diff] [blame] | 67 | -h | --help: Shows the help dialog |
| 68 | -c | --clean: Clean up before running the build |
| 69 | -d | --devclean: Clean up device only before running the build |
| 70 | -v | --vanilla: Build with no added app store solution **default option** |
| 71 | -f | --foss: build with FOSS (arm64-v8a) app store solutions added **requires vendor/foss** |
| 72 | -m | --microg: Build with MicroG |
| Bruno Martins | 23b40d0 | 2018-07-24 12:14:36 +0100 | [diff] [blame] | 73 | ``` |
| Jackeagle | ba27098 | 2025-03-18 02:35:26 -0400 | [diff] [blame] | 74 | |
| 75 | **Examples:** |
| 76 | |
| 77 | - **To build with FOSS** |
| Bruno Martins | 23b40d0 | 2018-07-24 12:14:36 +0100 | [diff] [blame] | 78 | ``` |
| Jackeagle | ba27098 | 2025-03-18 02:35:26 -0400 | [diff] [blame] | 79 | blissify -f deviceCodename |
| Bruno Martins | 23b40d0 | 2018-07-24 12:14:36 +0100 | [diff] [blame] | 80 | ``` |
| Chris Soyars | 878bc02 | 2011-11-14 21:41:03 -0500 | [diff] [blame] | 81 | |
| Jackeagle | ba27098 | 2025-03-18 02:35:26 -0400 | [diff] [blame] | 82 | - **To build deviceclean** |
| 83 | ``` |
| 84 | blissify -d deviceCodename |
| 85 | ``` |
| Chris Soyars | 878bc02 | 2011-11-14 21:41:03 -0500 | [diff] [blame] | 86 | |
| Jackeagle | ba27098 | 2025-03-18 02:35:26 -0400 | [diff] [blame] | 87 | **This method is also backwards compatible with the legacy blissify command also** |
| 88 | ``` |
| 89 | blissify deviceCodename |
| 90 | ``` |
| 91 | ## Report build issues |
| 92 | - You can reach us via [Telegram (BlissRoms Build Support)](https://t.me/Team_Bliss_Build_Support) |