From bb7b9f1bfe33074b4f49a3e4cd9a26f012b109e8 Mon Sep 17 00:00:00 2001 From: Milos Kozak Date: Mon, 16 Mar 2026 21:15:33 +0100 Subject: [PATCH 001/126] New translations updatetonewversion.md (Romanian) --- docs/CROWDIN/ro/Maintenance/UpdateToNewVersion.md | 6 +++++- 1 file changed, 5 insertions(+), 1 deletion(-) diff --git a/docs/CROWDIN/ro/Maintenance/UpdateToNewVersion.md b/docs/CROWDIN/ro/Maintenance/UpdateToNewVersion.md index 4a290089964a..bb94b8025194 100644 --- a/docs/CROWDIN/ro/Maintenance/UpdateToNewVersion.md +++ b/docs/CROWDIN/ro/Maintenance/UpdateToNewVersion.md @@ -16,10 +16,14 @@ If you already built your AAPS app with the Browser Build method, follow [these instructions](./UpdateBrowserBuild.md). -## Update AAPS with a computer +## Update AAPS with Android Studio Follow [these instructions.](./UpdateComputerBuild.md). +## Update AAPS with the command-line + +Use the [same instructions](../SettingUpAaps/CLIBuild.md) as when building AAPS previously, but pull new changes with git. + (Update-to-new-version-check-aaps-version-on-phone)= ### Check AAPS version on phone From ac21e421bdbce87ea731d2ef0d1447d9c8c4a2aa Mon Sep 17 00:00:00 2001 From: Milos Kozak Date: Mon, 16 Mar 2026 21:19:49 +0100 Subject: [PATCH 002/126] New translations documentationupdate.md (Romanian) --- docs/CROWDIN/ro/Maintenance/DocumentationUpdate.md | 5 +++++ 1 file changed, 5 insertions(+) diff --git a/docs/CROWDIN/ro/Maintenance/DocumentationUpdate.md b/docs/CROWDIN/ro/Maintenance/DocumentationUpdate.md index 0fafd92875ba..fa3b92479baf 100644 --- a/docs/CROWDIN/ro/Maintenance/DocumentationUpdate.md +++ b/docs/CROWDIN/ro/Maintenance/DocumentationUpdate.md @@ -1,5 +1,10 @@ # Docs updates & changes +## March 2026 + +- [Add CLI Build option](../SettingUpAaps/CLIBuild.md) @je-l +- Rename *Computer Build* to *Android Studio Build*. Preserve file names for URLs. + ## January 2025 - [3.4](#version3400) release and documentation update roll-up (Wizard, Computer build versions, Config Builder) From b16bbb168551317a366346395f8826dcb5bb1a2a Mon Sep 17 00:00:00 2001 From: Milos Kozak Date: Mon, 16 Mar 2026 21:20:25 +0100 Subject: [PATCH 003/126] New translations index.md (Romanian) --- docs/CROWDIN/ro/index.md | 5 +++-- 1 file changed, 3 insertions(+), 2 deletions(-) diff --git a/docs/CROWDIN/ro/index.md b/docs/CROWDIN/ro/index.md index 20b8f1837d2e..fc583173843e 100644 --- a/docs/CROWDIN/ro/index.md +++ b/docs/CROWDIN/ro/index.md @@ -91,7 +91,8 @@ Setting up the reporting server <./SettingUpAaps/SettingUpTheReportingServer.md> - Tidepool <./SettingUpAaps/Tidepool.md> Building AAPS <./SettingUpAaps/BuildingAaps.md> - Browser Build <./SettingUpAaps/BrowserBuild.md> -- Computer Build <./SettingUpAaps/ComputerBuild.md> +- Android Studio Build <./SettingUpAaps/ComputerBuild.md> +- CLI Build <./SettingUpAaps/CLIBuild.md> Transferring and Installing AAPS <./SettingUpAaps/TransferringAndInstallingAaps.md> Setup Wizard <./SettingUpAaps/SetupWizard.md> Your AAPS Profile <./SettingUpAaps/YourAapsProfile.md> @@ -149,7 +150,7 @@ AAPS Release Notes <./Maintenance/ReleaseNotes.md> Documentation updates <./Maintenance/DocumentationUpdate.md> Updating to a new version of AAPS <./Maintenance/UpdateToNewVersion.md> - Browser Update <./Maintenance/UpdateBrowserBuild.md> -- Computer Update <./Maintenance/UpdateComputerBuild.md> +- Android Studio Update <./Maintenance/UpdateComputerBuild.md> ``` From 9685ce51dee980f09a9d8fa0a2e199245f450525 Mon Sep 17 00:00:00 2001 From: Milos Kozak Date: Mon, 16 Mar 2026 21:23:48 +0100 Subject: [PATCH 004/126] New translations buildingaaps.md (Romanian) --- docs/CROWDIN/ro/SettingUpAaps/BuildingAaps.md | 15 +++++++++++---- 1 file changed, 11 insertions(+), 4 deletions(-) diff --git a/docs/CROWDIN/ro/SettingUpAaps/BuildingAaps.md b/docs/CROWDIN/ro/SettingUpAaps/BuildingAaps.md index aa95e0cf7c3a..97d38551b766 100644 --- a/docs/CROWDIN/ro/SettingUpAaps/BuildingAaps.md +++ b/docs/CROWDIN/ro/SettingUpAaps/BuildingAaps.md @@ -8,9 +8,9 @@ See [FAQ page](../UsefulLinks/FAQ.md) for details. --- -Two methods are available to build the AAPS app: +Three methods are available to build the AAPS app: -### Build with a browser +### Build with a browser (recommended) You can build the app with your smartphone using GitHub actions, and save it in your Google Drive. @@ -18,9 +18,16 @@ You can build the app with your smartphone using GitHub actions, and save it in ---- -### Build with a computer +### Build with Android Studio -You can build the app with your computer using Android Studio. +You can build the app with your computer using Android Studio. This used to be the only build option, nowadays Android Studio is mostly used by developers who consider making code changes. **[Follow these instructions.](./ComputerBuild.md)** +---- + +### Build using the command-line + +This option is intended for those who prefer to build AAPS in local command-line, without installing Android Studio. + +**[Follow these instructions.](./CLIBuild.md)** From 3e739beb24509ef4847f883bf84ed57b240a9374 Mon Sep 17 00:00:00 2001 From: Milos Kozak Date: Mon, 16 Mar 2026 21:25:03 +0100 Subject: [PATCH 005/126] New translations computerbuild.md (Romanian) --- docs/CROWDIN/ro/SettingUpAaps/ComputerBuild.md | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-) diff --git a/docs/CROWDIN/ro/SettingUpAaps/ComputerBuild.md b/docs/CROWDIN/ro/SettingUpAaps/ComputerBuild.md index 4a8952c657d8..4a1ec5606bdc 100644 --- a/docs/CROWDIN/ro/SettingUpAaps/ComputerBuild.md +++ b/docs/CROWDIN/ro/SettingUpAaps/ComputerBuild.md @@ -1,4 +1,6 @@ -# Computer Build + + +# Android Studio Build This is the traditional method to build your AAPS app. From 02d9eaab8ff52032e4f691992cc4670b13ec03ce Mon Sep 17 00:00:00 2001 From: Milos Kozak Date: Mon, 16 Mar 2026 21:25:08 +0100 Subject: [PATCH 006/126] New translations updatecomputerbuild.md (Romanian) --- docs/CROWDIN/ro/Maintenance/UpdateComputerBuild.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/CROWDIN/ro/Maintenance/UpdateComputerBuild.md b/docs/CROWDIN/ro/Maintenance/UpdateComputerBuild.md index 6a55381526f5..5382357cc05a 100644 --- a/docs/CROWDIN/ro/Maintenance/UpdateComputerBuild.md +++ b/docs/CROWDIN/ro/Maintenance/UpdateComputerBuild.md @@ -1,4 +1,4 @@ -# Update with a computer +# Update with Android Studio ## Build yourself instead of download @@ -8,7 +8,7 @@ In case you want to build **AAPS** on a new computer : copy your back-up keystore file to the new computer. Then follow the [Initial build **AAPS** procedure](../SettingUpAaps/BuildingAaps.md) instead of this guide. With the only difference that instead of creating a new keystore, you can select the one you have copied on the new computer. ``` -## Overview for updating to a new version of AAPS with a computer +## Overview for updating to a new version of AAPS with Android Studio ```{contents} Steps for updating to a new version of AAPS :depth: 1 From 030ac2f5bf5998679917b0565cdbeccec5e07bd1 Mon Sep 17 00:00:00 2001 From: Milos Kozak Date: Mon, 16 Mar 2026 21:27:24 +0100 Subject: [PATCH 007/126] New translations clibuild.md (Romanian) --- docs/CROWDIN/ro/SettingUpAaps/CLIBuild.md | 54 +++++++++++++++++++++++ 1 file changed, 54 insertions(+) create mode 100644 docs/CROWDIN/ro/SettingUpAaps/CLIBuild.md diff --git a/docs/CROWDIN/ro/SettingUpAaps/CLIBuild.md b/docs/CROWDIN/ro/SettingUpAaps/CLIBuild.md new file mode 100644 index 000000000000..91bcee48b1db --- /dev/null +++ b/docs/CROWDIN/ro/SettingUpAaps/CLIBuild.md @@ -0,0 +1,54 @@ +# Build instructions for the command-line + +```{admonition} For users familiar with the command-line and git +:class: information + +The simplest option to build AAPS is the [Browser build](./BrowserBuild.md) alternative. +``` + +Tested with Fedora and Debian Linux, other systems should work with minimal adjustments. + +## Requirements + +Consult the minimum required Java version from [this table](#Building-APK-recommended-specification-of-computer-for-building-apk-file). Install the appropriate OpenJDK package using the system package manager. For example in Debian, the packages are named like `openjdk-21-jdk`. It should include `javac` and `keytool` binaries. + +Download the *Android Command line tools* package from the [Android Studio page](https://developer.android.com/studio#command-line-tools-only). Android Studio itself is not required. More information about installing this package is found in [sdkmanager docs](https://developer.android.com/tools/sdkmanager). After the package is installed, you should manually set two [environment variables](https://developer.android.com/tools/variables): `ANDROID_HOME` and `PATH`. Finally, run `sdkmanager --licenses` to finish the installation. + +## Building AAPS with Gradle wrapper + +### 1. Generate a Java keystore file for signing AAPS + +If you already have a keystore file for signing AAPS, reuse that. + +```sh +keytool -genkeypair -v \ + -keystore aaps-keystore.jks \ + -alias aaps-key \ + -keyalg RSA \ + -keysize 4096 \ + -validity 20000 +``` + +You will need the keystore file and passphrase every time you update AAPS. + +### 2. Compile the AAPS APK file + +Clone the [git repo](https://github.com/nightscout/AndroidAPS) if not already cloned. AAPS uses master branch for the latest stable version, ensure you are on the branch/tag you want to build. + +Run `./gradlew :app:assembleFullRelease` in the repo. It automatically downloads Gradle, dependencies, and then compiles the code. When the build succeeds, you should have an unsigned APK at `app/build/outputs/apk/full/release/app-full-release-unsigned.apk`. It should have also installed an `apksigner` binary to `$ANDROID_HOME`. Update your `PATH` again. + +### 3. Create a signed APK file from the unsigned one + + + +Change to your home directory and create a signed APK file: + +```sh +apksigner sign \ + --ks path/to/aaps-keystore.jks \ + --ks-key-alias aaps-key \ + --out app-full-release-signed.apk \ + ./AndroidAPS/app/build/outputs/apk/full/release/app-full-release-unsigned.apk +``` + +Now you have `app-full-release-signed.apk` ready for installation or upgrade. From 3a21018de45e98a1396a40521f1e042a168cc62e Mon Sep 17 00:00:00 2001 From: Milos Kozak Date: Mon, 16 Mar 2026 21:27:34 +0100 Subject: [PATCH 008/126] New translations updatetonewversion.md (French) --- docs/CROWDIN/fr/Maintenance/UpdateToNewVersion.md | 6 +++++- 1 file changed, 5 insertions(+), 1 deletion(-) diff --git a/docs/CROWDIN/fr/Maintenance/UpdateToNewVersion.md b/docs/CROWDIN/fr/Maintenance/UpdateToNewVersion.md index 48c963b02bac..0c1a706ee703 100644 --- a/docs/CROWDIN/fr/Maintenance/UpdateToNewVersion.md +++ b/docs/CROWDIN/fr/Maintenance/UpdateToNewVersion.md @@ -16,10 +16,14 @@ If you already built your AAPS app with the Browser Build method, follow [these instructions](./UpdateBrowserBuild.md). -## Update AAPS with a computer +## Update AAPS with Android Studio Follow [these instructions.](./UpdateComputerBuild.md). +## Update AAPS with the command-line + +Use the [same instructions](../SettingUpAaps/CLIBuild.md) as when building AAPS previously, but pull new changes with git. + (Update-to-new-version-check-aaps-version-on-phone)= ### Vérifier la version d'AAPS sur le téléphone From 44176253becaedbb2e59c522b0f05ebf602fad73 Mon Sep 17 00:00:00 2001 From: Milos Kozak Date: Mon, 16 Mar 2026 21:31:42 +0100 Subject: [PATCH 009/126] New translations documentationupdate.md (French) --- docs/CROWDIN/fr/Maintenance/DocumentationUpdate.md | 5 +++++ 1 file changed, 5 insertions(+) diff --git a/docs/CROWDIN/fr/Maintenance/DocumentationUpdate.md b/docs/CROWDIN/fr/Maintenance/DocumentationUpdate.md index 0b35c1984fe1..2e734158cec1 100644 --- a/docs/CROWDIN/fr/Maintenance/DocumentationUpdate.md +++ b/docs/CROWDIN/fr/Maintenance/DocumentationUpdate.md @@ -1,5 +1,10 @@ # Mises à jour et modifications de la documentation +## March 2026 + +- [Add CLI Build option](../SettingUpAaps/CLIBuild.md) @je-l +- Rename *Computer Build* to *Android Studio Build*. Preserve file names for URLs. + ## January 2025 - [3.4](#version3400) release and documentation update roll-up (Wizard, Computer build versions, Config Builder) From 1ac3fbe391607967d10b4a39f15d14b88a78c05f Mon Sep 17 00:00:00 2001 From: Milos Kozak Date: Mon, 16 Mar 2026 21:32:15 +0100 Subject: [PATCH 010/126] New translations index.md (French) --- docs/CROWDIN/fr/index.md | 5 +++-- 1 file changed, 3 insertions(+), 2 deletions(-) diff --git a/docs/CROWDIN/fr/index.md b/docs/CROWDIN/fr/index.md index fb09de2f42b0..ddcdfd3b0a92 100644 --- a/docs/CROWDIN/fr/index.md +++ b/docs/CROWDIN/fr/index.md @@ -91,7 +91,8 @@ Setting up the reporting server <./SettingUpAaps/SettingUpTheReportingServer.md> - Tidepool <./SettingUpAaps/Tidepool.md> Building AAPS <./SettingUpAaps/BuildingAaps.md> - Browser Build <./SettingUpAaps/BrowserBuild.md> -- Computer Build <./SettingUpAaps/ComputerBuild.md> +- Android Studio Build <./SettingUpAaps/ComputerBuild.md> +- CLI Build <./SettingUpAaps/CLIBuild.md> Transferring and Installing AAPS <./SettingUpAaps/TransferringAndInstallingAaps.md> Setup Wizard <./SettingUpAaps/SetupWizard.md> Your AAPS Profile <./SettingUpAaps/YourAapsProfile.md> @@ -149,7 +150,7 @@ AAPS Release Notes <./Maintenance/ReleaseNotes.md> Documentation updates <./Maintenance/DocumentationUpdate.md> Updating to a new version of AAPS <./Maintenance/UpdateToNewVersion.md> - Browser Update <./Maintenance/UpdateBrowserBuild.md> -- Computer Update <./Maintenance/UpdateComputerBuild.md> +- Android Studio Update <./Maintenance/UpdateComputerBuild.md> ``` From 05a6823308e6c51b06c50a897f7715b847794e97 Mon Sep 17 00:00:00 2001 From: Milos Kozak Date: Mon, 16 Mar 2026 21:35:31 +0100 Subject: [PATCH 011/126] New translations buildingaaps.md (French) --- docs/CROWDIN/fr/SettingUpAaps/BuildingAaps.md | 15 +++++++++++---- 1 file changed, 11 insertions(+), 4 deletions(-) diff --git a/docs/CROWDIN/fr/SettingUpAaps/BuildingAaps.md b/docs/CROWDIN/fr/SettingUpAaps/BuildingAaps.md index 4015249c0ff8..eb737e467bfb 100644 --- a/docs/CROWDIN/fr/SettingUpAaps/BuildingAaps.md +++ b/docs/CROWDIN/fr/SettingUpAaps/BuildingAaps.md @@ -8,9 +8,9 @@ See [FAQ page](../UsefulLinks/FAQ.md) for details. --- -Two methods are available to build the AAPS app: +Three methods are available to build the AAPS app: -### Build with a browser +### Build with a browser (recommended) You can build the app with your smartphone using GitHub actions, and save it in your Google Drive. @@ -18,9 +18,16 @@ You can build the app with your smartphone using GitHub actions, and save it in ---- -### Build with a computer +### Build with Android Studio -You can build the app with your computer using Android Studio. +You can build the app with your computer using Android Studio. This used to be the only build option, nowadays Android Studio is mostly used by developers who consider making code changes. **[Follow these instructions.](./ComputerBuild.md)** +---- + +### Build using the command-line + +This option is intended for those who prefer to build AAPS in local command-line, without installing Android Studio. + +**[Follow these instructions.](./CLIBuild.md)** From 9b2057f4c447d8a11a4beed657e5de0ebea407b1 Mon Sep 17 00:00:00 2001 From: Milos Kozak Date: Mon, 16 Mar 2026 21:36:46 +0100 Subject: [PATCH 012/126] New translations computerbuild.md (French) --- docs/CROWDIN/fr/SettingUpAaps/ComputerBuild.md | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-) diff --git a/docs/CROWDIN/fr/SettingUpAaps/ComputerBuild.md b/docs/CROWDIN/fr/SettingUpAaps/ComputerBuild.md index bd764b42cc36..189f935f244a 100644 --- a/docs/CROWDIN/fr/SettingUpAaps/ComputerBuild.md +++ b/docs/CROWDIN/fr/SettingUpAaps/ComputerBuild.md @@ -1,4 +1,6 @@ -# Computer Build + + +# Android Studio Build This is the traditional method to build your AAPS app. From 9d39e2d2c35be62e9a6cb6b37bc03fc962291a75 Mon Sep 17 00:00:00 2001 From: Milos Kozak Date: Mon, 16 Mar 2026 21:36:51 +0100 Subject: [PATCH 013/126] New translations updatecomputerbuild.md (French) --- docs/CROWDIN/fr/Maintenance/UpdateComputerBuild.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/CROWDIN/fr/Maintenance/UpdateComputerBuild.md b/docs/CROWDIN/fr/Maintenance/UpdateComputerBuild.md index 7569ab1eafc8..a9babc8bec8b 100644 --- a/docs/CROWDIN/fr/Maintenance/UpdateComputerBuild.md +++ b/docs/CROWDIN/fr/Maintenance/UpdateComputerBuild.md @@ -1,4 +1,4 @@ -# Update with a computer +# Update with Android Studio ## Construire vous-même au lieu de télécharger @@ -8,7 +8,7 @@ In case you want to build **AAPS** on a new computer : copy your back-up keystore file to the new computer. Then follow the [Initial build **AAPS** procedure](../SettingUpAaps/BuildingAaps.md) instead of this guide. With the only difference that instead of creating a new keystore, you can select the one you have copied on the new computer. ``` -## Overview for updating to a new version of AAPS with a computer +## Overview for updating to a new version of AAPS with Android Studio ```{contents} Steps for updating to a new version of AAPS :depth: 1 From 948328453f9633fb7c54acecbdf292420433ab2e Mon Sep 17 00:00:00 2001 From: Milos Kozak Date: Mon, 16 Mar 2026 21:39:00 +0100 Subject: [PATCH 014/126] New translations clibuild.md (French) --- docs/CROWDIN/fr/SettingUpAaps/CLIBuild.md | 54 +++++++++++++++++++++++ 1 file changed, 54 insertions(+) create mode 100644 docs/CROWDIN/fr/SettingUpAaps/CLIBuild.md diff --git a/docs/CROWDIN/fr/SettingUpAaps/CLIBuild.md b/docs/CROWDIN/fr/SettingUpAaps/CLIBuild.md new file mode 100644 index 000000000000..91bcee48b1db --- /dev/null +++ b/docs/CROWDIN/fr/SettingUpAaps/CLIBuild.md @@ -0,0 +1,54 @@ +# Build instructions for the command-line + +```{admonition} For users familiar with the command-line and git +:class: information + +The simplest option to build AAPS is the [Browser build](./BrowserBuild.md) alternative. +``` + +Tested with Fedora and Debian Linux, other systems should work with minimal adjustments. + +## Requirements + +Consult the minimum required Java version from [this table](#Building-APK-recommended-specification-of-computer-for-building-apk-file). Install the appropriate OpenJDK package using the system package manager. For example in Debian, the packages are named like `openjdk-21-jdk`. It should include `javac` and `keytool` binaries. + +Download the *Android Command line tools* package from the [Android Studio page](https://developer.android.com/studio#command-line-tools-only). Android Studio itself is not required. More information about installing this package is found in [sdkmanager docs](https://developer.android.com/tools/sdkmanager). After the package is installed, you should manually set two [environment variables](https://developer.android.com/tools/variables): `ANDROID_HOME` and `PATH`. Finally, run `sdkmanager --licenses` to finish the installation. + +## Building AAPS with Gradle wrapper + +### 1. Generate a Java keystore file for signing AAPS + +If you already have a keystore file for signing AAPS, reuse that. + +```sh +keytool -genkeypair -v \ + -keystore aaps-keystore.jks \ + -alias aaps-key \ + -keyalg RSA \ + -keysize 4096 \ + -validity 20000 +``` + +You will need the keystore file and passphrase every time you update AAPS. + +### 2. Compile the AAPS APK file + +Clone the [git repo](https://github.com/nightscout/AndroidAPS) if not already cloned. AAPS uses master branch for the latest stable version, ensure you are on the branch/tag you want to build. + +Run `./gradlew :app:assembleFullRelease` in the repo. It automatically downloads Gradle, dependencies, and then compiles the code. When the build succeeds, you should have an unsigned APK at `app/build/outputs/apk/full/release/app-full-release-unsigned.apk`. It should have also installed an `apksigner` binary to `$ANDROID_HOME`. Update your `PATH` again. + +### 3. Create a signed APK file from the unsigned one + + + +Change to your home directory and create a signed APK file: + +```sh +apksigner sign \ + --ks path/to/aaps-keystore.jks \ + --ks-key-alias aaps-key \ + --out app-full-release-signed.apk \ + ./AndroidAPS/app/build/outputs/apk/full/release/app-full-release-unsigned.apk +``` + +Now you have `app-full-release-signed.apk` ready for installation or upgrade. From 864632ca644af145d183ab6fd5bcab10bde3b084 Mon Sep 17 00:00:00 2001 From: Milos Kozak Date: Mon, 16 Mar 2026 21:39:10 +0100 Subject: [PATCH 015/126] New translations updatetonewversion.md (Spanish) --- docs/CROWDIN/es/Maintenance/UpdateToNewVersion.md | 6 +++++- 1 file changed, 5 insertions(+), 1 deletion(-) diff --git a/docs/CROWDIN/es/Maintenance/UpdateToNewVersion.md b/docs/CROWDIN/es/Maintenance/UpdateToNewVersion.md index 915c5254614f..e59d04226235 100644 --- a/docs/CROWDIN/es/Maintenance/UpdateToNewVersion.md +++ b/docs/CROWDIN/es/Maintenance/UpdateToNewVersion.md @@ -16,10 +16,14 @@ If you already built your AAPS app with the Browser Build method, follow [these instructions](./UpdateBrowserBuild.md). -## Update AAPS with a computer +## Update AAPS with Android Studio Follow [these instructions.](./UpdateComputerBuild.md). +## Update AAPS with the command-line + +Use the [same instructions](../SettingUpAaps/CLIBuild.md) as when building AAPS previously, but pull new changes with git. + (Update-to-new-version-check-aaps-version-on-phone)= ### Check AAPS version on phone From 94f22f31e034aa06973a30715bba334d33fce4e7 Mon Sep 17 00:00:00 2001 From: Milos Kozak Date: Mon, 16 Mar 2026 21:43:07 +0100 Subject: [PATCH 016/126] New translations documentationupdate.md (Spanish) --- docs/CROWDIN/es/Maintenance/DocumentationUpdate.md | 5 +++++ 1 file changed, 5 insertions(+) diff --git a/docs/CROWDIN/es/Maintenance/DocumentationUpdate.md b/docs/CROWDIN/es/Maintenance/DocumentationUpdate.md index 5a195f068c15..0b03c3e2cd5c 100644 --- a/docs/CROWDIN/es/Maintenance/DocumentationUpdate.md +++ b/docs/CROWDIN/es/Maintenance/DocumentationUpdate.md @@ -1,5 +1,10 @@ # Docs updates & changes +## March 2026 + +- [Add CLI Build option](../SettingUpAaps/CLIBuild.md) @je-l +- Rename *Computer Build* to *Android Studio Build*. Preserve file names for URLs. + ## January 2025 - [3.4](#version3400) release and documentation update roll-up (Wizard, Computer build versions, Config Builder) From 516cdb532e3cb6d8f33d221f24b12dd0f2e502d6 Mon Sep 17 00:00:00 2001 From: Milos Kozak Date: Mon, 16 Mar 2026 21:43:38 +0100 Subject: [PATCH 017/126] New translations index.md (Spanish) --- docs/CROWDIN/es/index.md | 5 +++-- 1 file changed, 3 insertions(+), 2 deletions(-) diff --git a/docs/CROWDIN/es/index.md b/docs/CROWDIN/es/index.md index 9537cdb435c0..45a75efa370d 100644 --- a/docs/CROWDIN/es/index.md +++ b/docs/CROWDIN/es/index.md @@ -91,7 +91,8 @@ Setting up the reporting server <./SettingUpAaps/SettingUpTheReportingServer.md> - Tidepool <./SettingUpAaps/Tidepool.md> Building AAPS <./SettingUpAaps/BuildingAaps.md> - Browser Build <./SettingUpAaps/BrowserBuild.md> -- Computer Build <./SettingUpAaps/ComputerBuild.md> +- Android Studio Build <./SettingUpAaps/ComputerBuild.md> +- CLI Build <./SettingUpAaps/CLIBuild.md> Transferring and Installing AAPS <./SettingUpAaps/TransferringAndInstallingAaps.md> Setup Wizard <./SettingUpAaps/SetupWizard.md> Your AAPS Profile <./SettingUpAaps/YourAapsProfile.md> @@ -149,7 +150,7 @@ AAPS Release Notes <./Maintenance/ReleaseNotes.md> Documentation updates <./Maintenance/DocumentationUpdate.md> Updating to a new version of AAPS <./Maintenance/UpdateToNewVersion.md> - Browser Update <./Maintenance/UpdateBrowserBuild.md> -- Computer Update <./Maintenance/UpdateComputerBuild.md> +- Android Studio Update <./Maintenance/UpdateComputerBuild.md> ``` From 90fab1863e8c32d4f6ceed93d864499c65e120b4 Mon Sep 17 00:00:00 2001 From: Milos Kozak Date: Mon, 16 Mar 2026 21:46:46 +0100 Subject: [PATCH 018/126] New translations buildingaaps.md (Spanish) --- docs/CROWDIN/es/SettingUpAaps/BuildingAaps.md | 15 +++++++++++---- 1 file changed, 11 insertions(+), 4 deletions(-) diff --git a/docs/CROWDIN/es/SettingUpAaps/BuildingAaps.md b/docs/CROWDIN/es/SettingUpAaps/BuildingAaps.md index 074775982d70..15bee0aecc60 100644 --- a/docs/CROWDIN/es/SettingUpAaps/BuildingAaps.md +++ b/docs/CROWDIN/es/SettingUpAaps/BuildingAaps.md @@ -8,9 +8,9 @@ See [FAQ page](../UsefulLinks/FAQ.md) for details. --- -Two methods are available to build the AAPS app: +Three methods are available to build the AAPS app: -### Build with a browser +### Build with a browser (recommended) You can build the app with your smartphone using GitHub actions, and save it in your Google Drive. @@ -18,9 +18,16 @@ You can build the app with your smartphone using GitHub actions, and save it in ---- -### Build with a computer +### Build with Android Studio -You can build the app with your computer using Android Studio. +You can build the app with your computer using Android Studio. This used to be the only build option, nowadays Android Studio is mostly used by developers who consider making code changes. **[Follow these instructions.](./ComputerBuild.md)** +---- + +### Build using the command-line + +This option is intended for those who prefer to build AAPS in local command-line, without installing Android Studio. + +**[Follow these instructions.](./CLIBuild.md)** From a6d1fa74a41177e794b986fef1f902695c5b0146 Mon Sep 17 00:00:00 2001 From: Milos Kozak Date: Mon, 16 Mar 2026 21:47:59 +0100 Subject: [PATCH 019/126] New translations computerbuild.md (Spanish) --- docs/CROWDIN/es/SettingUpAaps/ComputerBuild.md | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-) diff --git a/docs/CROWDIN/es/SettingUpAaps/ComputerBuild.md b/docs/CROWDIN/es/SettingUpAaps/ComputerBuild.md index 6cbd8eea178d..e78788a05a00 100644 --- a/docs/CROWDIN/es/SettingUpAaps/ComputerBuild.md +++ b/docs/CROWDIN/es/SettingUpAaps/ComputerBuild.md @@ -1,4 +1,6 @@ -# Computer Build + + +# Android Studio Build This is the traditional method to build your AAPS app. From 154ac59dfcbc35375b6ef3b22de4b0502e133d48 Mon Sep 17 00:00:00 2001 From: Milos Kozak Date: Mon, 16 Mar 2026 21:48:03 +0100 Subject: [PATCH 020/126] New translations updatecomputerbuild.md (Spanish) --- docs/CROWDIN/es/Maintenance/UpdateComputerBuild.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/CROWDIN/es/Maintenance/UpdateComputerBuild.md b/docs/CROWDIN/es/Maintenance/UpdateComputerBuild.md index f3200a487103..f999f48368c1 100644 --- a/docs/CROWDIN/es/Maintenance/UpdateComputerBuild.md +++ b/docs/CROWDIN/es/Maintenance/UpdateComputerBuild.md @@ -1,4 +1,4 @@ -# Update with a computer +# Update with Android Studio ## Construyela tú mismo en lugar de descargarla @@ -8,7 +8,7 @@ In case you want to build **AAPS** on a new computer : copy your back-up keystore file to the new computer. Then follow the [Initial build **AAPS** procedure](../SettingUpAaps/BuildingAaps.md) instead of this guide. With the only difference that instead of creating a new keystore, you can select the one you have copied on the new computer. ``` -## Overview for updating to a new version of AAPS with a computer +## Overview for updating to a new version of AAPS with Android Studio ```{contents} Steps for updating to a new version of AAPS :depth: 1 From fda74bb23fbe60c364eae52e26140cd5bd27f89e Mon Sep 17 00:00:00 2001 From: Milos Kozak Date: Mon, 16 Mar 2026 21:50:09 +0100 Subject: [PATCH 021/126] New translations clibuild.md (Spanish) --- docs/CROWDIN/es/SettingUpAaps/CLIBuild.md | 54 +++++++++++++++++++++++ 1 file changed, 54 insertions(+) create mode 100644 docs/CROWDIN/es/SettingUpAaps/CLIBuild.md diff --git a/docs/CROWDIN/es/SettingUpAaps/CLIBuild.md b/docs/CROWDIN/es/SettingUpAaps/CLIBuild.md new file mode 100644 index 000000000000..91bcee48b1db --- /dev/null +++ b/docs/CROWDIN/es/SettingUpAaps/CLIBuild.md @@ -0,0 +1,54 @@ +# Build instructions for the command-line + +```{admonition} For users familiar with the command-line and git +:class: information + +The simplest option to build AAPS is the [Browser build](./BrowserBuild.md) alternative. +``` + +Tested with Fedora and Debian Linux, other systems should work with minimal adjustments. + +## Requirements + +Consult the minimum required Java version from [this table](#Building-APK-recommended-specification-of-computer-for-building-apk-file). Install the appropriate OpenJDK package using the system package manager. For example in Debian, the packages are named like `openjdk-21-jdk`. It should include `javac` and `keytool` binaries. + +Download the *Android Command line tools* package from the [Android Studio page](https://developer.android.com/studio#command-line-tools-only). Android Studio itself is not required. More information about installing this package is found in [sdkmanager docs](https://developer.android.com/tools/sdkmanager). After the package is installed, you should manually set two [environment variables](https://developer.android.com/tools/variables): `ANDROID_HOME` and `PATH`. Finally, run `sdkmanager --licenses` to finish the installation. + +## Building AAPS with Gradle wrapper + +### 1. Generate a Java keystore file for signing AAPS + +If you already have a keystore file for signing AAPS, reuse that. + +```sh +keytool -genkeypair -v \ + -keystore aaps-keystore.jks \ + -alias aaps-key \ + -keyalg RSA \ + -keysize 4096 \ + -validity 20000 +``` + +You will need the keystore file and passphrase every time you update AAPS. + +### 2. Compile the AAPS APK file + +Clone the [git repo](https://github.com/nightscout/AndroidAPS) if not already cloned. AAPS uses master branch for the latest stable version, ensure you are on the branch/tag you want to build. + +Run `./gradlew :app:assembleFullRelease` in the repo. It automatically downloads Gradle, dependencies, and then compiles the code. When the build succeeds, you should have an unsigned APK at `app/build/outputs/apk/full/release/app-full-release-unsigned.apk`. It should have also installed an `apksigner` binary to `$ANDROID_HOME`. Update your `PATH` again. + +### 3. Create a signed APK file from the unsigned one + + + +Change to your home directory and create a signed APK file: + +```sh +apksigner sign \ + --ks path/to/aaps-keystore.jks \ + --ks-key-alias aaps-key \ + --out app-full-release-signed.apk \ + ./AndroidAPS/app/build/outputs/apk/full/release/app-full-release-unsigned.apk +``` + +Now you have `app-full-release-signed.apk` ready for installation or upgrade. From 664a1da3d46afdd9299e62e1d9b642df30cb5367 Mon Sep 17 00:00:00 2001 From: Milos Kozak Date: Mon, 16 Mar 2026 21:50:20 +0100 Subject: [PATCH 022/126] New translations updatetonewversion.md (Czech) --- docs/CROWDIN/cs/Maintenance/UpdateToNewVersion.md | 6 +++++- 1 file changed, 5 insertions(+), 1 deletion(-) diff --git a/docs/CROWDIN/cs/Maintenance/UpdateToNewVersion.md b/docs/CROWDIN/cs/Maintenance/UpdateToNewVersion.md index 2647e7e07cf9..8987836e2b4e 100644 --- a/docs/CROWDIN/cs/Maintenance/UpdateToNewVersion.md +++ b/docs/CROWDIN/cs/Maintenance/UpdateToNewVersion.md @@ -16,10 +16,14 @@ If you already built your AAPS app with the Browser Build method, follow [these instructions](./UpdateBrowserBuild.md). -## Update AAPS with a computer +## Update AAPS with Android Studio Follow [these instructions.](./UpdateComputerBuild.md). +## Update AAPS with the command-line + +Use the [same instructions](../SettingUpAaps/CLIBuild.md) as when building AAPS previously, but pull new changes with git. + (Update-to-new-version-check-aaps-version-on-phone)= ### Zkontrolujte verzi AAPS na telefonu From cace39b75d736ff6cd375791f9d0adcd6da806ad Mon Sep 17 00:00:00 2001 From: Milos Kozak Date: Mon, 16 Mar 2026 21:54:38 +0100 Subject: [PATCH 023/126] New translations documentationupdate.md (Czech) --- docs/CROWDIN/cs/Maintenance/DocumentationUpdate.md | 5 +++++ 1 file changed, 5 insertions(+) diff --git a/docs/CROWDIN/cs/Maintenance/DocumentationUpdate.md b/docs/CROWDIN/cs/Maintenance/DocumentationUpdate.md index adef55e8a685..06072b4c527d 100644 --- a/docs/CROWDIN/cs/Maintenance/DocumentationUpdate.md +++ b/docs/CROWDIN/cs/Maintenance/DocumentationUpdate.md @@ -1,5 +1,10 @@ # Docs updates & changes +## March 2026 + +- [Add CLI Build option](../SettingUpAaps/CLIBuild.md) @je-l +- Rename *Computer Build* to *Android Studio Build*. Preserve file names for URLs. + ## January 2025 - [3.4](#version3400) release and documentation update roll-up (Wizard, Computer build versions, Config Builder) From e47aa57e14b732ee0325d967041dbb68f789dd38 Mon Sep 17 00:00:00 2001 From: Milos Kozak Date: Mon, 16 Mar 2026 21:55:11 +0100 Subject: [PATCH 024/126] New translations index.md (Czech) --- docs/CROWDIN/cs/index.md | 5 +++-- 1 file changed, 3 insertions(+), 2 deletions(-) diff --git a/docs/CROWDIN/cs/index.md b/docs/CROWDIN/cs/index.md index c72efd509080..f05ee905532c 100644 --- a/docs/CROWDIN/cs/index.md +++ b/docs/CROWDIN/cs/index.md @@ -91,7 +91,8 @@ Setting up the reporting server <./SettingUpAaps/SettingUpTheReportingServer.md> - Tidepool <./SettingUpAaps/Tidepool.md> Building AAPS <./SettingUpAaps/BuildingAaps.md> - Browser Build <./SettingUpAaps/BrowserBuild.md> -- Computer Build <./SettingUpAaps/ComputerBuild.md> +- Android Studio Build <./SettingUpAaps/ComputerBuild.md> +- CLI Build <./SettingUpAaps/CLIBuild.md> Transferring and Installing AAPS <./SettingUpAaps/TransferringAndInstallingAaps.md> Setup Wizard <./SettingUpAaps/SetupWizard.md> Your AAPS Profile <./SettingUpAaps/YourAapsProfile.md> @@ -149,7 +150,7 @@ AAPS Release Notes <./Maintenance/ReleaseNotes.md> Documentation updates <./Maintenance/DocumentationUpdate.md> Updating to a new version of AAPS <./Maintenance/UpdateToNewVersion.md> - Browser Update <./Maintenance/UpdateBrowserBuild.md> -- Computer Update <./Maintenance/UpdateComputerBuild.md> +- Android Studio Update <./Maintenance/UpdateComputerBuild.md> ``` From ddfe4c5e29abb84daadb1dd58960fa5d1f078654 Mon Sep 17 00:00:00 2001 From: Milos Kozak Date: Mon, 16 Mar 2026 21:58:10 +0100 Subject: [PATCH 025/126] New translations buildingaaps.md (Czech) --- docs/CROWDIN/cs/SettingUpAaps/BuildingAaps.md | 15 +++++++++++---- 1 file changed, 11 insertions(+), 4 deletions(-) diff --git a/docs/CROWDIN/cs/SettingUpAaps/BuildingAaps.md b/docs/CROWDIN/cs/SettingUpAaps/BuildingAaps.md index 7d75a0752378..5685ae7e5e35 100644 --- a/docs/CROWDIN/cs/SettingUpAaps/BuildingAaps.md +++ b/docs/CROWDIN/cs/SettingUpAaps/BuildingAaps.md @@ -8,9 +8,9 @@ See [FAQ page](../UsefulLinks/FAQ.md) for details. --- -Two methods are available to build the AAPS app: +Three methods are available to build the AAPS app: -### Build with a browser +### Build with a browser (recommended) You can build the app with your smartphone using GitHub actions, and save it in your Google Drive. @@ -18,9 +18,16 @@ You can build the app with your smartphone using GitHub actions, and save it in ---- -### Build with a computer +### Build with Android Studio -You can build the app with your computer using Android Studio. +You can build the app with your computer using Android Studio. This used to be the only build option, nowadays Android Studio is mostly used by developers who consider making code changes. **[Follow these instructions.](./ComputerBuild.md)** +---- + +### Build using the command-line + +This option is intended for those who prefer to build AAPS in local command-line, without installing Android Studio. + +**[Follow these instructions.](./CLIBuild.md)** From 2b0cf726ce128962c4f363b4bf185e0f69fea310 Mon Sep 17 00:00:00 2001 From: Milos Kozak Date: Mon, 16 Mar 2026 21:59:22 +0100 Subject: [PATCH 026/126] New translations computerbuild.md (Czech) --- docs/CROWDIN/cs/SettingUpAaps/ComputerBuild.md | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-) diff --git a/docs/CROWDIN/cs/SettingUpAaps/ComputerBuild.md b/docs/CROWDIN/cs/SettingUpAaps/ComputerBuild.md index e73de34e96dd..f70718a9e343 100644 --- a/docs/CROWDIN/cs/SettingUpAaps/ComputerBuild.md +++ b/docs/CROWDIN/cs/SettingUpAaps/ComputerBuild.md @@ -1,4 +1,6 @@ -# Computer Build + + +# Android Studio Build This is the traditional method to build your AAPS app. From 9e434869ea257cf1a8e6ce5ceae74752f2885349 Mon Sep 17 00:00:00 2001 From: Milos Kozak Date: Mon, 16 Mar 2026 21:59:26 +0100 Subject: [PATCH 027/126] New translations updatecomputerbuild.md (Czech) --- docs/CROWDIN/cs/Maintenance/UpdateComputerBuild.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/CROWDIN/cs/Maintenance/UpdateComputerBuild.md b/docs/CROWDIN/cs/Maintenance/UpdateComputerBuild.md index be68ba5cda2b..9df19e0466c8 100644 --- a/docs/CROWDIN/cs/Maintenance/UpdateComputerBuild.md +++ b/docs/CROWDIN/cs/Maintenance/UpdateComputerBuild.md @@ -1,4 +1,4 @@ -# Update with a computer +# Update with Android Studio ## Vyrobte si místo stažení @@ -8,7 +8,7 @@ In case you want to build **AAPS** on a new computer : copy your back-up keystore file to the new computer. Then follow the [Initial build **AAPS** procedure](../SettingUpAaps/BuildingAaps.md) instead of this guide. With the only difference that instead of creating a new keystore, you can select the one you have copied on the new computer. ``` -## Overview for updating to a new version of AAPS with a computer +## Overview for updating to a new version of AAPS with Android Studio ```{contents} Steps for updating to a new version of AAPS :depth: 1 From c258724db336fca2274c537161e3f351fc178ea1 Mon Sep 17 00:00:00 2001 From: Milos Kozak Date: Mon, 16 Mar 2026 22:01:58 +0100 Subject: [PATCH 028/126] New translations clibuild.md (Czech) --- docs/CROWDIN/cs/SettingUpAaps/CLIBuild.md | 54 +++++++++++++++++++++++ 1 file changed, 54 insertions(+) create mode 100644 docs/CROWDIN/cs/SettingUpAaps/CLIBuild.md diff --git a/docs/CROWDIN/cs/SettingUpAaps/CLIBuild.md b/docs/CROWDIN/cs/SettingUpAaps/CLIBuild.md new file mode 100644 index 000000000000..68fed127b7ed --- /dev/null +++ b/docs/CROWDIN/cs/SettingUpAaps/CLIBuild.md @@ -0,0 +1,54 @@ +# Build instructions for the command-line + +```{admonition} For users familiar with the command-line and git +:class: information + +The simplest option to build AAPS is the [Browser build](./BrowserBuild.md) alternative. +``` + +Tested with Fedora and Debian Linux, other systems should work with minimal adjustments. + +## Požadavky + +Consult the minimum required Java version from [this table](#Building-APK-recommended-specification-of-computer-for-building-apk-file). Install the appropriate OpenJDK package using the system package manager. For example in Debian, the packages are named like `openjdk-21-jdk`. It should include `javac` and `keytool` binaries. + +Download the *Android Command line tools* package from the [Android Studio page](https://developer.android.com/studio#command-line-tools-only). Android Studio itself is not required. More information about installing this package is found in [sdkmanager docs](https://developer.android.com/tools/sdkmanager). After the package is installed, you should manually set two [environment variables](https://developer.android.com/tools/variables): `ANDROID_HOME` and `PATH`. Finally, run `sdkmanager --licenses` to finish the installation. + +## Building AAPS with Gradle wrapper + +### 1. Generate a Java keystore file for signing AAPS + +If you already have a keystore file for signing AAPS, reuse that. + +```sh +keytool -genkeypair -v \ + -keystore aaps-keystore.jks \ + -alias aaps-key \ + -keyalg RSA \ + -keysize 4096 \ + -validity 20000 +``` + +You will need the keystore file and passphrase every time you update AAPS. + +### 2. Compile the AAPS APK file + +Clone the [git repo](https://github.com/nightscout/AndroidAPS) if not already cloned. AAPS uses master branch for the latest stable version, ensure you are on the branch/tag you want to build. + +Run `./gradlew :app:assembleFullRelease` in the repo. It automatically downloads Gradle, dependencies, and then compiles the code. When the build succeeds, you should have an unsigned APK at `app/build/outputs/apk/full/release/app-full-release-unsigned.apk`. It should have also installed an `apksigner` binary to `$ANDROID_HOME`. Update your `PATH` again. + +### 3. Create a signed APK file from the unsigned one + + + +Change to your home directory and create a signed APK file: + +```sh +apksigner sign \ + --ks path/to/aaps-keystore.jks \ + --ks-key-alias aaps-key \ + --out app-full-release-signed.apk \ + ./AndroidAPS/app/build/outputs/apk/full/release/app-full-release-unsigned.apk +``` + +Now you have `app-full-release-signed.apk` ready for installation or upgrade. From 166d939752cf4fa77d6d17d7d9ec93c5f9be78b5 Mon Sep 17 00:00:00 2001 From: Milos Kozak Date: Mon, 16 Mar 2026 22:02:10 +0100 Subject: [PATCH 029/126] New translations updatetonewversion.md (German) --- docs/CROWDIN/de/Maintenance/UpdateToNewVersion.md | 6 +++++- 1 file changed, 5 insertions(+), 1 deletion(-) diff --git a/docs/CROWDIN/de/Maintenance/UpdateToNewVersion.md b/docs/CROWDIN/de/Maintenance/UpdateToNewVersion.md index c9737641067c..a00667d93ea8 100644 --- a/docs/CROWDIN/de/Maintenance/UpdateToNewVersion.md +++ b/docs/CROWDIN/de/Maintenance/UpdateToNewVersion.md @@ -16,10 +16,14 @@ Aufgrund der gesetzlichen Regelungen für Medizinprodukte ist **AAPS** nicht als Wenn Du die AAPS-App bereits mit der Browser-Build-Methode erstellt hast, befolge [diesen Anweisungen](./UpdateBrowserBuild.md). -## AAPS mit einem Computer aktualisieren +## Update AAPS with Android Studio Nutze [diese Anleitung](./UpdateComputerBuild.md). +## Update AAPS with the command-line + +Use the [same instructions](../SettingUpAaps/CLIBuild.md) as when building AAPS previously, but pull new changes with git. + (Update-to-new-version-check-aaps-version-on-phone)= ### AAPS-Version auf dem Smartphone überprüfen From 3453fc26b4631cebc0b9597055201a587151fc11 Mon Sep 17 00:00:00 2001 From: Milos Kozak Date: Mon, 16 Mar 2026 22:06:52 +0100 Subject: [PATCH 030/126] New translations documentationupdate.md (German) --- docs/CROWDIN/de/Maintenance/DocumentationUpdate.md | 5 +++++ 1 file changed, 5 insertions(+) diff --git a/docs/CROWDIN/de/Maintenance/DocumentationUpdate.md b/docs/CROWDIN/de/Maintenance/DocumentationUpdate.md index 9f1f63c4f2ac..d838cb63e0fb 100644 --- a/docs/CROWDIN/de/Maintenance/DocumentationUpdate.md +++ b/docs/CROWDIN/de/Maintenance/DocumentationUpdate.md @@ -1,5 +1,10 @@ # Docs Updates & Änderungen +## March 2026 + +- [Add CLI Build option](../SettingUpAaps/CLIBuild.md) @je-l +- Rename *Computer Build* to *Android Studio Build*. Preserve file names for URLs. + ## Januar 2025 - [3.4](#version3400) Veröffentlichung und Dokumentation aktualisiert Roll-up (Einrichtungsasssistent, Computer Build-Versionen, Konfiguration) From 863f65804e6f6f739ee29a3d1ba2cb27dae60c0d Mon Sep 17 00:00:00 2001 From: Milos Kozak Date: Mon, 16 Mar 2026 22:07:30 +0100 Subject: [PATCH 031/126] New translations index.md (German) --- docs/CROWDIN/de/index.md | 39 ++++++++++++++++++++------------------- 1 file changed, 20 insertions(+), 19 deletions(-) diff --git a/docs/CROWDIN/de/index.md b/docs/CROWDIN/de/index.md index 2a2fa08767c1..60f032aecb9a 100644 --- a/docs/CROWDIN/de/index.md +++ b/docs/CROWDIN/de/index.md @@ -84,21 +84,22 @@ Komponentenübersicht <./Getting-Started/ComponentOverview.md> ``` ```{toctree} -:caption: 3) AAPS +:caption: 3) Setting up AAPS -Einrichten des Berichtsservers <./SettingUpAaps/SettingUpTheReportingServer.md> +Setting up the reporting server <./SettingUpAaps/SettingUpTheReportingServer.md> - Nightscout <./SettingUpAaps/Nightscout.md> - Tidepool <./SettingUpAaps/Tidepool.md> -AAPS erstellen <./SettingUpAaps/BuildingAaps.md> -- Im Browser (Browser Build) <./SettingUpAaps/BrowserBuild.md> -- Mit dem Computer (Computer Build) <./SettingUpAaps/ComputerBuild.md> -AAPS übertragen und installieren <./SettingUpAaps/TransferringAndInstallingAaps.md> -Einrichtungsassistent <./SettingUpAaps/SetupWizard.md> -Dein AAPS-Profil <. SettingUpAaps/YourAapsProfile.md> -Ändern der AAPS-Konfiguration <./SettingUpAaps/ChangeAapsConfiguration.md> -- Konfiguation <./SettingUpAaps/ConfigBuilder.md> -- Einstellungen <./SettingUpAaps/Preferences.md> -Abschluss der Ziele <./SettingUpAaps/CompletingTheObjectives.md> +Building AAPS <./SettingUpAaps/BuildingAaps.md> +- Browser Build <./SettingUpAaps/BrowserBuild.md> +- Android Studio Build <./SettingUpAaps/ComputerBuild.md> +- CLI Build <./SettingUpAaps/CLIBuild.md> +Transferring and Installing AAPS <./SettingUpAaps/TransferringAndInstallingAaps.md> +Setup Wizard <./SettingUpAaps/SetupWizard.md> +Your AAPS Profile <./SettingUpAaps/YourAapsProfile.md> +Change AAPS configuration <./SettingUpAaps/ChangeAapsConfiguration.md> +- Config Builder <./SettingUpAaps/ConfigBuilder.md> +- Preferences <./SettingUpAaps/Preferences.md> +Completing the objectives <./SettingUpAaps/CompletingTheObjectives.md> ``` ```{toctree} @@ -141,15 +142,15 @@ Austausch-Plattform für eigene Zifferblätter <./ExchangeSiteCustomWatchfaces/i ``` ```{toctree} -:caption: 7) AAPS pflegen +:caption: 7) Maintenance of AAPS -Export/Import der Einstellungen <./Maintenance/ExportImporteinstellungen. d> -Deine Daten prüfen <./Maintenance/Reviewing.md> +Export/Import Settings <./Maintenance/ExportImportSettings.md> +Reviewing your data <./Maintenance/Reviewing.md> AAPS Release Notes <./Maintenance/ReleaseNotes.md> -Dokumentation aktualisieren <. Maintenance/DocumentationUpdate.md> -Update auf eine neue AAPS-Version <./Maintenance/UpdateToNewVersion. d> -- Browser-Update <./Maintenance/UpdateBrowserBuild.md> -- Computer-Update <./Maintenance/UpdateComputerBuild.md> +Documentation updates <./Maintenance/DocumentationUpdate.md> +Updating to a new version of AAPS <./Maintenance/UpdateToNewVersion.md> +- Browser Update <./Maintenance/UpdateBrowserBuild.md> +- Android Studio Update <./Maintenance/UpdateComputerBuild.md> ``` From 7f5acd94e71732ed5f70fae8e792ccd449138c4b Mon Sep 17 00:00:00 2001 From: Milos Kozak Date: Mon, 16 Mar 2026 22:11:12 +0100 Subject: [PATCH 032/126] New translations buildingaaps.md (German) --- docs/CROWDIN/de/SettingUpAaps/BuildingAaps.md | 15 +++++++++++---- 1 file changed, 11 insertions(+), 4 deletions(-) diff --git a/docs/CROWDIN/de/SettingUpAaps/BuildingAaps.md b/docs/CROWDIN/de/SettingUpAaps/BuildingAaps.md index 2c50cb6416fa..4ece18007f20 100644 --- a/docs/CROWDIN/de/SettingUpAaps/BuildingAaps.md +++ b/docs/CROWDIN/de/SettingUpAaps/BuildingAaps.md @@ -8,9 +8,9 @@ Zu den Details schaue bitte auf die [FAQ-Seite](../UsefulLinks/FAQ.md). --- -Die AAPS-App kann auf zwei Wegen erstellt werden: +Three methods are available to build the AAPS app: -### Mit einem Browser erstellen +### Build with a browser (recommended) Du kannst die App mit Deinem Smartphone und entsprechenden GitHub-Aktionen erstellen und in Deinem Google Drive speichern. @@ -18,9 +18,16 @@ Du kannst die App mit Deinem Smartphone und entsprechenden GitHub-Aktionen erste ---- -### Mit einem Computer erstellen +### Build with Android Studio -Du kannst die App mit Deinem Computer und dem „Android Studio“ erstellen. +You can build the app with your computer using Android Studio. This used to be the only build option, nowadays Android Studio is mostly used by developers who consider making code changes. **[Nutze diese Anleitung.](./ComputerBuild.md)** +---- + +### Build using the command-line + +This option is intended for those who prefer to build AAPS in local command-line, without installing Android Studio. + +**[Nutze diese Anleitung.](./CLIBuild.md)** From 3a12c4d8b87b80c17f28d0e667522f27a36bf776 Mon Sep 17 00:00:00 2001 From: Milos Kozak Date: Mon, 16 Mar 2026 22:12:39 +0100 Subject: [PATCH 033/126] New translations computerbuild.md (German) --- docs/CROWDIN/de/SettingUpAaps/ComputerBuild.md | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-) diff --git a/docs/CROWDIN/de/SettingUpAaps/ComputerBuild.md b/docs/CROWDIN/de/SettingUpAaps/ComputerBuild.md index b245483897a3..c0c0be720bee 100644 --- a/docs/CROWDIN/de/SettingUpAaps/ComputerBuild.md +++ b/docs/CROWDIN/de/SettingUpAaps/ComputerBuild.md @@ -1,4 +1,6 @@ -# Computer Build + + +# Android Studio Build Dies ist die herkömmliche Methode, um Deine AAPS-App zu erstellen. From cd96fabba8ba29b205e74dfd7c82c9fcc15513f6 Mon Sep 17 00:00:00 2001 From: Milos Kozak Date: Mon, 16 Mar 2026 22:12:45 +0100 Subject: [PATCH 034/126] New translations updatecomputerbuild.md (German) --- docs/CROWDIN/de/Maintenance/UpdateComputerBuild.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/CROWDIN/de/Maintenance/UpdateComputerBuild.md b/docs/CROWDIN/de/Maintenance/UpdateComputerBuild.md index 773db341d62f..8c20c279c49f 100644 --- a/docs/CROWDIN/de/Maintenance/UpdateComputerBuild.md +++ b/docs/CROWDIN/de/Maintenance/UpdateComputerBuild.md @@ -1,4 +1,4 @@ -# Mit einem PC/Computer aktualisieren +# Update with Android Studio ## Kein Download möglich - APK muss selbst erstellt werden @@ -8,7 +8,7 @@ Aufgrund der gesetzlichen Regelungen für Medizinprodukte ist **AAPS** nicht als Falls Du **AAPS** auf einem neuen Computer erstellen möchtest: Kopiere das Backup Deiner Keystore-Datei auf den neuen Computer. Folge dann dem [Prozess für die erstmalige **AAPS**-Erstellung](../SettingUpAaps/BuildingAaps.md) und nicht dieser Anleitung. Der einzige Unterschied besteht darin, dass Du anstelle einen neuen Keystore zu erstellen, den Keystore auswählst, den Du auf den neuen Computer kopiert hast. ``` -## Übersicht zur Aktualisierung auf eine neue AAPS-Version mit einem Computer +## Overview for updating to a new version of AAPS with Android Studio ```{contents} Steps for updating to a new version of AAPS :depth: 1 From 540ce60bcad22be64ce26a3424dbe24317980033 Mon Sep 17 00:00:00 2001 From: Milos Kozak Date: Mon, 16 Mar 2026 22:15:13 +0100 Subject: [PATCH 035/126] New translations clibuild.md (German) --- docs/CROWDIN/de/SettingUpAaps/CLIBuild.md | 54 +++++++++++++++++++++++ 1 file changed, 54 insertions(+) create mode 100644 docs/CROWDIN/de/SettingUpAaps/CLIBuild.md diff --git a/docs/CROWDIN/de/SettingUpAaps/CLIBuild.md b/docs/CROWDIN/de/SettingUpAaps/CLIBuild.md new file mode 100644 index 000000000000..b82dccda2722 --- /dev/null +++ b/docs/CROWDIN/de/SettingUpAaps/CLIBuild.md @@ -0,0 +1,54 @@ +# Build instructions for the command-line + +```{admonition} For users familiar with the command-line and git +:class: information + +The simplest option to build AAPS is the [Browser build](./BrowserBuild.md) alternative. +``` + +Tested with Fedora and Debian Linux, other systems should work with minimal adjustments. + +## Voraussetzungen + +Consult the minimum required Java version from [this table](#Building-APK-recommended-specification-of-computer-for-building-apk-file). Install the appropriate OpenJDK package using the system package manager. For example in Debian, the packages are named like `openjdk-21-jdk`. It should include `javac` and `keytool` binaries. + +Download the *Android Command line tools* package from the [Android Studio page](https://developer.android.com/studio#command-line-tools-only). Android Studio itself is not required. More information about installing this package is found in [sdkmanager docs](https://developer.android.com/tools/sdkmanager). After the package is installed, you should manually set two [environment variables](https://developer.android.com/tools/variables): `ANDROID_HOME` and `PATH`. Finally, run `sdkmanager --licenses` to finish the installation. + +## Building AAPS with Gradle wrapper + +### 1. Generate a Java keystore file for signing AAPS + +If you already have a keystore file for signing AAPS, reuse that. + +```sh +keytool -genkeypair -v \ + -keystore aaps-keystore.jks \ + -alias aaps-key \ + -keyalg RSA \ + -keysize 4096 \ + -validity 20000 +``` + +You will need the keystore file and passphrase every time you update AAPS. + +### 2. Compile the AAPS APK file + +Clone the [git repo](https://github.com/nightscout/AndroidAPS) if not already cloned. AAPS uses master branch for the latest stable version, ensure you are on the branch/tag you want to build. + +Run `./gradlew :app:assembleFullRelease` in the repo. It automatically downloads Gradle, dependencies, and then compiles the code. When the build succeeds, you should have an unsigned APK at `app/build/outputs/apk/full/release/app-full-release-unsigned.apk`. It should have also installed an `apksigner` binary to `$ANDROID_HOME`. Update your `PATH` again. + +### 3. Create a signed APK file from the unsigned one + + + +Change to your home directory and create a signed APK file: + +```sh +apksigner sign \ + --ks path/to/aaps-keystore.jks \ + --ks-key-alias aaps-key \ + --out app-full-release-signed.apk \ + ./AndroidAPS/app/build/outputs/apk/full/release/app-full-release-unsigned.apk +``` + +Now you have `app-full-release-signed.apk` ready for installation or upgrade. From 6cb26cbce2fdf67d8487d7a62bca344c5ff65aed Mon Sep 17 00:00:00 2001 From: Milos Kozak Date: Mon, 16 Mar 2026 22:15:24 +0100 Subject: [PATCH 036/126] New translations updatetonewversion.md (Greek) --- docs/CROWDIN/el/Maintenance/UpdateToNewVersion.md | 6 +++++- 1 file changed, 5 insertions(+), 1 deletion(-) diff --git a/docs/CROWDIN/el/Maintenance/UpdateToNewVersion.md b/docs/CROWDIN/el/Maintenance/UpdateToNewVersion.md index 2c0aec79a676..fbd3341d4789 100644 --- a/docs/CROWDIN/el/Maintenance/UpdateToNewVersion.md +++ b/docs/CROWDIN/el/Maintenance/UpdateToNewVersion.md @@ -16,10 +16,14 @@ If you already built your AAPS app with the Browser Build method, follow [these instructions](./UpdateBrowserBuild.md). -## Update AAPS with a computer +## Update AAPS with Android Studio Follow [these instructions.](./UpdateComputerBuild.md). +## Update AAPS with the command-line + +Use the [same instructions](../SettingUpAaps/CLIBuild.md) as when building AAPS previously, but pull new changes with git. + (Update-to-new-version-check-aaps-version-on-phone)= ### Ελέγξτε την έκδοση AAPS στο τηλέφωνό σας From 95227f57897df7d2a1b6a3d987d9db01f0a8e7c7 Mon Sep 17 00:00:00 2001 From: Milos Kozak Date: Mon, 16 Mar 2026 22:19:21 +0100 Subject: [PATCH 037/126] New translations documentationupdate.md (Greek) --- docs/CROWDIN/el/Maintenance/DocumentationUpdate.md | 5 +++++ 1 file changed, 5 insertions(+) diff --git a/docs/CROWDIN/el/Maintenance/DocumentationUpdate.md b/docs/CROWDIN/el/Maintenance/DocumentationUpdate.md index e474b7f79529..15db54ffc0ab 100644 --- a/docs/CROWDIN/el/Maintenance/DocumentationUpdate.md +++ b/docs/CROWDIN/el/Maintenance/DocumentationUpdate.md @@ -1,5 +1,10 @@ # Docs updates & changes +## March 2026 + +- [Add CLI Build option](../SettingUpAaps/CLIBuild.md) @je-l +- Rename *Computer Build* to *Android Studio Build*. Preserve file names for URLs. + ## January 2025 - [3.4](#version3400) release and documentation update roll-up (Wizard, Computer build versions, Config Builder) From e1a31c562fc464dd80a27e47832dcbb56fce99c3 Mon Sep 17 00:00:00 2001 From: Milos Kozak Date: Mon, 16 Mar 2026 22:19:52 +0100 Subject: [PATCH 038/126] New translations index.md (Greek) --- docs/CROWDIN/el/index.md | 5 +++-- 1 file changed, 3 insertions(+), 2 deletions(-) diff --git a/docs/CROWDIN/el/index.md b/docs/CROWDIN/el/index.md index dc94e2ec251d..fddd4437fb91 100644 --- a/docs/CROWDIN/el/index.md +++ b/docs/CROWDIN/el/index.md @@ -91,7 +91,8 @@ Setting up the reporting server <./SettingUpAaps/SettingUpTheReportingServer.md> - Tidepool <./SettingUpAaps/Tidepool.md> Building AAPS <./SettingUpAaps/BuildingAaps.md> - Browser Build <./SettingUpAaps/BrowserBuild.md> -- Computer Build <./SettingUpAaps/ComputerBuild.md> +- Android Studio Build <./SettingUpAaps/ComputerBuild.md> +- CLI Build <./SettingUpAaps/CLIBuild.md> Transferring and Installing AAPS <./SettingUpAaps/TransferringAndInstallingAaps.md> Setup Wizard <./SettingUpAaps/SetupWizard.md> Your AAPS Profile <./SettingUpAaps/YourAapsProfile.md> @@ -149,7 +150,7 @@ AAPS Release Notes <./Maintenance/ReleaseNotes.md> Documentation updates <./Maintenance/DocumentationUpdate.md> Updating to a new version of AAPS <./Maintenance/UpdateToNewVersion.md> - Browser Update <./Maintenance/UpdateBrowserBuild.md> -- Computer Update <./Maintenance/UpdateComputerBuild.md> +- Android Studio Update <./Maintenance/UpdateComputerBuild.md> ``` From a22f7cb168dd47cefbac3534c16d806327515a4c Mon Sep 17 00:00:00 2001 From: Milos Kozak Date: Mon, 16 Mar 2026 22:23:00 +0100 Subject: [PATCH 039/126] New translations buildingaaps.md (Greek) --- docs/CROWDIN/el/SettingUpAaps/BuildingAaps.md | 15 +++++++++++---- 1 file changed, 11 insertions(+), 4 deletions(-) diff --git a/docs/CROWDIN/el/SettingUpAaps/BuildingAaps.md b/docs/CROWDIN/el/SettingUpAaps/BuildingAaps.md index 5989cf3fd8b9..6c2691f4372b 100644 --- a/docs/CROWDIN/el/SettingUpAaps/BuildingAaps.md +++ b/docs/CROWDIN/el/SettingUpAaps/BuildingAaps.md @@ -8,9 +8,9 @@ See [FAQ page](../UsefulLinks/FAQ.md) for details. --- -Two methods are available to build the AAPS app: +Three methods are available to build the AAPS app: -### Build with a browser +### Build with a browser (recommended) You can build the app with your smartphone using GitHub actions, and save it in your Google Drive. @@ -18,9 +18,16 @@ You can build the app with your smartphone using GitHub actions, and save it in ---- -### Build with a computer +### Build with Android Studio -You can build the app with your computer using Android Studio. +You can build the app with your computer using Android Studio. This used to be the only build option, nowadays Android Studio is mostly used by developers who consider making code changes. **[Follow these instructions.](./ComputerBuild.md)** +---- + +### Build using the command-line + +This option is intended for those who prefer to build AAPS in local command-line, without installing Android Studio. + +**[Follow these instructions.](./CLIBuild.md)** From b5069a8b52801d01ec26938ad95e0dbcd35d701b Mon Sep 17 00:00:00 2001 From: Milos Kozak Date: Mon, 16 Mar 2026 22:24:10 +0100 Subject: [PATCH 040/126] New translations computerbuild.md (Greek) --- docs/CROWDIN/el/SettingUpAaps/ComputerBuild.md | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-) diff --git a/docs/CROWDIN/el/SettingUpAaps/ComputerBuild.md b/docs/CROWDIN/el/SettingUpAaps/ComputerBuild.md index f1f49fcdbfba..8e8be37f5ef5 100644 --- a/docs/CROWDIN/el/SettingUpAaps/ComputerBuild.md +++ b/docs/CROWDIN/el/SettingUpAaps/ComputerBuild.md @@ -1,4 +1,6 @@ -# Computer Build + + +# Android Studio Build This is the traditional method to build your AAPS app. From 8462dd3fd731337ecfb7e390487286bb9b96ab37 Mon Sep 17 00:00:00 2001 From: Milos Kozak Date: Mon, 16 Mar 2026 22:24:15 +0100 Subject: [PATCH 041/126] New translations updatecomputerbuild.md (Greek) --- docs/CROWDIN/el/Maintenance/UpdateComputerBuild.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/CROWDIN/el/Maintenance/UpdateComputerBuild.md b/docs/CROWDIN/el/Maintenance/UpdateComputerBuild.md index 05f9f95147af..2c6c56fb37a4 100644 --- a/docs/CROWDIN/el/Maintenance/UpdateComputerBuild.md +++ b/docs/CROWDIN/el/Maintenance/UpdateComputerBuild.md @@ -1,4 +1,4 @@ -# Update with a computer +# Update with Android Studio ## Φτιάξτε το μόνοι σας, αντί να το κατεβάσετε @@ -8,7 +8,7 @@ In case you want to build **AAPS** on a new computer : copy your back-up keystore file to the new computer. Then follow the [Initial build **AAPS** procedure](../SettingUpAaps/BuildingAaps.md) instead of this guide. With the only difference that instead of creating a new keystore, you can select the one you have copied on the new computer. ``` -## Overview for updating to a new version of AAPS with a computer +## Overview for updating to a new version of AAPS with Android Studio ```{contents} Steps for updating to a new version of AAPS :depth: 1 From f479d404212aa02bbde6ff8e749e73d37b9ceb2e Mon Sep 17 00:00:00 2001 From: Milos Kozak Date: Mon, 16 Mar 2026 22:26:20 +0100 Subject: [PATCH 042/126] New translations clibuild.md (Greek) --- docs/CROWDIN/el/SettingUpAaps/CLIBuild.md | 54 +++++++++++++++++++++++ 1 file changed, 54 insertions(+) create mode 100644 docs/CROWDIN/el/SettingUpAaps/CLIBuild.md diff --git a/docs/CROWDIN/el/SettingUpAaps/CLIBuild.md b/docs/CROWDIN/el/SettingUpAaps/CLIBuild.md new file mode 100644 index 000000000000..91bcee48b1db --- /dev/null +++ b/docs/CROWDIN/el/SettingUpAaps/CLIBuild.md @@ -0,0 +1,54 @@ +# Build instructions for the command-line + +```{admonition} For users familiar with the command-line and git +:class: information + +The simplest option to build AAPS is the [Browser build](./BrowserBuild.md) alternative. +``` + +Tested with Fedora and Debian Linux, other systems should work with minimal adjustments. + +## Requirements + +Consult the minimum required Java version from [this table](#Building-APK-recommended-specification-of-computer-for-building-apk-file). Install the appropriate OpenJDK package using the system package manager. For example in Debian, the packages are named like `openjdk-21-jdk`. It should include `javac` and `keytool` binaries. + +Download the *Android Command line tools* package from the [Android Studio page](https://developer.android.com/studio#command-line-tools-only). Android Studio itself is not required. More information about installing this package is found in [sdkmanager docs](https://developer.android.com/tools/sdkmanager). After the package is installed, you should manually set two [environment variables](https://developer.android.com/tools/variables): `ANDROID_HOME` and `PATH`. Finally, run `sdkmanager --licenses` to finish the installation. + +## Building AAPS with Gradle wrapper + +### 1. Generate a Java keystore file for signing AAPS + +If you already have a keystore file for signing AAPS, reuse that. + +```sh +keytool -genkeypair -v \ + -keystore aaps-keystore.jks \ + -alias aaps-key \ + -keyalg RSA \ + -keysize 4096 \ + -validity 20000 +``` + +You will need the keystore file and passphrase every time you update AAPS. + +### 2. Compile the AAPS APK file + +Clone the [git repo](https://github.com/nightscout/AndroidAPS) if not already cloned. AAPS uses master branch for the latest stable version, ensure you are on the branch/tag you want to build. + +Run `./gradlew :app:assembleFullRelease` in the repo. It automatically downloads Gradle, dependencies, and then compiles the code. When the build succeeds, you should have an unsigned APK at `app/build/outputs/apk/full/release/app-full-release-unsigned.apk`. It should have also installed an `apksigner` binary to `$ANDROID_HOME`. Update your `PATH` again. + +### 3. Create a signed APK file from the unsigned one + + + +Change to your home directory and create a signed APK file: + +```sh +apksigner sign \ + --ks path/to/aaps-keystore.jks \ + --ks-key-alias aaps-key \ + --out app-full-release-signed.apk \ + ./AndroidAPS/app/build/outputs/apk/full/release/app-full-release-unsigned.apk +``` + +Now you have `app-full-release-signed.apk` ready for installation or upgrade. From a1d9b1de7a1418b04f04e7d72d2171400b11848d Mon Sep 17 00:00:00 2001 From: Milos Kozak Date: Mon, 16 Mar 2026 22:26:30 +0100 Subject: [PATCH 043/126] New translations updatetonewversion.md (Hebrew) --- docs/CROWDIN/he/Maintenance/UpdateToNewVersion.md | 6 +++++- 1 file changed, 5 insertions(+), 1 deletion(-) diff --git a/docs/CROWDIN/he/Maintenance/UpdateToNewVersion.md b/docs/CROWDIN/he/Maintenance/UpdateToNewVersion.md index ce7a47824295..35dad0358740 100644 --- a/docs/CROWDIN/he/Maintenance/UpdateToNewVersion.md +++ b/docs/CROWDIN/he/Maintenance/UpdateToNewVersion.md @@ -16,10 +16,14 @@ If you already built your AAPS app with the Browser Build method, follow [these instructions](./UpdateBrowserBuild.md). -## Update AAPS with a computer +## Update AAPS with Android Studio Follow [these instructions.](./UpdateComputerBuild.md). +## Update AAPS with the command-line + +Use the [same instructions](../SettingUpAaps/CLIBuild.md) as when building AAPS previously, but pull new changes with git. + (Update-to-new-version-check-aaps-version-on-phone)= ### Check AAPS version on phone From 2b804b5a85ab5359da5d79e89a29bd630a71c1f9 Mon Sep 17 00:00:00 2001 From: Milos Kozak Date: Mon, 16 Mar 2026 22:30:15 +0100 Subject: [PATCH 044/126] New translations documentationupdate.md (Hebrew) --- docs/CROWDIN/he/Maintenance/DocumentationUpdate.md | 5 +++++ 1 file changed, 5 insertions(+) diff --git a/docs/CROWDIN/he/Maintenance/DocumentationUpdate.md b/docs/CROWDIN/he/Maintenance/DocumentationUpdate.md index 2434bb70c4ed..af134d2d90ac 100644 --- a/docs/CROWDIN/he/Maintenance/DocumentationUpdate.md +++ b/docs/CROWDIN/he/Maintenance/DocumentationUpdate.md @@ -1,5 +1,10 @@ # Docs updates & changes +## March 2026 + +- [Add CLI Build option](../SettingUpAaps/CLIBuild.md) @je-l +- Rename *Computer Build* to *Android Studio Build*. Preserve file names for URLs. + ## January 2025 - [3.4](#version3400) release and documentation update roll-up (Wizard, Computer build versions, Config Builder) From d55c3ee31297004fa08bca20ed0c61921dab4a58 Mon Sep 17 00:00:00 2001 From: Milos Kozak Date: Mon, 16 Mar 2026 22:30:49 +0100 Subject: [PATCH 045/126] New translations index.md (Hebrew) --- docs/CROWDIN/he/index.md | 5 +++-- 1 file changed, 3 insertions(+), 2 deletions(-) diff --git a/docs/CROWDIN/he/index.md b/docs/CROWDIN/he/index.md index d835fad7c1cb..e44dd32cd554 100644 --- a/docs/CROWDIN/he/index.md +++ b/docs/CROWDIN/he/index.md @@ -94,7 +94,8 @@ Setting up the reporting server <./SettingUpAaps/SettingUpTheReportingServer.md> - Tidepool <./SettingUpAaps/Tidepool.md> Building AAPS <./SettingUpAaps/BuildingAaps.md> - Browser Build <./SettingUpAaps/BrowserBuild.md> -- Computer Build <./SettingUpAaps/ComputerBuild.md> +- Android Studio Build <./SettingUpAaps/ComputerBuild.md> +- CLI Build <./SettingUpAaps/CLIBuild.md> Transferring and Installing AAPS <./SettingUpAaps/TransferringAndInstallingAaps.md> Setup Wizard <./SettingUpAaps/SetupWizard.md> Your AAPS Profile <./SettingUpAaps/YourAapsProfile.md> @@ -152,7 +153,7 @@ AAPS Release Notes <./Maintenance/ReleaseNotes.md> Documentation updates <./Maintenance/DocumentationUpdate.md> Updating to a new version of AAPS <./Maintenance/UpdateToNewVersion.md> - Browser Update <./Maintenance/UpdateBrowserBuild.md> -- Computer Update <./Maintenance/UpdateComputerBuild.md> +- Android Studio Update <./Maintenance/UpdateComputerBuild.md> ``` From 951d06511867cec66ef4c8a8310409864060f134 Mon Sep 17 00:00:00 2001 From: Milos Kozak Date: Mon, 16 Mar 2026 22:33:57 +0100 Subject: [PATCH 046/126] New translations buildingaaps.md (Hebrew) --- docs/CROWDIN/he/SettingUpAaps/BuildingAaps.md | 15 +++++++++++---- 1 file changed, 11 insertions(+), 4 deletions(-) diff --git a/docs/CROWDIN/he/SettingUpAaps/BuildingAaps.md b/docs/CROWDIN/he/SettingUpAaps/BuildingAaps.md index ea73db89bbfb..07e71aeaf6ed 100644 --- a/docs/CROWDIN/he/SettingUpAaps/BuildingAaps.md +++ b/docs/CROWDIN/he/SettingUpAaps/BuildingAaps.md @@ -8,9 +8,9 @@ See [FAQ page](../UsefulLinks/FAQ.md) for details. --- -Two methods are available to build the AAPS app: +Three methods are available to build the AAPS app: -### Build with a browser +### Build with a browser (recommended) You can build the app with your smartphone using GitHub actions, and save it in your Google Drive. @@ -18,9 +18,16 @@ You can build the app with your smartphone using GitHub actions, and save it in ---- -### Build with a computer +### Build with Android Studio -You can build the app with your computer using Android Studio. +You can build the app with your computer using Android Studio. This used to be the only build option, nowadays Android Studio is mostly used by developers who consider making code changes. **[Follow these instructions.](./ComputerBuild.md)** +---- + +### Build using the command-line + +This option is intended for those who prefer to build AAPS in local command-line, without installing Android Studio. + +**[Follow these instructions.](./CLIBuild.md)** From 755e632de66569e154139e9565211d1464619be6 Mon Sep 17 00:00:00 2001 From: Milos Kozak Date: Mon, 16 Mar 2026 22:35:10 +0100 Subject: [PATCH 047/126] New translations computerbuild.md (Hebrew) --- docs/CROWDIN/he/SettingUpAaps/ComputerBuild.md | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-) diff --git a/docs/CROWDIN/he/SettingUpAaps/ComputerBuild.md b/docs/CROWDIN/he/SettingUpAaps/ComputerBuild.md index d8fc98c78429..3d0c3a7a54bd 100644 --- a/docs/CROWDIN/he/SettingUpAaps/ComputerBuild.md +++ b/docs/CROWDIN/he/SettingUpAaps/ComputerBuild.md @@ -1,4 +1,6 @@ -# Computer Build + + +# Android Studio Build This is the traditional method to build your AAPS app. From 1ad1b6d8ee43e4f9715c1fd1308abd97552fc294 Mon Sep 17 00:00:00 2001 From: Milos Kozak Date: Mon, 16 Mar 2026 22:35:15 +0100 Subject: [PATCH 048/126] New translations updatecomputerbuild.md (Hebrew) --- docs/CROWDIN/he/Maintenance/UpdateComputerBuild.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/CROWDIN/he/Maintenance/UpdateComputerBuild.md b/docs/CROWDIN/he/Maintenance/UpdateComputerBuild.md index f4e068ee976f..56625cccdda4 100644 --- a/docs/CROWDIN/he/Maintenance/UpdateComputerBuild.md +++ b/docs/CROWDIN/he/Maintenance/UpdateComputerBuild.md @@ -1,4 +1,4 @@ -# Update with a computer +# Update with Android Studio ## בנייה עצמית במקום הורדה @@ -8,7 +8,7 @@ In case you want to build **AAPS** on a new computer : copy your back-up keystore file to the new computer. Then follow the [Initial build **AAPS** procedure](../SettingUpAaps/BuildingAaps.md) instead of this guide. With the only difference that instead of creating a new keystore, you can select the one you have copied on the new computer. ``` -## Overview for updating to a new version of AAPS with a computer +## Overview for updating to a new version of AAPS with Android Studio ```{contents} Steps for updating to a new version of AAPS :depth: 1 From 0afd664b5f84d95f728547dc936f65d3a2f363ab Mon Sep 17 00:00:00 2001 From: Milos Kozak Date: Mon, 16 Mar 2026 22:37:25 +0100 Subject: [PATCH 049/126] New translations clibuild.md (Hebrew) --- docs/CROWDIN/he/SettingUpAaps/CLIBuild.md | 54 +++++++++++++++++++++++ 1 file changed, 54 insertions(+) create mode 100644 docs/CROWDIN/he/SettingUpAaps/CLIBuild.md diff --git a/docs/CROWDIN/he/SettingUpAaps/CLIBuild.md b/docs/CROWDIN/he/SettingUpAaps/CLIBuild.md new file mode 100644 index 000000000000..91bcee48b1db --- /dev/null +++ b/docs/CROWDIN/he/SettingUpAaps/CLIBuild.md @@ -0,0 +1,54 @@ +# Build instructions for the command-line + +```{admonition} For users familiar with the command-line and git +:class: information + +The simplest option to build AAPS is the [Browser build](./BrowserBuild.md) alternative. +``` + +Tested with Fedora and Debian Linux, other systems should work with minimal adjustments. + +## Requirements + +Consult the minimum required Java version from [this table](#Building-APK-recommended-specification-of-computer-for-building-apk-file). Install the appropriate OpenJDK package using the system package manager. For example in Debian, the packages are named like `openjdk-21-jdk`. It should include `javac` and `keytool` binaries. + +Download the *Android Command line tools* package from the [Android Studio page](https://developer.android.com/studio#command-line-tools-only). Android Studio itself is not required. More information about installing this package is found in [sdkmanager docs](https://developer.android.com/tools/sdkmanager). After the package is installed, you should manually set two [environment variables](https://developer.android.com/tools/variables): `ANDROID_HOME` and `PATH`. Finally, run `sdkmanager --licenses` to finish the installation. + +## Building AAPS with Gradle wrapper + +### 1. Generate a Java keystore file for signing AAPS + +If you already have a keystore file for signing AAPS, reuse that. + +```sh +keytool -genkeypair -v \ + -keystore aaps-keystore.jks \ + -alias aaps-key \ + -keyalg RSA \ + -keysize 4096 \ + -validity 20000 +``` + +You will need the keystore file and passphrase every time you update AAPS. + +### 2. Compile the AAPS APK file + +Clone the [git repo](https://github.com/nightscout/AndroidAPS) if not already cloned. AAPS uses master branch for the latest stable version, ensure you are on the branch/tag you want to build. + +Run `./gradlew :app:assembleFullRelease` in the repo. It automatically downloads Gradle, dependencies, and then compiles the code. When the build succeeds, you should have an unsigned APK at `app/build/outputs/apk/full/release/app-full-release-unsigned.apk`. It should have also installed an `apksigner` binary to `$ANDROID_HOME`. Update your `PATH` again. + +### 3. Create a signed APK file from the unsigned one + + + +Change to your home directory and create a signed APK file: + +```sh +apksigner sign \ + --ks path/to/aaps-keystore.jks \ + --ks-key-alias aaps-key \ + --out app-full-release-signed.apk \ + ./AndroidAPS/app/build/outputs/apk/full/release/app-full-release-unsigned.apk +``` + +Now you have `app-full-release-signed.apk` ready for installation or upgrade. From 58e66db2ba45f39f9a2f14ee879c23d4d8164c91 Mon Sep 17 00:00:00 2001 From: Milos Kozak Date: Mon, 16 Mar 2026 22:37:36 +0100 Subject: [PATCH 050/126] New translations updatetonewversion.md (Korean) --- docs/CROWDIN/ko/Maintenance/UpdateToNewVersion.md | 6 +++++- 1 file changed, 5 insertions(+), 1 deletion(-) diff --git a/docs/CROWDIN/ko/Maintenance/UpdateToNewVersion.md b/docs/CROWDIN/ko/Maintenance/UpdateToNewVersion.md index 44291479fd40..46f3c4184212 100644 --- a/docs/CROWDIN/ko/Maintenance/UpdateToNewVersion.md +++ b/docs/CROWDIN/ko/Maintenance/UpdateToNewVersion.md @@ -16,10 +16,14 @@ If you already built your AAPS app with the Browser Build method, follow [these instructions](./UpdateBrowserBuild.md). -## Update AAPS with a computer +## Update AAPS with Android Studio Follow [these instructions.](./UpdateComputerBuild.md). +## Update AAPS with the command-line + +Use the [same instructions](../SettingUpAaps/CLIBuild.md) as when building AAPS previously, but pull new changes with git. + (Update-to-new-version-check-aaps-version-on-phone)= ### Check AAPS version on phone From bf3bc59485449b38077559f68721fa9d08731cfe Mon Sep 17 00:00:00 2001 From: Milos Kozak Date: Mon, 16 Mar 2026 22:41:12 +0100 Subject: [PATCH 051/126] New translations documentationupdate.md (Korean) --- docs/CROWDIN/ko/Maintenance/DocumentationUpdate.md | 5 +++++ 1 file changed, 5 insertions(+) diff --git a/docs/CROWDIN/ko/Maintenance/DocumentationUpdate.md b/docs/CROWDIN/ko/Maintenance/DocumentationUpdate.md index 8431fe3d39c4..b998a4732100 100644 --- a/docs/CROWDIN/ko/Maintenance/DocumentationUpdate.md +++ b/docs/CROWDIN/ko/Maintenance/DocumentationUpdate.md @@ -1,5 +1,10 @@ # Docs updates & changes +## March 2026 + +- [Add CLI Build option](../SettingUpAaps/CLIBuild.md) @je-l +- Rename *Computer Build* to *Android Studio Build*. Preserve file names for URLs. + ## January 2025 - [3.4](#version3400) release and documentation update roll-up (Wizard, Computer build versions, Config Builder) From c2f50cc453fb4caf8ed2dbae29fdbe491a69c946 Mon Sep 17 00:00:00 2001 From: Milos Kozak Date: Mon, 16 Mar 2026 22:41:41 +0100 Subject: [PATCH 052/126] New translations index.md (Korean) --- docs/CROWDIN/ko/index.md | 5 +++-- 1 file changed, 3 insertions(+), 2 deletions(-) diff --git a/docs/CROWDIN/ko/index.md b/docs/CROWDIN/ko/index.md index d4f6c178a00c..0050dcb4538a 100644 --- a/docs/CROWDIN/ko/index.md +++ b/docs/CROWDIN/ko/index.md @@ -91,7 +91,8 @@ Setting up the reporting server <./SettingUpAaps/SettingUpTheReportingServer.md> - Tidepool <./SettingUpAaps/Tidepool.md> Building AAPS <./SettingUpAaps/BuildingAaps.md> - Browser Build <./SettingUpAaps/BrowserBuild.md> -- Computer Build <./SettingUpAaps/ComputerBuild.md> +- Android Studio Build <./SettingUpAaps/ComputerBuild.md> +- CLI Build <./SettingUpAaps/CLIBuild.md> Transferring and Installing AAPS <./SettingUpAaps/TransferringAndInstallingAaps.md> Setup Wizard <./SettingUpAaps/SetupWizard.md> Your AAPS Profile <./SettingUpAaps/YourAapsProfile.md> @@ -149,7 +150,7 @@ AAPS Release Notes <./Maintenance/ReleaseNotes.md> Documentation updates <./Maintenance/DocumentationUpdate.md> Updating to a new version of AAPS <./Maintenance/UpdateToNewVersion.md> - Browser Update <./Maintenance/UpdateBrowserBuild.md> -- Computer Update <./Maintenance/UpdateComputerBuild.md> +- Android Studio Update <./Maintenance/UpdateComputerBuild.md> ``` From 5c46525ba992d68524808f9c40488b630a951bb7 Mon Sep 17 00:00:00 2001 From: Milos Kozak Date: Mon, 16 Mar 2026 22:44:41 +0100 Subject: [PATCH 053/126] New translations buildingaaps.md (Korean) --- docs/CROWDIN/ko/SettingUpAaps/BuildingAaps.md | 15 +++++++++++---- 1 file changed, 11 insertions(+), 4 deletions(-) diff --git a/docs/CROWDIN/ko/SettingUpAaps/BuildingAaps.md b/docs/CROWDIN/ko/SettingUpAaps/BuildingAaps.md index 195a8f3037de..18c67763e0f0 100644 --- a/docs/CROWDIN/ko/SettingUpAaps/BuildingAaps.md +++ b/docs/CROWDIN/ko/SettingUpAaps/BuildingAaps.md @@ -8,9 +8,9 @@ See [FAQ page](../UsefulLinks/FAQ.md) for details. --- -Two methods are available to build the AAPS app: +Three methods are available to build the AAPS app: -### Build with a browser +### Build with a browser (recommended) You can build the app with your smartphone using GitHub actions, and save it in your Google Drive. @@ -18,9 +18,16 @@ You can build the app with your smartphone using GitHub actions, and save it in ---- -### Build with a computer +### Build with Android Studio -You can build the app with your computer using Android Studio. +You can build the app with your computer using Android Studio. This used to be the only build option, nowadays Android Studio is mostly used by developers who consider making code changes. **[Follow these instructions.](./ComputerBuild.md)** +---- + +### Build using the command-line + +This option is intended for those who prefer to build AAPS in local command-line, without installing Android Studio. + +**[Follow these instructions.](./CLIBuild.md)** From f52a1af2ebe0b931f75abe9be066696b93b3f239 Mon Sep 17 00:00:00 2001 From: Milos Kozak Date: Mon, 16 Mar 2026 22:45:53 +0100 Subject: [PATCH 054/126] New translations computerbuild.md (Korean) --- docs/CROWDIN/ko/SettingUpAaps/ComputerBuild.md | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-) diff --git a/docs/CROWDIN/ko/SettingUpAaps/ComputerBuild.md b/docs/CROWDIN/ko/SettingUpAaps/ComputerBuild.md index b83338634ed8..41606bb34b90 100644 --- a/docs/CROWDIN/ko/SettingUpAaps/ComputerBuild.md +++ b/docs/CROWDIN/ko/SettingUpAaps/ComputerBuild.md @@ -1,4 +1,6 @@ -# Computer Build + + +# Android Studio Build This is the traditional method to build your AAPS app. From 72159d52f0e0f72269fa9c3ca1550322853fa1c5 Mon Sep 17 00:00:00 2001 From: Milos Kozak Date: Mon, 16 Mar 2026 22:45:58 +0100 Subject: [PATCH 055/126] New translations updatecomputerbuild.md (Korean) --- docs/CROWDIN/ko/Maintenance/UpdateComputerBuild.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/CROWDIN/ko/Maintenance/UpdateComputerBuild.md b/docs/CROWDIN/ko/Maintenance/UpdateComputerBuild.md index f550d48cfa80..bd1d22c9948f 100644 --- a/docs/CROWDIN/ko/Maintenance/UpdateComputerBuild.md +++ b/docs/CROWDIN/ko/Maintenance/UpdateComputerBuild.md @@ -1,4 +1,4 @@ -# Update with a computer +# Update with Android Studio ## 다운로드 대신에 당신 스스로 빌드하세요 @@ -8,7 +8,7 @@ In case you want to build **AAPS** on a new computer : copy your back-up keystore file to the new computer. Then follow the [Initial build **AAPS** procedure](../SettingUpAaps/BuildingAaps.md) instead of this guide. With the only difference that instead of creating a new keystore, you can select the one you have copied on the new computer. ``` -## Overview for updating to a new version of AAPS with a computer +## Overview for updating to a new version of AAPS with Android Studio ```{contents} Steps for updating to a new version of AAPS :depth: 1 From 9f4bf0d12a2e7dc487c517c636ec559efb299ea7 Mon Sep 17 00:00:00 2001 From: Milos Kozak Date: Mon, 16 Mar 2026 22:48:24 +0100 Subject: [PATCH 056/126] New translations clibuild.md (Korean) --- docs/CROWDIN/ko/SettingUpAaps/CLIBuild.md | 54 +++++++++++++++++++++++ 1 file changed, 54 insertions(+) create mode 100644 docs/CROWDIN/ko/SettingUpAaps/CLIBuild.md diff --git a/docs/CROWDIN/ko/SettingUpAaps/CLIBuild.md b/docs/CROWDIN/ko/SettingUpAaps/CLIBuild.md new file mode 100644 index 000000000000..91bcee48b1db --- /dev/null +++ b/docs/CROWDIN/ko/SettingUpAaps/CLIBuild.md @@ -0,0 +1,54 @@ +# Build instructions for the command-line + +```{admonition} For users familiar with the command-line and git +:class: information + +The simplest option to build AAPS is the [Browser build](./BrowserBuild.md) alternative. +``` + +Tested with Fedora and Debian Linux, other systems should work with minimal adjustments. + +## Requirements + +Consult the minimum required Java version from [this table](#Building-APK-recommended-specification-of-computer-for-building-apk-file). Install the appropriate OpenJDK package using the system package manager. For example in Debian, the packages are named like `openjdk-21-jdk`. It should include `javac` and `keytool` binaries. + +Download the *Android Command line tools* package from the [Android Studio page](https://developer.android.com/studio#command-line-tools-only). Android Studio itself is not required. More information about installing this package is found in [sdkmanager docs](https://developer.android.com/tools/sdkmanager). After the package is installed, you should manually set two [environment variables](https://developer.android.com/tools/variables): `ANDROID_HOME` and `PATH`. Finally, run `sdkmanager --licenses` to finish the installation. + +## Building AAPS with Gradle wrapper + +### 1. Generate a Java keystore file for signing AAPS + +If you already have a keystore file for signing AAPS, reuse that. + +```sh +keytool -genkeypair -v \ + -keystore aaps-keystore.jks \ + -alias aaps-key \ + -keyalg RSA \ + -keysize 4096 \ + -validity 20000 +``` + +You will need the keystore file and passphrase every time you update AAPS. + +### 2. Compile the AAPS APK file + +Clone the [git repo](https://github.com/nightscout/AndroidAPS) if not already cloned. AAPS uses master branch for the latest stable version, ensure you are on the branch/tag you want to build. + +Run `./gradlew :app:assembleFullRelease` in the repo. It automatically downloads Gradle, dependencies, and then compiles the code. When the build succeeds, you should have an unsigned APK at `app/build/outputs/apk/full/release/app-full-release-unsigned.apk`. It should have also installed an `apksigner` binary to `$ANDROID_HOME`. Update your `PATH` again. + +### 3. Create a signed APK file from the unsigned one + + + +Change to your home directory and create a signed APK file: + +```sh +apksigner sign \ + --ks path/to/aaps-keystore.jks \ + --ks-key-alias aaps-key \ + --out app-full-release-signed.apk \ + ./AndroidAPS/app/build/outputs/apk/full/release/app-full-release-unsigned.apk +``` + +Now you have `app-full-release-signed.apk` ready for installation or upgrade. From f67b12de4f9ab36e201b4fb0c3cf0785daa3aa4e Mon Sep 17 00:00:00 2001 From: Milos Kozak Date: Mon, 16 Mar 2026 22:48:37 +0100 Subject: [PATCH 057/126] New translations updatetonewversion.md (Lithuanian) --- docs/CROWDIN/lt/Maintenance/UpdateToNewVersion.md | 6 +++++- 1 file changed, 5 insertions(+), 1 deletion(-) diff --git a/docs/CROWDIN/lt/Maintenance/UpdateToNewVersion.md b/docs/CROWDIN/lt/Maintenance/UpdateToNewVersion.md index a3035061e3fe..7b3e2e38be5e 100644 --- a/docs/CROWDIN/lt/Maintenance/UpdateToNewVersion.md +++ b/docs/CROWDIN/lt/Maintenance/UpdateToNewVersion.md @@ -16,10 +16,14 @@ If you already built your AAPS app with the Browser Build method, follow [these instructions](./UpdateBrowserBuild.md). -## Update AAPS with a computer +## Update AAPS with Android Studio Follow [these instructions.](./UpdateComputerBuild.md). +## Update AAPS with the command-line + +Use the [same instructions](../SettingUpAaps/CLIBuild.md) as when building AAPS previously, but pull new changes with git. + (Update-to-new-version-check-aaps-version-on-phone)= ### Check AAPS version on phone From dfb96830377930ad5628bc9cb35bbf8584f24624 Mon Sep 17 00:00:00 2001 From: Milos Kozak Date: Mon, 16 Mar 2026 22:53:04 +0100 Subject: [PATCH 058/126] New translations documentationupdate.md (Lithuanian) --- docs/CROWDIN/lt/Maintenance/DocumentationUpdate.md | 5 +++++ 1 file changed, 5 insertions(+) diff --git a/docs/CROWDIN/lt/Maintenance/DocumentationUpdate.md b/docs/CROWDIN/lt/Maintenance/DocumentationUpdate.md index eacd2b091a86..5ee499fb66a8 100644 --- a/docs/CROWDIN/lt/Maintenance/DocumentationUpdate.md +++ b/docs/CROWDIN/lt/Maintenance/DocumentationUpdate.md @@ -1,5 +1,10 @@ # Docs updates & changes +## March 2026 + +- [Add CLI Build option](../SettingUpAaps/CLIBuild.md) @je-l +- Rename *Computer Build* to *Android Studio Build*. Preserve file names for URLs. + ## January 2025 - [3.4](#version3400) release and documentation update roll-up (Wizard, Computer build versions, Config Builder) From 1cb3de1b3dd9bdc427c04288f46105a8f21911e9 Mon Sep 17 00:00:00 2001 From: Milos Kozak Date: Mon, 16 Mar 2026 22:53:39 +0100 Subject: [PATCH 059/126] New translations index.md (Lithuanian) --- docs/CROWDIN/lt/index.md | 5 +++-- 1 file changed, 3 insertions(+), 2 deletions(-) diff --git a/docs/CROWDIN/lt/index.md b/docs/CROWDIN/lt/index.md index 14746596938e..2543c6e95760 100644 --- a/docs/CROWDIN/lt/index.md +++ b/docs/CROWDIN/lt/index.md @@ -91,7 +91,8 @@ Setting up the reporting server <./SettingUpAaps/SettingUpTheReportingServer.md> - Tidepool <./SettingUpAaps/Tidepool.md> Building AAPS <./SettingUpAaps/BuildingAaps.md> - Browser Build <./SettingUpAaps/BrowserBuild.md> -- Computer Build <./SettingUpAaps/ComputerBuild.md> +- Android Studio Build <./SettingUpAaps/ComputerBuild.md> +- CLI Build <./SettingUpAaps/CLIBuild.md> Transferring and Installing AAPS <./SettingUpAaps/TransferringAndInstallingAaps.md> Setup Wizard <./SettingUpAaps/SetupWizard.md> Your AAPS Profile <./SettingUpAaps/YourAapsProfile.md> @@ -149,7 +150,7 @@ AAPS Release Notes <./Maintenance/ReleaseNotes.md> Documentation updates <./Maintenance/DocumentationUpdate.md> Updating to a new version of AAPS <./Maintenance/UpdateToNewVersion.md> - Browser Update <./Maintenance/UpdateBrowserBuild.md> -- Computer Update <./Maintenance/UpdateComputerBuild.md> +- Android Studio Update <./Maintenance/UpdateComputerBuild.md> ``` From 5e66da1d228374cbf3276b511d3fdddcf7e53631 Mon Sep 17 00:00:00 2001 From: Milos Kozak Date: Mon, 16 Mar 2026 22:56:57 +0100 Subject: [PATCH 060/126] New translations buildingaaps.md (Lithuanian) --- docs/CROWDIN/lt/SettingUpAaps/BuildingAaps.md | 15 +++++++++++---- 1 file changed, 11 insertions(+), 4 deletions(-) diff --git a/docs/CROWDIN/lt/SettingUpAaps/BuildingAaps.md b/docs/CROWDIN/lt/SettingUpAaps/BuildingAaps.md index de235042c554..6a3f61276159 100644 --- a/docs/CROWDIN/lt/SettingUpAaps/BuildingAaps.md +++ b/docs/CROWDIN/lt/SettingUpAaps/BuildingAaps.md @@ -8,9 +8,9 @@ See [FAQ page](../UsefulLinks/FAQ.md) for details. --- -Two methods are available to build the AAPS app: +Three methods are available to build the AAPS app: -### Build with a browser +### Build with a browser (recommended) You can build the app with your smartphone using GitHub actions, and save it in your Google Drive. @@ -18,9 +18,16 @@ You can build the app with your smartphone using GitHub actions, and save it in ---- -### Build with a computer +### Build with Android Studio -You can build the app with your computer using Android Studio. +You can build the app with your computer using Android Studio. This used to be the only build option, nowadays Android Studio is mostly used by developers who consider making code changes. **[Follow these instructions.](./ComputerBuild.md)** +---- + +### Build using the command-line + +This option is intended for those who prefer to build AAPS in local command-line, without installing Android Studio. + +**[Follow these instructions.](./CLIBuild.md)** From 68c268a42db9f96622c0e7f5bae98c020c8b9367 Mon Sep 17 00:00:00 2001 From: Milos Kozak Date: Mon, 16 Mar 2026 22:58:11 +0100 Subject: [PATCH 061/126] New translations computerbuild.md (Lithuanian) --- docs/CROWDIN/lt/SettingUpAaps/ComputerBuild.md | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-) diff --git a/docs/CROWDIN/lt/SettingUpAaps/ComputerBuild.md b/docs/CROWDIN/lt/SettingUpAaps/ComputerBuild.md index d9aabdce1926..e34bd73ecbbe 100644 --- a/docs/CROWDIN/lt/SettingUpAaps/ComputerBuild.md +++ b/docs/CROWDIN/lt/SettingUpAaps/ComputerBuild.md @@ -1,4 +1,6 @@ -# Computer Build + + +# Android Studio Build This is the traditional method to build your AAPS app. From bd23a1c4fe6cde9b5e25c9e9b827314a005ac3ae Mon Sep 17 00:00:00 2001 From: Milos Kozak Date: Mon, 16 Mar 2026 22:58:15 +0100 Subject: [PATCH 062/126] New translations updatecomputerbuild.md (Lithuanian) --- docs/CROWDIN/lt/Maintenance/UpdateComputerBuild.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/CROWDIN/lt/Maintenance/UpdateComputerBuild.md b/docs/CROWDIN/lt/Maintenance/UpdateComputerBuild.md index 951ea68606c8..ac53106e028c 100644 --- a/docs/CROWDIN/lt/Maintenance/UpdateComputerBuild.md +++ b/docs/CROWDIN/lt/Maintenance/UpdateComputerBuild.md @@ -1,4 +1,4 @@ -# Update with a computer +# Update with Android Studio ## Kurti sau, o ne parsisiųsti @@ -8,7 +8,7 @@ In case you want to build **AAPS** on a new computer : copy your back-up keystore file to the new computer. Then follow the [Initial build **AAPS** procedure](../SettingUpAaps/BuildingAaps.md) instead of this guide. With the only difference that instead of creating a new keystore, you can select the one you have copied on the new computer. ``` -## Overview for updating to a new version of AAPS with a computer +## Overview for updating to a new version of AAPS with Android Studio ```{contents} Steps for updating to a new version of AAPS :depth: 1 From e26ff95581e3a105eeb0b98db61b93e313669145 Mon Sep 17 00:00:00 2001 From: Milos Kozak Date: Mon, 16 Mar 2026 23:00:37 +0100 Subject: [PATCH 063/126] New translations clibuild.md (Lithuanian) --- docs/CROWDIN/lt/SettingUpAaps/CLIBuild.md | 54 +++++++++++++++++++++++ 1 file changed, 54 insertions(+) create mode 100644 docs/CROWDIN/lt/SettingUpAaps/CLIBuild.md diff --git a/docs/CROWDIN/lt/SettingUpAaps/CLIBuild.md b/docs/CROWDIN/lt/SettingUpAaps/CLIBuild.md new file mode 100644 index 000000000000..91bcee48b1db --- /dev/null +++ b/docs/CROWDIN/lt/SettingUpAaps/CLIBuild.md @@ -0,0 +1,54 @@ +# Build instructions for the command-line + +```{admonition} For users familiar with the command-line and git +:class: information + +The simplest option to build AAPS is the [Browser build](./BrowserBuild.md) alternative. +``` + +Tested with Fedora and Debian Linux, other systems should work with minimal adjustments. + +## Requirements + +Consult the minimum required Java version from [this table](#Building-APK-recommended-specification-of-computer-for-building-apk-file). Install the appropriate OpenJDK package using the system package manager. For example in Debian, the packages are named like `openjdk-21-jdk`. It should include `javac` and `keytool` binaries. + +Download the *Android Command line tools* package from the [Android Studio page](https://developer.android.com/studio#command-line-tools-only). Android Studio itself is not required. More information about installing this package is found in [sdkmanager docs](https://developer.android.com/tools/sdkmanager). After the package is installed, you should manually set two [environment variables](https://developer.android.com/tools/variables): `ANDROID_HOME` and `PATH`. Finally, run `sdkmanager --licenses` to finish the installation. + +## Building AAPS with Gradle wrapper + +### 1. Generate a Java keystore file for signing AAPS + +If you already have a keystore file for signing AAPS, reuse that. + +```sh +keytool -genkeypair -v \ + -keystore aaps-keystore.jks \ + -alias aaps-key \ + -keyalg RSA \ + -keysize 4096 \ + -validity 20000 +``` + +You will need the keystore file and passphrase every time you update AAPS. + +### 2. Compile the AAPS APK file + +Clone the [git repo](https://github.com/nightscout/AndroidAPS) if not already cloned. AAPS uses master branch for the latest stable version, ensure you are on the branch/tag you want to build. + +Run `./gradlew :app:assembleFullRelease` in the repo. It automatically downloads Gradle, dependencies, and then compiles the code. When the build succeeds, you should have an unsigned APK at `app/build/outputs/apk/full/release/app-full-release-unsigned.apk`. It should have also installed an `apksigner` binary to `$ANDROID_HOME`. Update your `PATH` again. + +### 3. Create a signed APK file from the unsigned one + + + +Change to your home directory and create a signed APK file: + +```sh +apksigner sign \ + --ks path/to/aaps-keystore.jks \ + --ks-key-alias aaps-key \ + --out app-full-release-signed.apk \ + ./AndroidAPS/app/build/outputs/apk/full/release/app-full-release-unsigned.apk +``` + +Now you have `app-full-release-signed.apk` ready for installation or upgrade. From b15ff93937b16a954e7ceb31ef0e29ab9fbd49a6 Mon Sep 17 00:00:00 2001 From: Milos Kozak Date: Mon, 16 Mar 2026 23:00:51 +0100 Subject: [PATCH 064/126] New translations updatetonewversion.md (Dutch) --- docs/CROWDIN/nl/Maintenance/UpdateToNewVersion.md | 6 +++++- 1 file changed, 5 insertions(+), 1 deletion(-) diff --git a/docs/CROWDIN/nl/Maintenance/UpdateToNewVersion.md b/docs/CROWDIN/nl/Maintenance/UpdateToNewVersion.md index f5016ee083f4..6c3853d335f3 100644 --- a/docs/CROWDIN/nl/Maintenance/UpdateToNewVersion.md +++ b/docs/CROWDIN/nl/Maintenance/UpdateToNewVersion.md @@ -16,10 +16,14 @@ If you already built your AAPS app with the Browser Build method, follow [these instructions](./UpdateBrowserBuild.md). -## Update AAPS with a computer +## Update AAPS with Android Studio Follow [these instructions.](./UpdateComputerBuild.md). +## Update AAPS with the command-line + +Use the [same instructions](../SettingUpAaps/CLIBuild.md) as when building AAPS previously, but pull new changes with git. + (Update-to-new-version-check-aaps-version-on-phone)= ### Check AAPS version on phone From 9891b5081074f42008615ef8aa251cadaff8ea5d Mon Sep 17 00:00:00 2001 From: Milos Kozak Date: Mon, 16 Mar 2026 23:05:23 +0100 Subject: [PATCH 065/126] New translations documentationupdate.md (Dutch) --- docs/CROWDIN/nl/Maintenance/DocumentationUpdate.md | 5 +++++ 1 file changed, 5 insertions(+) diff --git a/docs/CROWDIN/nl/Maintenance/DocumentationUpdate.md b/docs/CROWDIN/nl/Maintenance/DocumentationUpdate.md index b97dd89b44af..b4b25fe9e3f8 100644 --- a/docs/CROWDIN/nl/Maintenance/DocumentationUpdate.md +++ b/docs/CROWDIN/nl/Maintenance/DocumentationUpdate.md @@ -1,5 +1,10 @@ # Docs updates & changes +## March 2026 + +- [Add CLI Build option](../SettingUpAaps/CLIBuild.md) @je-l +- Rename *Computer Build* to *Android Studio Build*. Preserve file names for URLs. + ## January 2025 - [3.4](#version3400) release and documentation update roll-up (Wizard, Computer build versions, Config Builder) From 7dc50f4b0645b20db766e381de6bed45f308b8fb Mon Sep 17 00:00:00 2001 From: Milos Kozak Date: Mon, 16 Mar 2026 23:05:59 +0100 Subject: [PATCH 066/126] New translations index.md (Dutch) --- docs/CROWDIN/nl/index.md | 5 +++-- 1 file changed, 3 insertions(+), 2 deletions(-) diff --git a/docs/CROWDIN/nl/index.md b/docs/CROWDIN/nl/index.md index fda21e4a6ca5..c34aeafcefc7 100644 --- a/docs/CROWDIN/nl/index.md +++ b/docs/CROWDIN/nl/index.md @@ -91,7 +91,8 @@ Setting up the reporting server <./SettingUpAaps/SettingUpTheReportingServer.md> - Tidepool <./SettingUpAaps/Tidepool.md> Building AAPS <./SettingUpAaps/BuildingAaps.md> - Browser Build <./SettingUpAaps/BrowserBuild.md> -- Computer Build <./SettingUpAaps/ComputerBuild.md> +- Android Studio Build <./SettingUpAaps/ComputerBuild.md> +- CLI Build <./SettingUpAaps/CLIBuild.md> Transferring and Installing AAPS <./SettingUpAaps/TransferringAndInstallingAaps.md> Setup Wizard <./SettingUpAaps/SetupWizard.md> Your AAPS Profile <./SettingUpAaps/YourAapsProfile.md> @@ -149,7 +150,7 @@ AAPS Release Notes <./Maintenance/ReleaseNotes.md> Documentation updates <./Maintenance/DocumentationUpdate.md> Updating to a new version of AAPS <./Maintenance/UpdateToNewVersion.md> - Browser Update <./Maintenance/UpdateBrowserBuild.md> -- Computer Update <./Maintenance/UpdateComputerBuild.md> +- Android Studio Update <./Maintenance/UpdateComputerBuild.md> ``` From 67df552f841a2a64cddca0d372229c757b2c55df Mon Sep 17 00:00:00 2001 From: Milos Kozak Date: Mon, 16 Mar 2026 23:09:34 +0100 Subject: [PATCH 067/126] New translations buildingaaps.md (Dutch) --- docs/CROWDIN/nl/SettingUpAaps/BuildingAaps.md | 15 +++++++++++---- 1 file changed, 11 insertions(+), 4 deletions(-) diff --git a/docs/CROWDIN/nl/SettingUpAaps/BuildingAaps.md b/docs/CROWDIN/nl/SettingUpAaps/BuildingAaps.md index 2aa06619889f..6922c2b10929 100644 --- a/docs/CROWDIN/nl/SettingUpAaps/BuildingAaps.md +++ b/docs/CROWDIN/nl/SettingUpAaps/BuildingAaps.md @@ -8,9 +8,9 @@ See [FAQ page](../UsefulLinks/FAQ.md) for details. --- -Two methods are available to build the AAPS app: +Three methods are available to build the AAPS app: -### Build with a browser +### Build with a browser (recommended) You can build the app with your smartphone using GitHub actions, and save it in your Google Drive. @@ -18,9 +18,16 @@ You can build the app with your smartphone using GitHub actions, and save it in ---- -### Build with a computer +### Build with Android Studio -You can build the app with your computer using Android Studio. +You can build the app with your computer using Android Studio. This used to be the only build option, nowadays Android Studio is mostly used by developers who consider making code changes. **[Follow these instructions.](./ComputerBuild.md)** +---- + +### Build using the command-line + +This option is intended for those who prefer to build AAPS in local command-line, without installing Android Studio. + +**[Follow these instructions.](./CLIBuild.md)** From 93b44816c431f6bd250243dd8d90f894eb8294da Mon Sep 17 00:00:00 2001 From: Milos Kozak Date: Mon, 16 Mar 2026 23:10:51 +0100 Subject: [PATCH 068/126] New translations computerbuild.md (Dutch) --- docs/CROWDIN/nl/SettingUpAaps/ComputerBuild.md | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-) diff --git a/docs/CROWDIN/nl/SettingUpAaps/ComputerBuild.md b/docs/CROWDIN/nl/SettingUpAaps/ComputerBuild.md index e5175422e172..b2a3de86a016 100644 --- a/docs/CROWDIN/nl/SettingUpAaps/ComputerBuild.md +++ b/docs/CROWDIN/nl/SettingUpAaps/ComputerBuild.md @@ -1,4 +1,6 @@ -# Computer Build + + +# Android Studio Build This is the traditional method to build your AAPS app. From 047d0cf478bdbc27b7e832da79364567b8e29433 Mon Sep 17 00:00:00 2001 From: Milos Kozak Date: Mon, 16 Mar 2026 23:10:56 +0100 Subject: [PATCH 069/126] New translations updatecomputerbuild.md (Dutch) --- docs/CROWDIN/nl/Maintenance/UpdateComputerBuild.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/CROWDIN/nl/Maintenance/UpdateComputerBuild.md b/docs/CROWDIN/nl/Maintenance/UpdateComputerBuild.md index 31facc9c8d27..53170088fa4b 100644 --- a/docs/CROWDIN/nl/Maintenance/UpdateComputerBuild.md +++ b/docs/CROWDIN/nl/Maintenance/UpdateComputerBuild.md @@ -1,4 +1,4 @@ -# Update with a computer +# Update with Android Studio ## Zelf bouwen, in plaats van downloaden @@ -8,7 +8,7 @@ In case you want to build **AAPS** on a new computer : copy your back-up keystore file to the new computer. Then follow the [Initial build **AAPS** procedure](../SettingUpAaps/BuildingAaps.md) instead of this guide. With the only difference that instead of creating a new keystore, you can select the one you have copied on the new computer. ``` -## Overview for updating to a new version of AAPS with a computer +## Overview for updating to a new version of AAPS with Android Studio ```{contents} Steps for updating to a new version of AAPS :depth: 1 From 47793f6af2c366c7bdd5c10ece4ad768113e96a9 Mon Sep 17 00:00:00 2001 From: Milos Kozak Date: Mon, 16 Mar 2026 23:13:03 +0100 Subject: [PATCH 070/126] New translations clibuild.md (Dutch) --- docs/CROWDIN/nl/SettingUpAaps/CLIBuild.md | 54 +++++++++++++++++++++++ 1 file changed, 54 insertions(+) create mode 100644 docs/CROWDIN/nl/SettingUpAaps/CLIBuild.md diff --git a/docs/CROWDIN/nl/SettingUpAaps/CLIBuild.md b/docs/CROWDIN/nl/SettingUpAaps/CLIBuild.md new file mode 100644 index 000000000000..91bcee48b1db --- /dev/null +++ b/docs/CROWDIN/nl/SettingUpAaps/CLIBuild.md @@ -0,0 +1,54 @@ +# Build instructions for the command-line + +```{admonition} For users familiar with the command-line and git +:class: information + +The simplest option to build AAPS is the [Browser build](./BrowserBuild.md) alternative. +``` + +Tested with Fedora and Debian Linux, other systems should work with minimal adjustments. + +## Requirements + +Consult the minimum required Java version from [this table](#Building-APK-recommended-specification-of-computer-for-building-apk-file). Install the appropriate OpenJDK package using the system package manager. For example in Debian, the packages are named like `openjdk-21-jdk`. It should include `javac` and `keytool` binaries. + +Download the *Android Command line tools* package from the [Android Studio page](https://developer.android.com/studio#command-line-tools-only). Android Studio itself is not required. More information about installing this package is found in [sdkmanager docs](https://developer.android.com/tools/sdkmanager). After the package is installed, you should manually set two [environment variables](https://developer.android.com/tools/variables): `ANDROID_HOME` and `PATH`. Finally, run `sdkmanager --licenses` to finish the installation. + +## Building AAPS with Gradle wrapper + +### 1. Generate a Java keystore file for signing AAPS + +If you already have a keystore file for signing AAPS, reuse that. + +```sh +keytool -genkeypair -v \ + -keystore aaps-keystore.jks \ + -alias aaps-key \ + -keyalg RSA \ + -keysize 4096 \ + -validity 20000 +``` + +You will need the keystore file and passphrase every time you update AAPS. + +### 2. Compile the AAPS APK file + +Clone the [git repo](https://github.com/nightscout/AndroidAPS) if not already cloned. AAPS uses master branch for the latest stable version, ensure you are on the branch/tag you want to build. + +Run `./gradlew :app:assembleFullRelease` in the repo. It automatically downloads Gradle, dependencies, and then compiles the code. When the build succeeds, you should have an unsigned APK at `app/build/outputs/apk/full/release/app-full-release-unsigned.apk`. It should have also installed an `apksigner` binary to `$ANDROID_HOME`. Update your `PATH` again. + +### 3. Create a signed APK file from the unsigned one + + + +Change to your home directory and create a signed APK file: + +```sh +apksigner sign \ + --ks path/to/aaps-keystore.jks \ + --ks-key-alias aaps-key \ + --out app-full-release-signed.apk \ + ./AndroidAPS/app/build/outputs/apk/full/release/app-full-release-unsigned.apk +``` + +Now you have `app-full-release-signed.apk` ready for installation or upgrade. From 700d536f82d3cf8810b898c444168a1efd51ae4e Mon Sep 17 00:00:00 2001 From: Milos Kozak Date: Mon, 16 Mar 2026 23:13:14 +0100 Subject: [PATCH 071/126] New translations updatetonewversion.md (Polish) --- docs/CROWDIN/pl/Maintenance/UpdateToNewVersion.md | 6 +++++- 1 file changed, 5 insertions(+), 1 deletion(-) diff --git a/docs/CROWDIN/pl/Maintenance/UpdateToNewVersion.md b/docs/CROWDIN/pl/Maintenance/UpdateToNewVersion.md index 17f5f95a3922..eac79f81216c 100644 --- a/docs/CROWDIN/pl/Maintenance/UpdateToNewVersion.md +++ b/docs/CROWDIN/pl/Maintenance/UpdateToNewVersion.md @@ -16,10 +16,14 @@ If you already built your AAPS app with the Browser Build method, follow [these instructions](./UpdateBrowserBuild.md). -## Update AAPS with a computer +## Update AAPS with Android Studio Follow [these instructions.](./UpdateComputerBuild.md). +## Update AAPS with the command-line + +Use the [same instructions](../SettingUpAaps/CLIBuild.md) as when building AAPS previously, but pull new changes with git. + (Update-to-new-version-check-aaps-version-on-phone)= ### Check AAPS version on phone From 8efacea4107cbfcbf61be80af89a5a54a00a0d83 Mon Sep 17 00:00:00 2001 From: Milos Kozak Date: Mon, 16 Mar 2026 23:17:09 +0100 Subject: [PATCH 072/126] New translations documentationupdate.md (Polish) --- docs/CROWDIN/pl/Maintenance/DocumentationUpdate.md | 5 +++++ 1 file changed, 5 insertions(+) diff --git a/docs/CROWDIN/pl/Maintenance/DocumentationUpdate.md b/docs/CROWDIN/pl/Maintenance/DocumentationUpdate.md index 70d34e46e43d..92f94fb70aaf 100644 --- a/docs/CROWDIN/pl/Maintenance/DocumentationUpdate.md +++ b/docs/CROWDIN/pl/Maintenance/DocumentationUpdate.md @@ -1,5 +1,10 @@ # Docs updates & changes +## March 2026 + +- [Add CLI Build option](../SettingUpAaps/CLIBuild.md) @je-l +- Rename *Computer Build* to *Android Studio Build*. Preserve file names for URLs. + ## January 2025 - [3.4](#version3400) release and documentation update roll-up (Wizard, Computer build versions, Config Builder) From f4899979cae72c5da26bd6f4ee13e061814f90a0 Mon Sep 17 00:00:00 2001 From: Milos Kozak Date: Mon, 16 Mar 2026 23:17:43 +0100 Subject: [PATCH 073/126] New translations index.md (Polish) --- docs/CROWDIN/pl/index.md | 5 +++-- 1 file changed, 3 insertions(+), 2 deletions(-) diff --git a/docs/CROWDIN/pl/index.md b/docs/CROWDIN/pl/index.md index ecda028b032a..d6aea57e0fa3 100644 --- a/docs/CROWDIN/pl/index.md +++ b/docs/CROWDIN/pl/index.md @@ -91,7 +91,8 @@ Setting up the reporting server <./SettingUpAaps/SettingUpTheReportingServer.md> - Tidepool <./SettingUpAaps/Tidepool.md> Building AAPS <./SettingUpAaps/BuildingAaps.md> - Browser Build <./SettingUpAaps/BrowserBuild.md> -- Computer Build <./SettingUpAaps/ComputerBuild.md> +- Android Studio Build <./SettingUpAaps/ComputerBuild.md> +- CLI Build <./SettingUpAaps/CLIBuild.md> Transferring and Installing AAPS <./SettingUpAaps/TransferringAndInstallingAaps.md> Setup Wizard <./SettingUpAaps/SetupWizard.md> Your AAPS Profile <./SettingUpAaps/YourAapsProfile.md> @@ -149,7 +150,7 @@ AAPS Release Notes <./Maintenance/ReleaseNotes.md> Documentation updates <./Maintenance/DocumentationUpdate.md> Updating to a new version of AAPS <./Maintenance/UpdateToNewVersion.md> - Browser Update <./Maintenance/UpdateBrowserBuild.md> -- Computer Update <./Maintenance/UpdateComputerBuild.md> +- Android Studio Update <./Maintenance/UpdateComputerBuild.md> ``` From 7ee91a84a6ded2a441112e1b44ff462e6eac456c Mon Sep 17 00:00:00 2001 From: Milos Kozak Date: Mon, 16 Mar 2026 23:21:12 +0100 Subject: [PATCH 074/126] New translations buildingaaps.md (Polish) --- docs/CROWDIN/pl/SettingUpAaps/BuildingAaps.md | 15 +++++++++++---- 1 file changed, 11 insertions(+), 4 deletions(-) diff --git a/docs/CROWDIN/pl/SettingUpAaps/BuildingAaps.md b/docs/CROWDIN/pl/SettingUpAaps/BuildingAaps.md index aa95e0cf7c3a..97d38551b766 100644 --- a/docs/CROWDIN/pl/SettingUpAaps/BuildingAaps.md +++ b/docs/CROWDIN/pl/SettingUpAaps/BuildingAaps.md @@ -8,9 +8,9 @@ See [FAQ page](../UsefulLinks/FAQ.md) for details. --- -Two methods are available to build the AAPS app: +Three methods are available to build the AAPS app: -### Build with a browser +### Build with a browser (recommended) You can build the app with your smartphone using GitHub actions, and save it in your Google Drive. @@ -18,9 +18,16 @@ You can build the app with your smartphone using GitHub actions, and save it in ---- -### Build with a computer +### Build with Android Studio -You can build the app with your computer using Android Studio. +You can build the app with your computer using Android Studio. This used to be the only build option, nowadays Android Studio is mostly used by developers who consider making code changes. **[Follow these instructions.](./ComputerBuild.md)** +---- + +### Build using the command-line + +This option is intended for those who prefer to build AAPS in local command-line, without installing Android Studio. + +**[Follow these instructions.](./CLIBuild.md)** From 3462141593f0cc5854f59b3ed134e2e8a272ea76 Mon Sep 17 00:00:00 2001 From: Milos Kozak Date: Mon, 16 Mar 2026 23:22:40 +0100 Subject: [PATCH 075/126] New translations computerbuild.md (Polish) --- docs/CROWDIN/pl/SettingUpAaps/ComputerBuild.md | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-) diff --git a/docs/CROWDIN/pl/SettingUpAaps/ComputerBuild.md b/docs/CROWDIN/pl/SettingUpAaps/ComputerBuild.md index 4a8952c657d8..4a1ec5606bdc 100644 --- a/docs/CROWDIN/pl/SettingUpAaps/ComputerBuild.md +++ b/docs/CROWDIN/pl/SettingUpAaps/ComputerBuild.md @@ -1,4 +1,6 @@ -# Computer Build + + +# Android Studio Build This is the traditional method to build your AAPS app. From d3dc11d3fd4a190fe1e08da514e1efd2a5f465b3 Mon Sep 17 00:00:00 2001 From: Milos Kozak Date: Mon, 16 Mar 2026 23:22:45 +0100 Subject: [PATCH 076/126] New translations updatecomputerbuild.md (Polish) --- docs/CROWDIN/pl/Maintenance/UpdateComputerBuild.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/CROWDIN/pl/Maintenance/UpdateComputerBuild.md b/docs/CROWDIN/pl/Maintenance/UpdateComputerBuild.md index 6a55381526f5..5382357cc05a 100644 --- a/docs/CROWDIN/pl/Maintenance/UpdateComputerBuild.md +++ b/docs/CROWDIN/pl/Maintenance/UpdateComputerBuild.md @@ -1,4 +1,4 @@ -# Update with a computer +# Update with Android Studio ## Build yourself instead of download @@ -8,7 +8,7 @@ In case you want to build **AAPS** on a new computer : copy your back-up keystore file to the new computer. Then follow the [Initial build **AAPS** procedure](../SettingUpAaps/BuildingAaps.md) instead of this guide. With the only difference that instead of creating a new keystore, you can select the one you have copied on the new computer. ``` -## Overview for updating to a new version of AAPS with a computer +## Overview for updating to a new version of AAPS with Android Studio ```{contents} Steps for updating to a new version of AAPS :depth: 1 From cba8ec90f0c05dc361032f2ba1e6ec52a813026d Mon Sep 17 00:00:00 2001 From: Milos Kozak Date: Mon, 16 Mar 2026 23:25:03 +0100 Subject: [PATCH 077/126] New translations clibuild.md (Polish) --- docs/CROWDIN/pl/SettingUpAaps/CLIBuild.md | 54 +++++++++++++++++++++++ 1 file changed, 54 insertions(+) create mode 100644 docs/CROWDIN/pl/SettingUpAaps/CLIBuild.md diff --git a/docs/CROWDIN/pl/SettingUpAaps/CLIBuild.md b/docs/CROWDIN/pl/SettingUpAaps/CLIBuild.md new file mode 100644 index 000000000000..91bcee48b1db --- /dev/null +++ b/docs/CROWDIN/pl/SettingUpAaps/CLIBuild.md @@ -0,0 +1,54 @@ +# Build instructions for the command-line + +```{admonition} For users familiar with the command-line and git +:class: information + +The simplest option to build AAPS is the [Browser build](./BrowserBuild.md) alternative. +``` + +Tested with Fedora and Debian Linux, other systems should work with minimal adjustments. + +## Requirements + +Consult the minimum required Java version from [this table](#Building-APK-recommended-specification-of-computer-for-building-apk-file). Install the appropriate OpenJDK package using the system package manager. For example in Debian, the packages are named like `openjdk-21-jdk`. It should include `javac` and `keytool` binaries. + +Download the *Android Command line tools* package from the [Android Studio page](https://developer.android.com/studio#command-line-tools-only). Android Studio itself is not required. More information about installing this package is found in [sdkmanager docs](https://developer.android.com/tools/sdkmanager). After the package is installed, you should manually set two [environment variables](https://developer.android.com/tools/variables): `ANDROID_HOME` and `PATH`. Finally, run `sdkmanager --licenses` to finish the installation. + +## Building AAPS with Gradle wrapper + +### 1. Generate a Java keystore file for signing AAPS + +If you already have a keystore file for signing AAPS, reuse that. + +```sh +keytool -genkeypair -v \ + -keystore aaps-keystore.jks \ + -alias aaps-key \ + -keyalg RSA \ + -keysize 4096 \ + -validity 20000 +``` + +You will need the keystore file and passphrase every time you update AAPS. + +### 2. Compile the AAPS APK file + +Clone the [git repo](https://github.com/nightscout/AndroidAPS) if not already cloned. AAPS uses master branch for the latest stable version, ensure you are on the branch/tag you want to build. + +Run `./gradlew :app:assembleFullRelease` in the repo. It automatically downloads Gradle, dependencies, and then compiles the code. When the build succeeds, you should have an unsigned APK at `app/build/outputs/apk/full/release/app-full-release-unsigned.apk`. It should have also installed an `apksigner` binary to `$ANDROID_HOME`. Update your `PATH` again. + +### 3. Create a signed APK file from the unsigned one + + + +Change to your home directory and create a signed APK file: + +```sh +apksigner sign \ + --ks path/to/aaps-keystore.jks \ + --ks-key-alias aaps-key \ + --out app-full-release-signed.apk \ + ./AndroidAPS/app/build/outputs/apk/full/release/app-full-release-unsigned.apk +``` + +Now you have `app-full-release-signed.apk` ready for installation or upgrade. From be951a0a0fe7643de78d7656ce6af555972b7e06 Mon Sep 17 00:00:00 2001 From: Milos Kozak Date: Mon, 16 Mar 2026 23:25:14 +0100 Subject: [PATCH 078/126] New translations updatetonewversion.md (Portuguese) --- docs/CROWDIN/pt/Maintenance/UpdateToNewVersion.md | 6 +++++- 1 file changed, 5 insertions(+), 1 deletion(-) diff --git a/docs/CROWDIN/pt/Maintenance/UpdateToNewVersion.md b/docs/CROWDIN/pt/Maintenance/UpdateToNewVersion.md index a3c3e878e440..61814566c361 100644 --- a/docs/CROWDIN/pt/Maintenance/UpdateToNewVersion.md +++ b/docs/CROWDIN/pt/Maintenance/UpdateToNewVersion.md @@ -16,10 +16,14 @@ If you already built your AAPS app with the Browser Build method, follow [these instructions](./UpdateBrowserBuild.md). -## Update AAPS with a computer +## Update AAPS with Android Studio Follow [these instructions.](./UpdateComputerBuild.md). +## Update AAPS with the command-line + +Use the [same instructions](../SettingUpAaps/CLIBuild.md) as when building AAPS previously, but pull new changes with git. + (Update-to-new-version-check-aaps-version-on-phone)= ### Check AAPS version on phone From 463df71bb612b8e27c15ca0a69bba478b44ceefc Mon Sep 17 00:00:00 2001 From: Milos Kozak Date: Mon, 16 Mar 2026 23:29:12 +0100 Subject: [PATCH 079/126] New translations documentationupdate.md (Portuguese) --- docs/CROWDIN/pt/Maintenance/DocumentationUpdate.md | 5 +++++ 1 file changed, 5 insertions(+) diff --git a/docs/CROWDIN/pt/Maintenance/DocumentationUpdate.md b/docs/CROWDIN/pt/Maintenance/DocumentationUpdate.md index b4e3c885049d..68d1fb0ed5f4 100644 --- a/docs/CROWDIN/pt/Maintenance/DocumentationUpdate.md +++ b/docs/CROWDIN/pt/Maintenance/DocumentationUpdate.md @@ -1,5 +1,10 @@ # Docs updates & changes +## March 2026 + +- [Add CLI Build option](../SettingUpAaps/CLIBuild.md) @je-l +- Rename *Computer Build* to *Android Studio Build*. Preserve file names for URLs. + ## January 2025 - [3.4](#version3400) release and documentation update roll-up (Wizard, Computer build versions, Config Builder) From 2942de2c7649311fa62bf4a3ad08d6b878587619 Mon Sep 17 00:00:00 2001 From: Milos Kozak Date: Mon, 16 Mar 2026 23:29:44 +0100 Subject: [PATCH 080/126] New translations index.md (Portuguese) --- docs/CROWDIN/pt/index.md | 5 +++-- 1 file changed, 3 insertions(+), 2 deletions(-) diff --git a/docs/CROWDIN/pt/index.md b/docs/CROWDIN/pt/index.md index 16bf4dd80c01..49af20b8bf7e 100644 --- a/docs/CROWDIN/pt/index.md +++ b/docs/CROWDIN/pt/index.md @@ -91,7 +91,8 @@ Setting up the reporting server <./SettingUpAaps/SettingUpTheReportingServer.md> - Tidepool <./SettingUpAaps/Tidepool.md> Building AAPS <./SettingUpAaps/BuildingAaps.md> - Browser Build <./SettingUpAaps/BrowserBuild.md> -- Computer Build <./SettingUpAaps/ComputerBuild.md> +- Android Studio Build <./SettingUpAaps/ComputerBuild.md> +- CLI Build <./SettingUpAaps/CLIBuild.md> Transferring and Installing AAPS <./SettingUpAaps/TransferringAndInstallingAaps.md> Setup Wizard <./SettingUpAaps/SetupWizard.md> Your AAPS Profile <./SettingUpAaps/YourAapsProfile.md> @@ -149,7 +150,7 @@ AAPS Release Notes <./Maintenance/ReleaseNotes.md> Documentation updates <./Maintenance/DocumentationUpdate.md> Updating to a new version of AAPS <./Maintenance/UpdateToNewVersion.md> - Browser Update <./Maintenance/UpdateBrowserBuild.md> -- Computer Update <./Maintenance/UpdateComputerBuild.md> +- Android Studio Update <./Maintenance/UpdateComputerBuild.md> ``` From 5cf552b6522c1197b93ed07fdf7b0742072cdda6 Mon Sep 17 00:00:00 2001 From: Milos Kozak Date: Mon, 16 Mar 2026 23:33:16 +0100 Subject: [PATCH 081/126] New translations buildingaaps.md (Portuguese) --- docs/CROWDIN/pt/SettingUpAaps/BuildingAaps.md | 15 +++++++++++---- 1 file changed, 11 insertions(+), 4 deletions(-) diff --git a/docs/CROWDIN/pt/SettingUpAaps/BuildingAaps.md b/docs/CROWDIN/pt/SettingUpAaps/BuildingAaps.md index 72ad00ea6671..0ebbb3bea115 100644 --- a/docs/CROWDIN/pt/SettingUpAaps/BuildingAaps.md +++ b/docs/CROWDIN/pt/SettingUpAaps/BuildingAaps.md @@ -8,9 +8,9 @@ See [FAQ page](../UsefulLinks/FAQ.md) for details. --- -Two methods are available to build the AAPS app: +Three methods are available to build the AAPS app: -### Build with a browser +### Build with a browser (recommended) You can build the app with your smartphone using GitHub actions, and save it in your Google Drive. @@ -18,9 +18,16 @@ You can build the app with your smartphone using GitHub actions, and save it in ---- -### Build with a computer +### Build with Android Studio -You can build the app with your computer using Android Studio. +You can build the app with your computer using Android Studio. This used to be the only build option, nowadays Android Studio is mostly used by developers who consider making code changes. **[Follow these instructions.](./ComputerBuild.md)** +---- + +### Build using the command-line + +This option is intended for those who prefer to build AAPS in local command-line, without installing Android Studio. + +**[Follow these instructions.](./CLIBuild.md)** From 4d710e1a6bf3382905335562bbdc66951f18ca9e Mon Sep 17 00:00:00 2001 From: Milos Kozak Date: Mon, 16 Mar 2026 23:34:36 +0100 Subject: [PATCH 082/126] New translations computerbuild.md (Portuguese) --- docs/CROWDIN/pt/SettingUpAaps/ComputerBuild.md | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-) diff --git a/docs/CROWDIN/pt/SettingUpAaps/ComputerBuild.md b/docs/CROWDIN/pt/SettingUpAaps/ComputerBuild.md index e2a37b59a096..ed49ddda7e3d 100644 --- a/docs/CROWDIN/pt/SettingUpAaps/ComputerBuild.md +++ b/docs/CROWDIN/pt/SettingUpAaps/ComputerBuild.md @@ -1,4 +1,6 @@ -# Computer Build + + +# Android Studio Build This is the traditional method to build your AAPS app. From e0ab5d3e27c4d51a01b81106cb9504662a79bd96 Mon Sep 17 00:00:00 2001 From: Milos Kozak Date: Mon, 16 Mar 2026 23:34:41 +0100 Subject: [PATCH 083/126] New translations updatecomputerbuild.md (Portuguese) --- docs/CROWDIN/pt/Maintenance/UpdateComputerBuild.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/CROWDIN/pt/Maintenance/UpdateComputerBuild.md b/docs/CROWDIN/pt/Maintenance/UpdateComputerBuild.md index 6620c6787f22..d28d6a5c6ac1 100644 --- a/docs/CROWDIN/pt/Maintenance/UpdateComputerBuild.md +++ b/docs/CROWDIN/pt/Maintenance/UpdateComputerBuild.md @@ -1,4 +1,4 @@ -# Update with a computer +# Update with Android Studio ## Construa você em vez de fazer download @@ -8,7 +8,7 @@ In case you want to build **AAPS** on a new computer : copy your back-up keystore file to the new computer. Then follow the [Initial build **AAPS** procedure](../SettingUpAaps/BuildingAaps.md) instead of this guide. With the only difference that instead of creating a new keystore, you can select the one you have copied on the new computer. ``` -## Overview for updating to a new version of AAPS with a computer +## Overview for updating to a new version of AAPS with Android Studio ```{contents} Steps for updating to a new version of AAPS :depth: 1 From 8fd72b9a295c6b900d7291414e8db18c7e59c4f7 Mon Sep 17 00:00:00 2001 From: Milos Kozak Date: Mon, 16 Mar 2026 23:36:57 +0100 Subject: [PATCH 084/126] New translations clibuild.md (Portuguese) --- docs/CROWDIN/pt/SettingUpAaps/CLIBuild.md | 54 +++++++++++++++++++++++ 1 file changed, 54 insertions(+) create mode 100644 docs/CROWDIN/pt/SettingUpAaps/CLIBuild.md diff --git a/docs/CROWDIN/pt/SettingUpAaps/CLIBuild.md b/docs/CROWDIN/pt/SettingUpAaps/CLIBuild.md new file mode 100644 index 000000000000..91bcee48b1db --- /dev/null +++ b/docs/CROWDIN/pt/SettingUpAaps/CLIBuild.md @@ -0,0 +1,54 @@ +# Build instructions for the command-line + +```{admonition} For users familiar with the command-line and git +:class: information + +The simplest option to build AAPS is the [Browser build](./BrowserBuild.md) alternative. +``` + +Tested with Fedora and Debian Linux, other systems should work with minimal adjustments. + +## Requirements + +Consult the minimum required Java version from [this table](#Building-APK-recommended-specification-of-computer-for-building-apk-file). Install the appropriate OpenJDK package using the system package manager. For example in Debian, the packages are named like `openjdk-21-jdk`. It should include `javac` and `keytool` binaries. + +Download the *Android Command line tools* package from the [Android Studio page](https://developer.android.com/studio#command-line-tools-only). Android Studio itself is not required. More information about installing this package is found in [sdkmanager docs](https://developer.android.com/tools/sdkmanager). After the package is installed, you should manually set two [environment variables](https://developer.android.com/tools/variables): `ANDROID_HOME` and `PATH`. Finally, run `sdkmanager --licenses` to finish the installation. + +## Building AAPS with Gradle wrapper + +### 1. Generate a Java keystore file for signing AAPS + +If you already have a keystore file for signing AAPS, reuse that. + +```sh +keytool -genkeypair -v \ + -keystore aaps-keystore.jks \ + -alias aaps-key \ + -keyalg RSA \ + -keysize 4096 \ + -validity 20000 +``` + +You will need the keystore file and passphrase every time you update AAPS. + +### 2. Compile the AAPS APK file + +Clone the [git repo](https://github.com/nightscout/AndroidAPS) if not already cloned. AAPS uses master branch for the latest stable version, ensure you are on the branch/tag you want to build. + +Run `./gradlew :app:assembleFullRelease` in the repo. It automatically downloads Gradle, dependencies, and then compiles the code. When the build succeeds, you should have an unsigned APK at `app/build/outputs/apk/full/release/app-full-release-unsigned.apk`. It should have also installed an `apksigner` binary to `$ANDROID_HOME`. Update your `PATH` again. + +### 3. Create a signed APK file from the unsigned one + + + +Change to your home directory and create a signed APK file: + +```sh +apksigner sign \ + --ks path/to/aaps-keystore.jks \ + --ks-key-alias aaps-key \ + --out app-full-release-signed.apk \ + ./AndroidAPS/app/build/outputs/apk/full/release/app-full-release-unsigned.apk +``` + +Now you have `app-full-release-signed.apk` ready for installation or upgrade. From 04a0d8c6c3ab9797bce91fa3102d769664281481 Mon Sep 17 00:00:00 2001 From: Milos Kozak Date: Mon, 16 Mar 2026 23:37:09 +0100 Subject: [PATCH 085/126] New translations updatetonewversion.md (Russian) --- docs/CROWDIN/ru/Maintenance/UpdateToNewVersion.md | 6 +++++- 1 file changed, 5 insertions(+), 1 deletion(-) diff --git a/docs/CROWDIN/ru/Maintenance/UpdateToNewVersion.md b/docs/CROWDIN/ru/Maintenance/UpdateToNewVersion.md index 3eb358d27cff..e2598e3f18a3 100644 --- a/docs/CROWDIN/ru/Maintenance/UpdateToNewVersion.md +++ b/docs/CROWDIN/ru/Maintenance/UpdateToNewVersion.md @@ -16,10 +16,14 @@ If you already built your AAPS app with the Browser Build method, follow [these instructions](./UpdateBrowserBuild.md). -## Update AAPS with a computer +## Update AAPS with Android Studio Follow [these instructions.](./UpdateComputerBuild.md). +## Update AAPS with the command-line + +Use the [same instructions](../SettingUpAaps/CLIBuild.md) as when building AAPS previously, but pull new changes with git. + (Update-to-new-version-check-aaps-version-on-phone)= ### Проверьте версию AAPS на телефоне From c0c71ce9f2cca995f427538ba6293f9a63c0d57e Mon Sep 17 00:00:00 2001 From: Milos Kozak Date: Mon, 16 Mar 2026 23:41:05 +0100 Subject: [PATCH 086/126] New translations documentationupdate.md (Russian) --- docs/CROWDIN/ru/Maintenance/DocumentationUpdate.md | 5 +++++ 1 file changed, 5 insertions(+) diff --git a/docs/CROWDIN/ru/Maintenance/DocumentationUpdate.md b/docs/CROWDIN/ru/Maintenance/DocumentationUpdate.md index 2393d3ce6d28..93a97557c984 100644 --- a/docs/CROWDIN/ru/Maintenance/DocumentationUpdate.md +++ b/docs/CROWDIN/ru/Maintenance/DocumentationUpdate.md @@ -1,5 +1,10 @@ # Обновления и изменения в документации +## March 2026 + +- [Add CLI Build option](../SettingUpAaps/CLIBuild.md) @je-l +- Rename *Computer Build* to *Android Studio Build*. Preserve file names for URLs. + ## January 2025 - [3.4](#version3400) release and documentation update roll-up (Wizard, Computer build versions, Config Builder) From da23e8747ab4de25595861137a95f77ff4b32e6d Mon Sep 17 00:00:00 2001 From: Milos Kozak Date: Mon, 16 Mar 2026 23:41:39 +0100 Subject: [PATCH 087/126] New translations index.md (Russian) --- docs/CROWDIN/ru/index.md | 5 +++-- 1 file changed, 3 insertions(+), 2 deletions(-) diff --git a/docs/CROWDIN/ru/index.md b/docs/CROWDIN/ru/index.md index e81c480cf2f7..e72e15e561e1 100644 --- a/docs/CROWDIN/ru/index.md +++ b/docs/CROWDIN/ru/index.md @@ -91,7 +91,8 @@ Setting up the reporting server <./SettingUpAaps/SettingUpTheReportingServer.md> - Tidepool <./SettingUpAaps/Tidepool.md> Building AAPS <./SettingUpAaps/BuildingAaps.md> - Browser Build <./SettingUpAaps/BrowserBuild.md> -- Computer Build <./SettingUpAaps/ComputerBuild.md> +- Android Studio Build <./SettingUpAaps/ComputerBuild.md> +- CLI Build <./SettingUpAaps/CLIBuild.md> Transferring and Installing AAPS <./SettingUpAaps/TransferringAndInstallingAaps.md> Setup Wizard <./SettingUpAaps/SetupWizard.md> Your AAPS Profile <./SettingUpAaps/YourAapsProfile.md> @@ -149,7 +150,7 @@ AAPS Release Notes <./Maintenance/ReleaseNotes.md> Documentation updates <./Maintenance/DocumentationUpdate.md> Updating to a new version of AAPS <./Maintenance/UpdateToNewVersion.md> - Browser Update <./Maintenance/UpdateBrowserBuild.md> -- Computer Update <./Maintenance/UpdateComputerBuild.md> +- Android Studio Update <./Maintenance/UpdateComputerBuild.md> ``` From fbf6f1feb2144631e41537b26a59540880048e5e Mon Sep 17 00:00:00 2001 From: Milos Kozak Date: Mon, 16 Mar 2026 23:44:48 +0100 Subject: [PATCH 088/126] New translations buildingaaps.md (Russian) --- docs/CROWDIN/ru/SettingUpAaps/BuildingAaps.md | 15 +++++++++++---- 1 file changed, 11 insertions(+), 4 deletions(-) diff --git a/docs/CROWDIN/ru/SettingUpAaps/BuildingAaps.md b/docs/CROWDIN/ru/SettingUpAaps/BuildingAaps.md index bafa701fa0dd..75e0b1360dcc 100644 --- a/docs/CROWDIN/ru/SettingUpAaps/BuildingAaps.md +++ b/docs/CROWDIN/ru/SettingUpAaps/BuildingAaps.md @@ -8,9 +8,9 @@ See [FAQ page](../UsefulLinks/FAQ.md) for details. --- -Two methods are available to build the AAPS app: +Three methods are available to build the AAPS app: -### Build with a browser +### Build with a browser (recommended) You can build the app with your smartphone using GitHub actions, and save it in your Google Drive. @@ -18,9 +18,16 @@ You can build the app with your smartphone using GitHub actions, and save it in ---- -### Build with a computer +### Build with Android Studio -You can build the app with your computer using Android Studio. +You can build the app with your computer using Android Studio. This used to be the only build option, nowadays Android Studio is mostly used by developers who consider making code changes. **[Follow these instructions.](./ComputerBuild.md)** +---- + +### Build using the command-line + +This option is intended for those who prefer to build AAPS in local command-line, without installing Android Studio. + +**[Follow these instructions.](./CLIBuild.md)** From 9fb3eb8b7582a97668233cd47907b34ad4eadb0c Mon Sep 17 00:00:00 2001 From: Milos Kozak Date: Mon, 16 Mar 2026 23:46:03 +0100 Subject: [PATCH 089/126] New translations computerbuild.md (Russian) --- docs/CROWDIN/ru/SettingUpAaps/ComputerBuild.md | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-) diff --git a/docs/CROWDIN/ru/SettingUpAaps/ComputerBuild.md b/docs/CROWDIN/ru/SettingUpAaps/ComputerBuild.md index 2b251b2236ca..634b38545690 100644 --- a/docs/CROWDIN/ru/SettingUpAaps/ComputerBuild.md +++ b/docs/CROWDIN/ru/SettingUpAaps/ComputerBuild.md @@ -1,4 +1,6 @@ -# Computer Build + + +# Android Studio Build This is the traditional method to build your AAPS app. From 4798b98e8d1abdfa4bbdbae3553dd6bc0d6c9300 Mon Sep 17 00:00:00 2001 From: Milos Kozak Date: Mon, 16 Mar 2026 23:46:08 +0100 Subject: [PATCH 090/126] New translations updatecomputerbuild.md (Russian) --- docs/CROWDIN/ru/Maintenance/UpdateComputerBuild.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/CROWDIN/ru/Maintenance/UpdateComputerBuild.md b/docs/CROWDIN/ru/Maintenance/UpdateComputerBuild.md index fa4c94cb1b3a..28e4a81968f9 100644 --- a/docs/CROWDIN/ru/Maintenance/UpdateComputerBuild.md +++ b/docs/CROWDIN/ru/Maintenance/UpdateComputerBuild.md @@ -1,4 +1,4 @@ -# Update with a computer +# Update with Android Studio ## Постройте сами вместо скачивания @@ -8,7 +8,7 @@ In case you want to build **AAPS** on a new computer : copy your back-up keystore file to the new computer. Then follow the [Initial build **AAPS** procedure](../SettingUpAaps/BuildingAaps.md) instead of this guide. With the only difference that instead of creating a new keystore, you can select the one you have copied on the new computer. ``` -## Overview for updating to a new version of AAPS with a computer +## Overview for updating to a new version of AAPS with Android Studio ```{contents} Steps for updating to a new version of AAPS :depth: 1 From c5208a64a66067864318173c3e9f67e6665658ce Mon Sep 17 00:00:00 2001 From: Milos Kozak Date: Mon, 16 Mar 2026 23:48:19 +0100 Subject: [PATCH 091/126] New translations clibuild.md (Russian) --- docs/CROWDIN/ru/SettingUpAaps/CLIBuild.md | 54 +++++++++++++++++++++++ 1 file changed, 54 insertions(+) create mode 100644 docs/CROWDIN/ru/SettingUpAaps/CLIBuild.md diff --git a/docs/CROWDIN/ru/SettingUpAaps/CLIBuild.md b/docs/CROWDIN/ru/SettingUpAaps/CLIBuild.md new file mode 100644 index 000000000000..b53670a51fc5 --- /dev/null +++ b/docs/CROWDIN/ru/SettingUpAaps/CLIBuild.md @@ -0,0 +1,54 @@ +# Build instructions for the command-line + +```{admonition} For users familiar with the command-line and git +:class: information + +The simplest option to build AAPS is the [Browser build](./BrowserBuild.md) alternative. +``` + +Tested with Fedora and Debian Linux, other systems should work with minimal adjustments. + +## Что потребуется: + +Consult the minimum required Java version from [this table](#Building-APK-recommended-specification-of-computer-for-building-apk-file). Install the appropriate OpenJDK package using the system package manager. For example in Debian, the packages are named like `openjdk-21-jdk`. It should include `javac` and `keytool` binaries. + +Download the *Android Command line tools* package from the [Android Studio page](https://developer.android.com/studio#command-line-tools-only). Android Studio itself is not required. More information about installing this package is found in [sdkmanager docs](https://developer.android.com/tools/sdkmanager). After the package is installed, you should manually set two [environment variables](https://developer.android.com/tools/variables): `ANDROID_HOME` and `PATH`. Finally, run `sdkmanager --licenses` to finish the installation. + +## Building AAPS with Gradle wrapper + +### 1. Generate a Java keystore file for signing AAPS + +If you already have a keystore file for signing AAPS, reuse that. + +```sh +keytool -genkeypair -v \ + -keystore aaps-keystore.jks \ + -alias aaps-key \ + -keyalg RSA \ + -keysize 4096 \ + -validity 20000 +``` + +You will need the keystore file and passphrase every time you update AAPS. + +### 2. Compile the AAPS APK file + +Clone the [git repo](https://github.com/nightscout/AndroidAPS) if not already cloned. AAPS uses master branch for the latest stable version, ensure you are on the branch/tag you want to build. + +Run `./gradlew :app:assembleFullRelease` in the repo. It automatically downloads Gradle, dependencies, and then compiles the code. When the build succeeds, you should have an unsigned APK at `app/build/outputs/apk/full/release/app-full-release-unsigned.apk`. It should have also installed an `apksigner` binary to `$ANDROID_HOME`. Update your `PATH` again. + +### 3. Create a signed APK file from the unsigned one + + + +Change to your home directory and create a signed APK file: + +```sh +apksigner sign \ + --ks path/to/aaps-keystore.jks \ + --ks-key-alias aaps-key \ + --out app-full-release-signed.apk \ + ./AndroidAPS/app/build/outputs/apk/full/release/app-full-release-unsigned.apk +``` + +Now you have `app-full-release-signed.apk` ready for installation or upgrade. From 70fb6dcccd315d14940992ea86a7c110bf43cf6b Mon Sep 17 00:00:00 2001 From: Milos Kozak Date: Mon, 16 Mar 2026 23:48:30 +0100 Subject: [PATCH 092/126] New translations updatetonewversion.md (Slovak) --- docs/CROWDIN/sk/Maintenance/UpdateToNewVersion.md | 6 +++++- 1 file changed, 5 insertions(+), 1 deletion(-) diff --git a/docs/CROWDIN/sk/Maintenance/UpdateToNewVersion.md b/docs/CROWDIN/sk/Maintenance/UpdateToNewVersion.md index 4a290089964a..bb94b8025194 100644 --- a/docs/CROWDIN/sk/Maintenance/UpdateToNewVersion.md +++ b/docs/CROWDIN/sk/Maintenance/UpdateToNewVersion.md @@ -16,10 +16,14 @@ If you already built your AAPS app with the Browser Build method, follow [these instructions](./UpdateBrowserBuild.md). -## Update AAPS with a computer +## Update AAPS with Android Studio Follow [these instructions.](./UpdateComputerBuild.md). +## Update AAPS with the command-line + +Use the [same instructions](../SettingUpAaps/CLIBuild.md) as when building AAPS previously, but pull new changes with git. + (Update-to-new-version-check-aaps-version-on-phone)= ### Check AAPS version on phone From 4b691b0735e09f848239aa01565347d0776af113 Mon Sep 17 00:00:00 2001 From: Milos Kozak Date: Mon, 16 Mar 2026 23:52:29 +0100 Subject: [PATCH 093/126] New translations documentationupdate.md (Slovak) --- docs/CROWDIN/sk/Maintenance/DocumentationUpdate.md | 5 +++++ 1 file changed, 5 insertions(+) diff --git a/docs/CROWDIN/sk/Maintenance/DocumentationUpdate.md b/docs/CROWDIN/sk/Maintenance/DocumentationUpdate.md index 065449ea1893..bfbe3265e77d 100644 --- a/docs/CROWDIN/sk/Maintenance/DocumentationUpdate.md +++ b/docs/CROWDIN/sk/Maintenance/DocumentationUpdate.md @@ -1,5 +1,10 @@ # Docs updates & changes +## March 2026 + +- [Add CLI Build option](../SettingUpAaps/CLIBuild.md) @je-l +- Rename *Computer Build* to *Android Studio Build*. Preserve file names for URLs. + ## January 2025 - [3.4](#version3400) release and documentation update roll-up (Wizard, Computer build versions, Config Builder) From cb3517e16221d77f640b0971f56d2ea7dd3bc04e Mon Sep 17 00:00:00 2001 From: Milos Kozak Date: Mon, 16 Mar 2026 23:53:02 +0100 Subject: [PATCH 094/126] New translations index.md (Slovak) --- docs/CROWDIN/sk/index.md | 5 +++-- 1 file changed, 3 insertions(+), 2 deletions(-) diff --git a/docs/CROWDIN/sk/index.md b/docs/CROWDIN/sk/index.md index 20b8f1837d2e..fc583173843e 100644 --- a/docs/CROWDIN/sk/index.md +++ b/docs/CROWDIN/sk/index.md @@ -91,7 +91,8 @@ Setting up the reporting server <./SettingUpAaps/SettingUpTheReportingServer.md> - Tidepool <./SettingUpAaps/Tidepool.md> Building AAPS <./SettingUpAaps/BuildingAaps.md> - Browser Build <./SettingUpAaps/BrowserBuild.md> -- Computer Build <./SettingUpAaps/ComputerBuild.md> +- Android Studio Build <./SettingUpAaps/ComputerBuild.md> +- CLI Build <./SettingUpAaps/CLIBuild.md> Transferring and Installing AAPS <./SettingUpAaps/TransferringAndInstallingAaps.md> Setup Wizard <./SettingUpAaps/SetupWizard.md> Your AAPS Profile <./SettingUpAaps/YourAapsProfile.md> @@ -149,7 +150,7 @@ AAPS Release Notes <./Maintenance/ReleaseNotes.md> Documentation updates <./Maintenance/DocumentationUpdate.md> Updating to a new version of AAPS <./Maintenance/UpdateToNewVersion.md> - Browser Update <./Maintenance/UpdateBrowserBuild.md> -- Computer Update <./Maintenance/UpdateComputerBuild.md> +- Android Studio Update <./Maintenance/UpdateComputerBuild.md> ``` From 1738151f5dfedde408f75e3989e0762f69cc57ec Mon Sep 17 00:00:00 2001 From: Milos Kozak Date: Mon, 16 Mar 2026 23:56:17 +0100 Subject: [PATCH 095/126] New translations buildingaaps.md (Slovak) --- docs/CROWDIN/sk/SettingUpAaps/BuildingAaps.md | 15 +++++++++++---- 1 file changed, 11 insertions(+), 4 deletions(-) diff --git a/docs/CROWDIN/sk/SettingUpAaps/BuildingAaps.md b/docs/CROWDIN/sk/SettingUpAaps/BuildingAaps.md index aa95e0cf7c3a..97d38551b766 100644 --- a/docs/CROWDIN/sk/SettingUpAaps/BuildingAaps.md +++ b/docs/CROWDIN/sk/SettingUpAaps/BuildingAaps.md @@ -8,9 +8,9 @@ See [FAQ page](../UsefulLinks/FAQ.md) for details. --- -Two methods are available to build the AAPS app: +Three methods are available to build the AAPS app: -### Build with a browser +### Build with a browser (recommended) You can build the app with your smartphone using GitHub actions, and save it in your Google Drive. @@ -18,9 +18,16 @@ You can build the app with your smartphone using GitHub actions, and save it in ---- -### Build with a computer +### Build with Android Studio -You can build the app with your computer using Android Studio. +You can build the app with your computer using Android Studio. This used to be the only build option, nowadays Android Studio is mostly used by developers who consider making code changes. **[Follow these instructions.](./ComputerBuild.md)** +---- + +### Build using the command-line + +This option is intended for those who prefer to build AAPS in local command-line, without installing Android Studio. + +**[Follow these instructions.](./CLIBuild.md)** From dcc3f25ce00067098fe0fdb24fd43ac1e66ad977 Mon Sep 17 00:00:00 2001 From: Milos Kozak Date: Mon, 16 Mar 2026 23:57:28 +0100 Subject: [PATCH 096/126] New translations computerbuild.md (Slovak) --- docs/CROWDIN/sk/SettingUpAaps/ComputerBuild.md | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-) diff --git a/docs/CROWDIN/sk/SettingUpAaps/ComputerBuild.md b/docs/CROWDIN/sk/SettingUpAaps/ComputerBuild.md index 4a8952c657d8..4a1ec5606bdc 100644 --- a/docs/CROWDIN/sk/SettingUpAaps/ComputerBuild.md +++ b/docs/CROWDIN/sk/SettingUpAaps/ComputerBuild.md @@ -1,4 +1,6 @@ -# Computer Build + + +# Android Studio Build This is the traditional method to build your AAPS app. From 2f76c77adf38b84f81bbbc26256f7890e452cefb Mon Sep 17 00:00:00 2001 From: Milos Kozak Date: Mon, 16 Mar 2026 23:57:32 +0100 Subject: [PATCH 097/126] New translations updatecomputerbuild.md (Slovak) --- docs/CROWDIN/sk/Maintenance/UpdateComputerBuild.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/CROWDIN/sk/Maintenance/UpdateComputerBuild.md b/docs/CROWDIN/sk/Maintenance/UpdateComputerBuild.md index 6a55381526f5..5382357cc05a 100644 --- a/docs/CROWDIN/sk/Maintenance/UpdateComputerBuild.md +++ b/docs/CROWDIN/sk/Maintenance/UpdateComputerBuild.md @@ -1,4 +1,4 @@ -# Update with a computer +# Update with Android Studio ## Build yourself instead of download @@ -8,7 +8,7 @@ In case you want to build **AAPS** on a new computer : copy your back-up keystore file to the new computer. Then follow the [Initial build **AAPS** procedure](../SettingUpAaps/BuildingAaps.md) instead of this guide. With the only difference that instead of creating a new keystore, you can select the one you have copied on the new computer. ``` -## Overview for updating to a new version of AAPS with a computer +## Overview for updating to a new version of AAPS with Android Studio ```{contents} Steps for updating to a new version of AAPS :depth: 1 From fbae4c982a078b5d3195fd4ffc00c84caf2ca49e Mon Sep 17 00:00:00 2001 From: Milos Kozak Date: Mon, 16 Mar 2026 23:59:33 +0100 Subject: [PATCH 098/126] New translations clibuild.md (Slovak) --- docs/CROWDIN/sk/SettingUpAaps/CLIBuild.md | 54 +++++++++++++++++++++++ 1 file changed, 54 insertions(+) create mode 100644 docs/CROWDIN/sk/SettingUpAaps/CLIBuild.md diff --git a/docs/CROWDIN/sk/SettingUpAaps/CLIBuild.md b/docs/CROWDIN/sk/SettingUpAaps/CLIBuild.md new file mode 100644 index 000000000000..91bcee48b1db --- /dev/null +++ b/docs/CROWDIN/sk/SettingUpAaps/CLIBuild.md @@ -0,0 +1,54 @@ +# Build instructions for the command-line + +```{admonition} For users familiar with the command-line and git +:class: information + +The simplest option to build AAPS is the [Browser build](./BrowserBuild.md) alternative. +``` + +Tested with Fedora and Debian Linux, other systems should work with minimal adjustments. + +## Requirements + +Consult the minimum required Java version from [this table](#Building-APK-recommended-specification-of-computer-for-building-apk-file). Install the appropriate OpenJDK package using the system package manager. For example in Debian, the packages are named like `openjdk-21-jdk`. It should include `javac` and `keytool` binaries. + +Download the *Android Command line tools* package from the [Android Studio page](https://developer.android.com/studio#command-line-tools-only). Android Studio itself is not required. More information about installing this package is found in [sdkmanager docs](https://developer.android.com/tools/sdkmanager). After the package is installed, you should manually set two [environment variables](https://developer.android.com/tools/variables): `ANDROID_HOME` and `PATH`. Finally, run `sdkmanager --licenses` to finish the installation. + +## Building AAPS with Gradle wrapper + +### 1. Generate a Java keystore file for signing AAPS + +If you already have a keystore file for signing AAPS, reuse that. + +```sh +keytool -genkeypair -v \ + -keystore aaps-keystore.jks \ + -alias aaps-key \ + -keyalg RSA \ + -keysize 4096 \ + -validity 20000 +``` + +You will need the keystore file and passphrase every time you update AAPS. + +### 2. Compile the AAPS APK file + +Clone the [git repo](https://github.com/nightscout/AndroidAPS) if not already cloned. AAPS uses master branch for the latest stable version, ensure you are on the branch/tag you want to build. + +Run `./gradlew :app:assembleFullRelease` in the repo. It automatically downloads Gradle, dependencies, and then compiles the code. When the build succeeds, you should have an unsigned APK at `app/build/outputs/apk/full/release/app-full-release-unsigned.apk`. It should have also installed an `apksigner` binary to `$ANDROID_HOME`. Update your `PATH` again. + +### 3. Create a signed APK file from the unsigned one + + + +Change to your home directory and create a signed APK file: + +```sh +apksigner sign \ + --ks path/to/aaps-keystore.jks \ + --ks-key-alias aaps-key \ + --out app-full-release-signed.apk \ + ./AndroidAPS/app/build/outputs/apk/full/release/app-full-release-unsigned.apk +``` + +Now you have `app-full-release-signed.apk` ready for installation or upgrade. From 8e0b72c9fc954a1cca702c30574d42c508e268ac Mon Sep 17 00:00:00 2001 From: Milos Kozak Date: Mon, 16 Mar 2026 23:59:44 +0100 Subject: [PATCH 099/126] New translations updatetonewversion.md (Turkish) --- docs/CROWDIN/tr/Maintenance/UpdateToNewVersion.md | 6 +++++- 1 file changed, 5 insertions(+), 1 deletion(-) diff --git a/docs/CROWDIN/tr/Maintenance/UpdateToNewVersion.md b/docs/CROWDIN/tr/Maintenance/UpdateToNewVersion.md index 07fe35c4207f..d609f38c7a77 100644 --- a/docs/CROWDIN/tr/Maintenance/UpdateToNewVersion.md +++ b/docs/CROWDIN/tr/Maintenance/UpdateToNewVersion.md @@ -16,10 +16,14 @@ If you already built your AAPS app with the Browser Build method, follow [these instructions](./UpdateBrowserBuild.md). -## Update AAPS with a computer +## Update AAPS with Android Studio Follow [these instructions.](./UpdateComputerBuild.md). +## Update AAPS with the command-line + +Use the [same instructions](../SettingUpAaps/CLIBuild.md) as when building AAPS previously, but pull new changes with git. + (Update-to-new-version-check-aaps-version-on-phone)= ### Telefondaki AAPS sürümünü kontrol edin From 5dba3ef6cdf0c79118e6e78fd29227cd9c5e532d Mon Sep 17 00:00:00 2001 From: Milos Kozak Date: Tue, 17 Mar 2026 00:04:57 +0100 Subject: [PATCH 100/126] New translations documentationupdate.md (Turkish) --- docs/CROWDIN/tr/Maintenance/DocumentationUpdate.md | 5 +++++ 1 file changed, 5 insertions(+) diff --git a/docs/CROWDIN/tr/Maintenance/DocumentationUpdate.md b/docs/CROWDIN/tr/Maintenance/DocumentationUpdate.md index 4c42debdf944..418f12bd09c8 100644 --- a/docs/CROWDIN/tr/Maintenance/DocumentationUpdate.md +++ b/docs/CROWDIN/tr/Maintenance/DocumentationUpdate.md @@ -1,5 +1,10 @@ # Doküman güncellemeleri & değişiklikleri +## March 2026 + +- [Add CLI Build option](../SettingUpAaps/CLIBuild.md) @je-l +- Rename *Computer Build* to *Android Studio Build*. Preserve file names for URLs. + ## January 2025 - [3.4](#version3400) release and documentation update roll-up (Wizard, Computer build versions, Config Builder) From 58370cbc709539cf9fd690c0890dbdb2ec164ada Mon Sep 17 00:00:00 2001 From: Milos Kozak Date: Tue, 17 Mar 2026 00:05:32 +0100 Subject: [PATCH 101/126] New translations index.md (Turkish) --- docs/CROWDIN/tr/index.md | 5 +++-- 1 file changed, 3 insertions(+), 2 deletions(-) diff --git a/docs/CROWDIN/tr/index.md b/docs/CROWDIN/tr/index.md index c133811fc10d..bb39eb8d4cd0 100644 --- a/docs/CROWDIN/tr/index.md +++ b/docs/CROWDIN/tr/index.md @@ -91,7 +91,8 @@ Setting up the reporting server <./SettingUpAaps/SettingUpTheReportingServer.md> - Tidepool <./SettingUpAaps/Tidepool.md> Building AAPS <./SettingUpAaps/BuildingAaps.md> - Browser Build <./SettingUpAaps/BrowserBuild.md> -- Computer Build <./SettingUpAaps/ComputerBuild.md> +- Android Studio Build <./SettingUpAaps/ComputerBuild.md> +- CLI Build <./SettingUpAaps/CLIBuild.md> Transferring and Installing AAPS <./SettingUpAaps/TransferringAndInstallingAaps.md> Setup Wizard <./SettingUpAaps/SetupWizard.md> Your AAPS Profile <./SettingUpAaps/YourAapsProfile.md> @@ -149,7 +150,7 @@ AAPS Release Notes <./Maintenance/ReleaseNotes.md> Documentation updates <./Maintenance/DocumentationUpdate.md> Updating to a new version of AAPS <./Maintenance/UpdateToNewVersion.md> - Browser Update <./Maintenance/UpdateBrowserBuild.md> -- Computer Update <./Maintenance/UpdateComputerBuild.md> +- Android Studio Update <./Maintenance/UpdateComputerBuild.md> ``` From bb537c8c77f71b829a7b3f8950fc7d3701b09490 Mon Sep 17 00:00:00 2001 From: Milos Kozak Date: Tue, 17 Mar 2026 00:08:55 +0100 Subject: [PATCH 102/126] New translations buildingaaps.md (Turkish) --- docs/CROWDIN/tr/SettingUpAaps/BuildingAaps.md | 15 +++++++++++---- 1 file changed, 11 insertions(+), 4 deletions(-) diff --git a/docs/CROWDIN/tr/SettingUpAaps/BuildingAaps.md b/docs/CROWDIN/tr/SettingUpAaps/BuildingAaps.md index cfabef8a8ab2..049e5f5741b7 100644 --- a/docs/CROWDIN/tr/SettingUpAaps/BuildingAaps.md +++ b/docs/CROWDIN/tr/SettingUpAaps/BuildingAaps.md @@ -8,9 +8,9 @@ See [FAQ page](../UsefulLinks/FAQ.md) for details. --- -Two methods are available to build the AAPS app: +Three methods are available to build the AAPS app: -### Build with a browser +### Build with a browser (recommended) You can build the app with your smartphone using GitHub actions, and save it in your Google Drive. @@ -18,9 +18,16 @@ You can build the app with your smartphone using GitHub actions, and save it in ---- -### Build with a computer +### Build with Android Studio -You can build the app with your computer using Android Studio. +You can build the app with your computer using Android Studio. This used to be the only build option, nowadays Android Studio is mostly used by developers who consider making code changes. **[Follow these instructions.](./ComputerBuild.md)** +---- + +### Build using the command-line + +This option is intended for those who prefer to build AAPS in local command-line, without installing Android Studio. + +**[Follow these instructions.](./CLIBuild.md)** From db72504bb575214bcc4c9e1996ca1cbd577d2bb2 Mon Sep 17 00:00:00 2001 From: Milos Kozak Date: Tue, 17 Mar 2026 00:10:05 +0100 Subject: [PATCH 103/126] New translations computerbuild.md (Turkish) --- docs/CROWDIN/tr/SettingUpAaps/ComputerBuild.md | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-) diff --git a/docs/CROWDIN/tr/SettingUpAaps/ComputerBuild.md b/docs/CROWDIN/tr/SettingUpAaps/ComputerBuild.md index 4511ebef9d0e..415d9e160fbd 100644 --- a/docs/CROWDIN/tr/SettingUpAaps/ComputerBuild.md +++ b/docs/CROWDIN/tr/SettingUpAaps/ComputerBuild.md @@ -1,4 +1,6 @@ -# Computer Build + + +# Android Studio Build This is the traditional method to build your AAPS app. From e0415d37c827eb3da1dedbb62388012a557c2ae9 Mon Sep 17 00:00:00 2001 From: Milos Kozak Date: Tue, 17 Mar 2026 00:10:09 +0100 Subject: [PATCH 104/126] New translations updatecomputerbuild.md (Turkish) --- docs/CROWDIN/tr/Maintenance/UpdateComputerBuild.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/CROWDIN/tr/Maintenance/UpdateComputerBuild.md b/docs/CROWDIN/tr/Maintenance/UpdateComputerBuild.md index c3fb4aa8a63c..a585aa154caf 100644 --- a/docs/CROWDIN/tr/Maintenance/UpdateComputerBuild.md +++ b/docs/CROWDIN/tr/Maintenance/UpdateComputerBuild.md @@ -1,4 +1,4 @@ -# Update with a computer +# Update with Android Studio ## Programı İndirmek yerine kendiniz oluşturun... @@ -8,7 +8,7 @@ In case you want to build **AAPS** on a new computer : copy your back-up keystore file to the new computer. Then follow the [Initial build **AAPS** procedure](../SettingUpAaps/BuildingAaps.md) instead of this guide. With the only difference that instead of creating a new keystore, you can select the one you have copied on the new computer. ``` -## Overview for updating to a new version of AAPS with a computer +## Overview for updating to a new version of AAPS with Android Studio ```{contents} Steps for updating to a new version of AAPS :depth: 1 From b0eb110714718f02e1506380e4a1f1528dca442c Mon Sep 17 00:00:00 2001 From: Milos Kozak Date: Tue, 17 Mar 2026 00:12:14 +0100 Subject: [PATCH 105/126] New translations clibuild.md (Turkish) --- docs/CROWDIN/tr/SettingUpAaps/CLIBuild.md | 54 +++++++++++++++++++++++ 1 file changed, 54 insertions(+) create mode 100644 docs/CROWDIN/tr/SettingUpAaps/CLIBuild.md diff --git a/docs/CROWDIN/tr/SettingUpAaps/CLIBuild.md b/docs/CROWDIN/tr/SettingUpAaps/CLIBuild.md new file mode 100644 index 000000000000..91bcee48b1db --- /dev/null +++ b/docs/CROWDIN/tr/SettingUpAaps/CLIBuild.md @@ -0,0 +1,54 @@ +# Build instructions for the command-line + +```{admonition} For users familiar with the command-line and git +:class: information + +The simplest option to build AAPS is the [Browser build](./BrowserBuild.md) alternative. +``` + +Tested with Fedora and Debian Linux, other systems should work with minimal adjustments. + +## Requirements + +Consult the minimum required Java version from [this table](#Building-APK-recommended-specification-of-computer-for-building-apk-file). Install the appropriate OpenJDK package using the system package manager. For example in Debian, the packages are named like `openjdk-21-jdk`. It should include `javac` and `keytool` binaries. + +Download the *Android Command line tools* package from the [Android Studio page](https://developer.android.com/studio#command-line-tools-only). Android Studio itself is not required. More information about installing this package is found in [sdkmanager docs](https://developer.android.com/tools/sdkmanager). After the package is installed, you should manually set two [environment variables](https://developer.android.com/tools/variables): `ANDROID_HOME` and `PATH`. Finally, run `sdkmanager --licenses` to finish the installation. + +## Building AAPS with Gradle wrapper + +### 1. Generate a Java keystore file for signing AAPS + +If you already have a keystore file for signing AAPS, reuse that. + +```sh +keytool -genkeypair -v \ + -keystore aaps-keystore.jks \ + -alias aaps-key \ + -keyalg RSA \ + -keysize 4096 \ + -validity 20000 +``` + +You will need the keystore file and passphrase every time you update AAPS. + +### 2. Compile the AAPS APK file + +Clone the [git repo](https://github.com/nightscout/AndroidAPS) if not already cloned. AAPS uses master branch for the latest stable version, ensure you are on the branch/tag you want to build. + +Run `./gradlew :app:assembleFullRelease` in the repo. It automatically downloads Gradle, dependencies, and then compiles the code. When the build succeeds, you should have an unsigned APK at `app/build/outputs/apk/full/release/app-full-release-unsigned.apk`. It should have also installed an `apksigner` binary to `$ANDROID_HOME`. Update your `PATH` again. + +### 3. Create a signed APK file from the unsigned one + + + +Change to your home directory and create a signed APK file: + +```sh +apksigner sign \ + --ks path/to/aaps-keystore.jks \ + --ks-key-alias aaps-key \ + --out app-full-release-signed.apk \ + ./AndroidAPS/app/build/outputs/apk/full/release/app-full-release-unsigned.apk +``` + +Now you have `app-full-release-signed.apk` ready for installation or upgrade. From d79466ffdc3f19cb8602f5efa3a207456cd84bcf Mon Sep 17 00:00:00 2001 From: Milos Kozak Date: Tue, 17 Mar 2026 00:12:25 +0100 Subject: [PATCH 106/126] New translations updatetonewversion.md (Chinese Simplified) --- docs/CROWDIN/zh_CN/Maintenance/UpdateToNewVersion.md | 6 +++++- 1 file changed, 5 insertions(+), 1 deletion(-) diff --git a/docs/CROWDIN/zh_CN/Maintenance/UpdateToNewVersion.md b/docs/CROWDIN/zh_CN/Maintenance/UpdateToNewVersion.md index 50841d3f818d..4aa51b99e351 100644 --- a/docs/CROWDIN/zh_CN/Maintenance/UpdateToNewVersion.md +++ b/docs/CROWDIN/zh_CN/Maintenance/UpdateToNewVersion.md @@ -16,10 +16,14 @@ If you already built your AAPS app with the Browser Build method, follow [these instructions](./UpdateBrowserBuild.md). -## Update AAPS with a computer +## Update AAPS with Android Studio Follow [these instructions.](./UpdateComputerBuild.md). +## Update AAPS with the command-line + +Use the [same instructions](../SettingUpAaps/CLIBuild.md) as when building AAPS previously, but pull new changes with git. + (Update-to-new-version-check-aaps-version-on-phone)= ### 检查手机上的 AAPS 版本 From 0e338941eef581b89ee9767b6561061113fd60c6 Mon Sep 17 00:00:00 2001 From: Milos Kozak Date: Tue, 17 Mar 2026 00:15:59 +0100 Subject: [PATCH 107/126] New translations documentationupdate.md (Chinese Simplified) --- docs/CROWDIN/zh_CN/Maintenance/DocumentationUpdate.md | 5 +++++ 1 file changed, 5 insertions(+) diff --git a/docs/CROWDIN/zh_CN/Maintenance/DocumentationUpdate.md b/docs/CROWDIN/zh_CN/Maintenance/DocumentationUpdate.md index 5214572eb4e3..be7c4959c9ae 100644 --- a/docs/CROWDIN/zh_CN/Maintenance/DocumentationUpdate.md +++ b/docs/CROWDIN/zh_CN/Maintenance/DocumentationUpdate.md @@ -1,5 +1,10 @@ # 文档更新与变更 +## March 2026 + +- [Add CLI Build option](../SettingUpAaps/CLIBuild.md) @je-l +- Rename *Computer Build* to *Android Studio Build*. Preserve file names for URLs. + ## 2025年1月 - [3.4](#version3400) release and documentation update roll-up (Wizard, Computer build versions, Config Builder) From 12d10f33a2b200fa93b774cac820311f78884286 Mon Sep 17 00:00:00 2001 From: Milos Kozak Date: Tue, 17 Mar 2026 00:16:29 +0100 Subject: [PATCH 108/126] New translations index.md (Chinese Simplified) --- docs/CROWDIN/zh_CN/index.md | 43 +++++++++++++++++++------------------ 1 file changed, 22 insertions(+), 21 deletions(-) diff --git a/docs/CROWDIN/zh_CN/index.md b/docs/CROWDIN/zh_CN/index.md index 45b99e75d5a5..1de02dbbd15d 100644 --- a/docs/CROWDIN/zh_CN/index.md +++ b/docs/CROWDIN/zh_CN/index.md @@ -83,21 +83,22 @@ AAPS简介 <./Getting-Started/Introduction.md> ``` ```{toctree} -:caption: 3) 设置 AAPS +:caption: 3) Setting up AAPS -设置报告服务器 (Setting up the reporting server) <./SettingUpAaps/SettingUpTheReportingServer.md> +Setting up the reporting server <./SettingUpAaps/SettingUpTheReportingServer.md> - Nightscout <./SettingUpAaps/Nightscout.md> - Tidepool <./SettingUpAaps/Tidepool.md> -构建 AAPS (Building AAPS) <./SettingUpAaps/BuildingAaps.md> -- 浏览器构建<./SettingUpAaps/BrowserBuild.md> -- 电脑构建 <./SettingUpAaps/ComputerBuild.md> -传输并安装 AAPS <./SettingUpAaps/TransferringAndInstallingAaps.md> -设置向导 <./SettingUpAaps/SetupWizard.md> -你的 AAPS 配置文件 <./SettingUpAaps/YourAapsProfile.md> -更改 AAPS 配置 <./SettingUpAaps/ChangeAapsConfiguration.md> -- 配置生成器 <./SettingUpAaps/ConfigBuilder.md> -- 偏好设置 <./SettingUpAaps/Preferences.md> -完成任务阶段 <./SettingUpAaps/CompletingTheObjectives.md> +Building AAPS <./SettingUpAaps/BuildingAaps.md> +- Browser Build <./SettingUpAaps/BrowserBuild.md> +- Android Studio Build <./SettingUpAaps/ComputerBuild.md> +- CLI Build <./SettingUpAaps/CLIBuild.md> +Transferring and Installing AAPS <./SettingUpAaps/TransferringAndInstallingAaps.md> +Setup Wizard <./SettingUpAaps/SetupWizard.md> +Your AAPS Profile <./SettingUpAaps/YourAapsProfile.md> +Change AAPS configuration <./SettingUpAaps/ChangeAapsConfiguration.md> +- Config Builder <./SettingUpAaps/ConfigBuilder.md> +- Preferences <./SettingUpAaps/Preferences.md> +Completing the objectives <./SettingUpAaps/CompletingTheObjectives.md> ``` ```{toctree} @@ -140,15 +141,15 @@ Android Auto <./RemoteFeatures/AndroidAuto.md> ``` ```{toctree} -:caption: 7) AAPS 的维护 - -导出/导入设置 <./Maintenance/ExportImportSettings.md> -查看你的数据 <./Maintenance/Reviewing.md> -AAPS 发行说明 <./Maintenance/ReleaseNotes.md> -文档更新 <./Maintenance/DocumentationUpdate.md> -更新至 AAPS 新版本 <./Maintenance/UpdateToNewVersion.md> -- 浏览器更新 <./Maintenance/UpdateBrowserBuild.md> -- 电脑更新 <./Maintenance/UpdateComputerBuild.md> +:caption: 7) Maintenance of AAPS + +Export/Import Settings <./Maintenance/ExportImportSettings.md> +Reviewing your data <./Maintenance/Reviewing.md> +AAPS Release Notes <./Maintenance/ReleaseNotes.md> +Documentation updates <./Maintenance/DocumentationUpdate.md> +Updating to a new version of AAPS <./Maintenance/UpdateToNewVersion.md> +- Browser Update <./Maintenance/UpdateBrowserBuild.md> +- Android Studio Update <./Maintenance/UpdateComputerBuild.md> ``` From c5313aa5947f6014362a40a734189f493a442134 Mon Sep 17 00:00:00 2001 From: Milos Kozak Date: Tue, 17 Mar 2026 00:19:21 +0100 Subject: [PATCH 109/126] New translations buildingaaps.md (Chinese Simplified) --- docs/CROWDIN/zh_CN/SettingUpAaps/BuildingAaps.md | 15 +++++++++++---- 1 file changed, 11 insertions(+), 4 deletions(-) diff --git a/docs/CROWDIN/zh_CN/SettingUpAaps/BuildingAaps.md b/docs/CROWDIN/zh_CN/SettingUpAaps/BuildingAaps.md index 7166591ba934..80bb9736de7f 100644 --- a/docs/CROWDIN/zh_CN/SettingUpAaps/BuildingAaps.md +++ b/docs/CROWDIN/zh_CN/SettingUpAaps/BuildingAaps.md @@ -8,9 +8,9 @@ --- -Two methods are available to build the AAPS app: +Three methods are available to build the AAPS app: -### Build with a browser +### Build with a browser (recommended) You can build the app with your smartphone using GitHub actions, and save it in your Google Drive. @@ -18,9 +18,16 @@ You can build the app with your smartphone using GitHub actions, and save it in ---- -### Build with a computer +### Build with Android Studio -You can build the app with your computer using Android Studio. +You can build the app with your computer using Android Studio. This used to be the only build option, nowadays Android Studio is mostly used by developers who consider making code changes. **[Follow these instructions.](./ComputerBuild.md)** +---- + +### Build using the command-line + +This option is intended for those who prefer to build AAPS in local command-line, without installing Android Studio. + +**[Follow these instructions.](./CLIBuild.md)** From b5b6e46f4bc165ea6367374b7d22d0259da2949a Mon Sep 17 00:00:00 2001 From: Milos Kozak Date: Tue, 17 Mar 2026 00:20:27 +0100 Subject: [PATCH 110/126] New translations computerbuild.md (Chinese Simplified) --- docs/CROWDIN/zh_CN/SettingUpAaps/ComputerBuild.md | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-) diff --git a/docs/CROWDIN/zh_CN/SettingUpAaps/ComputerBuild.md b/docs/CROWDIN/zh_CN/SettingUpAaps/ComputerBuild.md index 62b34b4d776e..69ce06718288 100644 --- a/docs/CROWDIN/zh_CN/SettingUpAaps/ComputerBuild.md +++ b/docs/CROWDIN/zh_CN/SettingUpAaps/ComputerBuild.md @@ -1,4 +1,6 @@ -# Computer Build + + +# Android Studio Build This is the traditional method to build your AAPS app. From b8ea066c07c90bd2bb562fe2fffe37dca2928ea8 Mon Sep 17 00:00:00 2001 From: Milos Kozak Date: Tue, 17 Mar 2026 00:20:31 +0100 Subject: [PATCH 111/126] New translations updatecomputerbuild.md (Chinese Simplified) --- docs/CROWDIN/zh_CN/Maintenance/UpdateComputerBuild.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/CROWDIN/zh_CN/Maintenance/UpdateComputerBuild.md b/docs/CROWDIN/zh_CN/Maintenance/UpdateComputerBuild.md index f39c2e102589..d4b8f22c58ac 100644 --- a/docs/CROWDIN/zh_CN/Maintenance/UpdateComputerBuild.md +++ b/docs/CROWDIN/zh_CN/Maintenance/UpdateComputerBuild.md @@ -1,4 +1,4 @@ -# Update with a computer +# Update with Android Studio ## 自行构建而非下载 @@ -8,7 +8,7 @@ 如果您想在新电脑上构建 **AAPS**：请将备份的密钥库文件复制到新电脑。 然后按照 [首次构建 **AAPS** 流程](../SettingUpAaps/BuildingAaps.md) 操作，而非本指南。 唯一区别在于您可以选择已复制的密钥库文件而无需新建。 ``` -## Overview for updating to a new version of AAPS with a computer +## Overview for updating to a new version of AAPS with Android Studio ```{contents} Steps for updating to a new version of AAPS :depth: 1 From 44e3cb9e5a3e4f7c5cf2342fd0b59cc272147657 Mon Sep 17 00:00:00 2001 From: Milos Kozak Date: Tue, 17 Mar 2026 00:22:27 +0100 Subject: [PATCH 112/126] New translations clibuild.md (Chinese Simplified) --- docs/CROWDIN/zh_CN/SettingUpAaps/CLIBuild.md | 54 ++++++++++++++++++++ 1 file changed, 54 insertions(+) create mode 100644 docs/CROWDIN/zh_CN/SettingUpAaps/CLIBuild.md diff --git a/docs/CROWDIN/zh_CN/SettingUpAaps/CLIBuild.md b/docs/CROWDIN/zh_CN/SettingUpAaps/CLIBuild.md new file mode 100644 index 000000000000..a800e1b69b91 --- /dev/null +++ b/docs/CROWDIN/zh_CN/SettingUpAaps/CLIBuild.md @@ -0,0 +1,54 @@ +# Build instructions for the command-line + +```{admonition} For users familiar with the command-line and git +:class: information + +The simplest option to build AAPS is the [Browser build](./BrowserBuild.md) alternative. +``` + +Tested with Fedora and Debian Linux, other systems should work with minimal adjustments. + +## 要求 + +Consult the minimum required Java version from [this table](#Building-APK-recommended-specification-of-computer-for-building-apk-file). Install the appropriate OpenJDK package using the system package manager. For example in Debian, the packages are named like `openjdk-21-jdk`. It should include `javac` and `keytool` binaries. + +Download the *Android Command line tools* package from the [Android Studio page](https://developer.android.com/studio#command-line-tools-only). Android Studio itself is not required. More information about installing this package is found in [sdkmanager docs](https://developer.android.com/tools/sdkmanager). After the package is installed, you should manually set two [environment variables](https://developer.android.com/tools/variables): `ANDROID_HOME` and `PATH`. Finally, run `sdkmanager --licenses` to finish the installation. + +## Building AAPS with Gradle wrapper + +### 1. Generate a Java keystore file for signing AAPS + +If you already have a keystore file for signing AAPS, reuse that. + +```sh +keytool -genkeypair -v \ + -keystore aaps-keystore.jks \ + -alias aaps-key \ + -keyalg RSA \ + -keysize 4096 \ + -validity 20000 +``` + +You will need the keystore file and passphrase every time you update AAPS. + +### 2. Compile the AAPS APK file + +Clone the [git repo](https://github.com/nightscout/AndroidAPS) if not already cloned. AAPS uses master branch for the latest stable version, ensure you are on the branch/tag you want to build. + +Run `./gradlew :app:assembleFullRelease` in the repo. It automatically downloads Gradle, dependencies, and then compiles the code. When the build succeeds, you should have an unsigned APK at `app/build/outputs/apk/full/release/app-full-release-unsigned.apk`. It should have also installed an `apksigner` binary to `$ANDROID_HOME`. Update your `PATH` again. + +### 3. Create a signed APK file from the unsigned one + + + +Change to your home directory and create a signed APK file: + +```sh +apksigner sign \ + --ks path/to/aaps-keystore.jks \ + --ks-key-alias aaps-key \ + --out app-full-release-signed.apk \ + ./AndroidAPS/app/build/outputs/apk/full/release/app-full-release-unsigned.apk +``` + +Now you have `app-full-release-signed.apk` ready for installation or upgrade. From 57956369fbb970ea674ec2df2c1259907d50350b Mon Sep 17 00:00:00 2001 From: Milos Kozak Date: Tue, 17 Mar 2026 00:22:37 +0100 Subject: [PATCH 113/126] New translations updatetonewversion.md (Chinese Traditional) --- docs/CROWDIN/zh_TW/Maintenance/UpdateToNewVersion.md | 6 +++++- 1 file changed, 5 insertions(+), 1 deletion(-) diff --git a/docs/CROWDIN/zh_TW/Maintenance/UpdateToNewVersion.md b/docs/CROWDIN/zh_TW/Maintenance/UpdateToNewVersion.md index 2ceba177a9a3..40127562ca40 100644 --- a/docs/CROWDIN/zh_TW/Maintenance/UpdateToNewVersion.md +++ b/docs/CROWDIN/zh_TW/Maintenance/UpdateToNewVersion.md @@ -16,10 +16,14 @@ 如果你已使用瀏覽器版本方法建置了 AAPS 應用程式，請遵循 [這些指示](./UpdateBrowserBuild.md)。 -## 使用電腦更新 AAPS +## Update AAPS with Android Studio 請遵循 [這些指示。](./UpdateComputerBuild.md) +## Update AAPS with the command-line + +Use the [same instructions](../SettingUpAaps/CLIBuild.md) as when building AAPS previously, but pull new changes with git. + (Update-to-new-version-check-aaps-version-on-phone)= ### 檢查手機上的 AAPS 版本 From 1b47c08f58936033df6907559a9b95bfb6114e60 Mon Sep 17 00:00:00 2001 From: Milos Kozak Date: Tue, 17 Mar 2026 00:26:14 +0100 Subject: [PATCH 114/126] New translations documentationupdate.md (Chinese Traditional) --- docs/CROWDIN/zh_TW/Maintenance/DocumentationUpdate.md | 5 +++++ 1 file changed, 5 insertions(+) diff --git a/docs/CROWDIN/zh_TW/Maintenance/DocumentationUpdate.md b/docs/CROWDIN/zh_TW/Maintenance/DocumentationUpdate.md index a96e57e46dcd..2216cc34f5f9 100644 --- a/docs/CROWDIN/zh_TW/Maintenance/DocumentationUpdate.md +++ b/docs/CROWDIN/zh_TW/Maintenance/DocumentationUpdate.md @@ -1,5 +1,10 @@ # 文件更新與變更 +## March 2026 + +- [Add CLI Build option](../SettingUpAaps/CLIBuild.md) @je-l +- Rename *Computer Build* to *Android Studio Build*. Preserve file names for URLs. + ## 2025年1月 - [3.4](#version3400) 版發佈與文件更新彙總（嚮導、電腦建置版本、組態建置工具） From 58c6300c25840eba507a2542c90686fc9bd041db Mon Sep 17 00:00:00 2001 From: Milos Kozak Date: Tue, 17 Mar 2026 00:26:43 +0100 Subject: [PATCH 115/126] New translations index.md (Chinese Traditional) --- docs/CROWDIN/zh_TW/index.md | 43 +++++++++++++++++++------------------ 1 file changed, 22 insertions(+), 21 deletions(-) diff --git a/docs/CROWDIN/zh_TW/index.md b/docs/CROWDIN/zh_TW/index.md index 8232fa988107..79569eb4d23c 100644 --- a/docs/CROWDIN/zh_TW/index.md +++ b/docs/CROWDIN/zh_TW/index.md @@ -84,21 +84,22 @@ AAPS 簡介 <./Getting-Started/Introduction.md> ``` ```{toctree} -:caption: 3) 設定 AAPS +:caption: 3) Setting up AAPS -設定報告伺服器 <./SettingUpAaps/SettingUpTheReportingServer.md> +Setting up the reporting server <./SettingUpAaps/SettingUpTheReportingServer.md> - Nightscout <./SettingUpAaps/Nightscout.md> - Tidepool <./SettingUpAaps/Tidepool.md> -建置 AAPS <./SettingUpAaps/BuildingAaps.md> -- 瀏覽器建置 <./SettingUpAaps/BrowserBuild.md> -- 電腦建置 <./SettingUpAaps/ComputerBuild.md> -傳輸和安裝 AAPS <./SettingUpAaps/TransferringAndInstallingAaps.md> -嚮導 <./SettingUpAaps/SetupWizard.md> -您的 AAPS 設定檔 <./SettingUpAaps/YourAapsProfile.md> -變更 AAPS 配置 <./SettingUpAaps/ChangeAapsConfiguration.md> -- 配置建構器 <./SettingUpAaps/ConfigBuilder.md> -- 偏好設定 <./SettingUpAaps/Preferences.md> -完成目標 <./SettingUpAaps/CompletingTheObjectives.md> +Building AAPS <./SettingUpAaps/BuildingAaps.md> +- Browser Build <./SettingUpAaps/BrowserBuild.md> +- Android Studio Build <./SettingUpAaps/ComputerBuild.md> +- CLI Build <./SettingUpAaps/CLIBuild.md> +Transferring and Installing AAPS <./SettingUpAaps/TransferringAndInstallingAaps.md> +Setup Wizard <./SettingUpAaps/SetupWizard.md> +Your AAPS Profile <./SettingUpAaps/YourAapsProfile.md> +Change AAPS configuration <./SettingUpAaps/ChangeAapsConfiguration.md> +- Config Builder <./SettingUpAaps/ConfigBuilder.md> +- Preferences <./SettingUpAaps/Preferences.md> +Completing the objectives <./SettingUpAaps/CompletingTheObjectives.md> ``` ```{toctree} @@ -141,15 +142,15 @@ AAPS for Wear OS <./WearOS/BuildingAapsWearOS.md> ``` ```{toctree} -:caption: 7) AAPS 維護 - -匯出/匯入設定 <./Maintenance/ExportImportSettings.md> -檢查您的資料 <./Maintenance/Reviewing.md> -AAPS 版本更新說明 <./Maintenance/ReleaseNotes.md> -文檔更新 <./Maintenance/DocumentationUpdate.md> -更新到新的 AAPS 版本 <./Maintenance/UpdateToNewVersion.md> -- 瀏覽器更新 <./Maintenance/UpdateBrowserBuild.md> -- 電腦更新 <./Maintenance/UpdateComputerBuild.md> +:caption: 7) Maintenance of AAPS + +Export/Import Settings <./Maintenance/ExportImportSettings.md> +Reviewing your data <./Maintenance/Reviewing.md> +AAPS Release Notes <./Maintenance/ReleaseNotes.md> +Documentation updates <./Maintenance/DocumentationUpdate.md> +Updating to a new version of AAPS <./Maintenance/UpdateToNewVersion.md> +- Browser Update <./Maintenance/UpdateBrowserBuild.md> +- Android Studio Update <./Maintenance/UpdateComputerBuild.md> ``` From 5d693bce9c0034ac93cc0921a411200711394894 Mon Sep 17 00:00:00 2001 From: Milos Kozak Date: Tue, 17 Mar 2026 00:29:35 +0100 Subject: [PATCH 116/126] New translations buildingaaps.md (Chinese Traditional) --- docs/CROWDIN/zh_TW/SettingUpAaps/BuildingAaps.md | 15 +++++++++++---- 1 file changed, 11 insertions(+), 4 deletions(-) diff --git a/docs/CROWDIN/zh_TW/SettingUpAaps/BuildingAaps.md b/docs/CROWDIN/zh_TW/SettingUpAaps/BuildingAaps.md index 93fbde1cccaf..e1aafdb1e51f 100644 --- a/docs/CROWDIN/zh_TW/SettingUpAaps/BuildingAaps.md +++ b/docs/CROWDIN/zh_TW/SettingUpAaps/BuildingAaps.md @@ -8,9 +8,9 @@ --- -提供兩種方法來建立 AAPS 應用程式： +Three methods are available to build the AAPS app: -### 使用瀏覽器建立 +### Build with a browser (recommended) 您可以使用 GitHub actions 在智慧型手機上建立應用程式，並將其儲存在 Google 雲端硬碟中。 @@ -18,9 +18,16 @@ ---- -### 使用電腦建立 +### Build with Android Studio -您可以使用 Android Studio 在電腦上建立應用程式。 +You can build the app with your computer using Android Studio. This used to be the only build option, nowadays Android Studio is mostly used by developers who consider making code changes. **[請按照這些指示進行操作。](./ComputerBuild.md)** +---- + +### Build using the command-line + +This option is intended for those who prefer to build AAPS in local command-line, without installing Android Studio. + +**[請按照這些指示進行操作。](./CLIBuild.md)** From a761b87ee23a4b5ccff2405b64517cb771f69c1c Mon Sep 17 00:00:00 2001 From: Milos Kozak Date: Tue, 17 Mar 2026 00:30:43 +0100 Subject: [PATCH 117/126] New translations computerbuild.md (Chinese Traditional) --- docs/CROWDIN/zh_TW/SettingUpAaps/ComputerBuild.md | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-) diff --git a/docs/CROWDIN/zh_TW/SettingUpAaps/ComputerBuild.md b/docs/CROWDIN/zh_TW/SettingUpAaps/ComputerBuild.md index 22abb9439e93..37cd3a434b4b 100644 --- a/docs/CROWDIN/zh_TW/SettingUpAaps/ComputerBuild.md +++ b/docs/CROWDIN/zh_TW/SettingUpAaps/ComputerBuild.md @@ -1,4 +1,6 @@ -# 電腦建立 + + +# Android Studio Build 這是傳統的方法來建立您的 AAPS 應用程式。 From 7780d20f94c6546666798c13e1af702313bcb1c4 Mon Sep 17 00:00:00 2001 From: Milos Kozak Date: Tue, 17 Mar 2026 00:30:48 +0100 Subject: [PATCH 118/126] New translations updatecomputerbuild.md (Chinese Traditional) --- docs/CROWDIN/zh_TW/Maintenance/UpdateComputerBuild.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/CROWDIN/zh_TW/Maintenance/UpdateComputerBuild.md b/docs/CROWDIN/zh_TW/Maintenance/UpdateComputerBuild.md index 04cecde9d0db..f8d3f844d24e 100644 --- a/docs/CROWDIN/zh_TW/Maintenance/UpdateComputerBuild.md +++ b/docs/CROWDIN/zh_TW/Maintenance/UpdateComputerBuild.md @@ -1,4 +1,4 @@ -# 透過電腦進行更新 +# Update with Android Studio ## 自行建置，而不是下載 @@ -8,7 +8,7 @@ 如果你想在新電腦上建立 **AAPS**：請將你的備份金鑰存檔複製到新電腦上。 然後按照 [初始建置 **AAPS** 程序](../SettingUpAaps/BuildingAaps.md) 的步驟，而不是這個指導。 唯一的不同之處在於，你可以選擇你在新電腦上複製的金鑰存檔，而不必建立新的金鑰存檔。 ``` -## 使用電腦更新 AAPS 的總覽 +## Overview for updating to a new version of AAPS with Android Studio ```{contents} Steps for updating to a new version of AAPS :depth: 1 From 585097a0257fcd06acbd3a1a0548ef8c00b7ef36 Mon Sep 17 00:00:00 2001 From: Milos Kozak Date: Tue, 17 Mar 2026 00:32:53 +0100 Subject: [PATCH 119/126] New translations clibuild.md (Chinese Traditional) --- docs/CROWDIN/zh_TW/SettingUpAaps/CLIBuild.md | 54 ++++++++++++++++++++ 1 file changed, 54 insertions(+) create mode 100644 docs/CROWDIN/zh_TW/SettingUpAaps/CLIBuild.md diff --git a/docs/CROWDIN/zh_TW/SettingUpAaps/CLIBuild.md b/docs/CROWDIN/zh_TW/SettingUpAaps/CLIBuild.md new file mode 100644 index 000000000000..bc0c361ef399 --- /dev/null +++ b/docs/CROWDIN/zh_TW/SettingUpAaps/CLIBuild.md @@ -0,0 +1,54 @@ +# Build instructions for the command-line + +```{admonition} For users familiar with the command-line and git +:class: information + +The simplest option to build AAPS is the [Browser build](./BrowserBuild.md) alternative. +``` + +Tested with Fedora and Debian Linux, other systems should work with minimal adjustments. + +## 需求 + +Consult the minimum required Java version from [this table](#Building-APK-recommended-specification-of-computer-for-building-apk-file). Install the appropriate OpenJDK package using the system package manager. For example in Debian, the packages are named like `openjdk-21-jdk`. It should include `javac` and `keytool` binaries. + +Download the *Android Command line tools* package from the [Android Studio page](https://developer.android.com/studio#command-line-tools-only). Android Studio itself is not required. More information about installing this package is found in [sdkmanager docs](https://developer.android.com/tools/sdkmanager). After the package is installed, you should manually set two [environment variables](https://developer.android.com/tools/variables): `ANDROID_HOME` and `PATH`. Finally, run `sdkmanager --licenses` to finish the installation. + +## Building AAPS with Gradle wrapper + +### 1. Generate a Java keystore file for signing AAPS + +If you already have a keystore file for signing AAPS, reuse that. + +```sh +keytool -genkeypair -v \ + -keystore aaps-keystore.jks \ + -alias aaps-key \ + -keyalg RSA \ + -keysize 4096 \ + -validity 20000 +``` + +You will need the keystore file and passphrase every time you update AAPS. + +### 2. Compile the AAPS APK file + +Clone the [git repo](https://github.com/nightscout/AndroidAPS) if not already cloned. AAPS uses master branch for the latest stable version, ensure you are on the branch/tag you want to build. + +Run `./gradlew :app:assembleFullRelease` in the repo. It automatically downloads Gradle, dependencies, and then compiles the code. When the build succeeds, you should have an unsigned APK at `app/build/outputs/apk/full/release/app-full-release-unsigned.apk`. It should have also installed an `apksigner` binary to `$ANDROID_HOME`. Update your `PATH` again. + +### 3. Create a signed APK file from the unsigned one + + + +Change to your home directory and create a signed APK file: + +```sh +apksigner sign \ + --ks path/to/aaps-keystore.jks \ + --ks-key-alias aaps-key \ + --out app-full-release-signed.apk \ + ./AndroidAPS/app/build/outputs/apk/full/release/app-full-release-unsigned.apk +``` + +Now you have `app-full-release-signed.apk` ready for installation or upgrade. From 569a2940b6494f971b723929d3178428bafde3fb Mon Sep 17 00:00:00 2001 From: Milos Kozak Date: Tue, 17 Mar 2026 00:33:04 +0100 Subject: [PATCH 120/126] New translations updatetonewversion.md (Portuguese, Brazilian) --- docs/CROWDIN/pb/Maintenance/UpdateToNewVersion.md | 6 +++++- 1 file changed, 5 insertions(+), 1 deletion(-) diff --git a/docs/CROWDIN/pb/Maintenance/UpdateToNewVersion.md b/docs/CROWDIN/pb/Maintenance/UpdateToNewVersion.md index 4a290089964a..bb94b8025194 100644 --- a/docs/CROWDIN/pb/Maintenance/UpdateToNewVersion.md +++ b/docs/CROWDIN/pb/Maintenance/UpdateToNewVersion.md @@ -16,10 +16,14 @@ If you already built your AAPS app with the Browser Build method, follow [these instructions](./UpdateBrowserBuild.md). -## Update AAPS with a computer +## Update AAPS with Android Studio Follow [these instructions.](./UpdateComputerBuild.md). +## Update AAPS with the command-line + +Use the [same instructions](../SettingUpAaps/CLIBuild.md) as when building AAPS previously, but pull new changes with git. + (Update-to-new-version-check-aaps-version-on-phone)= ### Check AAPS version on phone From e42a595a510e57e18a2d8e4d66d6fdaf7c9a9fb4 Mon Sep 17 00:00:00 2001 From: Milos Kozak Date: Tue, 17 Mar 2026 00:36:42 +0100 Subject: [PATCH 121/126] New translations documentationupdate.md (Portuguese, Brazilian) --- docs/CROWDIN/pb/Maintenance/DocumentationUpdate.md | 5 +++++ 1 file changed, 5 insertions(+) diff --git a/docs/CROWDIN/pb/Maintenance/DocumentationUpdate.md b/docs/CROWDIN/pb/Maintenance/DocumentationUpdate.md index bcab53cb3ee4..ccbba16ade7a 100644 --- a/docs/CROWDIN/pb/Maintenance/DocumentationUpdate.md +++ b/docs/CROWDIN/pb/Maintenance/DocumentationUpdate.md @@ -1,5 +1,10 @@ # Docs updates & changes +## March 2026 + +- [Add CLI Build option](../SettingUpAaps/CLIBuild.md) @je-l +- Rename *Computer Build* to *Android Studio Build*. Preserve file names for URLs. + ## January 2025 - [3.4](#version3400) release and documentation update roll-up (Wizard, Computer build versions, Config Builder) From 2d97c8bd26d70d2fd34eb9ce5b5902487dc5495e Mon Sep 17 00:00:00 2001 From: Milos Kozak Date: Tue, 17 Mar 2026 00:37:11 +0100 Subject: [PATCH 122/126] New translations index.md (Portuguese, Brazilian) --- docs/CROWDIN/pb/index.md | 5 +++-- 1 file changed, 3 insertions(+), 2 deletions(-) diff --git a/docs/CROWDIN/pb/index.md b/docs/CROWDIN/pb/index.md index 20b8f1837d2e..fc583173843e 100644 --- a/docs/CROWDIN/pb/index.md +++ b/docs/CROWDIN/pb/index.md @@ -91,7 +91,8 @@ Setting up the reporting server <./SettingUpAaps/SettingUpTheReportingServer.md> - Tidepool <./SettingUpAaps/Tidepool.md> Building AAPS <./SettingUpAaps/BuildingAaps.md> - Browser Build <./SettingUpAaps/BrowserBuild.md> -- Computer Build <./SettingUpAaps/ComputerBuild.md> +- Android Studio Build <./SettingUpAaps/ComputerBuild.md> +- CLI Build <./SettingUpAaps/CLIBuild.md> Transferring and Installing AAPS <./SettingUpAaps/TransferringAndInstallingAaps.md> Setup Wizard <./SettingUpAaps/SetupWizard.md> Your AAPS Profile <./SettingUpAaps/YourAapsProfile.md> @@ -149,7 +150,7 @@ AAPS Release Notes <./Maintenance/ReleaseNotes.md> Documentation updates <./Maintenance/DocumentationUpdate.md> Updating to a new version of AAPS <./Maintenance/UpdateToNewVersion.md> - Browser Update <./Maintenance/UpdateBrowserBuild.md> -- Computer Update <./Maintenance/UpdateComputerBuild.md> +- Android Studio Update <./Maintenance/UpdateComputerBuild.md> ``` From 271b57a62425afc6dca2b8cf95ab8234d30ee772 Mon Sep 17 00:00:00 2001 From: Milos Kozak Date: Tue, 17 Mar 2026 00:39:55 +0100 Subject: [PATCH 123/126] New translations buildingaaps.md (Portuguese, Brazilian) --- docs/CROWDIN/pb/SettingUpAaps/BuildingAaps.md | 15 +++++++++++---- 1 file changed, 11 insertions(+), 4 deletions(-) diff --git a/docs/CROWDIN/pb/SettingUpAaps/BuildingAaps.md b/docs/CROWDIN/pb/SettingUpAaps/BuildingAaps.md index aa95e0cf7c3a..97d38551b766 100644 --- a/docs/CROWDIN/pb/SettingUpAaps/BuildingAaps.md +++ b/docs/CROWDIN/pb/SettingUpAaps/BuildingAaps.md @@ -8,9 +8,9 @@ See [FAQ page](../UsefulLinks/FAQ.md) for details. --- -Two methods are available to build the AAPS app: +Three methods are available to build the AAPS app: -### Build with a browser +### Build with a browser (recommended) You can build the app with your smartphone using GitHub actions, and save it in your Google Drive. @@ -18,9 +18,16 @@ You can build the app with your smartphone using GitHub actions, and save it in ---- -### Build with a computer +### Build with Android Studio -You can build the app with your computer using Android Studio. +You can build the app with your computer using Android Studio. This used to be the only build option, nowadays Android Studio is mostly used by developers who consider making code changes. **[Follow these instructions.](./ComputerBuild.md)** +---- + +### Build using the command-line + +This option is intended for those who prefer to build AAPS in local command-line, without installing Android Studio. + +**[Follow these instructions.](./CLIBuild.md)** From ac60c308d2485f7f3e62dec700edfd4cc974efc1 Mon Sep 17 00:00:00 2001 From: Milos Kozak Date: Tue, 17 Mar 2026 00:41:00 +0100 Subject: [PATCH 124/126] New translations computerbuild.md (Portuguese, Brazilian) --- docs/CROWDIN/pb/SettingUpAaps/ComputerBuild.md | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-) diff --git a/docs/CROWDIN/pb/SettingUpAaps/ComputerBuild.md b/docs/CROWDIN/pb/SettingUpAaps/ComputerBuild.md index 4a8952c657d8..4a1ec5606bdc 100644 --- a/docs/CROWDIN/pb/SettingUpAaps/ComputerBuild.md +++ b/docs/CROWDIN/pb/SettingUpAaps/ComputerBuild.md @@ -1,4 +1,6 @@ -# Computer Build + + +# Android Studio Build This is the traditional method to build your AAPS app. From e731ac818fe58924cf735e66c8b605d55ca29f77 Mon Sep 17 00:00:00 2001 From: Milos Kozak Date: Tue, 17 Mar 2026 00:41:03 +0100 Subject: [PATCH 125/126] New translations updatecomputerbuild.md (Portuguese, Brazilian) --- docs/CROWDIN/pb/Maintenance/UpdateComputerBuild.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/CROWDIN/pb/Maintenance/UpdateComputerBuild.md b/docs/CROWDIN/pb/Maintenance/UpdateComputerBuild.md index 6a55381526f5..5382357cc05a 100644 --- a/docs/CROWDIN/pb/Maintenance/UpdateComputerBuild.md +++ b/docs/CROWDIN/pb/Maintenance/UpdateComputerBuild.md @@ -1,4 +1,4 @@ -# Update with a computer +# Update with Android Studio ## Build yourself instead of download @@ -8,7 +8,7 @@ In case you want to build **AAPS** on a new computer : copy your back-up keystore file to the new computer. Then follow the [Initial build **AAPS** procedure](../SettingUpAaps/BuildingAaps.md) instead of this guide. With the only difference that instead of creating a new keystore, you can select the one you have copied on the new computer. ``` -## Overview for updating to a new version of AAPS with a computer +## Overview for updating to a new version of AAPS with Android Studio ```{contents} Steps for updating to a new version of AAPS :depth: 1 From e836028937f404e7f4ddaaefda33b6fd79e8f062 Mon Sep 17 00:00:00 2001 From: Milos Kozak Date: Tue, 17 Mar 2026 00:42:58 +0100 Subject: [PATCH 126/126] New translations clibuild.md (Portuguese, Brazilian) --- docs/CROWDIN/pb/SettingUpAaps/CLIBuild.md | 54 +++++++++++++++++++++++ 1 file changed, 54 insertions(+) create mode 100644 docs/CROWDIN/pb/SettingUpAaps/CLIBuild.md diff --git a/docs/CROWDIN/pb/SettingUpAaps/CLIBuild.md b/docs/CROWDIN/pb/SettingUpAaps/CLIBuild.md new file mode 100644 index 000000000000..91bcee48b1db --- /dev/null +++ b/docs/CROWDIN/pb/SettingUpAaps/CLIBuild.md @@ -0,0 +1,54 @@ +# Build instructions for the command-line + +```{admonition} For users familiar with the command-line and git +:class: information + +The simplest option to build AAPS is the [Browser build](./BrowserBuild.md) alternative. +``` + +Tested with Fedora and Debian Linux, other systems should work with minimal adjustments. + +## Requirements + +Consult the minimum required Java version from [this table](#Building-APK-recommended-specification-of-computer-for-building-apk-file). Install the appropriate OpenJDK package using the system package manager. For example in Debian, the packages are named like `openjdk-21-jdk`. It should include `javac` and `keytool` binaries. + +Download the *Android Command line tools* package from the [Android Studio page](https://developer.android.com/studio#command-line-tools-only). Android Studio itself is not required. More information about installing this package is found in [sdkmanager docs](https://developer.android.com/tools/sdkmanager). After the package is installed, you should manually set two [environment variables](https://developer.android.com/tools/variables): `ANDROID_HOME` and `PATH`. Finally, run `sdkmanager --licenses` to finish the installation. + +## Building AAPS with Gradle wrapper + +### 1. Generate a Java keystore file for signing AAPS + +If you already have a keystore file for signing AAPS, reuse that. + +```sh +keytool -genkeypair -v \ + -keystore aaps-keystore.jks \ + -alias aaps-key \ + -keyalg RSA \ + -keysize 4096 \ + -validity 20000 +``` + +You will need the keystore file and passphrase every time you update AAPS. + +### 2. Compile the AAPS APK file + +Clone the [git repo](https://github.com/nightscout/AndroidAPS) if not already cloned. AAPS uses master branch for the latest stable version, ensure you are on the branch/tag you want to build. + +Run `./gradlew :app:assembleFullRelease` in the repo. It automatically downloads Gradle, dependencies, and then compiles the code. When the build succeeds, you should have an unsigned APK at `app/build/outputs/apk/full/release/app-full-release-unsigned.apk`. It should have also installed an `apksigner` binary to `$ANDROID_HOME`. Update your `PATH` again. + +### 3. Create a signed APK file from the unsigned one + + + +Change to your home directory and create a signed APK file: + +```sh +apksigner sign \ + --ks path/to/aaps-keystore.jks \ + --ks-key-alias aaps-key \ + --out app-full-release-signed.apk \ + ./AndroidAPS/app/build/outputs/apk/full/release/app-full-release-unsigned.apk +``` + +Now you have `app-full-release-signed.apk` ready for installation or upgrade.