CalyxOS includes microG by default. However, since it is an Android app built using the gradle build system, which the AOSP build system does not support, we build it separately and include a prebuilt APK for the OS build.

Preparation

cd ~/calyxos/android14
cd external/microg/GmsCore
git fetch --tags
export JAVA_OPTS="-Xmx2048m"
echo 'mapbox.key=apikey' > local.properties

In our builds we fail if there is no Mapbox API key to avoid shipping a build without it, as that will break Maps inside apps.

For development, you can simply put in a dummy value like the one above.

Build

./gradlew --no-daemon build

Copy

We use the variant with mapbox and with nearby.

You can copy play-services-core-withMapbox-withNearby-release-unsigned.apk to prebuilts/calyx/microg/GmsCore/GmsCore.apk for it to be included in the OS build.