DivestOS/Container/README.md

62 lines
1.4 KiB
Markdown
Raw Normal View History

Container: Scripted builds I had a hard time following the [Build Guide](https://divestos.org/pages/build) and IMO a script does a much better job of removing the ambiguity and is more likely to be updated if it fails. Per https://github.com/Divested-Mobile/DivestOS-Website/issues/40 I think this script, as documentation, makes it much more clear what it means to "color in the lines" and suggests an efficient way of doing so. I'd like to update the Build Guide too, but I wanted to get your feedback on some of this first. The main thing I'm not thrilled with is that the workspace needs to be patched and reset twice (if I understand correctly). I got this notion from your guidance on a Reddit post a couple months back which I can't find now that Reddit seems to have taken down your content. Unfortunately I don't recall the details but the basic issue is that generating the signing keys was giving an error and the solution was to patch the workspace. But one of the workspace patching "phases" is to copy the keys to the kernel and this fails if the keys don't exist yet. So it's not clear how to get around doing this step twice. A couple notes on future work: - How to do incremental updates? There's no story on this yet and I haven't looked into it. - I found a wealth of information on building android in docker in this repository: https://github.com/lineageos4microg/docker-lineage-cicd. It might be worth considering trying to integrate DivestOS into that project or building on top of their image.
2024-07-26 21:30:33 +00:00
1. Build image
```sh
./build-image-{podman,docker}.sh
```
2. Run container
required arguments:
- $1 - path where android build will end up
```sh
mkdir android
./run-image-{podman,docker}.sh "$(pwd)/Builds"
```
3. Proceed with build
Either proceed manually (https://divestos.org/pages/build#init) or use the scripts:
a. Setup divestos-build
```sh
# $1: version
./phase-1.sh "20.0" |& tee phase-1.log
```
b. Choose your options (optional)
```sh
nano DivestOS/Scripts/init.sh
```
c. Update description (optional)
```sh
nano DivestOS/Scripts/Generate_Signing_Keys.sh
```
d. Add vendor blobs
```sh
githuborg="" # <-- put the correct github organization here
sed -i "/github/s/\[COLOUR IN THE LINES\]/$githuborg/g" DivestOS/Build/LineageOS-20.0/.repo/local_manifests/local_manifest.xml
gitlaborg="" # <-- put the correct gitlab organization here
sed -i "/gitlab/s/\[COLOUR IN THE LINES\]/$gitlaborg/g" DivestOS/Build/LineageOS-20.0/.repo/local_manifests/local_manifest.xml
```
e. Download and Build
```sh
# $1: version
# $2: device
./phase-2.sh "20.0" "sailfish" |& tee phase-2.log
```
Note: To read logs with rendered color codes, you can use `less -r phase-2.log`.
4. Proceed with Installation
The flashable builds are now located in the build directory path you assigned above and you're ready for [installation](https://divestos.org/pages/bootloader).