nixapks/README.md

Nixapks

A repository of derivations that builds as much open source android applications as possible.

$ nix build --print-out-paths github:osbm/nixapks#smouldering_durtles
/nix/store/z796iq87azckb8nsajpv43g7ybadq47s-smouldering_durtles-1.2.3.apk

Todo

• After adding 10 different apps (they all can be successfully built) ask to migrate this repo to the nix-community org.
• Add CI that builds all apps on every commit.
• Add first flutter app.
• Add first react-native app.
• Add first ionic app.
• Add documentation on github pages.
• Add binary cache
• Design a proper meta field for the needs of android apps.
  • description
  • license
  • main page
  • maintainers
  • minSdkVersion (explain what is this)
  • targetSdkVersion (explain what is this)
  • compileSdkVersion (explain what is this)
  • buildToolsVersion (explain what is this)
  • abi (list of supported abis: armeabi-v7a, arm64-v8a, x86, x86_64)

Create checks

• Check if the apk can be installed (hopefully on multiple architectures)
• Check the meta field
• Check if the output derivation has any runtime dependencies (it should not)
• Check if the app got an update (maybe from fdroid or github releases) and create a PR automatically.

Notes

Successful nix apk builds:

• https://github.com/CrazyChaoz/Minimal-Android-UWB-App
• https://github.com/iyox-studios/iyox-Wormhole
• https://github.com/expenses/irohdroid
• https://github.com/nix-community/robotnix/tree/master/apks/chromium
• 463c3f6606/apks/fdroid
• https://github.com/SpiralP/mobile_nebula

Important tools:

• https://github.com/CrazyChaoz/gradle-dot-nix : This flake can generate the full maven repo required to build a gradle app from gradle/verification-metadata.xml, all in the sandbox, without code generation.
• https://github.com/tadfisher/gradle2nix : Generate Nix expressions which build Gradle-based projects.
• https://github.com/tadfisher/android-nixpkgs : All packages from the Android SDK repository, packaged with Nix.
• gradle.fetchDeps : A tool to fetch Gradle dependencies and generate a Nix expression for them. This is used in nixpks to fetch the dependencies of the Gradle build system and generate deps.json files.

License

All the nix derivations in this repository are licensed under the MIT license. See the LICENSE file for details.

This license does not apply to the android applications built using these derivations. Please refer to the respective application's source code repository for licensing information.