Skip to content

Build.readme

Jump to bottom
PhilippC edited this page Mar 25, 2025 · 2 revisions

How to build Keepass2Android

Overview

Keepass2Android is a .net8 Android app. This means that you need .net8 Android to build it. However, the app also uses several components written in Java, so there are also Gradle-based projects involved. To make things even worse, some parts are written in native code.

To build KP2A from scratch, you need a Windows machine with:

  • .net 8 Android (comes with Microsoft Visual Studio)
  • Android SDK & NDK

Prior to building Keepass2Android, you need to build some of its components (from command line). Then you can build the full project either through Visual Studio, or through the command line.

Prerequisites

  • Install Android SDK & NDK (either manually with Google's sdkmanager, or through Android Studio). Visual Studio also installs a version of it, but in the end the directory must be writable and in a path without spaces (see below) so as to be able to build the components.

  • Fetch the main repository of Keepass2Android and all submodules

    • Note that VisualStudio can do this for you, otherwise run:
    • git submodule init && git submodule update

  • Install Visual Studio (for example 2022) with .net8 Android. This should provide the needed tools like

    • .net8 Android
    • MSBuild
    • Java JDK

  • If you plan to build also from the command line:

    • Install the MSVC build tools of visual studio. They provide the vcvarsall.bat file which among other things adds MSBuild to the PATH.
    • Install NuGet to build also with "make". Alternatively, on Windows, if you use chocolatey, run as administrator:
      • choco install nuget.commandline
    • Check that you have access to 'GNU make'.
      • On Windows, it is usually not available by default. But the Android NDK provides it. You can find it in %ANDROID_NDK_ROOT%\prebuilt\windows-x86_64\bin\make.exe. Alternatively, on Windows, if you use chocolatey, run as administrator:
        • choco install make

Building the required components:

This is done on the command line and requires the Android SDK & NDK and Java JDK.

  • Setup your environment:

    • Set these environment variables for Android's SDK & NDK

      • ANDROID_HOME (for example set ANDROID_HOME=C:\PATH\TO\android-sdk)
      • ANDROID_SDK_ROOT (for example set ANDROID_SDK_ROOT=C:\PATH\TO\android-sdk)
      • ANDROID_NDK_ROOT (for example set ANDROID_NDK_ROOT=C:\PATH\TO\android-sdk\ndk\version)

      Note: Care must be taken when setting the above variables to not include a trailing backslash in the path. A trailing backslash may cause make to fail.

      Note: If the path to the Android SDK contains spaces, you must do one of these:

      • either put the Android SDK into a path without spaces.

      • or create a symlink to that path which doesn't contain spaces. Attention: this requires administrator priveleges. For example:

        IF NOT EXIST C:\Android ( MKDIR C:\Android ) && 
MKLINK /D C:\Android\android-sdk "C:\Program Files (x86)\Android\android-sdk"

      This is because Android NDK doesn't support being installed in a path with spaces.

      Note: The Android SDK path will require to be writeable because during the build, some missing components might be downloaded & installed.

  • If you have "GNU make" available on your windows system, you may build by using the Makefile. You can also find a make executable in %ANDROID_NDK_ROOT%\prebuilt\windows-x86_64\bin\make.exe. To use it, see the instructions for Linux/macOS. Basically, just run make or mingw32-make depending on which distribution of GNU make for windows you have installed.

  • Otherwise proceed as below:

    1. Build argon2

      cd src/java/argon2
%ANDROID_NDK_ROOT%/ndk-build.cmd

    2. Build the other java components

      cd src/build-scripts
build-java.bat

      build-java.bat will call gradlew for several Java modules.

Notes:

  • For building the java parts, it is suggested to keep a short name (e.g. "c:\projects\keepass2android") for the root project directory. Otherwise the Windows path length limit might be hit when building.
  • Before building the java parts, make sure you have set the ANDROID_HOME variable or create a local.properties file inside the directories with a gradlew file. It is recommended to use the same SDK location as that of the Xamarin build.
  • On some environments, make can fail to properly use the detected MSBUILD tools. This seems to be due to long pathnames and/or spaces in pathnames. It may be required to explicitly set the MSBUILD path using 8.3 "short" path notation:
    • Determine the location of MSBUILD (e.g. C:\Program Files\Microsoft Visual Studio\2022\Community\MSBuild\Current\Bin\MSBuild.exe)
    • Generate the "short" path of that location (e.g.: C:\PROGRA~1\MICROS~2\2022\COMMUN~1\MSBuild\Current\Bin\MSBuild.exe)
    • When running make specify the location of ``MSBUILDexplicitly (e.g.:make MSBUILD="C:\PROGRA1\MICROS2\2022\COMMUN~1\MSBuild\Current\Bin\MSBuild.exe`

Building Keepass2Android:

These are the basic steps to build Keepass2Android. You can also build Keepass2Android Offline. For this, configure the build by using the Flavors.

With Visual Studio

  • On windows or on macOS open the src/KeePass.sln file with visual studio, and choose to build the project named 'keepass2android-app'

Command Line

Windows, Macos & Linux

to build the APK, simply run:

    make

or to skip building the APK:

    make msbuild

Where is the APK ?

The Apk can be installed on a device. It is located in src/keepass2android/bin/*/*-Signed.apk

If you build with Visual Studio, the APK is not produced automatically. You need to perform some extra step. See the documentation of Visual Studio on how to proceed.

Flavors

Keepass2Android is distributed in two flavors.

  • Keepass2Android (aka net)
  • Keepass2Android Offline (aka nonet)

The flavor is set through a MSBuild Property named "Flavor". The possible values are 'Net' and 'NoNet'.

The value of the Flavor property is used in 2 projects:

  • keepass2android-app (in src/keepass2android)
  • Kp2aBusinessLogic (in src/keepass2android)

Its value is set inside the *.csproj file (XML format) of each project in the Project/PropertyGroup/Flavor node. By default its value is set to an empty string so that development is made with AndroidManifest_debug.xml on the 'net' flavor.

This is the behaviour of the build system depending on the value of Flavor:

Flavor What is built AndroidManifest.xml used
`` (empty string): This is the default value. Keepass2Android AndroidManifest_debug.xml
Net Keepass2Android AndroidManifest_net.xml
NoNet Keepass2Android Offline AndroidManifest_nonet.xml

Select/Change flavor:

When building, by default, the flavor is not set. So the value used is the value of the Flavor property in *.csproj file. This should result on doing a build of the 'net' flavor.

You can force the Flavor by setting the Flavor property.

Proceed this way:

Command line

Windows, Macos & Linux

To force building 'net' with make, run:

    make Flavor=Net

To build 'nonet' with make, run:

    make Flavor=NoNet
MSBuild

To build with MSBuild directly on the command line, set the flavor with -p:Flavor=value argument. For example:

    MSBuild src/KeePass.sln ... -p:Flavor=NoNet

Visual Studio

When building with Visual Studio, edit the *.csproj file (XML format) and set the value in the Project/PropertyGroup/Flavor node. This is needed only for the projects that use the flavors.

Note: When switching between flavors, be sure to clean the previous build before.

Makefile

It is possible to override the project's default 'Flavor' (Net, NoNet) and 'Configuration' (Release, Debug) by passing it as argument to make. See the header of the Makefile to see what can be done.

Clone this wiki locally