Skip to content

Build and Reproducibility

rockcutto edited this page Oct 5, 2026 · 1 revision

LibreSpan can be built directly from the public repository.

Requirements

  • Git
  • JDK 17
  • Android SDK
  • Android SDK Platform 34
  • Gradle Wrapper included in the repository

LibreSpan uses the Gradle Wrapper, so you do not need to install a specific Gradle version separately.

The current wrapper uses Gradle 8.7.

Get the source

git clone https://github.com/rockcutto/librespan.git
cd librespan

The public development branch is:

git switch main
git pull --ff-only

For a normal build of the latest public version, main is sufficient.

To verify a specific published release, use the exact tag or commit associated with that release rather than the current main.

Build

Linux / macOS

Debug:

./gradlew assembleLibreSpanDebug

Release:

./gradlew assembleLibreSpanRelease

Windows

Debug:

.\gradlew.bat assembleLibreSpanDebug

Release:

.\gradlew.bat assembleLibreSpanRelease

Build output

APKs are written to:

build/outputs/apk/conversationsFree/

The internal Android variant name remains ConversationsFree, but the supported human-facing Gradle tasks are:

assembleLibreSpanDebug
assembleLibreSpanRelease

A normal LibreSpan Gradle build produces a universal APK.

Current public build parameters

Application ID: com.librespan
Minimum Android SDK: 24
Target Android SDK: 34
Compile SDK: 34
Java: 17
Gradle: 8.7

The debug build installs separately from the release build:

Release: com.librespan
Debug:   com.librespan.debug

Release signing

A local assembleLibreSpanRelease build is not the official signed LibreSpan release.

Official release APKs are signed with the project's release key. Android uses the application signature to verify whether an update is allowed.

Do not use unknown third-party APKs as a replacement for an official release.

ABI builds

LibreSpan's main Gradle configuration produces a universal APK.

Distribution may also provide APKs for individual architectures:

armeabi-v7a
arm64-v8a
x86
x86_64

These variants are part of the release/distribution pipeline and are not required for a normal local build.

Clone this wiki locally