DivestOS/Container/README.md
ryneeverett 3999fe1e1f 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 22:02:12 +00:00

1.4 KiB

  1. Build image
./build-image-{podman,docker}.sh
  1. Run container

required arguments:

  • $1 - path where android build will end up
mkdir android
./run-image-{podman,docker}.sh "$(pwd)/Builds"
  1. 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`.
  1. Proceed with Installation

The flashable builds are now located in the build directory path you assigned above and you're ready for installation.