diff --git a/docs/CROWDIN/cs/Maintenance/DocumentationUpdate.md b/docs/CROWDIN/cs/Maintenance/DocumentationUpdate.md index 1a409cffb9be..4d9002828b90 100644 --- a/docs/CROWDIN/cs/Maintenance/DocumentationUpdate.md +++ b/docs/CROWDIN/cs/Maintenance/DocumentationUpdate.md @@ -4,7 +4,7 @@ - Updated versions and Android Studio prerequisites - Added [3.3.2.1](#version3321) release, removed Android 16 references (fixed) -- Added [Browser Build](browser-build) @Angus +- Added [Browser Build](#browser-build) @Angus ## May 2025 diff --git a/docs/CROWDIN/cs/Maintenance/ReleaseNotes.md b/docs/CROWDIN/cs/Maintenance/ReleaseNotes.md index 5781616e3413..302043e1d300 100644 --- a/docs/CROWDIN/cs/Maintenance/ReleaseNotes.md +++ b/docs/CROWDIN/cs/Maintenance/ReleaseNotes.md @@ -55,6 +55,8 @@ Aby bylo uživatelům se starším Androidem umožněno používat starší verz WearOS 5, API level 34 (Android 14) has [limitations](#BuildingAapsWearOs-WearOS5). ``` +(latestrelease)= + (version3321)= ## Version 3.3.2.1 diff --git a/docs/CROWDIN/cs/Maintenance/UpdateBrowserBuild.md b/docs/CROWDIN/cs/Maintenance/UpdateBrowserBuild.md new file mode 100644 index 000000000000..1a48327da29b --- /dev/null +++ b/docs/CROWDIN/cs/Maintenance/UpdateBrowserBuild.md @@ -0,0 +1,101 @@ +# Update with a browser + +## Vyrobte si místo stažení + +**AAPS** is not available to download, due to regulations concerning medical devices. Je legální vytvořit aplikaci pro své vlastní použití, ale nesmíte dát kopii ostatním! See [FAQ page](../UsefulLinks/FAQ.md) for details. + +```{note} +In case you want to upgrade **AAPS** with a browser for the first time : copy your back-up keystore file to your Google Drive. Then follow the [Browser Build **AAPS** procedure](../SettingUpAaps/BrowserBuild.md) instead of this guide. Instead of creating a new keystore, you must select the one you have copied from your computer. +This operation will be mandatory only the first time, then for successive upgrades you will be able to follow this guide. +``` + +## Overview for updating to a new version of AAPS with a browser + +```{contents} Steps for updating to a new version of AAPS +:depth: 1 +:local: true +``` + +In case you experience problems, see separate page for [troubleshooting Android Studio](../GettingHelp/TroubleshootingAndroidStudio). + +### Export your settings + +Export your settings from the existing **AAPS** version on your phone. You might not need it, but better be safe than sorry. + +See the [Export & import settings](ExportImportSettings.md) page if you don't remember how to do this. + +(Update-to-new-version-update-your-repo)= +### Update your GitHub repository + +```{admonition} WARNING +:class: warning +Browser Build is available from AAPS version 3.3.2.1. +``` + +[Log into GitHub](https://github.com/login). + +1. Select Repositories. +2. Scroll down and select your own AndroidAPS repository. + +![Select AndroidAPS repo](../images/update/CI/GitHubUpdate1.png) + +3. Verify you are using your own copy of AndroidAPS (Forked from nightscout/AndroidAPS) +4. Tap Sync Fork to update it (the number of commits behind might differ from the picture) + + + +![Sync AndroidAPS repo](../images/update/CI/GitHubUpdate2.png) + +5. Tap Update Branch + +![Update AndroidAPS repo](../images/update/CI/GitHubUpdate3.png) + +Note: if you have modified your copy of AndroidAPS by mistake, you will see this screen. Discard all changes (commits) to return to the released version. + +![Discard rogue modifications](../images/update/CI/GitHubUpdate4.png) + +You have now synchronized (updated) your own copy with the latest release of Android APS. Good job. + +![Repo sync'ed](../images/update/CI/GitHubUpdate5.png) + +### Run the Workflow to Build the Signed APK + +1. In your GitHub copy of AndroidAPS, select Actions. +2. Expand All Workflows. +3. Select AAPS-CI + +![Actions AAPS-CI](../images/update/CI/GitHubActions1.png) + +4. Scroll down and tap Run Workflow. + +![Run Workflow](../images/update/CI/GitHubActions2.png) + +5. Select the branch you want to deploy (master), the [variant](variant) (fullRelease) and tap Run Workflow. + + + +![Run Workflow](../images/update/CI/GitHubActions3.png) + +6. You will see the message Workflow run was successfully requested. Refresh your browser page and you will be able to monitor the build progress. When the action completes, the AAPS CI action will show a green tick mark. You have successfully built the updated version of Android APS. + +![Monitor Workflow](../images/update/CI/GitHubActions4.png) + +### Install the AAPS APK + +1. Open your Google Drive +2. Browse into AAPS, select the new version folder and you will find both the phone and Android Wear versions. + +![Google Drive Location](../images/update/CI/GitHubActions5.png) + + +Continue [here](#Update-to-new-version-check-aaps-version-on-phone) + +## Troubleshooting + +If anything goes wrong, don't panic. + +Take a breath! + +Then see the [troubleshooting tips](#aaps-ci-preparation) if your problem is already documented! + +If you need further help, please reach out to other **AAPS** users on [Facebook](https://www.facebook.com/groups/AndroidAPSUsers) or [Discord](https://discord.gg/4fQUWHZ4Mw). \ No newline at end of file diff --git a/docs/CROWDIN/cs/Maintenance/UpdateComputerBuild.md b/docs/CROWDIN/cs/Maintenance/UpdateComputerBuild.md new file mode 100644 index 000000000000..be68ba5cda2b --- /dev/null +++ b/docs/CROWDIN/cs/Maintenance/UpdateComputerBuild.md @@ -0,0 +1,103 @@ +# Update with a computer + +## Vyrobte si místo stažení + +**AAPS** is not available to download, due to regulations concerning medical devices. Je legální vytvořit aplikaci pro své vlastní použití, ale nesmíte dát kopii ostatním! See [FAQ page](../UsefulLinks/FAQ.md) for details. + +```{note} +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 + +```{contents} Steps for updating to a new version of AAPS +:depth: 1 +:local: true +``` + +In case you experience problems, see separate page for [troubleshooting Android Studio](../GettingHelp/TroubleshootingAndroidStudio). + +### Export your settings + +Export your settings from the existing **AAPS** version on your phone. You might not need it, but better be safe than sorry. + +See the [Export & import settings](ExportImportSettings.md) page if you don't remember how to do this. + +### Check your Android Studio version + +The minimal version required is described in the [Building Instructions](#Building-APK-recommended-specification-of-computer-for-building-apk-file). If your version is older, please [update Android Studio first](#Building-APK-install-android-studio)! + +(Update-to-new-version-update-your-local-copy)= +### Update your local copy + +```{admonition} WARNING +:class: warning +If you update from versions prior to 2.8.x, please follow the instructions to do a [New clone](../SettingUpAaps/BuildingAaps.md), as this guide will not work for you! +``` + +* Open your existing AAPS project with Android Studio. You might need to select your project. (Double) click on the AAPS project. + + ![Android Studio - Select Project](../images/update/01_ProjectSelection.png) + +* In the menu bar of Android Studio, select Git -> Fetch + + ![Android Studio Menu - Git - Fetch](../images/update/02_GitFetch.png) + +* You will see a message in the lower right corner that Fetch was successful. + + ![Android Studio Menu - Git - Fetch successful](../images/update/03_GitFetchSuccessful.png) + +* In the menu bar, now select Git -> Pull + + ![Android Studio Menu - Git - Pull](../images/update/04_GitPull.png) + +* Leave all options as they are (origin/master) and select Pull + + ![Android Studio - Git - Pull dialog](../images/update/05_GitPullOptions.png) + +* Wait while download is in progress, you will see this as info in the bottom bar. When it's done, you will see a success message. + + ```{note} + The files that were updated may vary! This is not an indication + ``` + + ![Android Studio - Pull successful](../images/update/06_GitPullSuccess.png) + +* Gradle Sync will be running to download some dependencies. Wait until it is finished. + + ![Android Studio - Gradle Sync](../images/studioSetup/40_BackgroundTasks.png) + +### Check JVM version + +This check is particularly indicated if you have already built a previous version of **AAPS** on the same computer. + +Check in the [Building Instructions](#Building-APK-recommended-specification-of-computer-for-building-apk-file) the required version for JVM, matching the **AAPS** version you are now building. Then follow the steps described at [Incompatible Gradle JVM](#incompatible-gradle-jvm) to make sure you currently use the correct version. + +(Update-to-new-version-build-the-signed-apk)= +### Build the Signed APK + +Your sourcecode is now the current released version, and all prerequisites have been checked. It's time to build the signed apk as described in the [build signed apk section](#Building-APK-generate-signed-apk). + +(Update-to-new-version-transfer-and-install)= + +### Transfer and install the apk +You need to transfer the apk to your phone so you can install it. + +```{note} +If you completed the build with the same existing key store in Android Studio, then you do not need to remove the existing app on your phone. When you install the apk, follow the prompts to install updates. +For other scenarios such as establishing a new key store in Android Studio for your signed apk, you will need to delete the old app before installing the apk. **Make sure to export your settings!** +``` + +See the instructions for [transferring and installing AAPS](../SettingUpAaps/TransferringAndInstallingAaps.md) + +Continue [here](#Update-to-new-version-check-aaps-version-on-phone). + +## Troubleshooting + +If anything goes wrong, don't panic. + +Take a breath! + +Then see the separate page [troubleshooting Android Studio](../GettingHelp/TroubleshootingAndroidStudio) if your problem is already documented! + +If you need further help, please reach out to other **AAPS** users on [Facebook](https://www.facebook.com/groups/AndroidAPSUsers) or [Discord](https://discord.gg/4fQUWHZ4Mw). \ No newline at end of file diff --git a/docs/CROWDIN/cs/Maintenance/UpdateToNewVersion.md b/docs/CROWDIN/cs/Maintenance/UpdateToNewVersion.md index a311cb6325d2..17cbeaebb640 100644 --- a/docs/CROWDIN/cs/Maintenance/UpdateToNewVersion.md +++ b/docs/CROWDIN/cs/Maintenance/UpdateToNewVersion.md @@ -10,91 +10,14 @@ * When a new release is available, in the **AAPS** app itself, you will receive an information banner about the new version. * The new version will also be announced on Facebook at the time of release. * Following the release, please read the [Release Notes](ReleaseNotes.md) in detail, and clarify any queries with the community on Facebook or Discord, before proceeding with the update. - - ```{note} - 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 +## Update AAPS with browser build -```{contents} Steps for updating to a new version of AAPS :depth: 1 :local: true +If you already built your AAPS app with the Browser Build method, follow [these instructions](./UpdateBrowserBuild.md). -
In case you experience problems, see separate page for [troubleshooting Android Studio](../GettingHelp/TroubleshootingAndroidStudio). - - ### Export your settings - - Export your settings from the existing **AAPS** version on your phone. You might not need it, but better be safe than sorry. - - See the [Export & import settings](ExportImportSettings.md) page if you don't remember how to do this. - - ### Check your Android Studio version - - The minimal version required is described in the [Building Instructions](#Building-APK-recommended-specification-of-computer-for-building-apk-file). If your version is older, please [update Android Studio first](#Building-APK-install-android-studio)! - - (Update-to-new-version-update-your-local-copy)= - ### Update your local copy - - ```{admonition} WARNING - :class: warning - If you update from versions prior to 2.8.x, please follow the instructions to do a [New clone](../SettingUpAaps/BuildingAaps.md), as this guide will not work for you! - +## Update AAPS with a computer -* Open your existing AAPS project with Android Studio. You might need to select your project. (Double) click on the AAPS project. - - ![Android Studio - Select Project](../images/update/01_ProjectSelection.png) - -* In the menu bar of Android Studio, select Git -> Fetch - - ![Android Studio Menu - Git - Fetch](../images/update/02_GitFetch.png) - -* You will see a message in the lower right corner that Fetch was successful. - - ![Android Studio Menu - Git - Fetch successful](../images/update/03_GitFetchSuccessful.png) - -* In the menu bar, now select Git -> Pull - - ![Android Studio Menu - Git - Pull](../images/update/04_GitPull.png) - -* Leave all options as they are (origin/master) and select Pull - - ![Android Studio - Git - Pull dialog](../images/update/05_GitPullOptions.png) - -* Wait while download is in progress, you will see this as info in the bottom bar. When it's done, you will see a success message. - - ```{note} - The files that were updated may vary! This is not an indication - ``` - - ![Android Studio - Pull successful](../images/update/06_GitPullSuccess.png) - -* Gradle Sync will be running to download some dependencies. Wait until it is finished. - - ![Android Studio - Gradle Sync](../images/studioSetup/40_BackgroundTasks.png) - -### Check JVM version - -This check is particularly indicated if you have already built a previous version of **AAPS** on the same computer. - -Check in the [Building Instructions](#Building-APK-recommended-specification-of-computer-for-building-apk-file) the required version for JVM, matching the **AAPS** version you are now building. Then follow the steps described at [Incompatible Gradle JVM](#incompatible-gradle-jvm) to make sure you currently use the correct version. - -(Update-to-new-version-build-the-signed-apk)= - -### Build the Signed APK - -Your sourcecode is now the current released version, and all prerequisites have been checked. It's time to build the signed apk as described in the [build signed apk section](#Building-APK-generate-signed-apk). - -(Update-to-new-version-transfer-and-install)= - -### Transfer and install the apk - -You need to transfer the apk to your phone so you can install it. - -```{note} -If you completed the build with the same existing key store in Android Studio, then you do not need to remove the existing app on your phone. When you install the apk, follow the prompts to install updates. -For other scenarios such as establishing a new key store in Android Studio for your signed apk, you will need to delete the old app before installing the apk. **Make sure to export your settings!** -``` - -See the instructions for [transferring and installing AAPS](../SettingUpAaps/TransferringAndInstallingAaps.md) +Follow [these instructions.](./UpdateComputerBuild.md). (Update-to-new-version-check-aaps-version-on-phone)= @@ -104,14 +27,4 @@ After you installed the new apk, you can check the AAPS version on your phone by ![Nainstalovaná verze AAPS](../images/Update_VersionCheck.png) -Check in the [Release Notes](../Maintenance/ReleaseNotes.md) if there are any specific instructions after update. - -## Troubleshooting - -If anything goes wrong, don't panic. - -Take a breath! - -Then see the separate page [troubleshooting Android Studio](../GettingHelp/TroubleshootingAndroidStudio) if your problem is already documented! - -If you need further help, please reach out to other **AAPS** users on [Facebook](https://www.facebook.com/groups/AndroidAPSUsers) or [Discord](https://discord.gg/4fQUWHZ4Mw). \ No newline at end of file +Check in the [Release Notes](../Maintenance/ReleaseNotes.md) if there are any specific instructions after update. \ No newline at end of file diff --git a/docs/CROWDIN/cs/SettingUpAaps/BrowserBuild.md b/docs/CROWDIN/cs/SettingUpAaps/BrowserBuild.md index 673a609a65c5..90db139eedf0 100644 --- a/docs/CROWDIN/cs/SettingUpAaps/BrowserBuild.md +++ b/docs/CROWDIN/cs/SettingUpAaps/BrowserBuild.md @@ -1,3 +1,5 @@ +(browser-build)= + # Browser build Building AAPS with GitHub Actions. diff --git a/docs/CROWDIN/cs/images/Building-the-App/CI/aaps_ci_simple_http_server.png b/docs/CROWDIN/cs/images/Building-the-App/CI/aaps_ci_simple_http_server.png index 95ac2d4eb443..2e2fb47e5ca2 100644 Binary files a/docs/CROWDIN/cs/images/Building-the-App/CI/aaps_ci_simple_http_server.png and b/docs/CROWDIN/cs/images/Building-the-App/CI/aaps_ci_simple_http_server.png differ diff --git a/docs/CROWDIN/cs/images/Building-the-App/CI/aaps_ci_simple_http_server_step1.png b/docs/CROWDIN/cs/images/Building-the-App/CI/aaps_ci_simple_http_server_step1.png index 78f52682b58d..b348162dcb1c 100644 Binary files a/docs/CROWDIN/cs/images/Building-the-App/CI/aaps_ci_simple_http_server_step1.png and b/docs/CROWDIN/cs/images/Building-the-App/CI/aaps_ci_simple_http_server_step1.png differ diff --git a/docs/CROWDIN/cs/images/Building-the-App/CI/aaps_ci_simple_http_server_step2.png b/docs/CROWDIN/cs/images/Building-the-App/CI/aaps_ci_simple_http_server_step2.png index c292ac667f63..cabadeefb97a 100644 Binary files a/docs/CROWDIN/cs/images/Building-the-App/CI/aaps_ci_simple_http_server_step2.png and b/docs/CROWDIN/cs/images/Building-the-App/CI/aaps_ci_simple_http_server_step2.png differ diff --git a/docs/CROWDIN/cs/images/Building-the-App/CI/aaps_ci_simple_http_server_step3.png b/docs/CROWDIN/cs/images/Building-the-App/CI/aaps_ci_simple_http_server_step3.png index bd31cd0ffb3d..9a26d3526369 100644 Binary files a/docs/CROWDIN/cs/images/Building-the-App/CI/aaps_ci_simple_http_server_step3.png and b/docs/CROWDIN/cs/images/Building-the-App/CI/aaps_ci_simple_http_server_step3.png differ diff --git a/docs/CROWDIN/cs/images/Building-the-App/CI/aaps_ci_simple_http_server_step4.png b/docs/CROWDIN/cs/images/Building-the-App/CI/aaps_ci_simple_http_server_step4.png index cc187ec72a14..285492424351 100644 Binary files a/docs/CROWDIN/cs/images/Building-the-App/CI/aaps_ci_simple_http_server_step4.png and b/docs/CROWDIN/cs/images/Building-the-App/CI/aaps_ci_simple_http_server_step4.png differ diff --git a/docs/CROWDIN/cs/images/Building-the-App/CI/aaps_ci_simple_http_server_store.png b/docs/CROWDIN/cs/images/Building-the-App/CI/aaps_ci_simple_http_server_store.png index 4b157ca8d3d8..65bf101f55e4 100644 Binary files a/docs/CROWDIN/cs/images/Building-the-App/CI/aaps_ci_simple_http_server_store.png and b/docs/CROWDIN/cs/images/Building-the-App/CI/aaps_ci_simple_http_server_store.png differ diff --git a/docs/CROWDIN/cs/images/update/CI/GitHubActions1.png b/docs/CROWDIN/cs/images/update/CI/GitHubActions1.png new file mode 100644 index 000000000000..e04ce6e76d8b Binary files /dev/null and b/docs/CROWDIN/cs/images/update/CI/GitHubActions1.png differ diff --git a/docs/CROWDIN/cs/images/update/CI/GitHubActions2.png b/docs/CROWDIN/cs/images/update/CI/GitHubActions2.png new file mode 100644 index 000000000000..7b5c5a842d16 Binary files /dev/null and b/docs/CROWDIN/cs/images/update/CI/GitHubActions2.png differ diff --git a/docs/CROWDIN/cs/images/update/CI/GitHubActions3.png b/docs/CROWDIN/cs/images/update/CI/GitHubActions3.png new file mode 100644 index 000000000000..cff0ed34b214 Binary files /dev/null and b/docs/CROWDIN/cs/images/update/CI/GitHubActions3.png differ diff --git a/docs/CROWDIN/cs/images/update/CI/GitHubActions4.png b/docs/CROWDIN/cs/images/update/CI/GitHubActions4.png new file mode 100644 index 000000000000..bede3c2dfe08 Binary files /dev/null and b/docs/CROWDIN/cs/images/update/CI/GitHubActions4.png differ diff --git a/docs/CROWDIN/cs/images/update/CI/GitHubActions5.png b/docs/CROWDIN/cs/images/update/CI/GitHubActions5.png new file mode 100644 index 000000000000..d96e31cf084d Binary files /dev/null and b/docs/CROWDIN/cs/images/update/CI/GitHubActions5.png differ diff --git a/docs/CROWDIN/cs/images/update/CI/GitHubUpdate1.png b/docs/CROWDIN/cs/images/update/CI/GitHubUpdate1.png new file mode 100644 index 000000000000..3058dc270d28 Binary files /dev/null and b/docs/CROWDIN/cs/images/update/CI/GitHubUpdate1.png differ diff --git a/docs/CROWDIN/cs/images/update/CI/GitHubUpdate2.png b/docs/CROWDIN/cs/images/update/CI/GitHubUpdate2.png new file mode 100644 index 000000000000..1ae9568c8107 Binary files /dev/null and b/docs/CROWDIN/cs/images/update/CI/GitHubUpdate2.png differ diff --git a/docs/CROWDIN/cs/images/update/CI/GitHubUpdate3.png b/docs/CROWDIN/cs/images/update/CI/GitHubUpdate3.png new file mode 100644 index 000000000000..d18f9119c76d Binary files /dev/null and b/docs/CROWDIN/cs/images/update/CI/GitHubUpdate3.png differ diff --git a/docs/CROWDIN/cs/images/update/CI/GitHubUpdate4.png b/docs/CROWDIN/cs/images/update/CI/GitHubUpdate4.png new file mode 100644 index 000000000000..8c38c071cb8f Binary files /dev/null and b/docs/CROWDIN/cs/images/update/CI/GitHubUpdate4.png differ diff --git a/docs/CROWDIN/cs/images/update/CI/GitHubUpdate5.png b/docs/CROWDIN/cs/images/update/CI/GitHubUpdate5.png new file mode 100644 index 000000000000..409aef1f34dc Binary files /dev/null and b/docs/CROWDIN/cs/images/update/CI/GitHubUpdate5.png differ diff --git a/docs/CROWDIN/cs/index.md b/docs/CROWDIN/cs/index.md index de517333c697..f5c1b314c475 100644 --- a/docs/CROWDIN/cs/index.md +++ b/docs/CROWDIN/cs/index.md @@ -2,10 +2,10 @@ ![image](./images/basic-outline-of-AAPS.png) -```{admonition} Version 3.3 +```{admonition} Latest Release :class: note -29/12/2024 : Version 3.3 is out. Check the [Release Notes](#version3300) to see what's new and get update instructions. +14/08/2025 : Version 3.3.2.1 is out. Check the [Release Notes](#latestrelease) to see what's new and get update instructions. ``` @@ -21,7 +21,7 @@ Section **2) Getting Started**, the [Introduction](Getting-Started/Introduction. Now that you have a solid understanding of the process, you can start assembling your **AAPS** loop. -Section **3) Setting up AAPS** contains step-by-step instructions to do this. It covers choosing and [setting up your reporting server](./SettingUpAaps/SettingUpTheReportingServer.md) (Nightscout or Tidepool) so you can review and share your data, getting your computer ready for building the AAPS app, building the AAPS app and transferring the AAPS app to your phone. It also covers setting up the **AAPS** app using the setup Wizard, linking it with your CGM app, and either a real or virtual insulin pump, as well as linking **AAPS** to your reporting server. You are then slowly introduced to the full usage of what **AAPS** has to offer via a safe and carefully calibrated step-by-step process designed to make sure that you/your child are thoroughly familiar and comfortable navigating all the different levels and menu configurations before graduating on the next phase, commonly referred to as the next "Objective", until you are have enough experience to begin using the more advanced options available within the app. These Objectives are specially designed in such a way that will gradually unlock more possibilities of **AAPS** and switch from Open Loop to Closed Loop. +Section **3) Setting up AAPS** contains step-by-step instructions to do this. It covers choosing and [setting up your reporting server](./SettingUpAaps/SettingUpTheReportingServer.md) (Nightscout or Tidepool) so you can review and share your data, getting ready for building the AAPS app, building the AAPS app and transferring the AAPS app to your phone. It also covers setting up the **AAPS** app using the setup Wizard, linking it with your CGM app, and either a real or virtual insulin pump, as well as linking **AAPS** to your reporting server. You are then slowly introduced to the full usage of what **AAPS** has to offer via a safe and carefully calibrated step-by-step process designed to make sure that you/your child are thoroughly familiar and comfortable navigating all the different levels and menu configurations before graduating on the next phase, commonly referred to as the next "Objective", until you are have enough experience to begin using the more advanced options available within the app. These Objectives are specially designed in such a way that will gradually unlock more possibilities of **AAPS** and switch from Open Loop to Closed Loop. Section **4) Daily life with AAPS** covers key **AAPS** features, to help you use (and customise) **AAPS**. This including understanding the screens, carbs-on-board, sensitivity, profile switching, temp targets, extended carbs (or eCarbs), automations, and DynamicISF. It also covers frequent topics like how to manage different types of meals, how to deal with cannula and sensor changes, smartphone updates, daylight saving changes, and [travelling with AAPS](DailyLifeWithAaps/TimezoneTraveling-DaylightSavingTime.md) and sports. Common questions and answers are located within the troubleshooting section. diff --git a/docs/CROWDIN/de/Maintenance/DocumentationUpdate.md b/docs/CROWDIN/de/Maintenance/DocumentationUpdate.md index 55b34f5e3829..850e6d91ad5b 100644 --- a/docs/CROWDIN/de/Maintenance/DocumentationUpdate.md +++ b/docs/CROWDIN/de/Maintenance/DocumentationUpdate.md @@ -4,7 +4,7 @@ - Updated versions and Android Studio prerequisites - Added [3.3.2.1](#version3321) release, removed Android 16 references (fixed) -- Added [Browser Build](browser-build) @Angus +- Added [Browser Build](#browser-build) @Angus ## Mai 2025 diff --git a/docs/CROWDIN/de/Maintenance/ReleaseNotes.md b/docs/CROWDIN/de/Maintenance/ReleaseNotes.md index 69c5f4a6dc65..de5fc49b9838 100644 --- a/docs/CROWDIN/de/Maintenance/ReleaseNotes.md +++ b/docs/CROWDIN/de/Maintenance/ReleaseNotes.md @@ -55,6 +55,8 @@ Damit Benutzer älterer Android-Versionen nicht ausgeschlossen werden, wurden zw WearOS 5, API Level 34 (Android 14) hat [einige Einschränkungen](#BuildingAapsWearOs-WearOS5). ``` +(latestrelease)= + (version3321)= ## Version 3.3.2.1 diff --git a/docs/CROWDIN/de/Maintenance/UpdateBrowserBuild.md b/docs/CROWDIN/de/Maintenance/UpdateBrowserBuild.md new file mode 100644 index 000000000000..e40d9ab55380 --- /dev/null +++ b/docs/CROWDIN/de/Maintenance/UpdateBrowserBuild.md @@ -0,0 +1,101 @@ +# Update with a browser + +## Kein Download möglich - APK muss selbst erstellt werden + +**AAPS** is not available to download, due to regulations concerning medical devices. Es ist zulässig, die App für den eigenen Gebrauch zu erstellen, aber du darfst keine Kopie an andere weitergeben! Zu den Details schaue bitte auf die [FAQ-Seite](../UsefulLinks/FAQ.md). + +```{note} +In case you want to upgrade **AAPS** with a browser for the first time : copy your back-up keystore file to your Google Drive. Then follow the [Browser Build **AAPS** procedure](../SettingUpAaps/BrowserBuild.md) instead of this guide. Instead of creating a new keystore, you must select the one you have copied from your computer. +This operation will be mandatory only the first time, then for successive upgrades you will be able to follow this guide. +``` + +## Overview for updating to a new version of AAPS with a browser + +```{contents} Steps for updating to a new version of AAPS +:depth: 1 +:local: true +``` + +In case you experience problems, see separate page for [troubleshooting Android Studio](../GettingHelp/TroubleshootingAndroidStudio). + +### Export your settings + +Exportiere die Einstellungen Deiner aktuellen **AAPS**-Version Deines Smartphones. Vielleicht brauchst Du sie nicht, aber sicher ist sicher. + +Wenn Du nicht mehr genau weißt, wie man das macht, schaue auf der Seite [Export & Import der Einstellungen](ExportImportSettings.md) nach. + +(Update-to-new-version-update-your-repo)= +### Update your GitHub repository + +```{admonition} WARNING +:class: warning +Browser Build is available from AAPS version 3.3.2.1. +``` + +[Log into GitHub](https://github.com/login). + +1. Select Repositories. +2. Scroll down and select your own AndroidAPS repository. + +![Select AndroidAPS repo](../images/update/CI/GitHubUpdate1.png) + +3. Verify you are using your own copy of AndroidAPS (Forked from nightscout/AndroidAPS) +4. Tap Sync Fork to update it (the number of commits behind might differ from the picture) + + + +![Sync AndroidAPS repo](../images/update/CI/GitHubUpdate2.png) + +5. Tap Update Branch + +![Update AndroidAPS repo](../images/update/CI/GitHubUpdate3.png) + +Note: if you have modified your copy of AndroidAPS by mistake, you will see this screen. Discard all changes (commits) to return to the released version. + +![Discard rogue modifications](../images/update/CI/GitHubUpdate4.png) + +You have now synchronized (updated) your own copy with the latest release of Android APS. Good job. + +![Repo sync'ed](../images/update/CI/GitHubUpdate5.png) + +### Run the Workflow to Build the Signed APK + +1. In your GitHub copy of AndroidAPS, select Actions. +2. Expand All Workflows. +3. Select AAPS-CI + +![Actions AAPS-CI](../images/update/CI/GitHubActions1.png) + +4. Scroll down and tap Run Workflow. + +![Run Workflow](../images/update/CI/GitHubActions2.png) + +5. Select the branch you want to deploy (master), the [variant](variant) (fullRelease) and tap Run Workflow. + + + +![Run Workflow](../images/update/CI/GitHubActions3.png) + +6. You will see the message Workflow run was successfully requested. Refresh your browser page and you will be able to monitor the build progress. When the action completes, the AAPS CI action will show a green tick mark. You have successfully built the updated version of Android APS. + +![Monitor Workflow](../images/update/CI/GitHubActions4.png) + +### Install the AAPS APK + +1. Open your Google Drive +2. Browse into AAPS, select the new version folder and you will find both the phone and Android Wear versions. + +![Google Drive Location](../images/update/CI/GitHubActions5.png) + + +Continue [here](#Update-to-new-version-check-aaps-version-on-phone) + +## Problembehandlung + +Keine Panik, wenn irgendetwas schiefläuft. + +Tief durchatmen! + +Then see the [troubleshooting tips](#aaps-ci-preparation) if your problem is already documented! + +If you need further help, please reach out to other **AAPS** users on [Facebook](https://www.facebook.com/groups/AndroidAPSUsers) or [Discord](https://discord.gg/4fQUWHZ4Mw). \ No newline at end of file diff --git a/docs/CROWDIN/de/Maintenance/UpdateComputerBuild.md b/docs/CROWDIN/de/Maintenance/UpdateComputerBuild.md new file mode 100644 index 000000000000..694e758c57b2 --- /dev/null +++ b/docs/CROWDIN/de/Maintenance/UpdateComputerBuild.md @@ -0,0 +1,103 @@ +# Update with a computer + +## Kein Download möglich - APK muss selbst erstellt werden + +**AAPS** is not available to download, due to regulations concerning medical devices. Es ist zulässig, die App für den eigenen Gebrauch zu erstellen, aber du darfst keine Kopie an andere weitergeben! Zu den Details schaue bitte auf die [FAQ-Seite](../UsefulLinks/FAQ.md). + +```{note} +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. +``` + +## Overview for updating to a new version of AAPS with a computer + +```{contents} Steps for updating to a new version of AAPS +:depth: 1 +:local: true +``` + +In case you experience problems, see separate page for [troubleshooting Android Studio](../GettingHelp/TroubleshootingAndroidStudio). + +### Export your settings + +Exportiere die Einstellungen Deiner aktuellen **AAPS**-Version Deines Smartphones. Vielleicht brauchst Du sie nicht, aber sicher ist sicher. + +Wenn Du nicht mehr genau weißt, wie man das macht, schaue auf der Seite [Export & Import der Einstellungen](ExportImportSettings.md) nach. + +### Check your Android Studio version + +The minimal version required is described in the [Building Instructions](#Building-APK-recommended-specification-of-computer-for-building-apk-file). If your version is older, please [update Android Studio first](#Building-APK-install-android-studio)! + +(Update-to-new-version-update-your-local-copy)= +### Update your local copy + +```{admonition} WARNING +:class: warning +If you update from versions prior to 2.8.x, please follow the instructions to do a [New clone](../SettingUpAaps/BuildingAaps.md), as this guide will not work for you! +``` + +* Öffne Dein bestehendes AAPS-Projekt mit Android Studio. Möglicherweise musst Du Dein Projekt wählen. Klicke (doppelt) auf das AAPS-Projekt. + + ![Android Studio - Projekt auswählen](../images/update/01_ProjectSelection.png) + +* Wähle in der Menüleiste des Android Studios Git -> Fetch + + ![Android Studio Menü - Git - Fetch](../images/update/02_GitFetch.png) + +* Unten rechts wird Dir eine Meldung angezeigt, sobald der Fetch erfolgreich durchgeführt wurde. + + ![Android Studio Menü - Git - Fetch erfolgreich](../images/update/03_GitFetchSuccessful.png) + +* Wähle nun in der Menüleiste Git -> Pull + + ![Android Studio Menü - Git - Pull](../images/update/04_GitPull.png) + +* Lasse alle Optionen wie sie sind (Original/Master) und wähle Pull. + + ![Android Studio - Git - Pull-Dialog](../images/update/05_GitPullOptions.png) + +* Warte ab, während der Download läuft. Du siehst dazu einen Hinweis in der Fußzeile. Eine Erfolgsmeldung wird angezeigt, so bald erfolgreich heruntergeladen wurde. + + ```{note} + Die Anzahl der aktualisierten Dateien kann unterschiedlich sein! Dies ist kein Hinweis auf einen Download-Fehler. + ``` + + ![Android Studio - Pull erfolgreich](../images/update/06_GitPullSuccess.png) + +* Gradle Sync wird ausgeführt, um einige Abhängigkeiten herunterzuladen. Warte, bis es fertig ist. + + ![Android Studio - Gradle Sync](../images/studioSetup/40_BackgroundTasks.png) + +### JVM-Version prüfen + +This check is particularly indicated if you have already built a previous version of **AAPS** on the same computer. + +Check in the [Building Instructions](#Building-APK-recommended-specification-of-computer-for-building-apk-file) the required version for JVM, matching the **AAPS** version you are now building. Um sicherzustellen, dass Du die korrekte JVM-Version verwendest, befolge die Schritte, die im Abschnitt [Incompatible Gradle JVM](#incompatible-gradle-jvm) beschriebenen sind. + +(Update-to-new-version-build-the-signed-apk)= +### Erstelle die signierte APK + +Dein Quellcode entspricht jetzt der zuletzt freigegebenen Version und alle Voraussetzungen sind geprüft. Es ist an der Zeit, die signierte APK wie im Abschnitt[Signierte AAPS APK erstellen](#Building-APK-generate-signed-apk) beschrieben zu erstellen (bauen). + +(Update-to-new-version-transfer-and-install)= + +### Übertrage und installiere die APK +Du musst die APK-Datei auf Dein Smartphone übertragen, um sie dort installieren zu können. + +```{note} +Wenn Du beim Erstellen Deinen bestehenden „Keystore“ im Android Studio genutzt hast, musst Du die bestehende App nicht deinstallieren. Um die APK zu installieren, folge den Anweisungen während des Updatevorgangs. +In allen anderen Fällen (z.B. wenn ein neuer 'key store' für das Signieren der APK genutzt wurde), muss die alte App gelöscht werden, bevor die neue Version installiert werden kann. **Achte darauf, Deine Einstellungen zu exportieren!** +``` + +Nutze die Anleitung [AAPS auf Dein Smartphone übertragen und installieren](../SettingUpAaps/TransferringAndInstallingAaps.md) + +Continue [here](#Update-to-new-version-check-aaps-version-on-phone). + +## Problembehandlung + +Keine Panik, wenn irgendetwas schiefläuft. + +Tief durchatmen! + +Danach schaue auf der Seite [Fehlerbehebung für Android Studio](../GettingHelp/TroubleshootingAndroidStudio) nach einer Lösung, sofern Dein Problem bereits bekannt sein sollte! + +If you need further help, please reach out to other **AAPS** users on [Facebook](https://www.facebook.com/groups/AndroidAPSUsers) or [Discord](https://discord.gg/4fQUWHZ4Mw). \ No newline at end of file diff --git a/docs/CROWDIN/de/Maintenance/UpdateToNewVersion.md b/docs/CROWDIN/de/Maintenance/UpdateToNewVersion.md index 0cd6a87ff3fc..d201947fa6ed 100644 --- a/docs/CROWDIN/de/Maintenance/UpdateToNewVersion.md +++ b/docs/CROWDIN/de/Maintenance/UpdateToNewVersion.md @@ -9,92 +9,15 @@ Aufgrund der gesetzlichen Regelungen für Medizinprodukte ist **AAPS** nicht als * Aktualisiere so bald wie möglich auf die neueste **AAPS**-Version, nachdem sie verfügbar ist. * Sobald eine neue Version verfügbar ist, wird Dir in der **AAPS**-App ein Hinweis darüber angezeigt. * Wenn eine neue Version verfügbar ist, wird darüber auch auf Facebook informiert. -* Nach der Veröffentlichung lies bitte die [Versionshinweise](ReleaseNotes.md) (Release Notes) genau durch, und kläre mögliche Fragen in der Community auf Facebook oder Discord, bevor Du mit dem Update weiter machst. - - ```{note} - 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. - ``` +* Following the release, please read the [Release Notes](ReleaseNotes.md) in detail, and clarify any queries with the community on Facebook or Discord, before proceeding with the update. -## Übersicht zum Aktualisieren auf eine neue AAPS Version +## Update AAPS with browser build -```{contents} Schritte, um auf eine neue AAPS-Version zu aktualisieren :depth: 1 :local: true +If you already built your AAPS app with the Browser Build method, follow [these instructions](./UpdateBrowserBuild.md). -
Falls Probleme auftreten, schaue auf der eigenen Seite für [Fehlerbehebung des Android Studio](../GettingHelp/TroubleshootingAndroidStudio) nach einer Lösung. - - ### Exportiere Deine Einstellungen - - Exportiere Deine Einstellungen aus der auf Deinem Smartphone existierenden **AAPS**-Version. Vielleicht brauchst Du sie nicht, aber sicher ist sicher. - - Wenn Du nicht mehr genau weißt, wie das geht, lies es auf der Seite [Ex- & Importieren der Einstellungen](ExportImportSettings.md) nach. - - ### Überprüfe Deine Android Studio Version - - Die benötigte Minimalversion ist im Abschnitt [AAPS erstellen](#Building-APK-recommended-specification-of-computer-for-building-apk-file) beschrieben. Sollte Deine Version älter sein, [aktualisiere zuerst das Android Studio](#Building-APK-install-android-studio)! - - (Update-to-new-version-update-your-local-copy)= - ### Aktualisiere Deine lokale Kopie - - ```{admonition} WARNING - :class: warning - Wenn Du von einer Version vor 2.8.x aktualisierst, erstelle - wie in der Anleitung beschrieben - einen [neuen Clone](../SettingUpAaps/BuildingAaps.md). Der hier beschriebene Weg wird für Dich nicht funktionieren! - +## Update AAPS with a computer -* Öffne Dein bestehendes AAPS-Projekt mit Android Studio. Möglicherweise musst Du Dein Projekt wählen. Klicke (doppelt) auf das AAPS-Projekt. - - ![Android Studio - Projekt auswählen](../images/update/01_ProjectSelection.png) - -* Wähle in der Menüleiste von Android Studio Git -> Fetch. - - ![Android Studio Menü - Git - Fetch](../images/update/02_GitFetch.png) - -* Unten rechts wird Dir eine Meldung angezeigt, sobald der Fetch erfolgreich durchgeführt wurde. - - ![Android Studio Menü - Git - Fetch erfolgreich](../images/update/03_GitFetchSuccessful.png) - -* Wähle nun in der Menüleiste Git -> Pull. - - ![Android Studio Menü - Git - Pull](../images/update/04_GitPull.png) - -* Lasse alle Optionen wie sie sind (Original/Master) und wähle Pull. - - ![Android Studio - Git - Pull-Dialog](../images/update/05_GitPullOptions.png) - -* Warte ab, während der Download läuft. Du siehst dazu einen Hinweis in der Fußzeile. Eine Erfolgsmeldung wird angezeigt, so bald erfolgreich heruntergeladen wurde. - - ```{note} - Die Anzahl der aktualisierten Dateien kann unterschiedlich sein! Dies ist kein Hinweis auf einen Download-Fehler. - ``` - - ![Android Studio - Pull erfolgreich](../images/update/06_GitPullSuccess.png) - -* Gradle Sync wird ausgeführt, um einige Abhängigkeiten herunterzuladen. Warte, bis es fertig ist. - - ![Android Studio - Gradle Sync](../images/studioSetup/40_BackgroundTasks.png) - -### JVM-Version prüfen - -Diese Prüfung ist besonders dann notwendig, wenn Du bereits eine frühere **AAPS**-Version auf demselben Computer erstellt hast. - -Schaue im Abschnitt [AAPS erstellen](#Building-APK-recommended-specification-of-computer-for-building-apk-file) nach, welche JVM-Version zur **AAPS**-Version, die Du erstellen möchtest, passt. Um sicherzustellen, dass Du die korrekte JVM-Version verwendest, befolge die Schritte, die im Abschnitt [Incompatible Gradle JVM](#incompatible-gradle-jvm) beschriebenen sind. - -(Update-to-new-version-build-the-signed-apk)= - -### Erstelle die signierte APK - -Dein Quellcode entspricht jetzt der zuletzt freigegebenen Version und alle Voraussetzungen sind geprüft. Es ist an der Zeit, die signierte APK wie im Abschnitt[Signierte AAPS APK erstellen](#Building-APK-generate-signed-apk) beschrieben zu erstellen (bauen). - -(Update-to-new-version-transfer-and-install)= - -### Übertrage und installiere die APK - -Du musst die APK-Datei auf Dein Smartphone übertragen, um sie dort installieren zu können. - -```{note} -Wenn Du beim Erstellen Deinen bestehenden „Keystore“ im Android Studio genutzt hast, musst Du die bestehende App nicht deinstallieren. Um die APK zu installieren, folge den Anweisungen während des Updatevorgangs. -In allen anderen Fällen (z.B. wenn ein neuer 'key store' für das Signieren der APK genutzt wurde), muss die alte App gelöscht werden, bevor die neue Version installiert werden kann. **Achte darauf, Deine Einstellungen zu exportieren!** -``` - -Nutze die Anleitung [AAPS auf Dein Smartphone übertragen und installieren](../SettingUpAaps/TransferringAndInstallingAaps.md) +Follow [these instructions.](./UpdateComputerBuild.md). (Update-to-new-version-check-aaps-version-on-phone)= @@ -104,14 +27,4 @@ Nachdem Du die neue APK-Datei installiert hast, kannst Du auf dem Smartphone die ![Installierte AAPS Version](../images/Update_VersionCheck.png) -Schaue in den [Release Notes](../Maintenance/ReleaseNotes.md) nach, ob es nach dem Update besondere Dinge zu beachten gibt. - -## Problembehandlung - -Keine Panik, wenn irgendetwas schiefläuft. - -Tief durchatmen! - -Danach schaue auf der Seite [Fehlerbehebung für Android Studio](../GettingHelp/TroubleshootingAndroidStudio) nach einer Lösung, sofern Dein Problem bereits bekannt sein sollte! - -Wenn Du weitere Hilfe brauchst, kontaktiere bitte andere **AAPS**-Nutzende auf [Facebook](https://www.facebook.com/groups/AndroidAPSUsers) oder [Discord](https://discord.gg/4fQUWHZ4Mw). \ No newline at end of file +Schaue in den [Release Notes](../Maintenance/ReleaseNotes.md) nach, ob es nach dem Update besondere Dinge zu beachten gibt. \ No newline at end of file diff --git a/docs/CROWDIN/de/SettingUpAaps/BrowserBuild.md b/docs/CROWDIN/de/SettingUpAaps/BrowserBuild.md index e13ec9ed4e64..3b19973be1ec 100644 --- a/docs/CROWDIN/de/SettingUpAaps/BrowserBuild.md +++ b/docs/CROWDIN/de/SettingUpAaps/BrowserBuild.md @@ -1,3 +1,5 @@ +(browser-build)= + # Browser build Building AAPS with GitHub Actions. diff --git a/docs/CROWDIN/de/images/Building-the-App/CI/aaps_ci_simple_http_server.png b/docs/CROWDIN/de/images/Building-the-App/CI/aaps_ci_simple_http_server.png index 95ac2d4eb443..2e2fb47e5ca2 100644 Binary files a/docs/CROWDIN/de/images/Building-the-App/CI/aaps_ci_simple_http_server.png and b/docs/CROWDIN/de/images/Building-the-App/CI/aaps_ci_simple_http_server.png differ diff --git a/docs/CROWDIN/de/images/Building-the-App/CI/aaps_ci_simple_http_server_step1.png b/docs/CROWDIN/de/images/Building-the-App/CI/aaps_ci_simple_http_server_step1.png index 78f52682b58d..b348162dcb1c 100644 Binary files a/docs/CROWDIN/de/images/Building-the-App/CI/aaps_ci_simple_http_server_step1.png and b/docs/CROWDIN/de/images/Building-the-App/CI/aaps_ci_simple_http_server_step1.png differ diff --git a/docs/CROWDIN/de/images/Building-the-App/CI/aaps_ci_simple_http_server_step2.png b/docs/CROWDIN/de/images/Building-the-App/CI/aaps_ci_simple_http_server_step2.png index c292ac667f63..cabadeefb97a 100644 Binary files a/docs/CROWDIN/de/images/Building-the-App/CI/aaps_ci_simple_http_server_step2.png and b/docs/CROWDIN/de/images/Building-the-App/CI/aaps_ci_simple_http_server_step2.png differ diff --git a/docs/CROWDIN/de/images/Building-the-App/CI/aaps_ci_simple_http_server_step3.png b/docs/CROWDIN/de/images/Building-the-App/CI/aaps_ci_simple_http_server_step3.png index bd31cd0ffb3d..9a26d3526369 100644 Binary files a/docs/CROWDIN/de/images/Building-the-App/CI/aaps_ci_simple_http_server_step3.png and b/docs/CROWDIN/de/images/Building-the-App/CI/aaps_ci_simple_http_server_step3.png differ diff --git a/docs/CROWDIN/de/images/Building-the-App/CI/aaps_ci_simple_http_server_step4.png b/docs/CROWDIN/de/images/Building-the-App/CI/aaps_ci_simple_http_server_step4.png index cc187ec72a14..285492424351 100644 Binary files a/docs/CROWDIN/de/images/Building-the-App/CI/aaps_ci_simple_http_server_step4.png and b/docs/CROWDIN/de/images/Building-the-App/CI/aaps_ci_simple_http_server_step4.png differ diff --git a/docs/CROWDIN/de/images/Building-the-App/CI/aaps_ci_simple_http_server_store.png b/docs/CROWDIN/de/images/Building-the-App/CI/aaps_ci_simple_http_server_store.png index 4b157ca8d3d8..65bf101f55e4 100644 Binary files a/docs/CROWDIN/de/images/Building-the-App/CI/aaps_ci_simple_http_server_store.png and b/docs/CROWDIN/de/images/Building-the-App/CI/aaps_ci_simple_http_server_store.png differ diff --git a/docs/CROWDIN/de/images/update/CI/GitHubActions1.png b/docs/CROWDIN/de/images/update/CI/GitHubActions1.png new file mode 100644 index 000000000000..e04ce6e76d8b Binary files /dev/null and b/docs/CROWDIN/de/images/update/CI/GitHubActions1.png differ diff --git a/docs/CROWDIN/de/images/update/CI/GitHubActions2.png b/docs/CROWDIN/de/images/update/CI/GitHubActions2.png new file mode 100644 index 000000000000..7b5c5a842d16 Binary files /dev/null and b/docs/CROWDIN/de/images/update/CI/GitHubActions2.png differ diff --git a/docs/CROWDIN/de/images/update/CI/GitHubActions3.png b/docs/CROWDIN/de/images/update/CI/GitHubActions3.png new file mode 100644 index 000000000000..cff0ed34b214 Binary files /dev/null and b/docs/CROWDIN/de/images/update/CI/GitHubActions3.png differ diff --git a/docs/CROWDIN/de/images/update/CI/GitHubActions4.png b/docs/CROWDIN/de/images/update/CI/GitHubActions4.png new file mode 100644 index 000000000000..bede3c2dfe08 Binary files /dev/null and b/docs/CROWDIN/de/images/update/CI/GitHubActions4.png differ diff --git a/docs/CROWDIN/de/images/update/CI/GitHubActions5.png b/docs/CROWDIN/de/images/update/CI/GitHubActions5.png new file mode 100644 index 000000000000..d96e31cf084d Binary files /dev/null and b/docs/CROWDIN/de/images/update/CI/GitHubActions5.png differ diff --git a/docs/CROWDIN/de/images/update/CI/GitHubUpdate1.png b/docs/CROWDIN/de/images/update/CI/GitHubUpdate1.png new file mode 100644 index 000000000000..3058dc270d28 Binary files /dev/null and b/docs/CROWDIN/de/images/update/CI/GitHubUpdate1.png differ diff --git a/docs/CROWDIN/de/images/update/CI/GitHubUpdate2.png b/docs/CROWDIN/de/images/update/CI/GitHubUpdate2.png new file mode 100644 index 000000000000..1ae9568c8107 Binary files /dev/null and b/docs/CROWDIN/de/images/update/CI/GitHubUpdate2.png differ diff --git a/docs/CROWDIN/de/images/update/CI/GitHubUpdate3.png b/docs/CROWDIN/de/images/update/CI/GitHubUpdate3.png new file mode 100644 index 000000000000..d18f9119c76d Binary files /dev/null and b/docs/CROWDIN/de/images/update/CI/GitHubUpdate3.png differ diff --git a/docs/CROWDIN/de/images/update/CI/GitHubUpdate4.png b/docs/CROWDIN/de/images/update/CI/GitHubUpdate4.png new file mode 100644 index 000000000000..8c38c071cb8f Binary files /dev/null and b/docs/CROWDIN/de/images/update/CI/GitHubUpdate4.png differ diff --git a/docs/CROWDIN/de/images/update/CI/GitHubUpdate5.png b/docs/CROWDIN/de/images/update/CI/GitHubUpdate5.png new file mode 100644 index 000000000000..409aef1f34dc Binary files /dev/null and b/docs/CROWDIN/de/images/update/CI/GitHubUpdate5.png differ diff --git a/docs/CROWDIN/de/index.md b/docs/CROWDIN/de/index.md index a1ef98bfec81..fd92da50fdef 100644 --- a/docs/CROWDIN/de/index.md +++ b/docs/CROWDIN/de/index.md @@ -2,10 +2,10 @@ ![grafik](./images/basic-outline-of-AAPS.png) -```{admonition} Version 3.3 +```{admonition} Latest Release :class: note -29/12/2024: Version 3.3 ist nun verfügbar. Schau Dir die [Release Notes](#version3300) an, in denen Du erfährst welche Neuerungen es gibt und was es bei einem Update zu beachten gibt. +14/08/2025 : Version 3.3.2.1 is out. Check the [Release Notes](#latestrelease) to see what's new and get update instructions. ``` @@ -21,7 +21,7 @@ Abschnitt **2) „Erste Schritte“** - Die [Einführung](Getting-Started/Introd Jetzt, da Du ein solides Grundverständnis des Prozesses hast, kannst Du damit beginnen, Deinen **AAPS**-Loop zu erstellen. -Abschnitt **3) AAPS einrichten** enthält Schritt-für-Schritt Anleitungen, um dies zu tun. Es beschreibt die Auswahl und [Einrichtung Deines Servers für Berichte](./SettingUpAaps/SettingUpTheReportingServer.md) (Nightscout oder Tidepool), damit Du Deine relevanten Daten auswerten und teilen kannst, die Vorbereitung Deines Computers für die Erstellung, das eigentliche Erstellen (sog. build) der AAPS-App und die Übertragung der AAPS-App auf Dein Smartphone. Es umfasst auch das Einrichten der **AAPS**-App mithilfe des Einrichtungsassistenten, das Verknüpfen mit Deiner CGM-App und entweder einer echten oder einer virtuellen Insulinpumpe sowie das Verknüpfen von **AAPS** mit Deinem Berichtsserver. Du wirst danach durch einen kleinschrittigen und sehr fein justierten Prozess sehr behutsam an die vollständige **AAPS**-Nutzung herangeführt. Damit soll sichergestellt werden, dass Du oder Dein Kind, sicher durch die verschiedenen Funktionen und Menü-Konfigurationen navigieren lernst, bevor Du zur folgenden Phase (auch "nächstes Ziel" bzw. "Objective" genannt) übergehst und schließlich genug Erfahrung gesammelt hast, um die weitreichensten Funktionalitäten der App nutzen zu können. Diese Objectives (Ziele) sind so aufgebaut, dass nach und nach weitere **AAPS**-Funktionen freigeschaltet werden und so am Ende vom 'Open Loop' auf 'Closed Loop' umgestellt werden kann. +Abschnitt **3) AAPS einrichten** enthält Schritt-für-Schritt Anleitungen, um dies zu tun. It covers choosing and [setting up your reporting server](./SettingUpAaps/SettingUpTheReportingServer.md) (Nightscout or Tidepool) so you can review and share your data, getting ready for building the AAPS app, building the AAPS app and transferring the AAPS app to your phone. Es umfasst auch das Einrichten der **AAPS**-App mithilfe des Einrichtungsassistenten, das Verknüpfen mit Deiner CGM-App und entweder einer echten oder einer virtuellen Insulinpumpe sowie das Verknüpfen von **AAPS** mit Deinem Berichtsserver. Du wirst danach durch einen kleinschrittigen und sehr fein justierten Prozess sehr behutsam an die vollständige **AAPS**-Nutzung herangeführt. Damit soll sichergestellt werden, dass Du oder Dein Kind, sicher durch die verschiedenen Funktionen und Menü-Konfigurationen navigieren lernst, bevor Du zur folgenden Phase (auch "nächstes Ziel" bzw. "Objective" genannt) übergehst und schließlich genug Erfahrung gesammelt hast, um die weitreichensten Funktionalitäten der App nutzen zu können. Diese Objectives (Ziele) sind so aufgebaut, dass nach und nach weitere **AAPS**-Funktionen freigeschaltet werden und so am Ende vom 'Open Loop' auf 'Closed Loop' umgestellt werden kann. Abschnitt **4) AAPS im Alltag** behandelt wichtige **AAPS**-Funktionen, um Dir beim Umgang (und der Anpassung) von **AAPS** zu helfen. Dies beinhaltet insbesondere das Verständnis der Bildschirme, Kohlenhydrate an Bord (CoB), Sensitivität, Profilwechsel, temporäre Ziele, verzögerte Kohlenhydrate (oder eCarbs), Automatisierungen und dynamischer ISF (DynamicISF). Es behandelt auch häufige Themen wie den Umgang mit verschiedenen Mahlzeitenarten den Umgang mit Kanülen- und Sensorwechseln, Smartphone-Updates, Zeitumstellungen, [Reisen mit AAPS](DailyLifeWithAaps/TimezoneTraveling-DaylightSavingTime.md) und Sport. Häufig gestellte Fragen und Antworten dazu findest Du im Abschnitt zur Fehlerbehebung. diff --git a/docs/CROWDIN/el/Maintenance/DocumentationUpdate.md b/docs/CROWDIN/el/Maintenance/DocumentationUpdate.md index ab1963a3639e..db9845d64e26 100644 --- a/docs/CROWDIN/el/Maintenance/DocumentationUpdate.md +++ b/docs/CROWDIN/el/Maintenance/DocumentationUpdate.md @@ -4,7 +4,7 @@ - Updated versions and Android Studio prerequisites - Added [3.3.2.1](#version3321) release, removed Android 16 references (fixed) -- Added [Browser Build](browser-build) @Angus +- Added [Browser Build](#browser-build) @Angus ## May 2025 diff --git a/docs/CROWDIN/el/Maintenance/ReleaseNotes.md b/docs/CROWDIN/el/Maintenance/ReleaseNotes.md index fddbe9cbd688..d208375056fb 100644 --- a/docs/CROWDIN/el/Maintenance/ReleaseNotes.md +++ b/docs/CROWDIN/el/Maintenance/ReleaseNotes.md @@ -55,6 +55,8 @@ In order to allow users with older Android to use older version of AAPS new vers WearOS 5, API level 34 (Android 14) has [limitations](#BuildingAapsWearOs-WearOS5). ``` +(latestrelease)= + (version3321)= ## Version 3.3.2.1 diff --git a/docs/CROWDIN/el/Maintenance/UpdateBrowserBuild.md b/docs/CROWDIN/el/Maintenance/UpdateBrowserBuild.md new file mode 100644 index 000000000000..c68fc0b8ee05 --- /dev/null +++ b/docs/CROWDIN/el/Maintenance/UpdateBrowserBuild.md @@ -0,0 +1,101 @@ +# Update with a browser + +## Φτιάξτε το μόνοι σας, αντί να το κατεβάσετε + +**AAPS** is not available to download, due to regulations concerning medical devices. It is legal to build the app for your own use, but you must not give a copy to others! See [FAQ page](../UsefulLinks/FAQ.md) for details. + +```{note} +In case you want to upgrade **AAPS** with a browser for the first time : copy your back-up keystore file to your Google Drive. Then follow the [Browser Build **AAPS** procedure](../SettingUpAaps/BrowserBuild.md) instead of this guide. Instead of creating a new keystore, you must select the one you have copied from your computer. +This operation will be mandatory only the first time, then for successive upgrades you will be able to follow this guide. +``` + +## Overview for updating to a new version of AAPS with a browser + +```{contents} Steps for updating to a new version of AAPS +:depth: 1 +:local: true +``` + +In case you experience problems, see separate page for [troubleshooting Android Studio](../GettingHelp/TroubleshootingAndroidStudio). + +### Export your settings + +Export your settings from the existing **AAPS** version on your phone. You might not need it, but better be safe than sorry. + +See the [Export & import settings](ExportImportSettings.md) page if you don't remember how to do this. + +(Update-to-new-version-update-your-repo)= +### Update your GitHub repository + +```{admonition} WARNING +:class: warning +Browser Build is available from AAPS version 3.3.2.1. +``` + +[Log into GitHub](https://github.com/login). + +1. Select Repositories. +2. Scroll down and select your own AndroidAPS repository. + +![Select AndroidAPS repo](../images/update/CI/GitHubUpdate1.png) + +3. Verify you are using your own copy of AndroidAPS (Forked from nightscout/AndroidAPS) +4. Tap Sync Fork to update it (the number of commits behind might differ from the picture) + + + +![Sync AndroidAPS repo](../images/update/CI/GitHubUpdate2.png) + +5. Tap Update Branch + +![Update AndroidAPS repo](../images/update/CI/GitHubUpdate3.png) + +Note: if you have modified your copy of AndroidAPS by mistake, you will see this screen. Discard all changes (commits) to return to the released version. + +![Discard rogue modifications](../images/update/CI/GitHubUpdate4.png) + +You have now synchronized (updated) your own copy with the latest release of Android APS. Good job. + +![Repo sync'ed](../images/update/CI/GitHubUpdate5.png) + +### Run the Workflow to Build the Signed APK + +1. In your GitHub copy of AndroidAPS, select Actions. +2. Expand All Workflows. +3. Select AAPS-CI + +![Actions AAPS-CI](../images/update/CI/GitHubActions1.png) + +4. Scroll down and tap Run Workflow. + +![Run Workflow](../images/update/CI/GitHubActions2.png) + +5. Select the branch you want to deploy (master), the [variant](variant) (fullRelease) and tap Run Workflow. + + + +![Run Workflow](../images/update/CI/GitHubActions3.png) + +6. You will see the message Workflow run was successfully requested. Refresh your browser page and you will be able to monitor the build progress. When the action completes, the AAPS CI action will show a green tick mark. You have successfully built the updated version of Android APS. + +![Monitor Workflow](../images/update/CI/GitHubActions4.png) + +### Install the AAPS APK + +1. Open your Google Drive +2. Browse into AAPS, select the new version folder and you will find both the phone and Android Wear versions. + +![Google Drive Location](../images/update/CI/GitHubActions5.png) + + +Continue [here](#Update-to-new-version-check-aaps-version-on-phone) + +## Troubleshooting + +If anything goes wrong, don't panic. + +Take a breath! + +Then see the [troubleshooting tips](#aaps-ci-preparation) if your problem is already documented! + +If you need further help, please reach out to other **AAPS** users on [Facebook](https://www.facebook.com/groups/AndroidAPSUsers) or [Discord](https://discord.gg/4fQUWHZ4Mw). \ No newline at end of file diff --git a/docs/CROWDIN/el/Maintenance/UpdateComputerBuild.md b/docs/CROWDIN/el/Maintenance/UpdateComputerBuild.md new file mode 100644 index 000000000000..05f9f95147af --- /dev/null +++ b/docs/CROWDIN/el/Maintenance/UpdateComputerBuild.md @@ -0,0 +1,103 @@ +# Update with a computer + +## Φτιάξτε το μόνοι σας, αντί να το κατεβάσετε + +**AAPS** is not available to download, due to regulations concerning medical devices. It is legal to build the app for your own use, but you must not give a copy to others! See [FAQ page](../UsefulLinks/FAQ.md) for details. + +```{note} +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 + +```{contents} Steps for updating to a new version of AAPS +:depth: 1 +:local: true +``` + +In case you experience problems, see separate page for [troubleshooting Android Studio](../GettingHelp/TroubleshootingAndroidStudio). + +### Export your settings + +Export your settings from the existing **AAPS** version on your phone. You might not need it, but better be safe than sorry. + +See the [Export & import settings](ExportImportSettings.md) page if you don't remember how to do this. + +### Check your Android Studio version + +The minimal version required is described in the [Building Instructions](#Building-APK-recommended-specification-of-computer-for-building-apk-file). If your version is older, please [update Android Studio first](#Building-APK-install-android-studio)! + +(Update-to-new-version-update-your-local-copy)= +### Update your local copy + +```{admonition} WARNING +:class: warning +If you update from versions prior to 2.8.x, please follow the instructions to do a [New clone](../SettingUpAaps/BuildingAaps.md), as this guide will not work for you! +``` + +* Open your existing AAPS project with Android Studio. You might need to select your project. (Double) click on the AAPS project. + + ![Android Studio - Select Project](../images/update/01_ProjectSelection.png) + +* In the menu bar of Android Studio, select Git -> Fetch + + ![Android Studio Menu - Git - Fetch](../images/update/02_GitFetch.png) + +* You will see a message in the lower right corner that Fetch was successful. + + ![Android Studio Menu - Git - Fetch successful](../images/update/03_GitFetchSuccessful.png) + +* In the menu bar, now select Git -> Pull + + ![Android Studio Menu - Git - Pull](../images/update/04_GitPull.png) + +* Leave all options as they are (origin/master) and select Pull + + ![Android Studio - Git - Pull dialog](../images/update/05_GitPullOptions.png) + +* Wait while download is in progress, you will see this as info in the bottom bar. When it's done, you will see a success message. + + ```{note} + The files that were updated may vary! This is not an indication + ``` + + ![Android Studio - Pull successful](../images/update/06_GitPullSuccess.png) + +* Gradle Sync will be running to download some dependencies. Wait until it is finished. + + ![Android Studio - Gradle Sync](../images/studioSetup/40_BackgroundTasks.png) + +### Check JVM version + +This check is particularly indicated if you have already built a previous version of **AAPS** on the same computer. + +Check in the [Building Instructions](#Building-APK-recommended-specification-of-computer-for-building-apk-file) the required version for JVM, matching the **AAPS** version you are now building. Then follow the steps described at [Incompatible Gradle JVM](#incompatible-gradle-jvm) to make sure you currently use the correct version. + +(Update-to-new-version-build-the-signed-apk)= +### Build the Signed APK + +Your sourcecode is now the current released version, and all prerequisites have been checked. It's time to build the signed apk as described in the [build signed apk section](#Building-APK-generate-signed-apk). + +(Update-to-new-version-transfer-and-install)= + +### Transfer and install the apk +You need to transfer the apk to your phone so you can install it. + +```{note} +If you completed the build with the same existing key store in Android Studio, then you do not need to remove the existing app on your phone. When you install the apk, follow the prompts to install updates. +For other scenarios such as establishing a new key store in Android Studio for your signed apk, you will need to delete the old app before installing the apk. **Make sure to export your settings!** +``` + +See the instructions for [transferring and installing AAPS](../SettingUpAaps/TransferringAndInstallingAaps.md) + +Continue [here](#Update-to-new-version-check-aaps-version-on-phone). + +## Troubleshooting + +If anything goes wrong, don't panic. + +Take a breath! + +Then see the separate page [troubleshooting Android Studio](../GettingHelp/TroubleshootingAndroidStudio) if your problem is already documented! + +If you need further help, please reach out to other **AAPS** users on [Facebook](https://www.facebook.com/groups/AndroidAPSUsers) or [Discord](https://discord.gg/4fQUWHZ4Mw). \ No newline at end of file diff --git a/docs/CROWDIN/el/Maintenance/UpdateToNewVersion.md b/docs/CROWDIN/el/Maintenance/UpdateToNewVersion.md index cb9fcb978a61..0e1a294def73 100644 --- a/docs/CROWDIN/el/Maintenance/UpdateToNewVersion.md +++ b/docs/CROWDIN/el/Maintenance/UpdateToNewVersion.md @@ -10,91 +10,14 @@ * When a new release is available, in the **AAPS** app itself, you will receive an information banner about the new version. * The new version will also be announced on Facebook at the time of release. * Following the release, please read the [Release Notes](ReleaseNotes.md) in detail, and clarify any queries with the community on Facebook or Discord, before proceeding with the update. - - ```{note} - 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 +## Update AAPS with browser build -```{contents} Steps for updating to a new version of AAPS :depth: 1 :local: true +If you already built your AAPS app with the Browser Build method, follow [these instructions](./UpdateBrowserBuild.md). -
In case you experience problems, see separate page for [troubleshooting Android Studio](../GettingHelp/TroubleshootingAndroidStudio). - - ### Export your settings - - Export your settings from the existing **AAPS** version on your phone. You might not need it, but better be safe than sorry. - - See the [Export & import settings](ExportImportSettings.md) page if you don't remember how to do this. - - ### Check your Android Studio version - - The minimal version required is described in the [Building Instructions](#Building-APK-recommended-specification-of-computer-for-building-apk-file). If your version is older, please [update Android Studio first](#Building-APK-install-android-studio)! - - (Update-to-new-version-update-your-local-copy)= - ### Update your local copy - - ```{admonition} WARNING - :class: warning - If you update from versions prior to 2.8.x, please follow the instructions to do a [New clone](../SettingUpAaps/BuildingAaps.md), as this guide will not work for you! - +## Update AAPS with a computer -* Open your existing AAPS project with Android Studio. You might need to select your project. (Double) click on the AAPS project. - - ![Android Studio - Select Project](../images/update/01_ProjectSelection.png) - -* In the menu bar of Android Studio, select Git -> Fetch - - ![Android Studio Menu - Git - Fetch](../images/update/02_GitFetch.png) - -* You will see a message in the lower right corner that Fetch was successful. - - ![Android Studio Menu - Git - Fetch successful](../images/update/03_GitFetchSuccessful.png) - -* In the menu bar, now select Git -> Pull - - ![Android Studio Menu - Git - Pull](../images/update/04_GitPull.png) - -* Leave all options as they are (origin/master) and select Pull - - ![Android Studio - Git - Pull dialog](../images/update/05_GitPullOptions.png) - -* Wait while download is in progress, you will see this as info in the bottom bar. When it's done, you will see a success message. - - ```{note} - The files that were updated may vary! This is not an indication - ``` - - ![Android Studio - Pull successful](../images/update/06_GitPullSuccess.png) - -* Gradle Sync will be running to download some dependencies. Wait until it is finished. - - ![Android Studio - Gradle Sync](../images/studioSetup/40_BackgroundTasks.png) - -### Check JVM version - -This check is particularly indicated if you have already built a previous version of **AAPS** on the same computer. - -Check in the [Building Instructions](#Building-APK-recommended-specification-of-computer-for-building-apk-file) the required version for JVM, matching the **AAPS** version you are now building. Then follow the steps described at [Incompatible Gradle JVM](#incompatible-gradle-jvm) to make sure you currently use the correct version. - -(Update-to-new-version-build-the-signed-apk)= - -### Build the Signed APK - -Your sourcecode is now the current released version, and all prerequisites have been checked. It's time to build the signed apk as described in the [build signed apk section](#Building-APK-generate-signed-apk). - -(Update-to-new-version-transfer-and-install)= - -### Transfer and install the apk - -You need to transfer the apk to your phone so you can install it. - -```{note} -If you completed the build with the same existing key store in Android Studio, then you do not need to remove the existing app on your phone. When you install the apk, follow the prompts to install updates. -For other scenarios such as establishing a new key store in Android Studio for your signed apk, you will need to delete the old app before installing the apk. **Make sure to export your settings!** -``` - -See the instructions for [transferring and installing AAPS](../SettingUpAaps/TransferringAndInstallingAaps.md) +Follow [these instructions.](./UpdateComputerBuild.md). (Update-to-new-version-check-aaps-version-on-phone)= @@ -104,14 +27,4 @@ After you installed the new apk, you can check the AAPS version on your phone by ![Η έκδοση AAPS έχει εγκατασταθεί](../images/Update_VersionCheck.png) -Check in the [Release Notes](../Maintenance/ReleaseNotes.md) if there are any specific instructions after update. - -## Troubleshooting - -If anything goes wrong, don't panic. - -Take a breath! - -Then see the separate page [troubleshooting Android Studio](../GettingHelp/TroubleshootingAndroidStudio) if your problem is already documented! - -If you need further help, please reach out to other **AAPS** users on [Facebook](https://www.facebook.com/groups/AndroidAPSUsers) or [Discord](https://discord.gg/4fQUWHZ4Mw). \ No newline at end of file +Check in the [Release Notes](../Maintenance/ReleaseNotes.md) if there are any specific instructions after update. \ No newline at end of file diff --git a/docs/CROWDIN/el/SettingUpAaps/BrowserBuild.md b/docs/CROWDIN/el/SettingUpAaps/BrowserBuild.md index 525d1808b1a2..58dbc578da98 100644 --- a/docs/CROWDIN/el/SettingUpAaps/BrowserBuild.md +++ b/docs/CROWDIN/el/SettingUpAaps/BrowserBuild.md @@ -1,3 +1,5 @@ +(browser-build)= + # Browser build Building AAPS with GitHub Actions. diff --git a/docs/CROWDIN/el/images/Building-the-App/CI/aaps_ci_simple_http_server.png b/docs/CROWDIN/el/images/Building-the-App/CI/aaps_ci_simple_http_server.png index 95ac2d4eb443..2e2fb47e5ca2 100644 Binary files a/docs/CROWDIN/el/images/Building-the-App/CI/aaps_ci_simple_http_server.png and b/docs/CROWDIN/el/images/Building-the-App/CI/aaps_ci_simple_http_server.png differ diff --git a/docs/CROWDIN/el/images/Building-the-App/CI/aaps_ci_simple_http_server_step1.png b/docs/CROWDIN/el/images/Building-the-App/CI/aaps_ci_simple_http_server_step1.png index 78f52682b58d..b348162dcb1c 100644 Binary files a/docs/CROWDIN/el/images/Building-the-App/CI/aaps_ci_simple_http_server_step1.png and b/docs/CROWDIN/el/images/Building-the-App/CI/aaps_ci_simple_http_server_step1.png differ diff --git a/docs/CROWDIN/el/images/Building-the-App/CI/aaps_ci_simple_http_server_step2.png b/docs/CROWDIN/el/images/Building-the-App/CI/aaps_ci_simple_http_server_step2.png index c292ac667f63..cabadeefb97a 100644 Binary files a/docs/CROWDIN/el/images/Building-the-App/CI/aaps_ci_simple_http_server_step2.png and b/docs/CROWDIN/el/images/Building-the-App/CI/aaps_ci_simple_http_server_step2.png differ diff --git a/docs/CROWDIN/el/images/Building-the-App/CI/aaps_ci_simple_http_server_step3.png b/docs/CROWDIN/el/images/Building-the-App/CI/aaps_ci_simple_http_server_step3.png index bd31cd0ffb3d..9a26d3526369 100644 Binary files a/docs/CROWDIN/el/images/Building-the-App/CI/aaps_ci_simple_http_server_step3.png and b/docs/CROWDIN/el/images/Building-the-App/CI/aaps_ci_simple_http_server_step3.png differ diff --git a/docs/CROWDIN/el/images/Building-the-App/CI/aaps_ci_simple_http_server_step4.png b/docs/CROWDIN/el/images/Building-the-App/CI/aaps_ci_simple_http_server_step4.png index cc187ec72a14..285492424351 100644 Binary files a/docs/CROWDIN/el/images/Building-the-App/CI/aaps_ci_simple_http_server_step4.png and b/docs/CROWDIN/el/images/Building-the-App/CI/aaps_ci_simple_http_server_step4.png differ diff --git a/docs/CROWDIN/el/images/Building-the-App/CI/aaps_ci_simple_http_server_store.png b/docs/CROWDIN/el/images/Building-the-App/CI/aaps_ci_simple_http_server_store.png index 4b157ca8d3d8..65bf101f55e4 100644 Binary files a/docs/CROWDIN/el/images/Building-the-App/CI/aaps_ci_simple_http_server_store.png and b/docs/CROWDIN/el/images/Building-the-App/CI/aaps_ci_simple_http_server_store.png differ diff --git a/docs/CROWDIN/el/images/update/CI/GitHubActions1.png b/docs/CROWDIN/el/images/update/CI/GitHubActions1.png new file mode 100644 index 000000000000..e04ce6e76d8b Binary files /dev/null and b/docs/CROWDIN/el/images/update/CI/GitHubActions1.png differ diff --git a/docs/CROWDIN/el/images/update/CI/GitHubActions2.png b/docs/CROWDIN/el/images/update/CI/GitHubActions2.png new file mode 100644 index 000000000000..7b5c5a842d16 Binary files /dev/null and b/docs/CROWDIN/el/images/update/CI/GitHubActions2.png differ diff --git a/docs/CROWDIN/el/images/update/CI/GitHubActions3.png b/docs/CROWDIN/el/images/update/CI/GitHubActions3.png new file mode 100644 index 000000000000..cff0ed34b214 Binary files /dev/null and b/docs/CROWDIN/el/images/update/CI/GitHubActions3.png differ diff --git a/docs/CROWDIN/el/images/update/CI/GitHubActions4.png b/docs/CROWDIN/el/images/update/CI/GitHubActions4.png new file mode 100644 index 000000000000..bede3c2dfe08 Binary files /dev/null and b/docs/CROWDIN/el/images/update/CI/GitHubActions4.png differ diff --git a/docs/CROWDIN/el/images/update/CI/GitHubActions5.png b/docs/CROWDIN/el/images/update/CI/GitHubActions5.png new file mode 100644 index 000000000000..d96e31cf084d Binary files /dev/null and b/docs/CROWDIN/el/images/update/CI/GitHubActions5.png differ diff --git a/docs/CROWDIN/el/images/update/CI/GitHubUpdate1.png b/docs/CROWDIN/el/images/update/CI/GitHubUpdate1.png new file mode 100644 index 000000000000..3058dc270d28 Binary files /dev/null and b/docs/CROWDIN/el/images/update/CI/GitHubUpdate1.png differ diff --git a/docs/CROWDIN/el/images/update/CI/GitHubUpdate2.png b/docs/CROWDIN/el/images/update/CI/GitHubUpdate2.png new file mode 100644 index 000000000000..1ae9568c8107 Binary files /dev/null and b/docs/CROWDIN/el/images/update/CI/GitHubUpdate2.png differ diff --git a/docs/CROWDIN/el/images/update/CI/GitHubUpdate3.png b/docs/CROWDIN/el/images/update/CI/GitHubUpdate3.png new file mode 100644 index 000000000000..d18f9119c76d Binary files /dev/null and b/docs/CROWDIN/el/images/update/CI/GitHubUpdate3.png differ diff --git a/docs/CROWDIN/el/images/update/CI/GitHubUpdate4.png b/docs/CROWDIN/el/images/update/CI/GitHubUpdate4.png new file mode 100644 index 000000000000..8c38c071cb8f Binary files /dev/null and b/docs/CROWDIN/el/images/update/CI/GitHubUpdate4.png differ diff --git a/docs/CROWDIN/el/images/update/CI/GitHubUpdate5.png b/docs/CROWDIN/el/images/update/CI/GitHubUpdate5.png new file mode 100644 index 000000000000..409aef1f34dc Binary files /dev/null and b/docs/CROWDIN/el/images/update/CI/GitHubUpdate5.png differ diff --git a/docs/CROWDIN/el/index.md b/docs/CROWDIN/el/index.md index 1b22a5a0671b..69a9809e1df8 100644 --- a/docs/CROWDIN/el/index.md +++ b/docs/CROWDIN/el/index.md @@ -2,10 +2,10 @@ ![image](./images/basic-outline-of-AAPS.png) -```{admonition} Version 3.3 +```{admonition} Latest Release :class: note -29/12/2024 : Version 3.3 is out. Check the [Release Notes](#version3300) to see what's new and get update instructions. +14/08/2025 : Version 3.3.2.1 is out. Check the [Release Notes](#latestrelease) to see what's new and get update instructions. ``` @@ -21,7 +21,7 @@ Section **2) Getting Started**, the [Introduction](Getting-Started/Introduction. Now that you have a solid understanding of the process, you can start assembling your **AAPS** loop. -Section **3) Setting up AAPS** contains step-by-step instructions to do this. It covers choosing and [setting up your reporting server](./SettingUpAaps/SettingUpTheReportingServer.md) (Nightscout or Tidepool) so you can review and share your data, getting your computer ready for building the AAPS app, building the AAPS app and transferring the AAPS app to your phone. It also covers setting up the **AAPS** app using the setup Wizard, linking it with your CGM app, and either a real or virtual insulin pump, as well as linking **AAPS** to your reporting server. You are then slowly introduced to the full usage of what **AAPS** has to offer via a safe and carefully calibrated step-by-step process designed to make sure that you/your child are thoroughly familiar and comfortable navigating all the different levels and menu configurations before graduating on the next phase, commonly referred to as the next "Objective", until you are have enough experience to begin using the more advanced options available within the app. These Objectives are specially designed in such a way that will gradually unlock more possibilities of **AAPS** and switch from Open Loop to Closed Loop. +Section **3) Setting up AAPS** contains step-by-step instructions to do this. It covers choosing and [setting up your reporting server](./SettingUpAaps/SettingUpTheReportingServer.md) (Nightscout or Tidepool) so you can review and share your data, getting ready for building the AAPS app, building the AAPS app and transferring the AAPS app to your phone. It also covers setting up the **AAPS** app using the setup Wizard, linking it with your CGM app, and either a real or virtual insulin pump, as well as linking **AAPS** to your reporting server. You are then slowly introduced to the full usage of what **AAPS** has to offer via a safe and carefully calibrated step-by-step process designed to make sure that you/your child are thoroughly familiar and comfortable navigating all the different levels and menu configurations before graduating on the next phase, commonly referred to as the next "Objective", until you are have enough experience to begin using the more advanced options available within the app. These Objectives are specially designed in such a way that will gradually unlock more possibilities of **AAPS** and switch from Open Loop to Closed Loop. Section **4) Daily life with AAPS** covers key **AAPS** features, to help you use (and customise) **AAPS**. This including understanding the screens, carbs-on-board, sensitivity, profile switching, temp targets, extended carbs (or eCarbs), automations, and DynamicISF. It also covers frequent topics like how to manage different types of meals, how to deal with cannula and sensor changes, smartphone updates, daylight saving changes, and [travelling with AAPS](DailyLifeWithAaps/TimezoneTraveling-DaylightSavingTime.md) and sports. Common questions and answers are located within the troubleshooting section. diff --git a/docs/CROWDIN/es/Maintenance/DocumentationUpdate.md b/docs/CROWDIN/es/Maintenance/DocumentationUpdate.md index 763b6bf784ee..e5a82db291cc 100644 --- a/docs/CROWDIN/es/Maintenance/DocumentationUpdate.md +++ b/docs/CROWDIN/es/Maintenance/DocumentationUpdate.md @@ -4,7 +4,7 @@ - Updated versions and Android Studio prerequisites - Added [3.3.2.1](#version3321) release, removed Android 16 references (fixed) -- Added [Browser Build](browser-build) @Angus +- Added [Browser Build](#browser-build) @Angus ## May 2025 diff --git a/docs/CROWDIN/es/Maintenance/ReleaseNotes.md b/docs/CROWDIN/es/Maintenance/ReleaseNotes.md index 51fb168ceb2a..4bd1bf89578d 100644 --- a/docs/CROWDIN/es/Maintenance/ReleaseNotes.md +++ b/docs/CROWDIN/es/Maintenance/ReleaseNotes.md @@ -53,6 +53,8 @@ Se han lanzado nuevas versiones de AAPS que sólo comprueban la versión de Andr WearOS 5, API level 34 (Android 14) has [limitations](#BuildingAapsWearOs-WearOS5). ``` +(latestrelease)= + (version3321)= ## Version 3.3.2.1 diff --git a/docs/CROWDIN/es/Maintenance/UpdateBrowserBuild.md b/docs/CROWDIN/es/Maintenance/UpdateBrowserBuild.md new file mode 100644 index 000000000000..4e2a297eecdc --- /dev/null +++ b/docs/CROWDIN/es/Maintenance/UpdateBrowserBuild.md @@ -0,0 +1,101 @@ +# Update with a browser + +## Construyela tú mismo en lugar de descargarla + +**AAPS** is not available to download, due to regulations concerning medical devices. It is legal to build the app for your own use, but you must not give a copy to others! See [FAQ page](../UsefulLinks/FAQ.md) for details. + +```{note} +In case you want to upgrade **AAPS** with a browser for the first time : copy your back-up keystore file to your Google Drive. Then follow the [Browser Build **AAPS** procedure](../SettingUpAaps/BrowserBuild.md) instead of this guide. Instead of creating a new keystore, you must select the one you have copied from your computer. +This operation will be mandatory only the first time, then for successive upgrades you will be able to follow this guide. +``` + +## Overview for updating to a new version of AAPS with a browser + +```{contents} Steps for updating to a new version of AAPS +:depth: 1 +:local: true +``` + +In case you experience problems, see separate page for [troubleshooting Android Studio](../GettingHelp/TroubleshootingAndroidStudio). + +### Export your settings + +Export your settings from the existing **AAPS** version on your phone. You might not need it, but better be safe than sorry. + +See the [Export & import settings](ExportImportSettings.md) page if you don't remember how to do this. + +(Update-to-new-version-update-your-repo)= +### Update your GitHub repository + +```{admonition} WARNING +:class: warning +Browser Build is available from AAPS version 3.3.2.1. +``` + +[Log into GitHub](https://github.com/login). + +1. Select Repositories. +2. Scroll down and select your own AndroidAPS repository. + +![Select AndroidAPS repo](../images/update/CI/GitHubUpdate1.png) + +3. Verify you are using your own copy of AndroidAPS (Forked from nightscout/AndroidAPS) +4. Tap Sync Fork to update it (the number of commits behind might differ from the picture) + + + +![Sync AndroidAPS repo](../images/update/CI/GitHubUpdate2.png) + +5. Tap Update Branch + +![Update AndroidAPS repo](../images/update/CI/GitHubUpdate3.png) + +Note: if you have modified your copy of AndroidAPS by mistake, you will see this screen. Discard all changes (commits) to return to the released version. + +![Discard rogue modifications](../images/update/CI/GitHubUpdate4.png) + +You have now synchronized (updated) your own copy with the latest release of Android APS. Good job. + +![Repo sync'ed](../images/update/CI/GitHubUpdate5.png) + +### Run the Workflow to Build the Signed APK + +1. In your GitHub copy of AndroidAPS, select Actions. +2. Expand All Workflows. +3. Select AAPS-CI + +![Actions AAPS-CI](../images/update/CI/GitHubActions1.png) + +4. Scroll down and tap Run Workflow. + +![Run Workflow](../images/update/CI/GitHubActions2.png) + +5. Select the branch you want to deploy (master), the [variant](variant) (fullRelease) and tap Run Workflow. + + + +![Run Workflow](../images/update/CI/GitHubActions3.png) + +6. You will see the message Workflow run was successfully requested. Refresh your browser page and you will be able to monitor the build progress. When the action completes, the AAPS CI action will show a green tick mark. You have successfully built the updated version of Android APS. + +![Monitor Workflow](../images/update/CI/GitHubActions4.png) + +### Install the AAPS APK + +1. Open your Google Drive +2. Browse into AAPS, select the new version folder and you will find both the phone and Android Wear versions. + +![Google Drive Location](../images/update/CI/GitHubActions5.png) + + +Continue [here](#Update-to-new-version-check-aaps-version-on-phone) + +## Troubleshooting + +If anything goes wrong, don't panic. + +Take a breath! + +Then see the [troubleshooting tips](#aaps-ci-preparation) if your problem is already documented! + +If you need further help, please reach out to other **AAPS** users on [Facebook](https://www.facebook.com/groups/AndroidAPSUsers) or [Discord](https://discord.gg/4fQUWHZ4Mw). \ No newline at end of file diff --git a/docs/CROWDIN/es/Maintenance/UpdateComputerBuild.md b/docs/CROWDIN/es/Maintenance/UpdateComputerBuild.md new file mode 100644 index 000000000000..f3200a487103 --- /dev/null +++ b/docs/CROWDIN/es/Maintenance/UpdateComputerBuild.md @@ -0,0 +1,103 @@ +# Update with a computer + +## Construyela tú mismo en lugar de descargarla + +**AAPS** is not available to download, due to regulations concerning medical devices. It is legal to build the app for your own use, but you must not give a copy to others! See [FAQ page](../UsefulLinks/FAQ.md) for details. + +```{note} +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 + +```{contents} Steps for updating to a new version of AAPS +:depth: 1 +:local: true +``` + +In case you experience problems, see separate page for [troubleshooting Android Studio](../GettingHelp/TroubleshootingAndroidStudio). + +### Export your settings + +Export your settings from the existing **AAPS** version on your phone. You might not need it, but better be safe than sorry. + +See the [Export & import settings](ExportImportSettings.md) page if you don't remember how to do this. + +### Check your Android Studio version + +The minimal version required is described in the [Building Instructions](#Building-APK-recommended-specification-of-computer-for-building-apk-file). If your version is older, please [update Android Studio first](#Building-APK-install-android-studio)! + +(Update-to-new-version-update-your-local-copy)= +### Update your local copy + +```{admonition} WARNING +:class: warning +If you update from versions prior to 2.8.x, please follow the instructions to do a [New clone](../SettingUpAaps/BuildingAaps.md), as this guide will not work for you! +``` + +* Open your existing AAPS project with Android Studio. You might need to select your project. (Double) click on the AAPS project. + + ![Android Studio - Select Project](../images/update/01_ProjectSelection.png) + +* In the menu bar of Android Studio, select Git -> Fetch + + ![Android Studio Menu - Git - Fetch](../images/update/02_GitFetch.png) + +* You will see a message in the lower right corner that Fetch was successful. + + ![Android Studio Menu - Git - Fetch successful](../images/update/03_GitFetchSuccessful.png) + +* In the menu bar, now select Git -> Pull + + ![Android Studio Menu - Git - Pull](../images/update/04_GitPull.png) + +* Leave all options as they are (origin/master) and select Pull + + ![Android Studio - Git - Pull dialog](../images/update/05_GitPullOptions.png) + +* Wait while download is in progress, you will see this as info in the bottom bar. When it's done, you will see a success message. + + ```{note} + The files that were updated may vary! This is not an indication + ``` + + ![Android Studio - Pull successful](../images/update/06_GitPullSuccess.png) + +* Gradle Sync will be running to download some dependencies. Wait until it is finished. + + ![Android Studio - Gradle Sync](../images/studioSetup/40_BackgroundTasks.png) + +### Check JVM version + +This check is particularly indicated if you have already built a previous version of **AAPS** on the same computer. + +Check in the [Building Instructions](#Building-APK-recommended-specification-of-computer-for-building-apk-file) the required version for JVM, matching the **AAPS** version you are now building. Then follow the steps described at [Incompatible Gradle JVM](#incompatible-gradle-jvm) to make sure you currently use the correct version. + +(Update-to-new-version-build-the-signed-apk)= +### Build the Signed APK + +Your sourcecode is now the current released version, and all prerequisites have been checked. It's time to build the signed apk as described in the [build signed apk section](#Building-APK-generate-signed-apk). + +(Update-to-new-version-transfer-and-install)= + +### Transfer and install the apk +You need to transfer the apk to your phone so you can install it. + +```{note} +If you completed the build with the same existing key store in Android Studio, then you do not need to remove the existing app on your phone. When you install the apk, follow the prompts to install updates. +For other scenarios such as establishing a new key store in Android Studio for your signed apk, you will need to delete the old app before installing the apk. **Make sure to export your settings!** +``` + +See the instructions for [transferring and installing AAPS](../SettingUpAaps/TransferringAndInstallingAaps.md) + +Continue [here](#Update-to-new-version-check-aaps-version-on-phone). + +## Troubleshooting + +If anything goes wrong, don't panic. + +Take a breath! + +Then see the separate page [troubleshooting Android Studio](../GettingHelp/TroubleshootingAndroidStudio) if your problem is already documented! + +If you need further help, please reach out to other **AAPS** users on [Facebook](https://www.facebook.com/groups/AndroidAPSUsers) or [Discord](https://discord.gg/4fQUWHZ4Mw). \ No newline at end of file diff --git a/docs/CROWDIN/es/Maintenance/UpdateToNewVersion.md b/docs/CROWDIN/es/Maintenance/UpdateToNewVersion.md index 58e9e1ce0a9c..dc7606872dbf 100644 --- a/docs/CROWDIN/es/Maintenance/UpdateToNewVersion.md +++ b/docs/CROWDIN/es/Maintenance/UpdateToNewVersion.md @@ -10,91 +10,14 @@ * When a new release is available, in the **AAPS** app itself, you will receive an information banner about the new version. * The new version will also be announced on Facebook at the time of release. * Following the release, please read the [Release Notes](ReleaseNotes.md) in detail, and clarify any queries with the community on Facebook or Discord, before proceeding with the update. - - ```{note} - 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 +## Update AAPS with browser build -```{contents} Steps for updating to a new version of AAPS :depth: 1 :local: true +If you already built your AAPS app with the Browser Build method, follow [these instructions](./UpdateBrowserBuild.md). -
In case you experience problems, see separate page for [troubleshooting Android Studio](../GettingHelp/TroubleshootingAndroidStudio). - - ### Export your settings - - Export your settings from the existing **AAPS** version on your phone. You might not need it, but better be safe than sorry. - - See the [Export & import settings](ExportImportSettings.md) page if you don't remember how to do this. - - ### Check your Android Studio version - - The minimal version required is described in the [Building Instructions](#Building-APK-recommended-specification-of-computer-for-building-apk-file). If your version is older, please [update Android Studio first](#Building-APK-install-android-studio)! - - (Update-to-new-version-update-your-local-copy)= - ### Update your local copy - - ```{admonition} WARNING - :class: warning - If you update from versions prior to 2.8.x, please follow the instructions to do a [New clone](../SettingUpAaps/BuildingAaps.md), as this guide will not work for you! - +## Update AAPS with a computer -* Open your existing AAPS project with Android Studio. You might need to select your project. (Double) click on the AAPS project. - - ![Android Studio - Select Project](../images/update/01_ProjectSelection.png) - -* In the menu bar of Android Studio, select Git -> Fetch - - ![Android Studio Menu - Git - Fetch](../images/update/02_GitFetch.png) - -* You will see a message in the lower right corner that Fetch was successful. - - ![Android Studio Menu - Git - Fetch successful](../images/update/03_GitFetchSuccessful.png) - -* In the menu bar, now select Git -> Pull - - ![Android Studio Menu - Git - Pull](../images/update/04_GitPull.png) - -* Leave all options as they are (origin/master) and select Pull - - ![Android Studio - Git - Pull dialog](../images/update/05_GitPullOptions.png) - -* Wait while download is in progress, you will see this as info in the bottom bar. When it's done, you will see a success message. - - ```{note} - The files that were updated may vary! This is not an indication - ``` - - ![Android Studio - Pull successful](../images/update/06_GitPullSuccess.png) - -* Gradle Sync will be running to download some dependencies. Wait until it is finished. - - ![Android Studio - Gradle Sync](../images/studioSetup/40_BackgroundTasks.png) - -### Check JVM version - -This check is particularly indicated if you have already built a previous version of **AAPS** on the same computer. - -Check in the [Building Instructions](#Building-APK-recommended-specification-of-computer-for-building-apk-file) the required version for JVM, matching the **AAPS** version you are now building. Then follow the steps described at [Incompatible Gradle JVM](#incompatible-gradle-jvm) to make sure you currently use the correct version. - -(Update-to-new-version-build-the-signed-apk)= - -### Build the Signed APK - -Your sourcecode is now the current released version, and all prerequisites have been checked. It's time to build the signed apk as described in the [build signed apk section](#Building-APK-generate-signed-apk). - -(Update-to-new-version-transfer-and-install)= - -### Transfer and install the apk - -You need to transfer the apk to your phone so you can install it. - -```{note} -If you completed the build with the same existing key store in Android Studio, then you do not need to remove the existing app on your phone. When you install the apk, follow the prompts to install updates. -For other scenarios such as establishing a new key store in Android Studio for your signed apk, you will need to delete the old app before installing the apk. **Make sure to export your settings!** -``` - -See the instructions for [transferring and installing AAPS](../SettingUpAaps/TransferringAndInstallingAaps.md) +Follow [these instructions.](./UpdateComputerBuild.md). (Update-to-new-version-check-aaps-version-on-phone)= @@ -104,14 +27,4 @@ After you installed the new apk, you can check the AAPS version on your phone by ![AAPS version installed](../images/Update_VersionCheck.png) -Check in the [Release Notes](../Maintenance/ReleaseNotes.md) if there are any specific instructions after update. - -## Troubleshooting - -If anything goes wrong, don't panic. - -Take a breath! - -Then see the separate page [troubleshooting Android Studio](../GettingHelp/TroubleshootingAndroidStudio) if your problem is already documented! - -If you need further help, please reach out to other **AAPS** users on [Facebook](https://www.facebook.com/groups/AndroidAPSUsers) or [Discord](https://discord.gg/4fQUWHZ4Mw). \ No newline at end of file +Check in the [Release Notes](../Maintenance/ReleaseNotes.md) if there are any specific instructions after update. \ No newline at end of file diff --git a/docs/CROWDIN/es/SettingUpAaps/BrowserBuild.md b/docs/CROWDIN/es/SettingUpAaps/BrowserBuild.md index 97a47bdd8b27..61074bb261c6 100644 --- a/docs/CROWDIN/es/SettingUpAaps/BrowserBuild.md +++ b/docs/CROWDIN/es/SettingUpAaps/BrowserBuild.md @@ -1,3 +1,5 @@ +(browser-build)= + # Browser build Building AAPS with GitHub Actions. diff --git a/docs/CROWDIN/es/images/Building-the-App/CI/aaps_ci_simple_http_server.png b/docs/CROWDIN/es/images/Building-the-App/CI/aaps_ci_simple_http_server.png index 95ac2d4eb443..2e2fb47e5ca2 100644 Binary files a/docs/CROWDIN/es/images/Building-the-App/CI/aaps_ci_simple_http_server.png and b/docs/CROWDIN/es/images/Building-the-App/CI/aaps_ci_simple_http_server.png differ diff --git a/docs/CROWDIN/es/images/Building-the-App/CI/aaps_ci_simple_http_server_step1.png b/docs/CROWDIN/es/images/Building-the-App/CI/aaps_ci_simple_http_server_step1.png index 78f52682b58d..b348162dcb1c 100644 Binary files a/docs/CROWDIN/es/images/Building-the-App/CI/aaps_ci_simple_http_server_step1.png and b/docs/CROWDIN/es/images/Building-the-App/CI/aaps_ci_simple_http_server_step1.png differ diff --git a/docs/CROWDIN/es/images/Building-the-App/CI/aaps_ci_simple_http_server_step2.png b/docs/CROWDIN/es/images/Building-the-App/CI/aaps_ci_simple_http_server_step2.png index c292ac667f63..cabadeefb97a 100644 Binary files a/docs/CROWDIN/es/images/Building-the-App/CI/aaps_ci_simple_http_server_step2.png and b/docs/CROWDIN/es/images/Building-the-App/CI/aaps_ci_simple_http_server_step2.png differ diff --git a/docs/CROWDIN/es/images/Building-the-App/CI/aaps_ci_simple_http_server_step3.png b/docs/CROWDIN/es/images/Building-the-App/CI/aaps_ci_simple_http_server_step3.png index bd31cd0ffb3d..9a26d3526369 100644 Binary files a/docs/CROWDIN/es/images/Building-the-App/CI/aaps_ci_simple_http_server_step3.png and b/docs/CROWDIN/es/images/Building-the-App/CI/aaps_ci_simple_http_server_step3.png differ diff --git a/docs/CROWDIN/es/images/Building-the-App/CI/aaps_ci_simple_http_server_step4.png b/docs/CROWDIN/es/images/Building-the-App/CI/aaps_ci_simple_http_server_step4.png index cc187ec72a14..285492424351 100644 Binary files a/docs/CROWDIN/es/images/Building-the-App/CI/aaps_ci_simple_http_server_step4.png and b/docs/CROWDIN/es/images/Building-the-App/CI/aaps_ci_simple_http_server_step4.png differ diff --git a/docs/CROWDIN/es/images/Building-the-App/CI/aaps_ci_simple_http_server_store.png b/docs/CROWDIN/es/images/Building-the-App/CI/aaps_ci_simple_http_server_store.png index 4b157ca8d3d8..65bf101f55e4 100644 Binary files a/docs/CROWDIN/es/images/Building-the-App/CI/aaps_ci_simple_http_server_store.png and b/docs/CROWDIN/es/images/Building-the-App/CI/aaps_ci_simple_http_server_store.png differ diff --git a/docs/CROWDIN/es/images/update/CI/GitHubActions1.png b/docs/CROWDIN/es/images/update/CI/GitHubActions1.png new file mode 100644 index 000000000000..e04ce6e76d8b Binary files /dev/null and b/docs/CROWDIN/es/images/update/CI/GitHubActions1.png differ diff --git a/docs/CROWDIN/es/images/update/CI/GitHubActions2.png b/docs/CROWDIN/es/images/update/CI/GitHubActions2.png new file mode 100644 index 000000000000..7b5c5a842d16 Binary files /dev/null and b/docs/CROWDIN/es/images/update/CI/GitHubActions2.png differ diff --git a/docs/CROWDIN/es/images/update/CI/GitHubActions3.png b/docs/CROWDIN/es/images/update/CI/GitHubActions3.png new file mode 100644 index 000000000000..cff0ed34b214 Binary files /dev/null and b/docs/CROWDIN/es/images/update/CI/GitHubActions3.png differ diff --git a/docs/CROWDIN/es/images/update/CI/GitHubActions4.png b/docs/CROWDIN/es/images/update/CI/GitHubActions4.png new file mode 100644 index 000000000000..bede3c2dfe08 Binary files /dev/null and b/docs/CROWDIN/es/images/update/CI/GitHubActions4.png differ diff --git a/docs/CROWDIN/es/images/update/CI/GitHubActions5.png b/docs/CROWDIN/es/images/update/CI/GitHubActions5.png new file mode 100644 index 000000000000..d96e31cf084d Binary files /dev/null and b/docs/CROWDIN/es/images/update/CI/GitHubActions5.png differ diff --git a/docs/CROWDIN/es/images/update/CI/GitHubUpdate1.png b/docs/CROWDIN/es/images/update/CI/GitHubUpdate1.png new file mode 100644 index 000000000000..3058dc270d28 Binary files /dev/null and b/docs/CROWDIN/es/images/update/CI/GitHubUpdate1.png differ diff --git a/docs/CROWDIN/es/images/update/CI/GitHubUpdate2.png b/docs/CROWDIN/es/images/update/CI/GitHubUpdate2.png new file mode 100644 index 000000000000..1ae9568c8107 Binary files /dev/null and b/docs/CROWDIN/es/images/update/CI/GitHubUpdate2.png differ diff --git a/docs/CROWDIN/es/images/update/CI/GitHubUpdate3.png b/docs/CROWDIN/es/images/update/CI/GitHubUpdate3.png new file mode 100644 index 000000000000..d18f9119c76d Binary files /dev/null and b/docs/CROWDIN/es/images/update/CI/GitHubUpdate3.png differ diff --git a/docs/CROWDIN/es/images/update/CI/GitHubUpdate4.png b/docs/CROWDIN/es/images/update/CI/GitHubUpdate4.png new file mode 100644 index 000000000000..8c38c071cb8f Binary files /dev/null and b/docs/CROWDIN/es/images/update/CI/GitHubUpdate4.png differ diff --git a/docs/CROWDIN/es/images/update/CI/GitHubUpdate5.png b/docs/CROWDIN/es/images/update/CI/GitHubUpdate5.png new file mode 100644 index 000000000000..409aef1f34dc Binary files /dev/null and b/docs/CROWDIN/es/images/update/CI/GitHubUpdate5.png differ diff --git a/docs/CROWDIN/es/index.md b/docs/CROWDIN/es/index.md index 6648b19ae2cf..5f5628f32afd 100644 --- a/docs/CROWDIN/es/index.md +++ b/docs/CROWDIN/es/index.md @@ -2,10 +2,10 @@ ![imagen](./images/basic-outline-of-AAPS.png) -```{admonition} Version 3.3 +```{admonition} Latest Release :class: note -29/12/2024 : Version 3.3 is out. Check the [Release Notes](#version3300) to see what's new and get update instructions. +14/08/2025 : Version 3.3.2.1 is out. Check the [Release Notes](#latestrelease) to see what's new and get update instructions. ``` @@ -21,7 +21,7 @@ Section **2) Getting Started**, the [Introduction](Getting-Started/Introduction. Now that you have a solid understanding of the process, you can start assembling your **AAPS** loop. -Section **3) Setting up AAPS** contains step-by-step instructions to do this. It covers choosing and [setting up your reporting server](./SettingUpAaps/SettingUpTheReportingServer.md) (Nightscout or Tidepool) so you can review and share your data, getting your computer ready for building the AAPS app, building the AAPS app and transferring the AAPS app to your phone. It also covers setting up the **AAPS** app using the setup Wizard, linking it with your CGM app, and either a real or virtual insulin pump, as well as linking **AAPS** to your reporting server. You are then slowly introduced to the full usage of what **AAPS** has to offer via a safe and carefully calibrated step-by-step process designed to make sure that you/your child are thoroughly familiar and comfortable navigating all the different levels and menu configurations before graduating on the next phase, commonly referred to as the next "Objective", until you are have enough experience to begin using the more advanced options available within the app. These Objectives are specially designed in such a way that will gradually unlock more possibilities of **AAPS** and switch from Open Loop to Closed Loop. +Section **3) Setting up AAPS** contains step-by-step instructions to do this. It covers choosing and [setting up your reporting server](./SettingUpAaps/SettingUpTheReportingServer.md) (Nightscout or Tidepool) so you can review and share your data, getting ready for building the AAPS app, building the AAPS app and transferring the AAPS app to your phone. It also covers setting up the **AAPS** app using the setup Wizard, linking it with your CGM app, and either a real or virtual insulin pump, as well as linking **AAPS** to your reporting server. You are then slowly introduced to the full usage of what **AAPS** has to offer via a safe and carefully calibrated step-by-step process designed to make sure that you/your child are thoroughly familiar and comfortable navigating all the different levels and menu configurations before graduating on the next phase, commonly referred to as the next "Objective", until you are have enough experience to begin using the more advanced options available within the app. These Objectives are specially designed in such a way that will gradually unlock more possibilities of **AAPS** and switch from Open Loop to Closed Loop. Section **4) Daily life with AAPS** covers key **AAPS** features, to help you use (and customise) **AAPS**. This including understanding the screens, carbs-on-board, sensitivity, profile switching, temp targets, extended carbs (or eCarbs), automations, and DynamicISF. It also covers frequent topics like how to manage different types of meals, how to deal with cannula and sensor changes, smartphone updates, daylight saving changes, and [travelling with AAPS](DailyLifeWithAaps/TimezoneTraveling-DaylightSavingTime.md) and sports. Common questions and answers are located within the troubleshooting section. diff --git a/docs/CROWDIN/fr/Maintenance/DocumentationUpdate.md b/docs/CROWDIN/fr/Maintenance/DocumentationUpdate.md index 683fcb1c2af9..8a061a8356f3 100644 --- a/docs/CROWDIN/fr/Maintenance/DocumentationUpdate.md +++ b/docs/CROWDIN/fr/Maintenance/DocumentationUpdate.md @@ -4,7 +4,7 @@ - Updated versions and Android Studio prerequisites - Added [3.3.2.1](#version3321) release, removed Android 16 references (fixed) -- Added [Browser Build](browser-build) @Angus +- Added [Browser Build](#browser-build) @Angus ## May 2025 diff --git a/docs/CROWDIN/fr/Maintenance/ReleaseNotes.md b/docs/CROWDIN/fr/Maintenance/ReleaseNotes.md index 8b6ebae8eaca..59fc37f1d955 100644 --- a/docs/CROWDIN/fr/Maintenance/ReleaseNotes.md +++ b/docs/CROWDIN/fr/Maintenance/ReleaseNotes.md @@ -55,6 +55,8 @@ Afin de permettre aux utilisateurs ayant une ancienne version d'Android d'utilis WearOS 5, API level 34 (Android 14) has [limitations](#BuildingAapsWearOs-WearOS5). ``` +(latestrelease)= + (version3321)= ## Version 3.3.2.1 diff --git a/docs/CROWDIN/fr/Maintenance/UpdateBrowserBuild.md b/docs/CROWDIN/fr/Maintenance/UpdateBrowserBuild.md new file mode 100644 index 000000000000..8c93074c828a --- /dev/null +++ b/docs/CROWDIN/fr/Maintenance/UpdateBrowserBuild.md @@ -0,0 +1,101 @@ +# Update with a browser + +## Construire vous-même au lieu de télécharger + +**AAPS** is not available to download, due to regulations concerning medical devices. Il est légal de construire l'application pour votre usage personnel, mais vous ne devez en aucun cas donner une copie à d'autres personnes ! See [FAQ page](../UsefulLinks/FAQ.md) for details. + +```{note} +In case you want to upgrade **AAPS** with a browser for the first time : copy your back-up keystore file to your Google Drive. Then follow the [Browser Build **AAPS** procedure](../SettingUpAaps/BrowserBuild.md) instead of this guide. Instead of creating a new keystore, you must select the one you have copied from your computer. +This operation will be mandatory only the first time, then for successive upgrades you will be able to follow this guide. +``` + +## Overview for updating to a new version of AAPS with a browser + +```{contents} Steps for updating to a new version of AAPS +:depth: 1 +:local: true +``` + +In case you experience problems, see separate page for [troubleshooting Android Studio](../GettingHelp/TroubleshootingAndroidStudio). + +### Export your settings + +Export your settings from the existing **AAPS** version on your phone. You might not need it, but better be safe than sorry. + +See the [Export & import settings](ExportImportSettings.md) page if you don't remember how to do this. + +(Update-to-new-version-update-your-repo)= +### Update your GitHub repository + +```{admonition} WARNING +:class: warning +Browser Build is available from AAPS version 3.3.2.1. +``` + +[Log into GitHub](https://github.com/login). + +1. Select Repositories. +2. Scroll down and select your own AndroidAPS repository. + +![Select AndroidAPS repo](../images/update/CI/GitHubUpdate1.png) + +3. Verify you are using your own copy of AndroidAPS (Forked from nightscout/AndroidAPS) +4. Tap Sync Fork to update it (the number of commits behind might differ from the picture) + + + +![Sync AndroidAPS repo](../images/update/CI/GitHubUpdate2.png) + +5. Tap Update Branch + +![Update AndroidAPS repo](../images/update/CI/GitHubUpdate3.png) + +Note: if you have modified your copy of AndroidAPS by mistake, you will see this screen. Discard all changes (commits) to return to the released version. + +![Discard rogue modifications](../images/update/CI/GitHubUpdate4.png) + +You have now synchronized (updated) your own copy with the latest release of Android APS. Good job. + +![Repo sync'ed](../images/update/CI/GitHubUpdate5.png) + +### Run the Workflow to Build the Signed APK + +1. In your GitHub copy of AndroidAPS, select Actions. +2. Expand All Workflows. +3. Select AAPS-CI + +![Actions AAPS-CI](../images/update/CI/GitHubActions1.png) + +4. Scroll down and tap Run Workflow. + +![Run Workflow](../images/update/CI/GitHubActions2.png) + +5. Select the branch you want to deploy (master), the [variant](variant) (fullRelease) and tap Run Workflow. + + + +![Run Workflow](../images/update/CI/GitHubActions3.png) + +6. You will see the message Workflow run was successfully requested. Refresh your browser page and you will be able to monitor the build progress. When the action completes, the AAPS CI action will show a green tick mark. You have successfully built the updated version of Android APS. + +![Monitor Workflow](../images/update/CI/GitHubActions4.png) + +### Install the AAPS APK + +1. Open your Google Drive +2. Browse into AAPS, select the new version folder and you will find both the phone and Android Wear versions. + +![Google Drive Location](../images/update/CI/GitHubActions5.png) + + +Continue [here](#Update-to-new-version-check-aaps-version-on-phone) + +## Troubleshooting + +Si quelque chose ne va pas, ne paniquez pas. + +Respirez un bon coup ! + +Then see the [troubleshooting tips](#aaps-ci-preparation) if your problem is already documented! + +If you need further help, please reach out to other **AAPS** users on [Facebook](https://www.facebook.com/groups/AndroidAPSUsers) or [Discord](https://discord.gg/4fQUWHZ4Mw). \ No newline at end of file diff --git a/docs/CROWDIN/fr/Maintenance/UpdateComputerBuild.md b/docs/CROWDIN/fr/Maintenance/UpdateComputerBuild.md new file mode 100644 index 000000000000..7569ab1eafc8 --- /dev/null +++ b/docs/CROWDIN/fr/Maintenance/UpdateComputerBuild.md @@ -0,0 +1,103 @@ +# Update with a computer + +## Construire vous-même au lieu de télécharger + +**AAPS** is not available to download, due to regulations concerning medical devices. Il est légal de construire l'application pour votre usage personnel, mais vous ne devez en aucun cas donner une copie à d'autres personnes ! See [FAQ page](../UsefulLinks/FAQ.md) for details. + +```{note} +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 + +```{contents} Steps for updating to a new version of AAPS +:depth: 1 +:local: true +``` + +In case you experience problems, see separate page for [troubleshooting Android Studio](../GettingHelp/TroubleshootingAndroidStudio). + +### Export your settings + +Export your settings from the existing **AAPS** version on your phone. You might not need it, but better be safe than sorry. + +See the [Export & import settings](ExportImportSettings.md) page if you don't remember how to do this. + +### Check your Android Studio version + +The minimal version required is described in the [Building Instructions](#Building-APK-recommended-specification-of-computer-for-building-apk-file). If your version is older, please [update Android Studio first](#Building-APK-install-android-studio)! + +(Update-to-new-version-update-your-local-copy)= +### Update your local copy + +```{admonition} WARNING +:class: warning +If you update from versions prior to 2.8.x, please follow the instructions to do a [New clone](../SettingUpAaps/BuildingAaps.md), as this guide will not work for you! +``` + +* Open your existing AAPS project with Android Studio. You might need to select your project. (Double) click on the AAPS project. + + ![Android Studio - Select Project](../images/update/01_ProjectSelection.png) + +* In the menu bar of Android Studio, select Git -> Fetch + + ![Android Studio Menu - Git - Fetch](../images/update/02_GitFetch.png) + +* You will see a message in the lower right corner that Fetch was successful. + + ![Android Studio Menu - Git - Fetch successful](../images/update/03_GitFetchSuccessful.png) + +* In the menu bar, now select Git -> Pull + + ![Android Studio Menu - Git - Pull](../images/update/04_GitPull.png) + +* Leave all options as they are (origin/master) and select Pull + + ![Android Studio - Git - Pull dialog](../images/update/05_GitPullOptions.png) + +* Wait while download is in progress, you will see this as info in the bottom bar. Une fois terminé, vous verrez un message de réussite. + + ```{note} + The files that were updated may vary! This is not an indication + ``` + + ![Android Studio - Pull successful](../images/update/06_GitPullSuccess.png) + +* Gradle Sync will be running to download some dependencies. Patientez jusqu'à ce que ce soit fini. + + ![Android Studio - Gradle Sync](../images/studioSetup/40_BackgroundTasks.png) + +### Check JVM version + +This check is particularly indicated if you have already built a previous version of **AAPS** on the same computer. + +Check in the [Building Instructions](#Building-APK-recommended-specification-of-computer-for-building-apk-file) the required version for JVM, matching the **AAPS** version you are now building. Then follow the steps described at [Incompatible Gradle JVM](#incompatible-gradle-jvm) to make sure you currently use the correct version. + +(Update-to-new-version-build-the-signed-apk)= +### Build the Signed APK + +Your sourcecode is now the current released version, and all prerequisites have been checked. It's time to build the signed apk as described in the [build signed apk section](#Building-APK-generate-signed-apk). + +(Update-to-new-version-transfer-and-install)= + +### Transfer and install the apk +You need to transfer the apk to your phone so you can install it. + +```{note} +If you completed the build with the same existing key store in Android Studio, then you do not need to remove the existing app on your phone. Lorsque vous installez l'apk, suivez les instructions pour installer les mises à jour. +Pour d'autres scénarios comme la création d'un nouveau fichier de clés dans Android Studio pour votre apk signé, vous devrez d'abord supprimer l'ancienne application avant d'installer l'apk. **Make sure to export your settings!** +``` + +See the instructions for [transferring and installing AAPS](../SettingUpAaps/TransferringAndInstallingAaps.md) + +Continue [here](#Update-to-new-version-check-aaps-version-on-phone). + +## Troubleshooting + +Si quelque chose ne va pas, ne paniquez pas. + +Respirez un bon coup ! + +Then see the separate page [troubleshooting Android Studio](../GettingHelp/TroubleshootingAndroidStudio) if your problem is already documented! + +If you need further help, please reach out to other **AAPS** users on [Facebook](https://www.facebook.com/groups/AndroidAPSUsers) or [Discord](https://discord.gg/4fQUWHZ4Mw). \ No newline at end of file diff --git a/docs/CROWDIN/fr/Maintenance/UpdateToNewVersion.md b/docs/CROWDIN/fr/Maintenance/UpdateToNewVersion.md index a595542b71d7..b63241b1f90a 100644 --- a/docs/CROWDIN/fr/Maintenance/UpdateToNewVersion.md +++ b/docs/CROWDIN/fr/Maintenance/UpdateToNewVersion.md @@ -10,91 +10,14 @@ * When a new release is available, in the **AAPS** app itself, you will receive an information banner about the new version. * The new version will also be announced on Facebook at the time of release. * Following the release, please read the [Release Notes](ReleaseNotes.md) in detail, and clarify any queries with the community on Facebook or Discord, before proceeding with the update. - - ```{note} - 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 +## Update AAPS with browser build -```{contents} Steps for updating to a new version of AAPS :depth: 1 :local: true +If you already built your AAPS app with the Browser Build method, follow [these instructions](./UpdateBrowserBuild.md). -
In case you experience problems, see separate page for [troubleshooting Android Studio](../GettingHelp/TroubleshootingAndroidStudio). - - ### Export your settings - - Export your settings from the existing **AAPS** version on your phone. You might not need it, but better be safe than sorry. - - See the [Export & import settings](ExportImportSettings.md) page if you don't remember how to do this. - - ### Check your Android Studio version - - The minimal version required is described in the [Building Instructions](#Building-APK-recommended-specification-of-computer-for-building-apk-file). If your version is older, please [update Android Studio first](#Building-APK-install-android-studio)! - - (Update-to-new-version-update-your-local-copy)= - ### Update your local copy - - ```{admonition} WARNING - :class: warning - If you update from versions prior to 2.8.x, please follow the instructions to do a [New clone](../SettingUpAaps/BuildingAaps.md), as this guide will not work for you! - +## Update AAPS with a computer -* Open your existing AAPS project with Android Studio. You might need to select your project. (Double) click on the AAPS project. - - ![Android Studio - Select Project](../images/update/01_ProjectSelection.png) - -* In the menu bar of Android Studio, select Git -> Fetch - - ![Android Studio Menu - Git - Fetch](../images/update/02_GitFetch.png) - -* You will see a message in the lower right corner that Fetch was successful. - - ![Android Studio Menu - Git - Fetch successful](../images/update/03_GitFetchSuccessful.png) - -* In the menu bar, now select Git -> Pull - - ![Android Studio Menu - Git - Pull](../images/update/04_GitPull.png) - -* Leave all options as they are (origin/master) and select Pull - - ![Android Studio - Git - Pull dialog](../images/update/05_GitPullOptions.png) - -* Wait while download is in progress, you will see this as info in the bottom bar. Une fois terminé, vous verrez un message de réussite. - - ```{note} - The files that were updated may vary! This is not an indication - ``` - - ![Android Studio - Pull successful](../images/update/06_GitPullSuccess.png) - -* Gradle Sync will be running to download some dependencies. Patientez jusqu'à ce que ce soit fini. - - ![Android Studio - Gradle Sync](../images/studioSetup/40_BackgroundTasks.png) - -### Check JVM version - -This check is particularly indicated if you have already built a previous version of **AAPS** on the same computer. - -Check in the [Building Instructions](#Building-APK-recommended-specification-of-computer-for-building-apk-file) the required version for JVM, matching the **AAPS** version you are now building. Then follow the steps described at [Incompatible Gradle JVM](#incompatible-gradle-jvm) to make sure you currently use the correct version. - -(Update-to-new-version-build-the-signed-apk)= - -### Build the Signed APK - -Your sourcecode is now the current released version, and all prerequisites have been checked. It's time to build the signed apk as described in the [build signed apk section](#Building-APK-generate-signed-apk). - -(Update-to-new-version-transfer-and-install)= - -### Transfer and install the apk - -You need to transfer the apk to your phone so you can install it. - -```{note} -If you completed the build with the same existing key store in Android Studio, then you do not need to remove the existing app on your phone. Lorsque vous installez l'apk, suivez les instructions pour installer les mises à jour. -Pour d'autres scénarios comme la création d'un nouveau fichier de clés dans Android Studio pour votre apk signé, vous devrez d'abord supprimer l'ancienne application avant d'installer l'apk. **Make sure to export your settings!** -``` - -See the instructions for [transferring and installing AAPS](../SettingUpAaps/TransferringAndInstallingAaps.md) +Follow [these instructions.](./UpdateComputerBuild.md). (Update-to-new-version-check-aaps-version-on-phone)= @@ -104,14 +27,4 @@ Après avoir installer le nouvel apk, vous pouvez vérifier la version AAPS sur ![Version installée d'AAPS](../images/Update_VersionCheck.png) -Check in the [Release Notes](../Maintenance/ReleaseNotes.md) if there are any specific instructions after update. - -## Troubleshooting - -Si quelque chose ne va pas, ne paniquez pas. - -Respirez un bon coup ! - -Then see the separate page [troubleshooting Android Studio](../GettingHelp/TroubleshootingAndroidStudio) if your problem is already documented! - -If you need further help, please reach out to other **AAPS** users on [Facebook](https://www.facebook.com/groups/AndroidAPSUsers) or [Discord](https://discord.gg/4fQUWHZ4Mw). \ No newline at end of file +Check in the [Release Notes](../Maintenance/ReleaseNotes.md) if there are any specific instructions after update. \ No newline at end of file diff --git a/docs/CROWDIN/fr/SettingUpAaps/BrowserBuild.md b/docs/CROWDIN/fr/SettingUpAaps/BrowserBuild.md index ef8b06c33126..405d9bac3108 100644 --- a/docs/CROWDIN/fr/SettingUpAaps/BrowserBuild.md +++ b/docs/CROWDIN/fr/SettingUpAaps/BrowserBuild.md @@ -1,3 +1,5 @@ +(browser-build)= + # Browser build Building AAPS with GitHub Actions. diff --git a/docs/CROWDIN/fr/images/Building-the-App/CI/aaps_ci_simple_http_server.png b/docs/CROWDIN/fr/images/Building-the-App/CI/aaps_ci_simple_http_server.png index 95ac2d4eb443..2e2fb47e5ca2 100644 Binary files a/docs/CROWDIN/fr/images/Building-the-App/CI/aaps_ci_simple_http_server.png and b/docs/CROWDIN/fr/images/Building-the-App/CI/aaps_ci_simple_http_server.png differ diff --git a/docs/CROWDIN/fr/images/Building-the-App/CI/aaps_ci_simple_http_server_step1.png b/docs/CROWDIN/fr/images/Building-the-App/CI/aaps_ci_simple_http_server_step1.png index 78f52682b58d..b348162dcb1c 100644 Binary files a/docs/CROWDIN/fr/images/Building-the-App/CI/aaps_ci_simple_http_server_step1.png and b/docs/CROWDIN/fr/images/Building-the-App/CI/aaps_ci_simple_http_server_step1.png differ diff --git a/docs/CROWDIN/fr/images/Building-the-App/CI/aaps_ci_simple_http_server_step2.png b/docs/CROWDIN/fr/images/Building-the-App/CI/aaps_ci_simple_http_server_step2.png index c292ac667f63..cabadeefb97a 100644 Binary files a/docs/CROWDIN/fr/images/Building-the-App/CI/aaps_ci_simple_http_server_step2.png and b/docs/CROWDIN/fr/images/Building-the-App/CI/aaps_ci_simple_http_server_step2.png differ diff --git a/docs/CROWDIN/fr/images/Building-the-App/CI/aaps_ci_simple_http_server_step3.png b/docs/CROWDIN/fr/images/Building-the-App/CI/aaps_ci_simple_http_server_step3.png index bd31cd0ffb3d..9a26d3526369 100644 Binary files a/docs/CROWDIN/fr/images/Building-the-App/CI/aaps_ci_simple_http_server_step3.png and b/docs/CROWDIN/fr/images/Building-the-App/CI/aaps_ci_simple_http_server_step3.png differ diff --git a/docs/CROWDIN/fr/images/Building-the-App/CI/aaps_ci_simple_http_server_step4.png b/docs/CROWDIN/fr/images/Building-the-App/CI/aaps_ci_simple_http_server_step4.png index cc187ec72a14..285492424351 100644 Binary files a/docs/CROWDIN/fr/images/Building-the-App/CI/aaps_ci_simple_http_server_step4.png and b/docs/CROWDIN/fr/images/Building-the-App/CI/aaps_ci_simple_http_server_step4.png differ diff --git a/docs/CROWDIN/fr/images/Building-the-App/CI/aaps_ci_simple_http_server_store.png b/docs/CROWDIN/fr/images/Building-the-App/CI/aaps_ci_simple_http_server_store.png index 4b157ca8d3d8..65bf101f55e4 100644 Binary files a/docs/CROWDIN/fr/images/Building-the-App/CI/aaps_ci_simple_http_server_store.png and b/docs/CROWDIN/fr/images/Building-the-App/CI/aaps_ci_simple_http_server_store.png differ diff --git a/docs/CROWDIN/fr/images/update/CI/GitHubActions1.png b/docs/CROWDIN/fr/images/update/CI/GitHubActions1.png new file mode 100644 index 000000000000..e04ce6e76d8b Binary files /dev/null and b/docs/CROWDIN/fr/images/update/CI/GitHubActions1.png differ diff --git a/docs/CROWDIN/fr/images/update/CI/GitHubActions2.png b/docs/CROWDIN/fr/images/update/CI/GitHubActions2.png new file mode 100644 index 000000000000..7b5c5a842d16 Binary files /dev/null and b/docs/CROWDIN/fr/images/update/CI/GitHubActions2.png differ diff --git a/docs/CROWDIN/fr/images/update/CI/GitHubActions3.png b/docs/CROWDIN/fr/images/update/CI/GitHubActions3.png new file mode 100644 index 000000000000..cff0ed34b214 Binary files /dev/null and b/docs/CROWDIN/fr/images/update/CI/GitHubActions3.png differ diff --git a/docs/CROWDIN/fr/images/update/CI/GitHubActions4.png b/docs/CROWDIN/fr/images/update/CI/GitHubActions4.png new file mode 100644 index 000000000000..bede3c2dfe08 Binary files /dev/null and b/docs/CROWDIN/fr/images/update/CI/GitHubActions4.png differ diff --git a/docs/CROWDIN/fr/images/update/CI/GitHubActions5.png b/docs/CROWDIN/fr/images/update/CI/GitHubActions5.png new file mode 100644 index 000000000000..d96e31cf084d Binary files /dev/null and b/docs/CROWDIN/fr/images/update/CI/GitHubActions5.png differ diff --git a/docs/CROWDIN/fr/images/update/CI/GitHubUpdate1.png b/docs/CROWDIN/fr/images/update/CI/GitHubUpdate1.png new file mode 100644 index 000000000000..3058dc270d28 Binary files /dev/null and b/docs/CROWDIN/fr/images/update/CI/GitHubUpdate1.png differ diff --git a/docs/CROWDIN/fr/images/update/CI/GitHubUpdate2.png b/docs/CROWDIN/fr/images/update/CI/GitHubUpdate2.png new file mode 100644 index 000000000000..1ae9568c8107 Binary files /dev/null and b/docs/CROWDIN/fr/images/update/CI/GitHubUpdate2.png differ diff --git a/docs/CROWDIN/fr/images/update/CI/GitHubUpdate3.png b/docs/CROWDIN/fr/images/update/CI/GitHubUpdate3.png new file mode 100644 index 000000000000..d18f9119c76d Binary files /dev/null and b/docs/CROWDIN/fr/images/update/CI/GitHubUpdate3.png differ diff --git a/docs/CROWDIN/fr/images/update/CI/GitHubUpdate4.png b/docs/CROWDIN/fr/images/update/CI/GitHubUpdate4.png new file mode 100644 index 000000000000..8c38c071cb8f Binary files /dev/null and b/docs/CROWDIN/fr/images/update/CI/GitHubUpdate4.png differ diff --git a/docs/CROWDIN/fr/images/update/CI/GitHubUpdate5.png b/docs/CROWDIN/fr/images/update/CI/GitHubUpdate5.png new file mode 100644 index 000000000000..409aef1f34dc Binary files /dev/null and b/docs/CROWDIN/fr/images/update/CI/GitHubUpdate5.png differ diff --git a/docs/CROWDIN/fr/index.md b/docs/CROWDIN/fr/index.md index c9d10b8b1c79..77b74fcda7c9 100644 --- a/docs/CROWDIN/fr/index.md +++ b/docs/CROWDIN/fr/index.md @@ -2,10 +2,10 @@ ![image](./images/basic-outline-of-AAPS.png) -```{admonition} Version 3.3 +```{admonition} Latest Release :class: note -29/12/2024 : La version 3.3 est sortie. Consultez les [Notes de version] (#version3300) pour voir ce qui est nouveau et obtenir des instructions de mise à jour. +14/08/2025 : Version 3.3.2.1 is out. Check the [Release Notes](#latestrelease) to see what's new and get update instructions. ``` @@ -21,7 +21,7 @@ Cette section vous prépare techniquement à assembler aussi rapidement et effic Maintenant que vous avez une bonne compréhension du processus, vous pouvez démarrer l'assemblage de votre boucle **AAPS**. -Vous trouverez les instructions détaillées pour ce faire dans le chapitre **3) Installation d'AAPS**. On y parlera du choix et du [serveur de reporting](./SettingUpAaps/SettingUpTheReportingServer.md) (Nightscout ou Tidepool) afin que vous puissiez analyser et partager vos données, de la préparation de votre ordinateur pour installer Android Studio, de la compilation elle-même de l'application AAPS et du transfert de l'application AAPS sur votre téléphone. Ce chapitre décrit également la configuration de l'application **AAPS** à l'aide de l'Assistant de configuration, pour qu'il puisse communiquer avec votre application MGC et avec une pompe à insuline réelle ou virtuelle, ainsi qu'en liant **AAPS** à votre serveur de reporting. Vous serez ensuite petit à petit guidé dans l'utilisation d'**AAPS**, via un processus progressif, sécurisé et soigneusement calibré. Ce processus est conçu pour s'assurer que vous/votre enfant connaissez bien et êtes à l'aise dans la navigation entre les différents menus et sous-menus de configuration avant de passer à la phase suivante. Ces phases sont communément appelées Objectifs, et visent à vous faire acquérir suffisamment d'expérience pour pouvoir commencer à utiliser les fonctionnalités les plus avancées de l'application. Ces objectifs sont conçus spécifiquement de manière à débloquer progressivement plus de possibilités dans **AAPS** et à passer de la boucle ouverte à la boucle fermée. +Vous trouverez les instructions détaillées pour ce faire dans le chapitre **3) Installation d'AAPS**. It covers choosing and [setting up your reporting server](./SettingUpAaps/SettingUpTheReportingServer.md) (Nightscout or Tidepool) so you can review and share your data, getting ready for building the AAPS app, building the AAPS app and transferring the AAPS app to your phone. Ce chapitre décrit également la configuration de l'application **AAPS** à l'aide de l'Assistant de configuration, pour qu'il puisse communiquer avec votre application MGC et avec une pompe à insuline réelle ou virtuelle, ainsi qu'en liant **AAPS** à votre serveur de reporting. Vous serez ensuite petit à petit guidé dans l'utilisation d'**AAPS**, via un processus progressif, sécurisé et soigneusement calibré. Ce processus est conçu pour s'assurer que vous/votre enfant connaissez bien et êtes à l'aise dans la navigation entre les différents menus et sous-menus de configuration avant de passer à la phase suivante. Ces phases sont communément appelées Objectifs, et visent à vous faire acquérir suffisamment d'expérience pour pouvoir commencer à utiliser les fonctionnalités les plus avancées de l'application. Ces objectifs sont conçus spécifiquement de manière à débloquer progressivement plus de possibilités dans **AAPS** et à passer de la boucle ouverte à la boucle fermée. Le chapitre **4) Utilisation d'AAPS** couvre les principales fonctionnalités d'**AAPS**, pour vous aider à utiliser (et personnaliser) **AAPS**. Vous y trouverez des explications sur les écrans de l'application, les glucides actifs, la sensibilité, le changement de profil, les cibles temporaires, les glucides étendus (ou eCarbs), les automatisations et la SI Dynamique. On y parle également de sujets tels que la gestion de différents types de repas, le changement de cathéter ou de capteur, les mises à jour du smartphone, les changements d'heure, [voyager avec AAPS](DailyLifeWithAaps/TimezoneTraveling-DaylightSavingTime.md) et faire du sport. Les questions et réponses courantes se trouvent dans la section de dépannage. diff --git a/docs/CROWDIN/he/Maintenance/DocumentationUpdate.md b/docs/CROWDIN/he/Maintenance/DocumentationUpdate.md index d01215d9bafc..bb14def6ba69 100644 --- a/docs/CROWDIN/he/Maintenance/DocumentationUpdate.md +++ b/docs/CROWDIN/he/Maintenance/DocumentationUpdate.md @@ -4,7 +4,7 @@ - Updated versions and Android Studio prerequisites - Added [3.3.2.1](#version3321) release, removed Android 16 references (fixed) -- Added [Browser Build](browser-build) @Angus +- Added [Browser Build](#browser-build) @Angus ## May 2025 diff --git a/docs/CROWDIN/he/Maintenance/ReleaseNotes.md b/docs/CROWDIN/he/Maintenance/ReleaseNotes.md index 1a751d37d1cb..d138c006987f 100644 --- a/docs/CROWDIN/he/Maintenance/ReleaseNotes.md +++ b/docs/CROWDIN/he/Maintenance/ReleaseNotes.md @@ -55,6 +55,8 @@ In order to allow users with older Android to use older version of AAPS new vers WearOS 5, API level 34 (Android 14) has [limitations](#BuildingAapsWearOs-WearOS5). ``` +(latestrelease)= + (version3321)= ## Version 3.3.2.1 diff --git a/docs/CROWDIN/he/Maintenance/UpdateBrowserBuild.md b/docs/CROWDIN/he/Maintenance/UpdateBrowserBuild.md new file mode 100644 index 000000000000..757e1345f0b5 --- /dev/null +++ b/docs/CROWDIN/he/Maintenance/UpdateBrowserBuild.md @@ -0,0 +1,101 @@ +# Update with a browser + +## בנייה עצמית במקום הורדה + +**AAPS** is not available to download, due to regulations concerning medical devices. בנייה עצמית של היישום לשימוש אישי הינה חוקית אך אסור לתת את היישום לאחרים! See [FAQ page](../UsefulLinks/FAQ.md) for details. + +```{note} +In case you want to upgrade **AAPS** with a browser for the first time : copy your back-up keystore file to your Google Drive. Then follow the [Browser Build **AAPS** procedure](../SettingUpAaps/BrowserBuild.md) instead of this guide. Instead of creating a new keystore, you must select the one you have copied from your computer. +This operation will be mandatory only the first time, then for successive upgrades you will be able to follow this guide. +``` + +## Overview for updating to a new version of AAPS with a browser + +```{contents} Steps for updating to a new version of AAPS +:depth: 1 +:local: true +``` + +In case you experience problems, see separate page for [troubleshooting Android Studio](../GettingHelp/TroubleshootingAndroidStudio). + +### Export your settings + +Export your settings from the existing **AAPS** version on your phone. You might not need it, but better be safe than sorry. + +See the [Export & import settings](ExportImportSettings.md) page if you don't remember how to do this. + +(Update-to-new-version-update-your-repo)= +### Update your GitHub repository + +```{admonition} WARNING +:class: warning +Browser Build is available from AAPS version 3.3.2.1. +``` + +[Log into GitHub](https://github.com/login). + +1. Select Repositories. +2. Scroll down and select your own AndroidAPS repository. + +![Select AndroidAPS repo](../images/update/CI/GitHubUpdate1.png) + +3. Verify you are using your own copy of AndroidAPS (Forked from nightscout/AndroidAPS) +4. Tap Sync Fork to update it (the number of commits behind might differ from the picture) + + + +![Sync AndroidAPS repo](../images/update/CI/GitHubUpdate2.png) + +5. Tap Update Branch + +![Update AndroidAPS repo](../images/update/CI/GitHubUpdate3.png) + +Note: if you have modified your copy of AndroidAPS by mistake, you will see this screen. Discard all changes (commits) to return to the released version. + +![Discard rogue modifications](../images/update/CI/GitHubUpdate4.png) + +You have now synchronized (updated) your own copy with the latest release of Android APS. Good job. + +![Repo sync'ed](../images/update/CI/GitHubUpdate5.png) + +### Run the Workflow to Build the Signed APK + +1. In your GitHub copy of AndroidAPS, select Actions. +2. Expand All Workflows. +3. Select AAPS-CI + +![Actions AAPS-CI](../images/update/CI/GitHubActions1.png) + +4. Scroll down and tap Run Workflow. + +![Run Workflow](../images/update/CI/GitHubActions2.png) + +5. Select the branch you want to deploy (master), the [variant](variant) (fullRelease) and tap Run Workflow. + + + +![Run Workflow](../images/update/CI/GitHubActions3.png) + +6. You will see the message Workflow run was successfully requested. Refresh your browser page and you will be able to monitor the build progress. When the action completes, the AAPS CI action will show a green tick mark. You have successfully built the updated version of Android APS. + +![Monitor Workflow](../images/update/CI/GitHubActions4.png) + +### Install the AAPS APK + +1. Open your Google Drive +2. Browse into AAPS, select the new version folder and you will find both the phone and Android Wear versions. + +![Google Drive Location](../images/update/CI/GitHubActions5.png) + + +Continue [here](#Update-to-new-version-check-aaps-version-on-phone) + +## Troubleshooting + +If anything goes wrong, don't panic. + +Take a breath! + +Then see the [troubleshooting tips](#aaps-ci-preparation) if your problem is already documented! + +If you need further help, please reach out to other **AAPS** users on [Facebook](https://www.facebook.com/groups/AndroidAPSUsers) or [Discord](https://discord.gg/4fQUWHZ4Mw). \ No newline at end of file diff --git a/docs/CROWDIN/he/Maintenance/UpdateComputerBuild.md b/docs/CROWDIN/he/Maintenance/UpdateComputerBuild.md new file mode 100644 index 000000000000..f4e068ee976f --- /dev/null +++ b/docs/CROWDIN/he/Maintenance/UpdateComputerBuild.md @@ -0,0 +1,103 @@ +# Update with a computer + +## בנייה עצמית במקום הורדה + +**AAPS** is not available to download, due to regulations concerning medical devices. בנייה עצמית של היישום לשימוש אישי הינה חוקית אך אסור לתת את היישום לאחרים! See [FAQ page](../UsefulLinks/FAQ.md) for details. + +```{note} +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 + +```{contents} Steps for updating to a new version of AAPS +:depth: 1 +:local: true +``` + +In case you experience problems, see separate page for [troubleshooting Android Studio](../GettingHelp/TroubleshootingAndroidStudio). + +### Export your settings + +Export your settings from the existing **AAPS** version on your phone. You might not need it, but better be safe than sorry. + +See the [Export & import settings](ExportImportSettings.md) page if you don't remember how to do this. + +### Check your Android Studio version + +The minimal version required is described in the [Building Instructions](#Building-APK-recommended-specification-of-computer-for-building-apk-file). If your version is older, please [update Android Studio first](#Building-APK-install-android-studio)! + +(Update-to-new-version-update-your-local-copy)= +### Update your local copy + +```{admonition} WARNING +:class: warning +If you update from versions prior to 2.8.x, please follow the instructions to do a [New clone](../SettingUpAaps/BuildingAaps.md), as this guide will not work for you! +``` + +* Open your existing AAPS project with Android Studio. You might need to select your project. (Double) click on the AAPS project. + + ![Android Studio - Select Project](../images/update/01_ProjectSelection.png) + +* In the menu bar of Android Studio, select Git -> Fetch + + ![Android Studio Menu - Git - Fetch](../images/update/02_GitFetch.png) + +* You will see a message in the lower right corner that Fetch was successful. + + ![Android Studio Menu - Git - Fetch successful](../images/update/03_GitFetchSuccessful.png) + +* In the menu bar, now select Git -> Pull + + ![Android Studio Menu - Git - Pull](../images/update/04_GitPull.png) + +* Leave all options as they are (origin/master) and select Pull + + ![Android Studio - Git - Pull dialog](../images/update/05_GitPullOptions.png) + +* Wait while download is in progress, you will see this as info in the bottom bar. When it's done, you will see a success message. + + ```{note} + The files that were updated may vary! This is not an indication + ``` + + ![Android Studio - Pull successful](../images/update/06_GitPullSuccess.png) + +* Gradle Sync will be running to download some dependencies. Wait until it is finished. + + ![Android Studio - Gradle Sync](../images/studioSetup/40_BackgroundTasks.png) + +### Check JVM version + +This check is particularly indicated if you have already built a previous version of **AAPS** on the same computer. + +Check in the [Building Instructions](#Building-APK-recommended-specification-of-computer-for-building-apk-file) the required version for JVM, matching the **AAPS** version you are now building. Then follow the steps described at [Incompatible Gradle JVM](#incompatible-gradle-jvm) to make sure you currently use the correct version. + +(Update-to-new-version-build-the-signed-apk)= +### Build the Signed APK + +Your sourcecode is now the current released version, and all prerequisites have been checked. It's time to build the signed apk as described in the [build signed apk section](#Building-APK-generate-signed-apk). + +(Update-to-new-version-transfer-and-install)= + +### Transfer and install the apk +You need to transfer the apk to your phone so you can install it. + +```{note} +If you completed the build with the same existing key store in Android Studio, then you do not need to remove the existing app on your phone. When you install the apk, follow the prompts to install updates. +For other scenarios such as establishing a new key store in Android Studio for your signed apk, you will need to delete the old app before installing the apk. **Make sure to export your settings!** +``` + +See the instructions for [transferring and installing AAPS](../SettingUpAaps/TransferringAndInstallingAaps.md) + +Continue [here](#Update-to-new-version-check-aaps-version-on-phone). + +## Troubleshooting + +If anything goes wrong, don't panic. + +Take a breath! + +Then see the separate page [troubleshooting Android Studio](../GettingHelp/TroubleshootingAndroidStudio) if your problem is already documented! + +If you need further help, please reach out to other **AAPS** users on [Facebook](https://www.facebook.com/groups/AndroidAPSUsers) or [Discord](https://discord.gg/4fQUWHZ4Mw). \ No newline at end of file diff --git a/docs/CROWDIN/he/Maintenance/UpdateToNewVersion.md b/docs/CROWDIN/he/Maintenance/UpdateToNewVersion.md index b0228217d3ad..5f87b88aca1a 100644 --- a/docs/CROWDIN/he/Maintenance/UpdateToNewVersion.md +++ b/docs/CROWDIN/he/Maintenance/UpdateToNewVersion.md @@ -10,91 +10,14 @@ * When a new release is available, in the **AAPS** app itself, you will receive an information banner about the new version. * The new version will also be announced on Facebook at the time of release. * Following the release, please read the [Release Notes](ReleaseNotes.md) in detail, and clarify any queries with the community on Facebook or Discord, before proceeding with the update. - - ```{note} - 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 +## Update AAPS with browser build -```{contents} Steps for updating to a new version of AAPS :depth: 1 :local: true +If you already built your AAPS app with the Browser Build method, follow [these instructions](./UpdateBrowserBuild.md). -
In case you experience problems, see separate page for [troubleshooting Android Studio](../GettingHelp/TroubleshootingAndroidStudio). - - ### Export your settings - - Export your settings from the existing **AAPS** version on your phone. You might not need it, but better be safe than sorry. - - See the [Export & import settings](ExportImportSettings.md) page if you don't remember how to do this. - - ### Check your Android Studio version - - The minimal version required is described in the [Building Instructions](#Building-APK-recommended-specification-of-computer-for-building-apk-file). If your version is older, please [update Android Studio first](#Building-APK-install-android-studio)! - - (Update-to-new-version-update-your-local-copy)= - ### Update your local copy - - ```{admonition} WARNING - :class: warning - If you update from versions prior to 2.8.x, please follow the instructions to do a [New clone](../SettingUpAaps/BuildingAaps.md), as this guide will not work for you! - +## Update AAPS with a computer -* Open your existing AAPS project with Android Studio. You might need to select your project. (Double) click on the AAPS project. - - ![Android Studio - Select Project](../images/update/01_ProjectSelection.png) - -* In the menu bar of Android Studio, select Git -> Fetch - - ![Android Studio Menu - Git - Fetch](../images/update/02_GitFetch.png) - -* You will see a message in the lower right corner that Fetch was successful. - - ![Android Studio Menu - Git - Fetch successful](../images/update/03_GitFetchSuccessful.png) - -* In the menu bar, now select Git -> Pull - - ![Android Studio Menu - Git - Pull](../images/update/04_GitPull.png) - -* Leave all options as they are (origin/master) and select Pull - - ![Android Studio - Git - Pull dialog](../images/update/05_GitPullOptions.png) - -* Wait while download is in progress, you will see this as info in the bottom bar. When it's done, you will see a success message. - - ```{note} - The files that were updated may vary! This is not an indication - ``` - - ![Android Studio - Pull successful](../images/update/06_GitPullSuccess.png) - -* Gradle Sync will be running to download some dependencies. Wait until it is finished. - - ![Android Studio - Gradle Sync](../images/studioSetup/40_BackgroundTasks.png) - -### Check JVM version - -This check is particularly indicated if you have already built a previous version of **AAPS** on the same computer. - -Check in the [Building Instructions](#Building-APK-recommended-specification-of-computer-for-building-apk-file) the required version for JVM, matching the **AAPS** version you are now building. Then follow the steps described at [Incompatible Gradle JVM](#incompatible-gradle-jvm) to make sure you currently use the correct version. - -(Update-to-new-version-build-the-signed-apk)= - -### Build the Signed APK - -Your sourcecode is now the current released version, and all prerequisites have been checked. It's time to build the signed apk as described in the [build signed apk section](#Building-APK-generate-signed-apk). - -(Update-to-new-version-transfer-and-install)= - -### Transfer and install the apk - -You need to transfer the apk to your phone so you can install it. - -```{note} -If you completed the build with the same existing key store in Android Studio, then you do not need to remove the existing app on your phone. When you install the apk, follow the prompts to install updates. -For other scenarios such as establishing a new key store in Android Studio for your signed apk, you will need to delete the old app before installing the apk. **Make sure to export your settings!** -``` - -See the instructions for [transferring and installing AAPS](../SettingUpAaps/TransferringAndInstallingAaps.md) +Follow [these instructions.](./UpdateComputerBuild.md). (Update-to-new-version-check-aaps-version-on-phone)= @@ -104,14 +27,4 @@ After you installed the new apk, you can check the AAPS version on your phone by ![AAPS version installed](../images/Update_VersionCheck.png) -Check in the [Release Notes](../Maintenance/ReleaseNotes.md) if there are any specific instructions after update. - -## Troubleshooting - -If anything goes wrong, don't panic. - -Take a breath! - -Then see the separate page [troubleshooting Android Studio](../GettingHelp/TroubleshootingAndroidStudio) if your problem is already documented! - -If you need further help, please reach out to other **AAPS** users on [Facebook](https://www.facebook.com/groups/AndroidAPSUsers) or [Discord](https://discord.gg/4fQUWHZ4Mw). \ No newline at end of file +Check in the [Release Notes](../Maintenance/ReleaseNotes.md) if there are any specific instructions after update. \ No newline at end of file diff --git a/docs/CROWDIN/he/SettingUpAaps/BrowserBuild.md b/docs/CROWDIN/he/SettingUpAaps/BrowserBuild.md index d09d8cdf8a37..8b57c7d16f50 100644 --- a/docs/CROWDIN/he/SettingUpAaps/BrowserBuild.md +++ b/docs/CROWDIN/he/SettingUpAaps/BrowserBuild.md @@ -1,3 +1,5 @@ +(browser-build)= + # Browser build Building AAPS with GitHub Actions. diff --git a/docs/CROWDIN/he/images/Building-the-App/CI/aaps_ci_simple_http_server.png b/docs/CROWDIN/he/images/Building-the-App/CI/aaps_ci_simple_http_server.png index 95ac2d4eb443..2e2fb47e5ca2 100644 Binary files a/docs/CROWDIN/he/images/Building-the-App/CI/aaps_ci_simple_http_server.png and b/docs/CROWDIN/he/images/Building-the-App/CI/aaps_ci_simple_http_server.png differ diff --git a/docs/CROWDIN/he/images/Building-the-App/CI/aaps_ci_simple_http_server_step1.png b/docs/CROWDIN/he/images/Building-the-App/CI/aaps_ci_simple_http_server_step1.png index 78f52682b58d..b348162dcb1c 100644 Binary files a/docs/CROWDIN/he/images/Building-the-App/CI/aaps_ci_simple_http_server_step1.png and b/docs/CROWDIN/he/images/Building-the-App/CI/aaps_ci_simple_http_server_step1.png differ diff --git a/docs/CROWDIN/he/images/Building-the-App/CI/aaps_ci_simple_http_server_step2.png b/docs/CROWDIN/he/images/Building-the-App/CI/aaps_ci_simple_http_server_step2.png index c292ac667f63..cabadeefb97a 100644 Binary files a/docs/CROWDIN/he/images/Building-the-App/CI/aaps_ci_simple_http_server_step2.png and b/docs/CROWDIN/he/images/Building-the-App/CI/aaps_ci_simple_http_server_step2.png differ diff --git a/docs/CROWDIN/he/images/Building-the-App/CI/aaps_ci_simple_http_server_step3.png b/docs/CROWDIN/he/images/Building-the-App/CI/aaps_ci_simple_http_server_step3.png index bd31cd0ffb3d..9a26d3526369 100644 Binary files a/docs/CROWDIN/he/images/Building-the-App/CI/aaps_ci_simple_http_server_step3.png and b/docs/CROWDIN/he/images/Building-the-App/CI/aaps_ci_simple_http_server_step3.png differ diff --git a/docs/CROWDIN/he/images/Building-the-App/CI/aaps_ci_simple_http_server_step4.png b/docs/CROWDIN/he/images/Building-the-App/CI/aaps_ci_simple_http_server_step4.png index cc187ec72a14..285492424351 100644 Binary files a/docs/CROWDIN/he/images/Building-the-App/CI/aaps_ci_simple_http_server_step4.png and b/docs/CROWDIN/he/images/Building-the-App/CI/aaps_ci_simple_http_server_step4.png differ diff --git a/docs/CROWDIN/he/images/Building-the-App/CI/aaps_ci_simple_http_server_store.png b/docs/CROWDIN/he/images/Building-the-App/CI/aaps_ci_simple_http_server_store.png index 4b157ca8d3d8..65bf101f55e4 100644 Binary files a/docs/CROWDIN/he/images/Building-the-App/CI/aaps_ci_simple_http_server_store.png and b/docs/CROWDIN/he/images/Building-the-App/CI/aaps_ci_simple_http_server_store.png differ diff --git a/docs/CROWDIN/he/images/update/CI/GitHubActions1.png b/docs/CROWDIN/he/images/update/CI/GitHubActions1.png new file mode 100644 index 000000000000..e04ce6e76d8b Binary files /dev/null and b/docs/CROWDIN/he/images/update/CI/GitHubActions1.png differ diff --git a/docs/CROWDIN/he/images/update/CI/GitHubActions2.png b/docs/CROWDIN/he/images/update/CI/GitHubActions2.png new file mode 100644 index 000000000000..7b5c5a842d16 Binary files /dev/null and b/docs/CROWDIN/he/images/update/CI/GitHubActions2.png differ diff --git a/docs/CROWDIN/he/images/update/CI/GitHubActions3.png b/docs/CROWDIN/he/images/update/CI/GitHubActions3.png new file mode 100644 index 000000000000..cff0ed34b214 Binary files /dev/null and b/docs/CROWDIN/he/images/update/CI/GitHubActions3.png differ diff --git a/docs/CROWDIN/he/images/update/CI/GitHubActions4.png b/docs/CROWDIN/he/images/update/CI/GitHubActions4.png new file mode 100644 index 000000000000..bede3c2dfe08 Binary files /dev/null and b/docs/CROWDIN/he/images/update/CI/GitHubActions4.png differ diff --git a/docs/CROWDIN/he/images/update/CI/GitHubActions5.png b/docs/CROWDIN/he/images/update/CI/GitHubActions5.png new file mode 100644 index 000000000000..d96e31cf084d Binary files /dev/null and b/docs/CROWDIN/he/images/update/CI/GitHubActions5.png differ diff --git a/docs/CROWDIN/he/images/update/CI/GitHubUpdate1.png b/docs/CROWDIN/he/images/update/CI/GitHubUpdate1.png new file mode 100644 index 000000000000..3058dc270d28 Binary files /dev/null and b/docs/CROWDIN/he/images/update/CI/GitHubUpdate1.png differ diff --git a/docs/CROWDIN/he/images/update/CI/GitHubUpdate2.png b/docs/CROWDIN/he/images/update/CI/GitHubUpdate2.png new file mode 100644 index 000000000000..1ae9568c8107 Binary files /dev/null and b/docs/CROWDIN/he/images/update/CI/GitHubUpdate2.png differ diff --git a/docs/CROWDIN/he/images/update/CI/GitHubUpdate3.png b/docs/CROWDIN/he/images/update/CI/GitHubUpdate3.png new file mode 100644 index 000000000000..d18f9119c76d Binary files /dev/null and b/docs/CROWDIN/he/images/update/CI/GitHubUpdate3.png differ diff --git a/docs/CROWDIN/he/images/update/CI/GitHubUpdate4.png b/docs/CROWDIN/he/images/update/CI/GitHubUpdate4.png new file mode 100644 index 000000000000..8c38c071cb8f Binary files /dev/null and b/docs/CROWDIN/he/images/update/CI/GitHubUpdate4.png differ diff --git a/docs/CROWDIN/he/images/update/CI/GitHubUpdate5.png b/docs/CROWDIN/he/images/update/CI/GitHubUpdate5.png new file mode 100644 index 000000000000..409aef1f34dc Binary files /dev/null and b/docs/CROWDIN/he/images/update/CI/GitHubUpdate5.png differ diff --git a/docs/CROWDIN/he/index.md b/docs/CROWDIN/he/index.md index 455b1d311ed2..4758ccf6a7d3 100644 --- a/docs/CROWDIN/he/index.md +++ b/docs/CROWDIN/he/index.md @@ -2,10 +2,10 @@ ![image](./images/basic-outline-of-AAPS.png) -```{admonition} Version 3.3 +```{admonition} Latest Release :class: note -29/12/2024 : Version 3.3 is out. Check the [Release Notes](#version3300) to see what's new and get update instructions. +14/08/2025 : Version 3.3.2.1 is out. Check the [Release Notes](#latestrelease) to see what's new and get update instructions. ``` @@ -21,7 +21,7 @@ Section **2) Getting Started**, the [Introduction](Getting-Started/Introduction. Now that you have a solid understanding of the process, you can start assembling your **AAPS** loop. -Section **3) Setting up AAPS** contains step-by-step instructions to do this. It covers choosing and [setting up your reporting server](./SettingUpAaps/SettingUpTheReportingServer.md) (Nightscout or Tidepool) so you can review and share your data, getting your computer ready for building the AAPS app, building the AAPS app and transferring the AAPS app to your phone. It also covers setting up the **AAPS** app using the setup Wizard, linking it with your CGM app, and either a real or virtual insulin pump, as well as linking **AAPS** to your reporting server. You are then slowly introduced to the full usage of what **AAPS** has to offer via a safe and carefully calibrated step-by-step process designed to make sure that you/your child are thoroughly familiar and comfortable navigating all the different levels and menu configurations before graduating on the next phase, commonly referred to as the next "Objective", until you are have enough experience to begin using the more advanced options available within the app. These Objectives are specially designed in such a way that will gradually unlock more possibilities of **AAPS** and switch from Open Loop to Closed Loop. +Section **3) Setting up AAPS** contains step-by-step instructions to do this. It covers choosing and [setting up your reporting server](./SettingUpAaps/SettingUpTheReportingServer.md) (Nightscout or Tidepool) so you can review and share your data, getting ready for building the AAPS app, building the AAPS app and transferring the AAPS app to your phone. It also covers setting up the **AAPS** app using the setup Wizard, linking it with your CGM app, and either a real or virtual insulin pump, as well as linking **AAPS** to your reporting server. You are then slowly introduced to the full usage of what **AAPS** has to offer via a safe and carefully calibrated step-by-step process designed to make sure that you/your child are thoroughly familiar and comfortable navigating all the different levels and menu configurations before graduating on the next phase, commonly referred to as the next "Objective", until you are have enough experience to begin using the more advanced options available within the app. These Objectives are specially designed in such a way that will gradually unlock more possibilities of **AAPS** and switch from Open Loop to Closed Loop. Section **4) Daily life with AAPS** covers key **AAPS** features, to help you use (and customise) **AAPS**. This including understanding the screens, carbs-on-board, sensitivity, profile switching, temp targets, extended carbs (or eCarbs), automations, and DynamicISF. It also covers frequent topics like how to manage different types of meals, how to deal with cannula and sensor changes, smartphone updates, daylight saving changes, and [travelling with AAPS](DailyLifeWithAaps/TimezoneTraveling-DaylightSavingTime.md) and sports. Common questions and answers are located within the troubleshooting section. diff --git a/docs/CROWDIN/ko/Maintenance/DocumentationUpdate.md b/docs/CROWDIN/ko/Maintenance/DocumentationUpdate.md index 1915d4d39149..fe01688af3c0 100644 --- a/docs/CROWDIN/ko/Maintenance/DocumentationUpdate.md +++ b/docs/CROWDIN/ko/Maintenance/DocumentationUpdate.md @@ -4,7 +4,7 @@ - Updated versions and Android Studio prerequisites - Added [3.3.2.1](#version3321) release, removed Android 16 references (fixed) -- Added [Browser Build](browser-build) @Angus +- Added [Browser Build](#browser-build) @Angus ## May 2025 diff --git a/docs/CROWDIN/ko/Maintenance/ReleaseNotes.md b/docs/CROWDIN/ko/Maintenance/ReleaseNotes.md index 7ba23eaa25d7..78534579cc99 100644 --- a/docs/CROWDIN/ko/Maintenance/ReleaseNotes.md +++ b/docs/CROWDIN/ko/Maintenance/ReleaseNotes.md @@ -55,6 +55,8 @@ In order to allow users with older Android to use older version of AAPS new vers WearOS 5, API level 34 (Android 14) has [limitations](#BuildingAapsWearOs-WearOS5). ``` +(latestrelease)= + (version3321)= ## Version 3.3.2.1 diff --git a/docs/CROWDIN/ko/Maintenance/UpdateBrowserBuild.md b/docs/CROWDIN/ko/Maintenance/UpdateBrowserBuild.md new file mode 100644 index 000000000000..08b7ccdf4e6c --- /dev/null +++ b/docs/CROWDIN/ko/Maintenance/UpdateBrowserBuild.md @@ -0,0 +1,101 @@ +# Update with a browser + +## 다운로드 대신에 당신 스스로 빌드하세요 + +**AAPS** is not available to download, due to regulations concerning medical devices. It is legal to build the app for your own use, but you must not give a copy to others! See [FAQ page](../UsefulLinks/FAQ.md) for details. + +```{note} +In case you want to upgrade **AAPS** with a browser for the first time : copy your back-up keystore file to your Google Drive. Then follow the [Browser Build **AAPS** procedure](../SettingUpAaps/BrowserBuild.md) instead of this guide. Instead of creating a new keystore, you must select the one you have copied from your computer. +This operation will be mandatory only the first time, then for successive upgrades you will be able to follow this guide. +``` + +## Overview for updating to a new version of AAPS with a browser + +```{contents} Steps for updating to a new version of AAPS +:depth: 1 +:local: true +``` + +In case you experience problems, see separate page for [troubleshooting Android Studio](../GettingHelp/TroubleshootingAndroidStudio). + +### Export your settings + +Export your settings from the existing **AAPS** version on your phone. You might not need it, but better be safe than sorry. + +See the [Export & import settings](ExportImportSettings.md) page if you don't remember how to do this. + +(Update-to-new-version-update-your-repo)= +### Update your GitHub repository + +```{admonition} WARNING +:class: warning +Browser Build is available from AAPS version 3.3.2.1. +``` + +[Log into GitHub](https://github.com/login). + +1. Select Repositories. +2. Scroll down and select your own AndroidAPS repository. + +![Select AndroidAPS repo](../images/update/CI/GitHubUpdate1.png) + +3. Verify you are using your own copy of AndroidAPS (Forked from nightscout/AndroidAPS) +4. Tap Sync Fork to update it (the number of commits behind might differ from the picture) + + + +![Sync AndroidAPS repo](../images/update/CI/GitHubUpdate2.png) + +5. Tap Update Branch + +![Update AndroidAPS repo](../images/update/CI/GitHubUpdate3.png) + +Note: if you have modified your copy of AndroidAPS by mistake, you will see this screen. Discard all changes (commits) to return to the released version. + +![Discard rogue modifications](../images/update/CI/GitHubUpdate4.png) + +You have now synchronized (updated) your own copy with the latest release of Android APS. Good job. + +![Repo sync'ed](../images/update/CI/GitHubUpdate5.png) + +### Run the Workflow to Build the Signed APK + +1. In your GitHub copy of AndroidAPS, select Actions. +2. Expand All Workflows. +3. Select AAPS-CI + +![Actions AAPS-CI](../images/update/CI/GitHubActions1.png) + +4. Scroll down and tap Run Workflow. + +![Run Workflow](../images/update/CI/GitHubActions2.png) + +5. Select the branch you want to deploy (master), the [variant](variant) (fullRelease) and tap Run Workflow. + + + +![Run Workflow](../images/update/CI/GitHubActions3.png) + +6. You will see the message Workflow run was successfully requested. Refresh your browser page and you will be able to monitor the build progress. When the action completes, the AAPS CI action will show a green tick mark. You have successfully built the updated version of Android APS. + +![Monitor Workflow](../images/update/CI/GitHubActions4.png) + +### Install the AAPS APK + +1. Open your Google Drive +2. Browse into AAPS, select the new version folder and you will find both the phone and Android Wear versions. + +![Google Drive Location](../images/update/CI/GitHubActions5.png) + + +Continue [here](#Update-to-new-version-check-aaps-version-on-phone) + +## Troubleshooting + +If anything goes wrong, don't panic. + +Take a breath! + +Then see the [troubleshooting tips](#aaps-ci-preparation) if your problem is already documented! + +If you need further help, please reach out to other **AAPS** users on [Facebook](https://www.facebook.com/groups/AndroidAPSUsers) or [Discord](https://discord.gg/4fQUWHZ4Mw). \ No newline at end of file diff --git a/docs/CROWDIN/ko/Maintenance/UpdateComputerBuild.md b/docs/CROWDIN/ko/Maintenance/UpdateComputerBuild.md new file mode 100644 index 000000000000..f550d48cfa80 --- /dev/null +++ b/docs/CROWDIN/ko/Maintenance/UpdateComputerBuild.md @@ -0,0 +1,103 @@ +# Update with a computer + +## 다운로드 대신에 당신 스스로 빌드하세요 + +**AAPS** is not available to download, due to regulations concerning medical devices. It is legal to build the app for your own use, but you must not give a copy to others! See [FAQ page](../UsefulLinks/FAQ.md) for details. + +```{note} +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 + +```{contents} Steps for updating to a new version of AAPS +:depth: 1 +:local: true +``` + +In case you experience problems, see separate page for [troubleshooting Android Studio](../GettingHelp/TroubleshootingAndroidStudio). + +### Export your settings + +Export your settings from the existing **AAPS** version on your phone. You might not need it, but better be safe than sorry. + +See the [Export & import settings](ExportImportSettings.md) page if you don't remember how to do this. + +### Check your Android Studio version + +The minimal version required is described in the [Building Instructions](#Building-APK-recommended-specification-of-computer-for-building-apk-file). If your version is older, please [update Android Studio first](#Building-APK-install-android-studio)! + +(Update-to-new-version-update-your-local-copy)= +### Update your local copy + +```{admonition} WARNING +:class: warning +If you update from versions prior to 2.8.x, please follow the instructions to do a [New clone](../SettingUpAaps/BuildingAaps.md), as this guide will not work for you! +``` + +* Open your existing AAPS project with Android Studio. You might need to select your project. (Double) click on the AAPS project. + + ![Android Studio - Select Project](../images/update/01_ProjectSelection.png) + +* In the menu bar of Android Studio, select Git -> Fetch + + ![Android Studio Menu - Git - Fetch](../images/update/02_GitFetch.png) + +* You will see a message in the lower right corner that Fetch was successful. + + ![Android Studio Menu - Git - Fetch successful](../images/update/03_GitFetchSuccessful.png) + +* In the menu bar, now select Git -> Pull + + ![Android Studio Menu - Git - Pull](../images/update/04_GitPull.png) + +* Leave all options as they are (origin/master) and select Pull + + ![Android Studio - Git - Pull dialog](../images/update/05_GitPullOptions.png) + +* Wait while download is in progress, you will see this as info in the bottom bar. When it's done, you will see a success message. + + ```{note} + The files that were updated may vary! This is not an indication + ``` + + ![Android Studio - Pull successful](../images/update/06_GitPullSuccess.png) + +* Gradle Sync will be running to download some dependencies. Wait until it is finished. + + ![Android Studio - Gradle Sync](../images/studioSetup/40_BackgroundTasks.png) + +### Check JVM version + +This check is particularly indicated if you have already built a previous version of **AAPS** on the same computer. + +Check in the [Building Instructions](#Building-APK-recommended-specification-of-computer-for-building-apk-file) the required version for JVM, matching the **AAPS** version you are now building. Then follow the steps described at [Incompatible Gradle JVM](#incompatible-gradle-jvm) to make sure you currently use the correct version. + +(Update-to-new-version-build-the-signed-apk)= +### Build the Signed APK + +Your sourcecode is now the current released version, and all prerequisites have been checked. It's time to build the signed apk as described in the [build signed apk section](#Building-APK-generate-signed-apk). + +(Update-to-new-version-transfer-and-install)= + +### Transfer and install the apk +You need to transfer the apk to your phone so you can install it. + +```{note} +If you completed the build with the same existing key store in Android Studio, then you do not need to remove the existing app on your phone. When you install the apk, follow the prompts to install updates. +For other scenarios such as establishing a new key store in Android Studio for your signed apk, you will need to delete the old app before installing the apk. **Make sure to export your settings!** +``` + +See the instructions for [transferring and installing AAPS](../SettingUpAaps/TransferringAndInstallingAaps.md) + +Continue [here](#Update-to-new-version-check-aaps-version-on-phone). + +## Troubleshooting + +If anything goes wrong, don't panic. + +Take a breath! + +Then see the separate page [troubleshooting Android Studio](../GettingHelp/TroubleshootingAndroidStudio) if your problem is already documented! + +If you need further help, please reach out to other **AAPS** users on [Facebook](https://www.facebook.com/groups/AndroidAPSUsers) or [Discord](https://discord.gg/4fQUWHZ4Mw). \ No newline at end of file diff --git a/docs/CROWDIN/ko/Maintenance/UpdateToNewVersion.md b/docs/CROWDIN/ko/Maintenance/UpdateToNewVersion.md index 2de7f9306c84..39652f06ceeb 100644 --- a/docs/CROWDIN/ko/Maintenance/UpdateToNewVersion.md +++ b/docs/CROWDIN/ko/Maintenance/UpdateToNewVersion.md @@ -10,91 +10,14 @@ * When a new release is available, in the **AAPS** app itself, you will receive an information banner about the new version. * The new version will also be announced on Facebook at the time of release. * Following the release, please read the [Release Notes](ReleaseNotes.md) in detail, and clarify any queries with the community on Facebook or Discord, before proceeding with the update. - - ```{note} - 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 +## Update AAPS with browser build -```{contents} Steps for updating to a new version of AAPS :depth: 1 :local: true +If you already built your AAPS app with the Browser Build method, follow [these instructions](./UpdateBrowserBuild.md). -
In case you experience problems, see separate page for [troubleshooting Android Studio](../GettingHelp/TroubleshootingAndroidStudio). - - ### Export your settings - - Export your settings from the existing **AAPS** version on your phone. You might not need it, but better be safe than sorry. - - See the [Export & import settings](ExportImportSettings.md) page if you don't remember how to do this. - - ### Check your Android Studio version - - The minimal version required is described in the [Building Instructions](#Building-APK-recommended-specification-of-computer-for-building-apk-file). If your version is older, please [update Android Studio first](#Building-APK-install-android-studio)! - - (Update-to-new-version-update-your-local-copy)= - ### Update your local copy - - ```{admonition} WARNING - :class: warning - If you update from versions prior to 2.8.x, please follow the instructions to do a [New clone](../SettingUpAaps/BuildingAaps.md), as this guide will not work for you! - +## Update AAPS with a computer -* Open your existing AAPS project with Android Studio. You might need to select your project. (Double) click on the AAPS project. - - ![Android Studio - Select Project](../images/update/01_ProjectSelection.png) - -* In the menu bar of Android Studio, select Git -> Fetch - - ![Android Studio Menu - Git - Fetch](../images/update/02_GitFetch.png) - -* You will see a message in the lower right corner that Fetch was successful. - - ![Android Studio Menu - Git - Fetch successful](../images/update/03_GitFetchSuccessful.png) - -* In the menu bar, now select Git -> Pull - - ![Android Studio Menu - Git - Pull](../images/update/04_GitPull.png) - -* Leave all options as they are (origin/master) and select Pull - - ![Android Studio - Git - Pull dialog](../images/update/05_GitPullOptions.png) - -* Wait while download is in progress, you will see this as info in the bottom bar. When it's done, you will see a success message. - - ```{note} - The files that were updated may vary! This is not an indication - ``` - - ![Android Studio - Pull successful](../images/update/06_GitPullSuccess.png) - -* Gradle Sync will be running to download some dependencies. Wait until it is finished. - - ![Android Studio - Gradle Sync](../images/studioSetup/40_BackgroundTasks.png) - -### Check JVM version - -This check is particularly indicated if you have already built a previous version of **AAPS** on the same computer. - -Check in the [Building Instructions](#Building-APK-recommended-specification-of-computer-for-building-apk-file) the required version for JVM, matching the **AAPS** version you are now building. Then follow the steps described at [Incompatible Gradle JVM](#incompatible-gradle-jvm) to make sure you currently use the correct version. - -(Update-to-new-version-build-the-signed-apk)= - -### Build the Signed APK - -Your sourcecode is now the current released version, and all prerequisites have been checked. It's time to build the signed apk as described in the [build signed apk section](#Building-APK-generate-signed-apk). - -(Update-to-new-version-transfer-and-install)= - -### Transfer and install the apk - -You need to transfer the apk to your phone so you can install it. - -```{note} -If you completed the build with the same existing key store in Android Studio, then you do not need to remove the existing app on your phone. When you install the apk, follow the prompts to install updates. -For other scenarios such as establishing a new key store in Android Studio for your signed apk, you will need to delete the old app before installing the apk. **Make sure to export your settings!** -``` - -See the instructions for [transferring and installing AAPS](../SettingUpAaps/TransferringAndInstallingAaps.md) +Follow [these instructions.](./UpdateComputerBuild.md). (Update-to-new-version-check-aaps-version-on-phone)= @@ -104,14 +27,4 @@ After you installed the new apk, you can check the AAPS version on your phone by ![AAPS version installed](../images/Update_VersionCheck.png) -Check in the [Release Notes](../Maintenance/ReleaseNotes.md) if there are any specific instructions after update. - -## Troubleshooting - -If anything goes wrong, don't panic. - -Take a breath! - -Then see the separate page [troubleshooting Android Studio](../GettingHelp/TroubleshootingAndroidStudio) if your problem is already documented! - -If you need further help, please reach out to other **AAPS** users on [Facebook](https://www.facebook.com/groups/AndroidAPSUsers) or [Discord](https://discord.gg/4fQUWHZ4Mw). \ No newline at end of file +Check in the [Release Notes](../Maintenance/ReleaseNotes.md) if there are any specific instructions after update. \ No newline at end of file diff --git a/docs/CROWDIN/ko/SettingUpAaps/BrowserBuild.md b/docs/CROWDIN/ko/SettingUpAaps/BrowserBuild.md index 10307201c517..9b342ae0e3cd 100644 --- a/docs/CROWDIN/ko/SettingUpAaps/BrowserBuild.md +++ b/docs/CROWDIN/ko/SettingUpAaps/BrowserBuild.md @@ -1,3 +1,5 @@ +(browser-build)= + # Browser build Building AAPS with GitHub Actions. diff --git a/docs/CROWDIN/ko/images/Building-the-App/CI/aaps_ci_simple_http_server.png b/docs/CROWDIN/ko/images/Building-the-App/CI/aaps_ci_simple_http_server.png index 95ac2d4eb443..2e2fb47e5ca2 100644 Binary files a/docs/CROWDIN/ko/images/Building-the-App/CI/aaps_ci_simple_http_server.png and b/docs/CROWDIN/ko/images/Building-the-App/CI/aaps_ci_simple_http_server.png differ diff --git a/docs/CROWDIN/ko/images/Building-the-App/CI/aaps_ci_simple_http_server_step1.png b/docs/CROWDIN/ko/images/Building-the-App/CI/aaps_ci_simple_http_server_step1.png index 78f52682b58d..b348162dcb1c 100644 Binary files a/docs/CROWDIN/ko/images/Building-the-App/CI/aaps_ci_simple_http_server_step1.png and b/docs/CROWDIN/ko/images/Building-the-App/CI/aaps_ci_simple_http_server_step1.png differ diff --git a/docs/CROWDIN/ko/images/Building-the-App/CI/aaps_ci_simple_http_server_step2.png b/docs/CROWDIN/ko/images/Building-the-App/CI/aaps_ci_simple_http_server_step2.png index c292ac667f63..cabadeefb97a 100644 Binary files a/docs/CROWDIN/ko/images/Building-the-App/CI/aaps_ci_simple_http_server_step2.png and b/docs/CROWDIN/ko/images/Building-the-App/CI/aaps_ci_simple_http_server_step2.png differ diff --git a/docs/CROWDIN/ko/images/Building-the-App/CI/aaps_ci_simple_http_server_step3.png b/docs/CROWDIN/ko/images/Building-the-App/CI/aaps_ci_simple_http_server_step3.png index bd31cd0ffb3d..9a26d3526369 100644 Binary files a/docs/CROWDIN/ko/images/Building-the-App/CI/aaps_ci_simple_http_server_step3.png and b/docs/CROWDIN/ko/images/Building-the-App/CI/aaps_ci_simple_http_server_step3.png differ diff --git a/docs/CROWDIN/ko/images/Building-the-App/CI/aaps_ci_simple_http_server_step4.png b/docs/CROWDIN/ko/images/Building-the-App/CI/aaps_ci_simple_http_server_step4.png index cc187ec72a14..285492424351 100644 Binary files a/docs/CROWDIN/ko/images/Building-the-App/CI/aaps_ci_simple_http_server_step4.png and b/docs/CROWDIN/ko/images/Building-the-App/CI/aaps_ci_simple_http_server_step4.png differ diff --git a/docs/CROWDIN/ko/images/Building-the-App/CI/aaps_ci_simple_http_server_store.png b/docs/CROWDIN/ko/images/Building-the-App/CI/aaps_ci_simple_http_server_store.png index 4b157ca8d3d8..65bf101f55e4 100644 Binary files a/docs/CROWDIN/ko/images/Building-the-App/CI/aaps_ci_simple_http_server_store.png and b/docs/CROWDIN/ko/images/Building-the-App/CI/aaps_ci_simple_http_server_store.png differ diff --git a/docs/CROWDIN/ko/images/update/CI/GitHubActions1.png b/docs/CROWDIN/ko/images/update/CI/GitHubActions1.png new file mode 100644 index 000000000000..e04ce6e76d8b Binary files /dev/null and b/docs/CROWDIN/ko/images/update/CI/GitHubActions1.png differ diff --git a/docs/CROWDIN/ko/images/update/CI/GitHubActions2.png b/docs/CROWDIN/ko/images/update/CI/GitHubActions2.png new file mode 100644 index 000000000000..7b5c5a842d16 Binary files /dev/null and b/docs/CROWDIN/ko/images/update/CI/GitHubActions2.png differ diff --git a/docs/CROWDIN/ko/images/update/CI/GitHubActions3.png b/docs/CROWDIN/ko/images/update/CI/GitHubActions3.png new file mode 100644 index 000000000000..cff0ed34b214 Binary files /dev/null and b/docs/CROWDIN/ko/images/update/CI/GitHubActions3.png differ diff --git a/docs/CROWDIN/ko/images/update/CI/GitHubActions4.png b/docs/CROWDIN/ko/images/update/CI/GitHubActions4.png new file mode 100644 index 000000000000..bede3c2dfe08 Binary files /dev/null and b/docs/CROWDIN/ko/images/update/CI/GitHubActions4.png differ diff --git a/docs/CROWDIN/ko/images/update/CI/GitHubActions5.png b/docs/CROWDIN/ko/images/update/CI/GitHubActions5.png new file mode 100644 index 000000000000..d96e31cf084d Binary files /dev/null and b/docs/CROWDIN/ko/images/update/CI/GitHubActions5.png differ diff --git a/docs/CROWDIN/ko/images/update/CI/GitHubUpdate1.png b/docs/CROWDIN/ko/images/update/CI/GitHubUpdate1.png new file mode 100644 index 000000000000..3058dc270d28 Binary files /dev/null and b/docs/CROWDIN/ko/images/update/CI/GitHubUpdate1.png differ diff --git a/docs/CROWDIN/ko/images/update/CI/GitHubUpdate2.png b/docs/CROWDIN/ko/images/update/CI/GitHubUpdate2.png new file mode 100644 index 000000000000..1ae9568c8107 Binary files /dev/null and b/docs/CROWDIN/ko/images/update/CI/GitHubUpdate2.png differ diff --git a/docs/CROWDIN/ko/images/update/CI/GitHubUpdate3.png b/docs/CROWDIN/ko/images/update/CI/GitHubUpdate3.png new file mode 100644 index 000000000000..d18f9119c76d Binary files /dev/null and b/docs/CROWDIN/ko/images/update/CI/GitHubUpdate3.png differ diff --git a/docs/CROWDIN/ko/images/update/CI/GitHubUpdate4.png b/docs/CROWDIN/ko/images/update/CI/GitHubUpdate4.png new file mode 100644 index 000000000000..8c38c071cb8f Binary files /dev/null and b/docs/CROWDIN/ko/images/update/CI/GitHubUpdate4.png differ diff --git a/docs/CROWDIN/ko/images/update/CI/GitHubUpdate5.png b/docs/CROWDIN/ko/images/update/CI/GitHubUpdate5.png new file mode 100644 index 000000000000..409aef1f34dc Binary files /dev/null and b/docs/CROWDIN/ko/images/update/CI/GitHubUpdate5.png differ diff --git a/docs/CROWDIN/ko/index.md b/docs/CROWDIN/ko/index.md index 91bfc43da27b..2b21ba58a14f 100644 --- a/docs/CROWDIN/ko/index.md +++ b/docs/CROWDIN/ko/index.md @@ -2,10 +2,10 @@ ![image](./images/basic-outline-of-AAPS.png) -```{admonition} Version 3.3 +```{admonition} Latest Release :class: note -29/12/2024 : Version 3.3 is out. Check the [Release Notes](#version3300) to see what's new and get update instructions. +14/08/2025 : Version 3.3.2.1 is out. Check the [Release Notes](#latestrelease) to see what's new and get update instructions. ``` @@ -21,7 +21,7 @@ Section **2) Getting Started**, the [Introduction](Getting-Started/Introduction. Now that you have a solid understanding of the process, you can start assembling your **AAPS** loop. -Section **3) Setting up AAPS** contains step-by-step instructions to do this. It covers choosing and [setting up your reporting server](./SettingUpAaps/SettingUpTheReportingServer.md) (Nightscout or Tidepool) so you can review and share your data, getting your computer ready for building the AAPS app, building the AAPS app and transferring the AAPS app to your phone. It also covers setting up the **AAPS** app using the setup Wizard, linking it with your CGM app, and either a real or virtual insulin pump, as well as linking **AAPS** to your reporting server. You are then slowly introduced to the full usage of what **AAPS** has to offer via a safe and carefully calibrated step-by-step process designed to make sure that you/your child are thoroughly familiar and comfortable navigating all the different levels and menu configurations before graduating on the next phase, commonly referred to as the next "Objective", until you are have enough experience to begin using the more advanced options available within the app. These Objectives are specially designed in such a way that will gradually unlock more possibilities of **AAPS** and switch from Open Loop to Closed Loop. +Section **3) Setting up AAPS** contains step-by-step instructions to do this. It covers choosing and [setting up your reporting server](./SettingUpAaps/SettingUpTheReportingServer.md) (Nightscout or Tidepool) so you can review and share your data, getting ready for building the AAPS app, building the AAPS app and transferring the AAPS app to your phone. It also covers setting up the **AAPS** app using the setup Wizard, linking it with your CGM app, and either a real or virtual insulin pump, as well as linking **AAPS** to your reporting server. You are then slowly introduced to the full usage of what **AAPS** has to offer via a safe and carefully calibrated step-by-step process designed to make sure that you/your child are thoroughly familiar and comfortable navigating all the different levels and menu configurations before graduating on the next phase, commonly referred to as the next "Objective", until you are have enough experience to begin using the more advanced options available within the app. These Objectives are specially designed in such a way that will gradually unlock more possibilities of **AAPS** and switch from Open Loop to Closed Loop. Section **4) Daily life with AAPS** covers key **AAPS** features, to help you use (and customise) **AAPS**. This including understanding the screens, carbs-on-board, sensitivity, profile switching, temp targets, extended carbs (or eCarbs), automations, and DynamicISF. It also covers frequent topics like how to manage different types of meals, how to deal with cannula and sensor changes, smartphone updates, daylight saving changes, and [travelling with AAPS](DailyLifeWithAaps/TimezoneTraveling-DaylightSavingTime.md) and sports. Common questions and answers are located within the troubleshooting section. diff --git a/docs/CROWDIN/lt/Maintenance/DocumentationUpdate.md b/docs/CROWDIN/lt/Maintenance/DocumentationUpdate.md index 8309b37dd070..fa8ac9fd4f67 100644 --- a/docs/CROWDIN/lt/Maintenance/DocumentationUpdate.md +++ b/docs/CROWDIN/lt/Maintenance/DocumentationUpdate.md @@ -4,7 +4,7 @@ - Updated versions and Android Studio prerequisites - Added [3.3.2.1](#version3321) release, removed Android 16 references (fixed) -- Added [Browser Build](browser-build) @Angus +- Added [Browser Build](#browser-build) @Angus ## May 2025 diff --git a/docs/CROWDIN/lt/Maintenance/ReleaseNotes.md b/docs/CROWDIN/lt/Maintenance/ReleaseNotes.md index a5be881fee36..47feb198b4b3 100644 --- a/docs/CROWDIN/lt/Maintenance/ReleaseNotes.md +++ b/docs/CROWDIN/lt/Maintenance/ReleaseNotes.md @@ -55,6 +55,8 @@ In order to allow users with older Android to use older version of AAPS new vers WearOS 5, API level 34 (Android 14) has [limitations](#BuildingAapsWearOs-WearOS5). ``` +(latestrelease)= + (version3321)= ## Version 3.3.2.1 diff --git a/docs/CROWDIN/lt/Maintenance/UpdateBrowserBuild.md b/docs/CROWDIN/lt/Maintenance/UpdateBrowserBuild.md new file mode 100644 index 000000000000..9f74f6735358 --- /dev/null +++ b/docs/CROWDIN/lt/Maintenance/UpdateBrowserBuild.md @@ -0,0 +1,101 @@ +# Update with a browser + +## Kurti sau, o ne parsisiųsti + +**AAPS** is not available to download, due to regulations concerning medical devices. It is legal to build the app for your own use, but you must not give a copy to others! See [FAQ page](../UsefulLinks/FAQ.md) for details. + +```{note} +In case you want to upgrade **AAPS** with a browser for the first time : copy your back-up keystore file to your Google Drive. Then follow the [Browser Build **AAPS** procedure](../SettingUpAaps/BrowserBuild.md) instead of this guide. Instead of creating a new keystore, you must select the one you have copied from your computer. +This operation will be mandatory only the first time, then for successive upgrades you will be able to follow this guide. +``` + +## Overview for updating to a new version of AAPS with a browser + +```{contents} Steps for updating to a new version of AAPS +:depth: 1 +:local: true +``` + +In case you experience problems, see separate page for [troubleshooting Android Studio](../GettingHelp/TroubleshootingAndroidStudio). + +### Export your settings + +Export your settings from the existing **AAPS** version on your phone. You might not need it, but better be safe than sorry. + +See the [Export & import settings](ExportImportSettings.md) page if you don't remember how to do this. + +(Update-to-new-version-update-your-repo)= +### Update your GitHub repository + +```{admonition} WARNING +:class: warning +Browser Build is available from AAPS version 3.3.2.1. +``` + +[Log into GitHub](https://github.com/login). + +1. Select Repositories. +2. Scroll down and select your own AndroidAPS repository. + +![Select AndroidAPS repo](../images/update/CI/GitHubUpdate1.png) + +3. Verify you are using your own copy of AndroidAPS (Forked from nightscout/AndroidAPS) +4. Tap Sync Fork to update it (the number of commits behind might differ from the picture) + + + +![Sync AndroidAPS repo](../images/update/CI/GitHubUpdate2.png) + +5. Tap Update Branch + +![Update AndroidAPS repo](../images/update/CI/GitHubUpdate3.png) + +Note: if you have modified your copy of AndroidAPS by mistake, you will see this screen. Discard all changes (commits) to return to the released version. + +![Discard rogue modifications](../images/update/CI/GitHubUpdate4.png) + +You have now synchronized (updated) your own copy with the latest release of Android APS. Good job. + +![Repo sync'ed](../images/update/CI/GitHubUpdate5.png) + +### Run the Workflow to Build the Signed APK + +1. In your GitHub copy of AndroidAPS, select Actions. +2. Expand All Workflows. +3. Select AAPS-CI + +![Actions AAPS-CI](../images/update/CI/GitHubActions1.png) + +4. Scroll down and tap Run Workflow. + +![Run Workflow](../images/update/CI/GitHubActions2.png) + +5. Select the branch you want to deploy (master), the [variant](variant) (fullRelease) and tap Run Workflow. + + + +![Run Workflow](../images/update/CI/GitHubActions3.png) + +6. You will see the message Workflow run was successfully requested. Refresh your browser page and you will be able to monitor the build progress. When the action completes, the AAPS CI action will show a green tick mark. You have successfully built the updated version of Android APS. + +![Monitor Workflow](../images/update/CI/GitHubActions4.png) + +### Install the AAPS APK + +1. Open your Google Drive +2. Browse into AAPS, select the new version folder and you will find both the phone and Android Wear versions. + +![Google Drive Location](../images/update/CI/GitHubActions5.png) + + +Continue [here](#Update-to-new-version-check-aaps-version-on-phone) + +## Troubleshooting + +If anything goes wrong, don't panic. + +Take a breath! + +Then see the [troubleshooting tips](#aaps-ci-preparation) if your problem is already documented! + +If you need further help, please reach out to other **AAPS** users on [Facebook](https://www.facebook.com/groups/AndroidAPSUsers) or [Discord](https://discord.gg/4fQUWHZ4Mw). \ No newline at end of file diff --git a/docs/CROWDIN/lt/Maintenance/UpdateComputerBuild.md b/docs/CROWDIN/lt/Maintenance/UpdateComputerBuild.md new file mode 100644 index 000000000000..951ea68606c8 --- /dev/null +++ b/docs/CROWDIN/lt/Maintenance/UpdateComputerBuild.md @@ -0,0 +1,103 @@ +# Update with a computer + +## Kurti sau, o ne parsisiųsti + +**AAPS** is not available to download, due to regulations concerning medical devices. It is legal to build the app for your own use, but you must not give a copy to others! See [FAQ page](../UsefulLinks/FAQ.md) for details. + +```{note} +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 + +```{contents} Steps for updating to a new version of AAPS +:depth: 1 +:local: true +``` + +In case you experience problems, see separate page for [troubleshooting Android Studio](../GettingHelp/TroubleshootingAndroidStudio). + +### Export your settings + +Export your settings from the existing **AAPS** version on your phone. You might not need it, but better be safe than sorry. + +See the [Export & import settings](ExportImportSettings.md) page if you don't remember how to do this. + +### Check your Android Studio version + +The minimal version required is described in the [Building Instructions](#Building-APK-recommended-specification-of-computer-for-building-apk-file). If your version is older, please [update Android Studio first](#Building-APK-install-android-studio)! + +(Update-to-new-version-update-your-local-copy)= +### Update your local copy + +```{admonition} WARNING +:class: warning +If you update from versions prior to 2.8.x, please follow the instructions to do a [New clone](../SettingUpAaps/BuildingAaps.md), as this guide will not work for you! +``` + +* Open your existing AAPS project with Android Studio. You might need to select your project. (Double) click on the AAPS project. + + ![Android Studio - Select Project](../images/update/01_ProjectSelection.png) + +* In the menu bar of Android Studio, select Git -> Fetch + + ![Android Studio Menu - Git - Fetch](../images/update/02_GitFetch.png) + +* You will see a message in the lower right corner that Fetch was successful. + + ![Android Studio Menu - Git - Fetch successful](../images/update/03_GitFetchSuccessful.png) + +* In the menu bar, now select Git -> Pull + + ![Android Studio Menu - Git - Pull](../images/update/04_GitPull.png) + +* Leave all options as they are (origin/master) and select Pull + + ![Android Studio - Git - Pull dialog](../images/update/05_GitPullOptions.png) + +* Wait while download is in progress, you will see this as info in the bottom bar. When it's done, you will see a success message. + + ```{note} + The files that were updated may vary! This is not an indication + ``` + + ![Android Studio - Pull successful](../images/update/06_GitPullSuccess.png) + +* Gradle Sync will be running to download some dependencies. Wait until it is finished. + + ![Android Studio - Gradle Sync](../images/studioSetup/40_BackgroundTasks.png) + +### Check JVM version + +This check is particularly indicated if you have already built a previous version of **AAPS** on the same computer. + +Check in the [Building Instructions](#Building-APK-recommended-specification-of-computer-for-building-apk-file) the required version for JVM, matching the **AAPS** version you are now building. Then follow the steps described at [Incompatible Gradle JVM](#incompatible-gradle-jvm) to make sure you currently use the correct version. + +(Update-to-new-version-build-the-signed-apk)= +### Build the Signed APK + +Your sourcecode is now the current released version, and all prerequisites have been checked. It's time to build the signed apk as described in the [build signed apk section](#Building-APK-generate-signed-apk). + +(Update-to-new-version-transfer-and-install)= + +### Transfer and install the apk +You need to transfer the apk to your phone so you can install it. + +```{note} +If you completed the build with the same existing key store in Android Studio, then you do not need to remove the existing app on your phone. When you install the apk, follow the prompts to install updates. +For other scenarios such as establishing a new key store in Android Studio for your signed apk, you will need to delete the old app before installing the apk. **Make sure to export your settings!** +``` + +See the instructions for [transferring and installing AAPS](../SettingUpAaps/TransferringAndInstallingAaps.md) + +Continue [here](#Update-to-new-version-check-aaps-version-on-phone). + +## Troubleshooting + +If anything goes wrong, don't panic. + +Take a breath! + +Then see the separate page [troubleshooting Android Studio](../GettingHelp/TroubleshootingAndroidStudio) if your problem is already documented! + +If you need further help, please reach out to other **AAPS** users on [Facebook](https://www.facebook.com/groups/AndroidAPSUsers) or [Discord](https://discord.gg/4fQUWHZ4Mw). \ No newline at end of file diff --git a/docs/CROWDIN/lt/Maintenance/UpdateToNewVersion.md b/docs/CROWDIN/lt/Maintenance/UpdateToNewVersion.md index 4ea93a9d9aab..d1a5bd0946ef 100644 --- a/docs/CROWDIN/lt/Maintenance/UpdateToNewVersion.md +++ b/docs/CROWDIN/lt/Maintenance/UpdateToNewVersion.md @@ -10,91 +10,14 @@ * When a new release is available, in the **AAPS** app itself, you will receive an information banner about the new version. * The new version will also be announced on Facebook at the time of release. * Following the release, please read the [Release Notes](ReleaseNotes.md) in detail, and clarify any queries with the community on Facebook or Discord, before proceeding with the update. - - ```{note} - 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 +## Update AAPS with browser build -```{contents} Steps for updating to a new version of AAPS :depth: 1 :local: true +If you already built your AAPS app with the Browser Build method, follow [these instructions](./UpdateBrowserBuild.md). -
In case you experience problems, see separate page for [troubleshooting Android Studio](../GettingHelp/TroubleshootingAndroidStudio). - - ### Export your settings - - Export your settings from the existing **AAPS** version on your phone. You might not need it, but better be safe than sorry. - - See the [Export & import settings](ExportImportSettings.md) page if you don't remember how to do this. - - ### Check your Android Studio version - - The minimal version required is described in the [Building Instructions](#Building-APK-recommended-specification-of-computer-for-building-apk-file). If your version is older, please [update Android Studio first](#Building-APK-install-android-studio)! - - (Update-to-new-version-update-your-local-copy)= - ### Update your local copy - - ```{admonition} WARNING - :class: warning - If you update from versions prior to 2.8.x, please follow the instructions to do a [New clone](../SettingUpAaps/BuildingAaps.md), as this guide will not work for you! - +## Update AAPS with a computer -* Open your existing AAPS project with Android Studio. You might need to select your project. (Double) click on the AAPS project. - - ![Android Studio - Select Project](../images/update/01_ProjectSelection.png) - -* In the menu bar of Android Studio, select Git -> Fetch - - ![Android Studio Menu - Git - Fetch](../images/update/02_GitFetch.png) - -* You will see a message in the lower right corner that Fetch was successful. - - ![Android Studio Menu - Git - Fetch successful](../images/update/03_GitFetchSuccessful.png) - -* In the menu bar, now select Git -> Pull - - ![Android Studio Menu - Git - Pull](../images/update/04_GitPull.png) - -* Leave all options as they are (origin/master) and select Pull - - ![Android Studio - Git - Pull dialog](../images/update/05_GitPullOptions.png) - -* Wait while download is in progress, you will see this as info in the bottom bar. When it's done, you will see a success message. - - ```{note} - The files that were updated may vary! This is not an indication - ``` - - ![Android Studio - Pull successful](../images/update/06_GitPullSuccess.png) - -* Gradle Sync will be running to download some dependencies. Wait until it is finished. - - ![Android Studio - Gradle Sync](../images/studioSetup/40_BackgroundTasks.png) - -### Check JVM version - -This check is particularly indicated if you have already built a previous version of **AAPS** on the same computer. - -Check in the [Building Instructions](#Building-APK-recommended-specification-of-computer-for-building-apk-file) the required version for JVM, matching the **AAPS** version you are now building. Then follow the steps described at [Incompatible Gradle JVM](#incompatible-gradle-jvm) to make sure you currently use the correct version. - -(Update-to-new-version-build-the-signed-apk)= - -### Build the Signed APK - -Your sourcecode is now the current released version, and all prerequisites have been checked. It's time to build the signed apk as described in the [build signed apk section](#Building-APK-generate-signed-apk). - -(Update-to-new-version-transfer-and-install)= - -### Transfer and install the apk - -You need to transfer the apk to your phone so you can install it. - -```{note} -If you completed the build with the same existing key store in Android Studio, then you do not need to remove the existing app on your phone. When you install the apk, follow the prompts to install updates. -For other scenarios such as establishing a new key store in Android Studio for your signed apk, you will need to delete the old app before installing the apk. **Make sure to export your settings!** -``` - -See the instructions for [transferring and installing AAPS](../SettingUpAaps/TransferringAndInstallingAaps.md) +Follow [these instructions.](./UpdateComputerBuild.md). (Update-to-new-version-check-aaps-version-on-phone)= @@ -104,14 +27,4 @@ After you installed the new apk, you can check the AAPS version on your phone by ![AAPS version installed](../images/Update_VersionCheck.png) -Check in the [Release Notes](../Maintenance/ReleaseNotes.md) if there are any specific instructions after update. - -## Troubleshooting - -If anything goes wrong, don't panic. - -Take a breath! - -Then see the separate page [troubleshooting Android Studio](../GettingHelp/TroubleshootingAndroidStudio) if your problem is already documented! - -If you need further help, please reach out to other **AAPS** users on [Facebook](https://www.facebook.com/groups/AndroidAPSUsers) or [Discord](https://discord.gg/4fQUWHZ4Mw). \ No newline at end of file +Check in the [Release Notes](../Maintenance/ReleaseNotes.md) if there are any specific instructions after update. \ No newline at end of file diff --git a/docs/CROWDIN/lt/SettingUpAaps/BrowserBuild.md b/docs/CROWDIN/lt/SettingUpAaps/BrowserBuild.md index 866a63ad7cee..d2d7ab95b9e9 100644 --- a/docs/CROWDIN/lt/SettingUpAaps/BrowserBuild.md +++ b/docs/CROWDIN/lt/SettingUpAaps/BrowserBuild.md @@ -1,3 +1,5 @@ +(browser-build)= + # Browser build Building AAPS with GitHub Actions. diff --git a/docs/CROWDIN/lt/images/Building-the-App/CI/aaps_ci_simple_http_server.png b/docs/CROWDIN/lt/images/Building-the-App/CI/aaps_ci_simple_http_server.png index 95ac2d4eb443..2e2fb47e5ca2 100644 Binary files a/docs/CROWDIN/lt/images/Building-the-App/CI/aaps_ci_simple_http_server.png and b/docs/CROWDIN/lt/images/Building-the-App/CI/aaps_ci_simple_http_server.png differ diff --git a/docs/CROWDIN/lt/images/Building-the-App/CI/aaps_ci_simple_http_server_step1.png b/docs/CROWDIN/lt/images/Building-the-App/CI/aaps_ci_simple_http_server_step1.png index 78f52682b58d..b348162dcb1c 100644 Binary files a/docs/CROWDIN/lt/images/Building-the-App/CI/aaps_ci_simple_http_server_step1.png and b/docs/CROWDIN/lt/images/Building-the-App/CI/aaps_ci_simple_http_server_step1.png differ diff --git a/docs/CROWDIN/lt/images/Building-the-App/CI/aaps_ci_simple_http_server_step2.png b/docs/CROWDIN/lt/images/Building-the-App/CI/aaps_ci_simple_http_server_step2.png index c292ac667f63..cabadeefb97a 100644 Binary files a/docs/CROWDIN/lt/images/Building-the-App/CI/aaps_ci_simple_http_server_step2.png and b/docs/CROWDIN/lt/images/Building-the-App/CI/aaps_ci_simple_http_server_step2.png differ diff --git a/docs/CROWDIN/lt/images/Building-the-App/CI/aaps_ci_simple_http_server_step3.png b/docs/CROWDIN/lt/images/Building-the-App/CI/aaps_ci_simple_http_server_step3.png index bd31cd0ffb3d..9a26d3526369 100644 Binary files a/docs/CROWDIN/lt/images/Building-the-App/CI/aaps_ci_simple_http_server_step3.png and b/docs/CROWDIN/lt/images/Building-the-App/CI/aaps_ci_simple_http_server_step3.png differ diff --git a/docs/CROWDIN/lt/images/Building-the-App/CI/aaps_ci_simple_http_server_step4.png b/docs/CROWDIN/lt/images/Building-the-App/CI/aaps_ci_simple_http_server_step4.png index cc187ec72a14..285492424351 100644 Binary files a/docs/CROWDIN/lt/images/Building-the-App/CI/aaps_ci_simple_http_server_step4.png and b/docs/CROWDIN/lt/images/Building-the-App/CI/aaps_ci_simple_http_server_step4.png differ diff --git a/docs/CROWDIN/lt/images/Building-the-App/CI/aaps_ci_simple_http_server_store.png b/docs/CROWDIN/lt/images/Building-the-App/CI/aaps_ci_simple_http_server_store.png index 4b157ca8d3d8..65bf101f55e4 100644 Binary files a/docs/CROWDIN/lt/images/Building-the-App/CI/aaps_ci_simple_http_server_store.png and b/docs/CROWDIN/lt/images/Building-the-App/CI/aaps_ci_simple_http_server_store.png differ diff --git a/docs/CROWDIN/lt/images/update/CI/GitHubActions1.png b/docs/CROWDIN/lt/images/update/CI/GitHubActions1.png new file mode 100644 index 000000000000..e04ce6e76d8b Binary files /dev/null and b/docs/CROWDIN/lt/images/update/CI/GitHubActions1.png differ diff --git a/docs/CROWDIN/lt/images/update/CI/GitHubActions2.png b/docs/CROWDIN/lt/images/update/CI/GitHubActions2.png new file mode 100644 index 000000000000..7b5c5a842d16 Binary files /dev/null and b/docs/CROWDIN/lt/images/update/CI/GitHubActions2.png differ diff --git a/docs/CROWDIN/lt/images/update/CI/GitHubActions3.png b/docs/CROWDIN/lt/images/update/CI/GitHubActions3.png new file mode 100644 index 000000000000..cff0ed34b214 Binary files /dev/null and b/docs/CROWDIN/lt/images/update/CI/GitHubActions3.png differ diff --git a/docs/CROWDIN/lt/images/update/CI/GitHubActions4.png b/docs/CROWDIN/lt/images/update/CI/GitHubActions4.png new file mode 100644 index 000000000000..bede3c2dfe08 Binary files /dev/null and b/docs/CROWDIN/lt/images/update/CI/GitHubActions4.png differ diff --git a/docs/CROWDIN/lt/images/update/CI/GitHubActions5.png b/docs/CROWDIN/lt/images/update/CI/GitHubActions5.png new file mode 100644 index 000000000000..d96e31cf084d Binary files /dev/null and b/docs/CROWDIN/lt/images/update/CI/GitHubActions5.png differ diff --git a/docs/CROWDIN/lt/images/update/CI/GitHubUpdate1.png b/docs/CROWDIN/lt/images/update/CI/GitHubUpdate1.png new file mode 100644 index 000000000000..3058dc270d28 Binary files /dev/null and b/docs/CROWDIN/lt/images/update/CI/GitHubUpdate1.png differ diff --git a/docs/CROWDIN/lt/images/update/CI/GitHubUpdate2.png b/docs/CROWDIN/lt/images/update/CI/GitHubUpdate2.png new file mode 100644 index 000000000000..1ae9568c8107 Binary files /dev/null and b/docs/CROWDIN/lt/images/update/CI/GitHubUpdate2.png differ diff --git a/docs/CROWDIN/lt/images/update/CI/GitHubUpdate3.png b/docs/CROWDIN/lt/images/update/CI/GitHubUpdate3.png new file mode 100644 index 000000000000..d18f9119c76d Binary files /dev/null and b/docs/CROWDIN/lt/images/update/CI/GitHubUpdate3.png differ diff --git a/docs/CROWDIN/lt/images/update/CI/GitHubUpdate4.png b/docs/CROWDIN/lt/images/update/CI/GitHubUpdate4.png new file mode 100644 index 000000000000..8c38c071cb8f Binary files /dev/null and b/docs/CROWDIN/lt/images/update/CI/GitHubUpdate4.png differ diff --git a/docs/CROWDIN/lt/images/update/CI/GitHubUpdate5.png b/docs/CROWDIN/lt/images/update/CI/GitHubUpdate5.png new file mode 100644 index 000000000000..409aef1f34dc Binary files /dev/null and b/docs/CROWDIN/lt/images/update/CI/GitHubUpdate5.png differ diff --git a/docs/CROWDIN/lt/index.md b/docs/CROWDIN/lt/index.md index d5a37d013f4e..9151e0ff4f81 100644 --- a/docs/CROWDIN/lt/index.md +++ b/docs/CROWDIN/lt/index.md @@ -2,10 +2,10 @@ ![image](./images/basic-outline-of-AAPS.png) -```{admonition} Version 3.3 +```{admonition} Latest Release :class: note -29/12/2024 : Version 3.3 is out. Check the [Release Notes](#version3300) to see what's new and get update instructions. +14/08/2025 : Version 3.3.2.1 is out. Check the [Release Notes](#latestrelease) to see what's new and get update instructions. ``` @@ -21,7 +21,7 @@ Section **2) Getting Started**, the [Introduction](Getting-Started/Introduction. Now that you have a solid understanding of the process, you can start assembling your **AAPS** loop. -Section **3) Setting up AAPS** contains step-by-step instructions to do this. It covers choosing and [setting up your reporting server](./SettingUpAaps/SettingUpTheReportingServer.md) (Nightscout or Tidepool) so you can review and share your data, getting your computer ready for building the AAPS app, building the AAPS app and transferring the AAPS app to your phone. It also covers setting up the **AAPS** app using the setup Wizard, linking it with your CGM app, and either a real or virtual insulin pump, as well as linking **AAPS** to your reporting server. You are then slowly introduced to the full usage of what **AAPS** has to offer via a safe and carefully calibrated step-by-step process designed to make sure that you/your child are thoroughly familiar and comfortable navigating all the different levels and menu configurations before graduating on the next phase, commonly referred to as the next "Objective", until you are have enough experience to begin using the more advanced options available within the app. These Objectives are specially designed in such a way that will gradually unlock more possibilities of **AAPS** and switch from Open Loop to Closed Loop. +Section **3) Setting up AAPS** contains step-by-step instructions to do this. It covers choosing and [setting up your reporting server](./SettingUpAaps/SettingUpTheReportingServer.md) (Nightscout or Tidepool) so you can review and share your data, getting ready for building the AAPS app, building the AAPS app and transferring the AAPS app to your phone. It also covers setting up the **AAPS** app using the setup Wizard, linking it with your CGM app, and either a real or virtual insulin pump, as well as linking **AAPS** to your reporting server. You are then slowly introduced to the full usage of what **AAPS** has to offer via a safe and carefully calibrated step-by-step process designed to make sure that you/your child are thoroughly familiar and comfortable navigating all the different levels and menu configurations before graduating on the next phase, commonly referred to as the next "Objective", until you are have enough experience to begin using the more advanced options available within the app. These Objectives are specially designed in such a way that will gradually unlock more possibilities of **AAPS** and switch from Open Loop to Closed Loop. Section **4) Daily life with AAPS** covers key **AAPS** features, to help you use (and customise) **AAPS**. This including understanding the screens, carbs-on-board, sensitivity, profile switching, temp targets, extended carbs (or eCarbs), automations, and DynamicISF. It also covers frequent topics like how to manage different types of meals, how to deal with cannula and sensor changes, smartphone updates, daylight saving changes, and [travelling with AAPS](DailyLifeWithAaps/TimezoneTraveling-DaylightSavingTime.md) and sports. Common questions and answers are located within the troubleshooting section. diff --git a/docs/CROWDIN/nl/Maintenance/DocumentationUpdate.md b/docs/CROWDIN/nl/Maintenance/DocumentationUpdate.md index 1cf7003c2260..39591f6eab39 100644 --- a/docs/CROWDIN/nl/Maintenance/DocumentationUpdate.md +++ b/docs/CROWDIN/nl/Maintenance/DocumentationUpdate.md @@ -4,7 +4,7 @@ - Updated versions and Android Studio prerequisites - Added [3.3.2.1](#version3321) release, removed Android 16 references (fixed) -- Added [Browser Build](browser-build) @Angus +- Added [Browser Build](#browser-build) @Angus ## May 2025 diff --git a/docs/CROWDIN/nl/Maintenance/ReleaseNotes.md b/docs/CROWDIN/nl/Maintenance/ReleaseNotes.md index 2649c9aae9a6..39b0796a692f 100644 --- a/docs/CROWDIN/nl/Maintenance/ReleaseNotes.md +++ b/docs/CROWDIN/nl/Maintenance/ReleaseNotes.md @@ -55,6 +55,8 @@ In order to allow users with older Android to use older version of AAPS new vers WearOS 5, API level 34 (Android 14) has [limitations](#BuildingAapsWearOs-WearOS5). ``` +(latestrelease)= + (version3321)= ## Version 3.3.2.1 diff --git a/docs/CROWDIN/nl/Maintenance/UpdateBrowserBuild.md b/docs/CROWDIN/nl/Maintenance/UpdateBrowserBuild.md new file mode 100644 index 000000000000..3ce608810b5c --- /dev/null +++ b/docs/CROWDIN/nl/Maintenance/UpdateBrowserBuild.md @@ -0,0 +1,101 @@ +# Update with a browser + +## Zelf bouwen, in plaats van downloaden + +**AAPS** is not available to download, due to regulations concerning medical devices. It is legal to build the app for your own use, but you must not give a copy to others! See [FAQ page](../UsefulLinks/FAQ.md) for details. + +```{note} +In case you want to upgrade **AAPS** with a browser for the first time : copy your back-up keystore file to your Google Drive. Then follow the [Browser Build **AAPS** procedure](../SettingUpAaps/BrowserBuild.md) instead of this guide. Instead of creating a new keystore, you must select the one you have copied from your computer. +This operation will be mandatory only the first time, then for successive upgrades you will be able to follow this guide. +``` + +## Overview for updating to a new version of AAPS with a browser + +```{contents} Steps for updating to a new version of AAPS +:depth: 1 +:local: true +``` + +In case you experience problems, see separate page for [troubleshooting Android Studio](../GettingHelp/TroubleshootingAndroidStudio). + +### Export your settings + +Export your settings from the existing **AAPS** version on your phone. You might not need it, but better be safe than sorry. + +See the [Export & import settings](ExportImportSettings.md) page if you don't remember how to do this. + +(Update-to-new-version-update-your-repo)= +### Update your GitHub repository + +```{admonition} WARNING +:class: warning +Browser Build is available from AAPS version 3.3.2.1. +``` + +[Log into GitHub](https://github.com/login). + +1. Select Repositories. +2. Scroll down and select your own AndroidAPS repository. + +![Select AndroidAPS repo](../images/update/CI/GitHubUpdate1.png) + +3. Verify you are using your own copy of AndroidAPS (Forked from nightscout/AndroidAPS) +4. Tap Sync Fork to update it (the number of commits behind might differ from the picture) + + + +![Sync AndroidAPS repo](../images/update/CI/GitHubUpdate2.png) + +5. Tap Update Branch + +![Update AndroidAPS repo](../images/update/CI/GitHubUpdate3.png) + +Note: if you have modified your copy of AndroidAPS by mistake, you will see this screen. Discard all changes (commits) to return to the released version. + +![Discard rogue modifications](../images/update/CI/GitHubUpdate4.png) + +You have now synchronized (updated) your own copy with the latest release of Android APS. Good job. + +![Repo sync'ed](../images/update/CI/GitHubUpdate5.png) + +### Run the Workflow to Build the Signed APK + +1. In your GitHub copy of AndroidAPS, select Actions. +2. Expand All Workflows. +3. Select AAPS-CI + +![Actions AAPS-CI](../images/update/CI/GitHubActions1.png) + +4. Scroll down and tap Run Workflow. + +![Run Workflow](../images/update/CI/GitHubActions2.png) + +5. Select the branch you want to deploy (master), the [variant](variant) (fullRelease) and tap Run Workflow. + + + +![Run Workflow](../images/update/CI/GitHubActions3.png) + +6. You will see the message Workflow run was successfully requested. Refresh your browser page and you will be able to monitor the build progress. When the action completes, the AAPS CI action will show a green tick mark. You have successfully built the updated version of Android APS. + +![Monitor Workflow](../images/update/CI/GitHubActions4.png) + +### Install the AAPS APK + +1. Open your Google Drive +2. Browse into AAPS, select the new version folder and you will find both the phone and Android Wear versions. + +![Google Drive Location](../images/update/CI/GitHubActions5.png) + + +Continue [here](#Update-to-new-version-check-aaps-version-on-phone) + +## Troubleshooting + +If anything goes wrong, don't panic. + +Take a breath! + +Then see the [troubleshooting tips](#aaps-ci-preparation) if your problem is already documented! + +If you need further help, please reach out to other **AAPS** users on [Facebook](https://www.facebook.com/groups/AndroidAPSUsers) or [Discord](https://discord.gg/4fQUWHZ4Mw). \ No newline at end of file diff --git a/docs/CROWDIN/nl/Maintenance/UpdateComputerBuild.md b/docs/CROWDIN/nl/Maintenance/UpdateComputerBuild.md new file mode 100644 index 000000000000..31facc9c8d27 --- /dev/null +++ b/docs/CROWDIN/nl/Maintenance/UpdateComputerBuild.md @@ -0,0 +1,103 @@ +# Update with a computer + +## Zelf bouwen, in plaats van downloaden + +**AAPS** is not available to download, due to regulations concerning medical devices. It is legal to build the app for your own use, but you must not give a copy to others! See [FAQ page](../UsefulLinks/FAQ.md) for details. + +```{note} +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 + +```{contents} Steps for updating to a new version of AAPS +:depth: 1 +:local: true +``` + +In case you experience problems, see separate page for [troubleshooting Android Studio](../GettingHelp/TroubleshootingAndroidStudio). + +### Export your settings + +Export your settings from the existing **AAPS** version on your phone. You might not need it, but better be safe than sorry. + +See the [Export & import settings](ExportImportSettings.md) page if you don't remember how to do this. + +### Check your Android Studio version + +The minimal version required is described in the [Building Instructions](#Building-APK-recommended-specification-of-computer-for-building-apk-file). If your version is older, please [update Android Studio first](#Building-APK-install-android-studio)! + +(Update-to-new-version-update-your-local-copy)= +### Update your local copy + +```{admonition} WARNING +:class: warning +If you update from versions prior to 2.8.x, please follow the instructions to do a [New clone](../SettingUpAaps/BuildingAaps.md), as this guide will not work for you! +``` + +* Open your existing AAPS project with Android Studio. You might need to select your project. (Double) click on the AAPS project. + + ![Android Studio - Select Project](../images/update/01_ProjectSelection.png) + +* In the menu bar of Android Studio, select Git -> Fetch + + ![Android Studio Menu - Git - Fetch](../images/update/02_GitFetch.png) + +* You will see a message in the lower right corner that Fetch was successful. + + ![Android Studio Menu - Git - Fetch successful](../images/update/03_GitFetchSuccessful.png) + +* In the menu bar, now select Git -> Pull + + ![Android Studio Menu - Git - Pull](../images/update/04_GitPull.png) + +* Leave all options as they are (origin/master) and select Pull + + ![Android Studio - Git - Pull dialog](../images/update/05_GitPullOptions.png) + +* Wait while download is in progress, you will see this as info in the bottom bar. When it's done, you will see a success message. + + ```{note} + The files that were updated may vary! This is not an indication + ``` + + ![Android Studio - Pull successful](../images/update/06_GitPullSuccess.png) + +* Gradle Sync will be running to download some dependencies. Wait until it is finished. + + ![Android Studio - Gradle Sync](../images/studioSetup/40_BackgroundTasks.png) + +### Check JVM version + +This check is particularly indicated if you have already built a previous version of **AAPS** on the same computer. + +Check in the [Building Instructions](#Building-APK-recommended-specification-of-computer-for-building-apk-file) the required version for JVM, matching the **AAPS** version you are now building. Then follow the steps described at [Incompatible Gradle JVM](#incompatible-gradle-jvm) to make sure you currently use the correct version. + +(Update-to-new-version-build-the-signed-apk)= +### Build the Signed APK + +Your sourcecode is now the current released version, and all prerequisites have been checked. It's time to build the signed apk as described in the [build signed apk section](#Building-APK-generate-signed-apk). + +(Update-to-new-version-transfer-and-install)= + +### Transfer and install the apk +You need to transfer the apk to your phone so you can install it. + +```{note} +If you completed the build with the same existing key store in Android Studio, then you do not need to remove the existing app on your phone. When you install the apk, follow the prompts to install updates. +For other scenarios such as establishing a new key store in Android Studio for your signed apk, you will need to delete the old app before installing the apk. **Make sure to export your settings!** +``` + +See the instructions for [transferring and installing AAPS](../SettingUpAaps/TransferringAndInstallingAaps.md) + +Continue [here](#Update-to-new-version-check-aaps-version-on-phone). + +## Troubleshooting + +If anything goes wrong, don't panic. + +Take a breath! + +Then see the separate page [troubleshooting Android Studio](../GettingHelp/TroubleshootingAndroidStudio) if your problem is already documented! + +If you need further help, please reach out to other **AAPS** users on [Facebook](https://www.facebook.com/groups/AndroidAPSUsers) or [Discord](https://discord.gg/4fQUWHZ4Mw). \ No newline at end of file diff --git a/docs/CROWDIN/nl/Maintenance/UpdateToNewVersion.md b/docs/CROWDIN/nl/Maintenance/UpdateToNewVersion.md index 117e1787b4e0..f24dd26d837c 100644 --- a/docs/CROWDIN/nl/Maintenance/UpdateToNewVersion.md +++ b/docs/CROWDIN/nl/Maintenance/UpdateToNewVersion.md @@ -10,91 +10,14 @@ * When a new release is available, in the **AAPS** app itself, you will receive an information banner about the new version. * The new version will also be announced on Facebook at the time of release. * Following the release, please read the [Release Notes](ReleaseNotes.md) in detail, and clarify any queries with the community on Facebook or Discord, before proceeding with the update. - - ```{note} - 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 +## Update AAPS with browser build -```{contents} Steps for updating to a new version of AAPS :depth: 1 :local: true +If you already built your AAPS app with the Browser Build method, follow [these instructions](./UpdateBrowserBuild.md). -
In case you experience problems, see separate page for [troubleshooting Android Studio](../GettingHelp/TroubleshootingAndroidStudio). - - ### Export your settings - - Export your settings from the existing **AAPS** version on your phone. You might not need it, but better be safe than sorry. - - See the [Export & import settings](ExportImportSettings.md) page if you don't remember how to do this. - - ### Check your Android Studio version - - The minimal version required is described in the [Building Instructions](#Building-APK-recommended-specification-of-computer-for-building-apk-file). If your version is older, please [update Android Studio first](#Building-APK-install-android-studio)! - - (Update-to-new-version-update-your-local-copy)= - ### Update your local copy - - ```{admonition} WARNING - :class: warning - If you update from versions prior to 2.8.x, please follow the instructions to do a [New clone](../SettingUpAaps/BuildingAaps.md), as this guide will not work for you! - +## Update AAPS with a computer -* Open your existing AAPS project with Android Studio. You might need to select your project. (Double) click on the AAPS project. - - ![Android Studio - Select Project](../images/update/01_ProjectSelection.png) - -* In the menu bar of Android Studio, select Git -> Fetch - - ![Android Studio Menu - Git - Fetch](../images/update/02_GitFetch.png) - -* You will see a message in the lower right corner that Fetch was successful. - - ![Android Studio Menu - Git - Fetch successful](../images/update/03_GitFetchSuccessful.png) - -* In the menu bar, now select Git -> Pull - - ![Android Studio Menu - Git - Pull](../images/update/04_GitPull.png) - -* Leave all options as they are (origin/master) and select Pull - - ![Android Studio - Git - Pull dialog](../images/update/05_GitPullOptions.png) - -* Wait while download is in progress, you will see this as info in the bottom bar. When it's done, you will see a success message. - - ```{note} - The files that were updated may vary! This is not an indication - ``` - - ![Android Studio - Pull successful](../images/update/06_GitPullSuccess.png) - -* Gradle Sync will be running to download some dependencies. Wait until it is finished. - - ![Android Studio - Gradle Sync](../images/studioSetup/40_BackgroundTasks.png) - -### Check JVM version - -This check is particularly indicated if you have already built a previous version of **AAPS** on the same computer. - -Check in the [Building Instructions](#Building-APK-recommended-specification-of-computer-for-building-apk-file) the required version for JVM, matching the **AAPS** version you are now building. Then follow the steps described at [Incompatible Gradle JVM](#incompatible-gradle-jvm) to make sure you currently use the correct version. - -(Update-to-new-version-build-the-signed-apk)= - -### Build the Signed APK - -Your sourcecode is now the current released version, and all prerequisites have been checked. It's time to build the signed apk as described in the [build signed apk section](#Building-APK-generate-signed-apk). - -(Update-to-new-version-transfer-and-install)= - -### Transfer and install the apk - -You need to transfer the apk to your phone so you can install it. - -```{note} -If you completed the build with the same existing key store in Android Studio, then you do not need to remove the existing app on your phone. When you install the apk, follow the prompts to install updates. -For other scenarios such as establishing a new key store in Android Studio for your signed apk, you will need to delete the old app before installing the apk. **Make sure to export your settings!** -``` - -See the instructions for [transferring and installing AAPS](../SettingUpAaps/TransferringAndInstallingAaps.md) +Follow [these instructions.](./UpdateComputerBuild.md). (Update-to-new-version-check-aaps-version-on-phone)= @@ -104,14 +27,4 @@ After you installed the new apk, you can check the AAPS version on your phone by ![AAPS version installed](../images/Update_VersionCheck.png) -Check in the [Release Notes](../Maintenance/ReleaseNotes.md) if there are any specific instructions after update. - -## Troubleshooting - -If anything goes wrong, don't panic. - -Take a breath! - -Then see the separate page [troubleshooting Android Studio](../GettingHelp/TroubleshootingAndroidStudio) if your problem is already documented! - -If you need further help, please reach out to other **AAPS** users on [Facebook](https://www.facebook.com/groups/AndroidAPSUsers) or [Discord](https://discord.gg/4fQUWHZ4Mw). \ No newline at end of file +Check in the [Release Notes](../Maintenance/ReleaseNotes.md) if there are any specific instructions after update. \ No newline at end of file diff --git a/docs/CROWDIN/nl/SettingUpAaps/BrowserBuild.md b/docs/CROWDIN/nl/SettingUpAaps/BrowserBuild.md index 190b14ceecbd..166f988a31f7 100644 --- a/docs/CROWDIN/nl/SettingUpAaps/BrowserBuild.md +++ b/docs/CROWDIN/nl/SettingUpAaps/BrowserBuild.md @@ -1,3 +1,5 @@ +(browser-build)= + # Browser build Building AAPS with GitHub Actions. diff --git a/docs/CROWDIN/nl/images/Building-the-App/CI/aaps_ci_simple_http_server.png b/docs/CROWDIN/nl/images/Building-the-App/CI/aaps_ci_simple_http_server.png index 95ac2d4eb443..2e2fb47e5ca2 100644 Binary files a/docs/CROWDIN/nl/images/Building-the-App/CI/aaps_ci_simple_http_server.png and b/docs/CROWDIN/nl/images/Building-the-App/CI/aaps_ci_simple_http_server.png differ diff --git a/docs/CROWDIN/nl/images/Building-the-App/CI/aaps_ci_simple_http_server_step1.png b/docs/CROWDIN/nl/images/Building-the-App/CI/aaps_ci_simple_http_server_step1.png index 78f52682b58d..b348162dcb1c 100644 Binary files a/docs/CROWDIN/nl/images/Building-the-App/CI/aaps_ci_simple_http_server_step1.png and b/docs/CROWDIN/nl/images/Building-the-App/CI/aaps_ci_simple_http_server_step1.png differ diff --git a/docs/CROWDIN/nl/images/Building-the-App/CI/aaps_ci_simple_http_server_step2.png b/docs/CROWDIN/nl/images/Building-the-App/CI/aaps_ci_simple_http_server_step2.png index c292ac667f63..cabadeefb97a 100644 Binary files a/docs/CROWDIN/nl/images/Building-the-App/CI/aaps_ci_simple_http_server_step2.png and b/docs/CROWDIN/nl/images/Building-the-App/CI/aaps_ci_simple_http_server_step2.png differ diff --git a/docs/CROWDIN/nl/images/Building-the-App/CI/aaps_ci_simple_http_server_step3.png b/docs/CROWDIN/nl/images/Building-the-App/CI/aaps_ci_simple_http_server_step3.png index bd31cd0ffb3d..9a26d3526369 100644 Binary files a/docs/CROWDIN/nl/images/Building-the-App/CI/aaps_ci_simple_http_server_step3.png and b/docs/CROWDIN/nl/images/Building-the-App/CI/aaps_ci_simple_http_server_step3.png differ diff --git a/docs/CROWDIN/nl/images/Building-the-App/CI/aaps_ci_simple_http_server_step4.png b/docs/CROWDIN/nl/images/Building-the-App/CI/aaps_ci_simple_http_server_step4.png index cc187ec72a14..285492424351 100644 Binary files a/docs/CROWDIN/nl/images/Building-the-App/CI/aaps_ci_simple_http_server_step4.png and b/docs/CROWDIN/nl/images/Building-the-App/CI/aaps_ci_simple_http_server_step4.png differ diff --git a/docs/CROWDIN/nl/images/Building-the-App/CI/aaps_ci_simple_http_server_store.png b/docs/CROWDIN/nl/images/Building-the-App/CI/aaps_ci_simple_http_server_store.png index 4b157ca8d3d8..65bf101f55e4 100644 Binary files a/docs/CROWDIN/nl/images/Building-the-App/CI/aaps_ci_simple_http_server_store.png and b/docs/CROWDIN/nl/images/Building-the-App/CI/aaps_ci_simple_http_server_store.png differ diff --git a/docs/CROWDIN/nl/images/update/CI/GitHubActions1.png b/docs/CROWDIN/nl/images/update/CI/GitHubActions1.png new file mode 100644 index 000000000000..e04ce6e76d8b Binary files /dev/null and b/docs/CROWDIN/nl/images/update/CI/GitHubActions1.png differ diff --git a/docs/CROWDIN/nl/images/update/CI/GitHubActions2.png b/docs/CROWDIN/nl/images/update/CI/GitHubActions2.png new file mode 100644 index 000000000000..7b5c5a842d16 Binary files /dev/null and b/docs/CROWDIN/nl/images/update/CI/GitHubActions2.png differ diff --git a/docs/CROWDIN/nl/images/update/CI/GitHubActions3.png b/docs/CROWDIN/nl/images/update/CI/GitHubActions3.png new file mode 100644 index 000000000000..cff0ed34b214 Binary files /dev/null and b/docs/CROWDIN/nl/images/update/CI/GitHubActions3.png differ diff --git a/docs/CROWDIN/nl/images/update/CI/GitHubActions4.png b/docs/CROWDIN/nl/images/update/CI/GitHubActions4.png new file mode 100644 index 000000000000..bede3c2dfe08 Binary files /dev/null and b/docs/CROWDIN/nl/images/update/CI/GitHubActions4.png differ diff --git a/docs/CROWDIN/nl/images/update/CI/GitHubActions5.png b/docs/CROWDIN/nl/images/update/CI/GitHubActions5.png new file mode 100644 index 000000000000..d96e31cf084d Binary files /dev/null and b/docs/CROWDIN/nl/images/update/CI/GitHubActions5.png differ diff --git a/docs/CROWDIN/nl/images/update/CI/GitHubUpdate1.png b/docs/CROWDIN/nl/images/update/CI/GitHubUpdate1.png new file mode 100644 index 000000000000..3058dc270d28 Binary files /dev/null and b/docs/CROWDIN/nl/images/update/CI/GitHubUpdate1.png differ diff --git a/docs/CROWDIN/nl/images/update/CI/GitHubUpdate2.png b/docs/CROWDIN/nl/images/update/CI/GitHubUpdate2.png new file mode 100644 index 000000000000..1ae9568c8107 Binary files /dev/null and b/docs/CROWDIN/nl/images/update/CI/GitHubUpdate2.png differ diff --git a/docs/CROWDIN/nl/images/update/CI/GitHubUpdate3.png b/docs/CROWDIN/nl/images/update/CI/GitHubUpdate3.png new file mode 100644 index 000000000000..d18f9119c76d Binary files /dev/null and b/docs/CROWDIN/nl/images/update/CI/GitHubUpdate3.png differ diff --git a/docs/CROWDIN/nl/images/update/CI/GitHubUpdate4.png b/docs/CROWDIN/nl/images/update/CI/GitHubUpdate4.png new file mode 100644 index 000000000000..8c38c071cb8f Binary files /dev/null and b/docs/CROWDIN/nl/images/update/CI/GitHubUpdate4.png differ diff --git a/docs/CROWDIN/nl/images/update/CI/GitHubUpdate5.png b/docs/CROWDIN/nl/images/update/CI/GitHubUpdate5.png new file mode 100644 index 000000000000..409aef1f34dc Binary files /dev/null and b/docs/CROWDIN/nl/images/update/CI/GitHubUpdate5.png differ diff --git a/docs/CROWDIN/nl/index.md b/docs/CROWDIN/nl/index.md index 24ccba344ab8..0e796af4f949 100644 --- a/docs/CROWDIN/nl/index.md +++ b/docs/CROWDIN/nl/index.md @@ -2,10 +2,10 @@ ![image](./images/basic-outline-of-AAPS.png) -```{admonition} Version 3.3 +```{admonition} Latest Release :class: note -29/12/2024 : Version 3.3 is out. Check the [Release Notes](#version3300) to see what's new and get update instructions. +14/08/2025 : Version 3.3.2.1 is out. Check the [Release Notes](#latestrelease) to see what's new and get update instructions. ``` @@ -21,7 +21,7 @@ Section **2) Getting Started**, the [Introduction](Getting-Started/Introduction. Now that you have a solid understanding of the process, you can start assembling your **AAPS** loop. -Section **3) Setting up AAPS** contains step-by-step instructions to do this. It covers choosing and [setting up your reporting server](./SettingUpAaps/SettingUpTheReportingServer.md) (Nightscout or Tidepool) so you can review and share your data, getting your computer ready for building the AAPS app, building the AAPS app and transferring the AAPS app to your phone. It also covers setting up the **AAPS** app using the setup Wizard, linking it with your CGM app, and either a real or virtual insulin pump, as well as linking **AAPS** to your reporting server. You are then slowly introduced to the full usage of what **AAPS** has to offer via a safe and carefully calibrated step-by-step process designed to make sure that you/your child are thoroughly familiar and comfortable navigating all the different levels and menu configurations before graduating on the next phase, commonly referred to as the next "Objective", until you are have enough experience to begin using the more advanced options available within the app. These Objectives are specially designed in such a way that will gradually unlock more possibilities of **AAPS** and switch from Open Loop to Closed Loop. +Section **3) Setting up AAPS** contains step-by-step instructions to do this. It covers choosing and [setting up your reporting server](./SettingUpAaps/SettingUpTheReportingServer.md) (Nightscout or Tidepool) so you can review and share your data, getting ready for building the AAPS app, building the AAPS app and transferring the AAPS app to your phone. It also covers setting up the **AAPS** app using the setup Wizard, linking it with your CGM app, and either a real or virtual insulin pump, as well as linking **AAPS** to your reporting server. You are then slowly introduced to the full usage of what **AAPS** has to offer via a safe and carefully calibrated step-by-step process designed to make sure that you/your child are thoroughly familiar and comfortable navigating all the different levels and menu configurations before graduating on the next phase, commonly referred to as the next "Objective", until you are have enough experience to begin using the more advanced options available within the app. These Objectives are specially designed in such a way that will gradually unlock more possibilities of **AAPS** and switch from Open Loop to Closed Loop. Section **4) Daily life with AAPS** covers key **AAPS** features, to help you use (and customise) **AAPS**. This including understanding the screens, carbs-on-board, sensitivity, profile switching, temp targets, extended carbs (or eCarbs), automations, and DynamicISF. It also covers frequent topics like how to manage different types of meals, how to deal with cannula and sensor changes, smartphone updates, daylight saving changes, and [travelling with AAPS](DailyLifeWithAaps/TimezoneTraveling-DaylightSavingTime.md) and sports. Common questions and answers are located within the troubleshooting section. diff --git a/docs/CROWDIN/pb/Maintenance/DocumentationUpdate.md b/docs/CROWDIN/pb/Maintenance/DocumentationUpdate.md index d816743d3bf1..b4c8611a823e 100644 --- a/docs/CROWDIN/pb/Maintenance/DocumentationUpdate.md +++ b/docs/CROWDIN/pb/Maintenance/DocumentationUpdate.md @@ -4,7 +4,7 @@ - Updated versions and Android Studio prerequisites - Added [3.3.2.1](#version3321) release, removed Android 16 references (fixed) -- Added [Browser Build](browser-build) @Angus +- Added [Browser Build](#browser-build) @Angus ## May 2025 diff --git a/docs/CROWDIN/pb/Maintenance/ReleaseNotes.md b/docs/CROWDIN/pb/Maintenance/ReleaseNotes.md index 7ba23eaa25d7..78534579cc99 100644 --- a/docs/CROWDIN/pb/Maintenance/ReleaseNotes.md +++ b/docs/CROWDIN/pb/Maintenance/ReleaseNotes.md @@ -55,6 +55,8 @@ In order to allow users with older Android to use older version of AAPS new vers WearOS 5, API level 34 (Android 14) has [limitations](#BuildingAapsWearOs-WearOS5). ``` +(latestrelease)= + (version3321)= ## Version 3.3.2.1 diff --git a/docs/CROWDIN/pb/Maintenance/UpdateBrowserBuild.md b/docs/CROWDIN/pb/Maintenance/UpdateBrowserBuild.md new file mode 100644 index 000000000000..6bfef1fe4e10 --- /dev/null +++ b/docs/CROWDIN/pb/Maintenance/UpdateBrowserBuild.md @@ -0,0 +1,101 @@ +# Update with a browser + +## Build yourself instead of download + +**AAPS** is not available to download, due to regulations concerning medical devices. It is legal to build the app for your own use, but you must not give a copy to others! See [FAQ page](../UsefulLinks/FAQ.md) for details. + +```{note} +In case you want to upgrade **AAPS** with a browser for the first time : copy your back-up keystore file to your Google Drive. Then follow the [Browser Build **AAPS** procedure](../SettingUpAaps/BrowserBuild.md) instead of this guide. Instead of creating a new keystore, you must select the one you have copied from your computer. +This operation will be mandatory only the first time, then for successive upgrades you will be able to follow this guide. +``` + +## Overview for updating to a new version of AAPS with a browser + +```{contents} Steps for updating to a new version of AAPS +:depth: 1 +:local: true +``` + +In case you experience problems, see separate page for [troubleshooting Android Studio](../GettingHelp/TroubleshootingAndroidStudio). + +### Export your settings + +Export your settings from the existing **AAPS** version on your phone. You might not need it, but better be safe than sorry. + +See the [Export & import settings](ExportImportSettings.md) page if you don't remember how to do this. + +(Update-to-new-version-update-your-repo)= +### Update your GitHub repository + +```{admonition} WARNING +:class: warning +Browser Build is available from AAPS version 3.3.2.1. +``` + +[Log into GitHub](https://github.com/login). + +1. Select Repositories. +2. Scroll down and select your own AndroidAPS repository. + +![Select AndroidAPS repo](../images/update/CI/GitHubUpdate1.png) + +3. Verify you are using your own copy of AndroidAPS (Forked from nightscout/AndroidAPS) +4. Tap Sync Fork to update it (the number of commits behind might differ from the picture) + + + +![Sync AndroidAPS repo](../images/update/CI/GitHubUpdate2.png) + +5. Tap Update Branch + +![Update AndroidAPS repo](../images/update/CI/GitHubUpdate3.png) + +Note: if you have modified your copy of AndroidAPS by mistake, you will see this screen. Discard all changes (commits) to return to the released version. + +![Discard rogue modifications](../images/update/CI/GitHubUpdate4.png) + +You have now synchronized (updated) your own copy with the latest release of Android APS. Good job. + +![Repo sync'ed](../images/update/CI/GitHubUpdate5.png) + +### Run the Workflow to Build the Signed APK + +1. In your GitHub copy of AndroidAPS, select Actions. +2. Expand All Workflows. +3. Select AAPS-CI + +![Actions AAPS-CI](../images/update/CI/GitHubActions1.png) + +4. Scroll down and tap Run Workflow. + +![Run Workflow](../images/update/CI/GitHubActions2.png) + +5. Select the branch you want to deploy (master), the [variant](variant) (fullRelease) and tap Run Workflow. + + + +![Run Workflow](../images/update/CI/GitHubActions3.png) + +6. You will see the message Workflow run was successfully requested. Refresh your browser page and you will be able to monitor the build progress. When the action completes, the AAPS CI action will show a green tick mark. You have successfully built the updated version of Android APS. + +![Monitor Workflow](../images/update/CI/GitHubActions4.png) + +### Install the AAPS APK + +1. Open your Google Drive +2. Browse into AAPS, select the new version folder and you will find both the phone and Android Wear versions. + +![Google Drive Location](../images/update/CI/GitHubActions5.png) + + +Continue [here](#Update-to-new-version-check-aaps-version-on-phone) + +## Troubleshooting + +If anything goes wrong, don't panic. + +Take a breath! + +Then see the [troubleshooting tips](#aaps-ci-preparation) if your problem is already documented! + +If you need further help, please reach out to other **AAPS** users on [Facebook](https://www.facebook.com/groups/AndroidAPSUsers) or [Discord](https://discord.gg/4fQUWHZ4Mw). \ No newline at end of file diff --git a/docs/CROWDIN/pb/Maintenance/UpdateComputerBuild.md b/docs/CROWDIN/pb/Maintenance/UpdateComputerBuild.md new file mode 100644 index 000000000000..6a55381526f5 --- /dev/null +++ b/docs/CROWDIN/pb/Maintenance/UpdateComputerBuild.md @@ -0,0 +1,103 @@ +# Update with a computer + +## Build yourself instead of download + +**AAPS** is not available to download, due to regulations concerning medical devices. It is legal to build the app for your own use, but you must not give a copy to others! See [FAQ page](../UsefulLinks/FAQ.md) for details. + +```{note} +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 + +```{contents} Steps for updating to a new version of AAPS +:depth: 1 +:local: true +``` + +In case you experience problems, see separate page for [troubleshooting Android Studio](../GettingHelp/TroubleshootingAndroidStudio). + +### Export your settings + +Export your settings from the existing **AAPS** version on your phone. You might not need it, but better be safe than sorry. + +See the [Export & import settings](ExportImportSettings.md) page if you don't remember how to do this. + +### Check your Android Studio version + +The minimal version required is described in the [Building Instructions](#Building-APK-recommended-specification-of-computer-for-building-apk-file). If your version is older, please [update Android Studio first](#Building-APK-install-android-studio)! + +(Update-to-new-version-update-your-local-copy)= +### Update your local copy + +```{admonition} WARNING +:class: warning +If you update from versions prior to 2.8.x, please follow the instructions to do a [New clone](../SettingUpAaps/BuildingAaps.md), as this guide will not work for you! +``` + +* Open your existing AAPS project with Android Studio. You might need to select your project. (Double) click on the AAPS project. + + ![Android Studio - Select Project](../images/update/01_ProjectSelection.png) + +* In the menu bar of Android Studio, select Git -> Fetch + + ![Android Studio Menu - Git - Fetch](../images/update/02_GitFetch.png) + +* You will see a message in the lower right corner that Fetch was successful. + + ![Android Studio Menu - Git - Fetch successful](../images/update/03_GitFetchSuccessful.png) + +* In the menu bar, now select Git -> Pull + + ![Android Studio Menu - Git - Pull](../images/update/04_GitPull.png) + +* Leave all options as they are (origin/master) and select Pull + + ![Android Studio - Git - Pull dialog](../images/update/05_GitPullOptions.png) + +* Wait while download is in progress, you will see this as info in the bottom bar. When it's done, you will see a success message. + + ```{note} + The files that were updated may vary! This is not an indication + ``` + + ![Android Studio - Pull successful](../images/update/06_GitPullSuccess.png) + +* Gradle Sync will be running to download some dependencies. Wait until it is finished. + + ![Android Studio - Gradle Sync](../images/studioSetup/40_BackgroundTasks.png) + +### Check JVM version + +This check is particularly indicated if you have already built a previous version of **AAPS** on the same computer. + +Check in the [Building Instructions](#Building-APK-recommended-specification-of-computer-for-building-apk-file) the required version for JVM, matching the **AAPS** version you are now building. Then follow the steps described at [Incompatible Gradle JVM](#incompatible-gradle-jvm) to make sure you currently use the correct version. + +(Update-to-new-version-build-the-signed-apk)= +### Build the Signed APK + +Your sourcecode is now the current released version, and all prerequisites have been checked. It's time to build the signed apk as described in the [build signed apk section](#Building-APK-generate-signed-apk). + +(Update-to-new-version-transfer-and-install)= + +### Transfer and install the apk +You need to transfer the apk to your phone so you can install it. + +```{note} +If you completed the build with the same existing key store in Android Studio, then you do not need to remove the existing app on your phone. When you install the apk, follow the prompts to install updates. +For other scenarios such as establishing a new key store in Android Studio for your signed apk, you will need to delete the old app before installing the apk. **Make sure to export your settings!** +``` + +See the instructions for [transferring and installing AAPS](../SettingUpAaps/TransferringAndInstallingAaps.md) + +Continue [here](#Update-to-new-version-check-aaps-version-on-phone). + +## Troubleshooting + +If anything goes wrong, don't panic. + +Take a breath! + +Then see the separate page [troubleshooting Android Studio](../GettingHelp/TroubleshootingAndroidStudio) if your problem is already documented! + +If you need further help, please reach out to other **AAPS** users on [Facebook](https://www.facebook.com/groups/AndroidAPSUsers) or [Discord](https://discord.gg/4fQUWHZ4Mw). \ No newline at end of file diff --git a/docs/CROWDIN/pb/Maintenance/UpdateToNewVersion.md b/docs/CROWDIN/pb/Maintenance/UpdateToNewVersion.md index d7eac798f670..e31ab758029f 100644 --- a/docs/CROWDIN/pb/Maintenance/UpdateToNewVersion.md +++ b/docs/CROWDIN/pb/Maintenance/UpdateToNewVersion.md @@ -10,91 +10,14 @@ * When a new release is available, in the **AAPS** app itself, you will receive an information banner about the new version. * The new version will also be announced on Facebook at the time of release. * Following the release, please read the [Release Notes](ReleaseNotes.md) in detail, and clarify any queries with the community on Facebook or Discord, before proceeding with the update. - - ```{note} - 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 +## Update AAPS with browser build -```{contents} Steps for updating to a new version of AAPS :depth: 1 :local: true +If you already built your AAPS app with the Browser Build method, follow [these instructions](./UpdateBrowserBuild.md). -
In case you experience problems, see separate page for [troubleshooting Android Studio](../GettingHelp/TroubleshootingAndroidStudio). - - ### Export your settings - - Export your settings from the existing **AAPS** version on your phone. You might not need it, but better be safe than sorry. - - See the [Export & import settings](ExportImportSettings.md) page if you don't remember how to do this. - - ### Check your Android Studio version - - The minimal version required is described in the [Building Instructions](#Building-APK-recommended-specification-of-computer-for-building-apk-file). If your version is older, please [update Android Studio first](#Building-APK-install-android-studio)! - - (Update-to-new-version-update-your-local-copy)= - ### Update your local copy - - ```{admonition} WARNING - :class: warning - If you update from versions prior to 2.8.x, please follow the instructions to do a [New clone](../SettingUpAaps/BuildingAaps.md), as this guide will not work for you! - +## Update AAPS with a computer -* Open your existing AAPS project with Android Studio. You might need to select your project. (Double) click on the AAPS project. - - ![Android Studio - Select Project](../images/update/01_ProjectSelection.png) - -* In the menu bar of Android Studio, select Git -> Fetch - - ![Android Studio Menu - Git - Fetch](../images/update/02_GitFetch.png) - -* You will see a message in the lower right corner that Fetch was successful. - - ![Android Studio Menu - Git - Fetch successful](../images/update/03_GitFetchSuccessful.png) - -* In the menu bar, now select Git -> Pull - - ![Android Studio Menu - Git - Pull](../images/update/04_GitPull.png) - -* Leave all options as they are (origin/master) and select Pull - - ![Android Studio - Git - Pull dialog](../images/update/05_GitPullOptions.png) - -* Wait while download is in progress, you will see this as info in the bottom bar. When it's done, you will see a success message. - - ```{note} - The files that were updated may vary! This is not an indication - ``` - - ![Android Studio - Pull successful](../images/update/06_GitPullSuccess.png) - -* Gradle Sync will be running to download some dependencies. Wait until it is finished. - - ![Android Studio - Gradle Sync](../images/studioSetup/40_BackgroundTasks.png) - -### Check JVM version - -This check is particularly indicated if you have already built a previous version of **AAPS** on the same computer. - -Check in the [Building Instructions](#Building-APK-recommended-specification-of-computer-for-building-apk-file) the required version for JVM, matching the **AAPS** version you are now building. Then follow the steps described at [Incompatible Gradle JVM](#incompatible-gradle-jvm) to make sure you currently use the correct version. - -(Update-to-new-version-build-the-signed-apk)= - -### Build the Signed APK - -Your sourcecode is now the current released version, and all prerequisites have been checked. It's time to build the signed apk as described in the [build signed apk section](#Building-APK-generate-signed-apk). - -(Update-to-new-version-transfer-and-install)= - -### Transfer and install the apk - -You need to transfer the apk to your phone so you can install it. - -```{note} -If you completed the build with the same existing key store in Android Studio, then you do not need to remove the existing app on your phone. When you install the apk, follow the prompts to install updates. -For other scenarios such as establishing a new key store in Android Studio for your signed apk, you will need to delete the old app before installing the apk. **Make sure to export your settings!** -``` - -See the instructions for [transferring and installing AAPS](../SettingUpAaps/TransferringAndInstallingAaps.md) +Follow [these instructions.](./UpdateComputerBuild.md). (Update-to-new-version-check-aaps-version-on-phone)= @@ -104,14 +27,4 @@ After you installed the new apk, you can check the AAPS version on your phone by ![AAPS version installed](../images/Update_VersionCheck.png) -Check in the [Release Notes](../Maintenance/ReleaseNotes.md) if there are any specific instructions after update. - -## Troubleshooting - -If anything goes wrong, don't panic. - -Take a breath! - -Then see the separate page [troubleshooting Android Studio](../GettingHelp/TroubleshootingAndroidStudio) if your problem is already documented! - -If you need further help, please reach out to other **AAPS** users on [Facebook](https://www.facebook.com/groups/AndroidAPSUsers) or [Discord](https://discord.gg/4fQUWHZ4Mw). \ No newline at end of file +Check in the [Release Notes](../Maintenance/ReleaseNotes.md) if there are any specific instructions after update. \ No newline at end of file diff --git a/docs/CROWDIN/pb/SettingUpAaps/BrowserBuild.md b/docs/CROWDIN/pb/SettingUpAaps/BrowserBuild.md index a3ad592f33dc..cef7e7098fd8 100644 --- a/docs/CROWDIN/pb/SettingUpAaps/BrowserBuild.md +++ b/docs/CROWDIN/pb/SettingUpAaps/BrowserBuild.md @@ -1,3 +1,5 @@ +(browser-build)= + # Browser build Building AAPS with GitHub Actions. diff --git a/docs/CROWDIN/pb/images/Building-the-App/CI/aaps_ci_simple_http_server.png b/docs/CROWDIN/pb/images/Building-the-App/CI/aaps_ci_simple_http_server.png index 95ac2d4eb443..2e2fb47e5ca2 100644 Binary files a/docs/CROWDIN/pb/images/Building-the-App/CI/aaps_ci_simple_http_server.png and b/docs/CROWDIN/pb/images/Building-the-App/CI/aaps_ci_simple_http_server.png differ diff --git a/docs/CROWDIN/pb/images/Building-the-App/CI/aaps_ci_simple_http_server_step1.png b/docs/CROWDIN/pb/images/Building-the-App/CI/aaps_ci_simple_http_server_step1.png index 78f52682b58d..b348162dcb1c 100644 Binary files a/docs/CROWDIN/pb/images/Building-the-App/CI/aaps_ci_simple_http_server_step1.png and b/docs/CROWDIN/pb/images/Building-the-App/CI/aaps_ci_simple_http_server_step1.png differ diff --git a/docs/CROWDIN/pb/images/Building-the-App/CI/aaps_ci_simple_http_server_step2.png b/docs/CROWDIN/pb/images/Building-the-App/CI/aaps_ci_simple_http_server_step2.png index c292ac667f63..cabadeefb97a 100644 Binary files a/docs/CROWDIN/pb/images/Building-the-App/CI/aaps_ci_simple_http_server_step2.png and b/docs/CROWDIN/pb/images/Building-the-App/CI/aaps_ci_simple_http_server_step2.png differ diff --git a/docs/CROWDIN/pb/images/Building-the-App/CI/aaps_ci_simple_http_server_step3.png b/docs/CROWDIN/pb/images/Building-the-App/CI/aaps_ci_simple_http_server_step3.png index bd31cd0ffb3d..9a26d3526369 100644 Binary files a/docs/CROWDIN/pb/images/Building-the-App/CI/aaps_ci_simple_http_server_step3.png and b/docs/CROWDIN/pb/images/Building-the-App/CI/aaps_ci_simple_http_server_step3.png differ diff --git a/docs/CROWDIN/pb/images/Building-the-App/CI/aaps_ci_simple_http_server_step4.png b/docs/CROWDIN/pb/images/Building-the-App/CI/aaps_ci_simple_http_server_step4.png index cc187ec72a14..285492424351 100644 Binary files a/docs/CROWDIN/pb/images/Building-the-App/CI/aaps_ci_simple_http_server_step4.png and b/docs/CROWDIN/pb/images/Building-the-App/CI/aaps_ci_simple_http_server_step4.png differ diff --git a/docs/CROWDIN/pb/images/Building-the-App/CI/aaps_ci_simple_http_server_store.png b/docs/CROWDIN/pb/images/Building-the-App/CI/aaps_ci_simple_http_server_store.png index 4b157ca8d3d8..65bf101f55e4 100644 Binary files a/docs/CROWDIN/pb/images/Building-the-App/CI/aaps_ci_simple_http_server_store.png and b/docs/CROWDIN/pb/images/Building-the-App/CI/aaps_ci_simple_http_server_store.png differ diff --git a/docs/CROWDIN/pb/images/update/CI/GitHubActions1.png b/docs/CROWDIN/pb/images/update/CI/GitHubActions1.png new file mode 100644 index 000000000000..e04ce6e76d8b Binary files /dev/null and b/docs/CROWDIN/pb/images/update/CI/GitHubActions1.png differ diff --git a/docs/CROWDIN/pb/images/update/CI/GitHubActions2.png b/docs/CROWDIN/pb/images/update/CI/GitHubActions2.png new file mode 100644 index 000000000000..7b5c5a842d16 Binary files /dev/null and b/docs/CROWDIN/pb/images/update/CI/GitHubActions2.png differ diff --git a/docs/CROWDIN/pb/images/update/CI/GitHubActions3.png b/docs/CROWDIN/pb/images/update/CI/GitHubActions3.png new file mode 100644 index 000000000000..cff0ed34b214 Binary files /dev/null and b/docs/CROWDIN/pb/images/update/CI/GitHubActions3.png differ diff --git a/docs/CROWDIN/pb/images/update/CI/GitHubActions4.png b/docs/CROWDIN/pb/images/update/CI/GitHubActions4.png new file mode 100644 index 000000000000..bede3c2dfe08 Binary files /dev/null and b/docs/CROWDIN/pb/images/update/CI/GitHubActions4.png differ diff --git a/docs/CROWDIN/pb/images/update/CI/GitHubActions5.png b/docs/CROWDIN/pb/images/update/CI/GitHubActions5.png new file mode 100644 index 000000000000..d96e31cf084d Binary files /dev/null and b/docs/CROWDIN/pb/images/update/CI/GitHubActions5.png differ diff --git a/docs/CROWDIN/pb/images/update/CI/GitHubUpdate1.png b/docs/CROWDIN/pb/images/update/CI/GitHubUpdate1.png new file mode 100644 index 000000000000..3058dc270d28 Binary files /dev/null and b/docs/CROWDIN/pb/images/update/CI/GitHubUpdate1.png differ diff --git a/docs/CROWDIN/pb/images/update/CI/GitHubUpdate2.png b/docs/CROWDIN/pb/images/update/CI/GitHubUpdate2.png new file mode 100644 index 000000000000..1ae9568c8107 Binary files /dev/null and b/docs/CROWDIN/pb/images/update/CI/GitHubUpdate2.png differ diff --git a/docs/CROWDIN/pb/images/update/CI/GitHubUpdate3.png b/docs/CROWDIN/pb/images/update/CI/GitHubUpdate3.png new file mode 100644 index 000000000000..d18f9119c76d Binary files /dev/null and b/docs/CROWDIN/pb/images/update/CI/GitHubUpdate3.png differ diff --git a/docs/CROWDIN/pb/images/update/CI/GitHubUpdate4.png b/docs/CROWDIN/pb/images/update/CI/GitHubUpdate4.png new file mode 100644 index 000000000000..8c38c071cb8f Binary files /dev/null and b/docs/CROWDIN/pb/images/update/CI/GitHubUpdate4.png differ diff --git a/docs/CROWDIN/pb/images/update/CI/GitHubUpdate5.png b/docs/CROWDIN/pb/images/update/CI/GitHubUpdate5.png new file mode 100644 index 000000000000..409aef1f34dc Binary files /dev/null and b/docs/CROWDIN/pb/images/update/CI/GitHubUpdate5.png differ diff --git a/docs/CROWDIN/pb/index.md b/docs/CROWDIN/pb/index.md index d22fe12f061e..076e981a23b9 100644 --- a/docs/CROWDIN/pb/index.md +++ b/docs/CROWDIN/pb/index.md @@ -2,10 +2,10 @@ ![image](./images/basic-outline-of-AAPS.png) -```{admonition} Version 3.3 +```{admonition} Latest Release :class: note -29/12/2024 : Version 3.3 is out. Check the [Release Notes](#version3300) to see what's new and get update instructions. +14/08/2025 : Version 3.3.2.1 is out. Check the [Release Notes](#latestrelease) to see what's new and get update instructions. ``` @@ -21,7 +21,7 @@ Section **2) Getting Started**, the [Introduction](Getting-Started/Introduction. Now that you have a solid understanding of the process, you can start assembling your **AAPS** loop. -Section **3) Setting up AAPS** contains step-by-step instructions to do this. It covers choosing and [setting up your reporting server](./SettingUpAaps/SettingUpTheReportingServer.md) (Nightscout or Tidepool) so you can review and share your data, getting your computer ready for building the AAPS app, building the AAPS app and transferring the AAPS app to your phone. It also covers setting up the **AAPS** app using the setup Wizard, linking it with your CGM app, and either a real or virtual insulin pump, as well as linking **AAPS** to your reporting server. You are then slowly introduced to the full usage of what **AAPS** has to offer via a safe and carefully calibrated step-by-step process designed to make sure that you/your child are thoroughly familiar and comfortable navigating all the different levels and menu configurations before graduating on the next phase, commonly referred to as the next "Objective", until you are have enough experience to begin using the more advanced options available within the app. These Objectives are specially designed in such a way that will gradually unlock more possibilities of **AAPS** and switch from Open Loop to Closed Loop. +Section **3) Setting up AAPS** contains step-by-step instructions to do this. It covers choosing and [setting up your reporting server](./SettingUpAaps/SettingUpTheReportingServer.md) (Nightscout or Tidepool) so you can review and share your data, getting ready for building the AAPS app, building the AAPS app and transferring the AAPS app to your phone. It also covers setting up the **AAPS** app using the setup Wizard, linking it with your CGM app, and either a real or virtual insulin pump, as well as linking **AAPS** to your reporting server. You are then slowly introduced to the full usage of what **AAPS** has to offer via a safe and carefully calibrated step-by-step process designed to make sure that you/your child are thoroughly familiar and comfortable navigating all the different levels and menu configurations before graduating on the next phase, commonly referred to as the next "Objective", until you are have enough experience to begin using the more advanced options available within the app. These Objectives are specially designed in such a way that will gradually unlock more possibilities of **AAPS** and switch from Open Loop to Closed Loop. Section **4) Daily life with AAPS** covers key **AAPS** features, to help you use (and customise) **AAPS**. This including understanding the screens, carbs-on-board, sensitivity, profile switching, temp targets, extended carbs (or eCarbs), automations, and DynamicISF. It also covers frequent topics like how to manage different types of meals, how to deal with cannula and sensor changes, smartphone updates, daylight saving changes, and [travelling with AAPS](DailyLifeWithAaps/TimezoneTraveling-DaylightSavingTime.md) and sports. Common questions and answers are located within the troubleshooting section. diff --git a/docs/CROWDIN/pl/Maintenance/DocumentationUpdate.md b/docs/CROWDIN/pl/Maintenance/DocumentationUpdate.md index 249094af711c..bd3333a61fb9 100644 --- a/docs/CROWDIN/pl/Maintenance/DocumentationUpdate.md +++ b/docs/CROWDIN/pl/Maintenance/DocumentationUpdate.md @@ -4,7 +4,7 @@ - Updated versions and Android Studio prerequisites - Added [3.3.2.1](#version3321) release, removed Android 16 references (fixed) -- Added [Browser Build](browser-build) @Angus +- Added [Browser Build](#browser-build) @Angus ## May 2025 diff --git a/docs/CROWDIN/pl/Maintenance/ReleaseNotes.md b/docs/CROWDIN/pl/Maintenance/ReleaseNotes.md index 0f0b34f92e9d..bbbdd10fc668 100644 --- a/docs/CROWDIN/pl/Maintenance/ReleaseNotes.md +++ b/docs/CROWDIN/pl/Maintenance/ReleaseNotes.md @@ -55,6 +55,8 @@ In order to allow users with older Android to use older version of AAPS new vers WearOS 5, API level 34 (Android 14) has [limitations](#BuildingAapsWearOs-WearOS5). ``` +(latestrelease)= + (version3321)= ## Version 3.3.2.1 diff --git a/docs/CROWDIN/pl/Maintenance/UpdateBrowserBuild.md b/docs/CROWDIN/pl/Maintenance/UpdateBrowserBuild.md new file mode 100644 index 000000000000..6bfef1fe4e10 --- /dev/null +++ b/docs/CROWDIN/pl/Maintenance/UpdateBrowserBuild.md @@ -0,0 +1,101 @@ +# Update with a browser + +## Build yourself instead of download + +**AAPS** is not available to download, due to regulations concerning medical devices. It is legal to build the app for your own use, but you must not give a copy to others! See [FAQ page](../UsefulLinks/FAQ.md) for details. + +```{note} +In case you want to upgrade **AAPS** with a browser for the first time : copy your back-up keystore file to your Google Drive. Then follow the [Browser Build **AAPS** procedure](../SettingUpAaps/BrowserBuild.md) instead of this guide. Instead of creating a new keystore, you must select the one you have copied from your computer. +This operation will be mandatory only the first time, then for successive upgrades you will be able to follow this guide. +``` + +## Overview for updating to a new version of AAPS with a browser + +```{contents} Steps for updating to a new version of AAPS +:depth: 1 +:local: true +``` + +In case you experience problems, see separate page for [troubleshooting Android Studio](../GettingHelp/TroubleshootingAndroidStudio). + +### Export your settings + +Export your settings from the existing **AAPS** version on your phone. You might not need it, but better be safe than sorry. + +See the [Export & import settings](ExportImportSettings.md) page if you don't remember how to do this. + +(Update-to-new-version-update-your-repo)= +### Update your GitHub repository + +```{admonition} WARNING +:class: warning +Browser Build is available from AAPS version 3.3.2.1. +``` + +[Log into GitHub](https://github.com/login). + +1. Select Repositories. +2. Scroll down and select your own AndroidAPS repository. + +![Select AndroidAPS repo](../images/update/CI/GitHubUpdate1.png) + +3. Verify you are using your own copy of AndroidAPS (Forked from nightscout/AndroidAPS) +4. Tap Sync Fork to update it (the number of commits behind might differ from the picture) + + + +![Sync AndroidAPS repo](../images/update/CI/GitHubUpdate2.png) + +5. Tap Update Branch + +![Update AndroidAPS repo](../images/update/CI/GitHubUpdate3.png) + +Note: if you have modified your copy of AndroidAPS by mistake, you will see this screen. Discard all changes (commits) to return to the released version. + +![Discard rogue modifications](../images/update/CI/GitHubUpdate4.png) + +You have now synchronized (updated) your own copy with the latest release of Android APS. Good job. + +![Repo sync'ed](../images/update/CI/GitHubUpdate5.png) + +### Run the Workflow to Build the Signed APK + +1. In your GitHub copy of AndroidAPS, select Actions. +2. Expand All Workflows. +3. Select AAPS-CI + +![Actions AAPS-CI](../images/update/CI/GitHubActions1.png) + +4. Scroll down and tap Run Workflow. + +![Run Workflow](../images/update/CI/GitHubActions2.png) + +5. Select the branch you want to deploy (master), the [variant](variant) (fullRelease) and tap Run Workflow. + + + +![Run Workflow](../images/update/CI/GitHubActions3.png) + +6. You will see the message Workflow run was successfully requested. Refresh your browser page and you will be able to monitor the build progress. When the action completes, the AAPS CI action will show a green tick mark. You have successfully built the updated version of Android APS. + +![Monitor Workflow](../images/update/CI/GitHubActions4.png) + +### Install the AAPS APK + +1. Open your Google Drive +2. Browse into AAPS, select the new version folder and you will find both the phone and Android Wear versions. + +![Google Drive Location](../images/update/CI/GitHubActions5.png) + + +Continue [here](#Update-to-new-version-check-aaps-version-on-phone) + +## Troubleshooting + +If anything goes wrong, don't panic. + +Take a breath! + +Then see the [troubleshooting tips](#aaps-ci-preparation) if your problem is already documented! + +If you need further help, please reach out to other **AAPS** users on [Facebook](https://www.facebook.com/groups/AndroidAPSUsers) or [Discord](https://discord.gg/4fQUWHZ4Mw). \ No newline at end of file diff --git a/docs/CROWDIN/pl/Maintenance/UpdateComputerBuild.md b/docs/CROWDIN/pl/Maintenance/UpdateComputerBuild.md new file mode 100644 index 000000000000..6a55381526f5 --- /dev/null +++ b/docs/CROWDIN/pl/Maintenance/UpdateComputerBuild.md @@ -0,0 +1,103 @@ +# Update with a computer + +## Build yourself instead of download + +**AAPS** is not available to download, due to regulations concerning medical devices. It is legal to build the app for your own use, but you must not give a copy to others! See [FAQ page](../UsefulLinks/FAQ.md) for details. + +```{note} +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 + +```{contents} Steps for updating to a new version of AAPS +:depth: 1 +:local: true +``` + +In case you experience problems, see separate page for [troubleshooting Android Studio](../GettingHelp/TroubleshootingAndroidStudio). + +### Export your settings + +Export your settings from the existing **AAPS** version on your phone. You might not need it, but better be safe than sorry. + +See the [Export & import settings](ExportImportSettings.md) page if you don't remember how to do this. + +### Check your Android Studio version + +The minimal version required is described in the [Building Instructions](#Building-APK-recommended-specification-of-computer-for-building-apk-file). If your version is older, please [update Android Studio first](#Building-APK-install-android-studio)! + +(Update-to-new-version-update-your-local-copy)= +### Update your local copy + +```{admonition} WARNING +:class: warning +If you update from versions prior to 2.8.x, please follow the instructions to do a [New clone](../SettingUpAaps/BuildingAaps.md), as this guide will not work for you! +``` + +* Open your existing AAPS project with Android Studio. You might need to select your project. (Double) click on the AAPS project. + + ![Android Studio - Select Project](../images/update/01_ProjectSelection.png) + +* In the menu bar of Android Studio, select Git -> Fetch + + ![Android Studio Menu - Git - Fetch](../images/update/02_GitFetch.png) + +* You will see a message in the lower right corner that Fetch was successful. + + ![Android Studio Menu - Git - Fetch successful](../images/update/03_GitFetchSuccessful.png) + +* In the menu bar, now select Git -> Pull + + ![Android Studio Menu - Git - Pull](../images/update/04_GitPull.png) + +* Leave all options as they are (origin/master) and select Pull + + ![Android Studio - Git - Pull dialog](../images/update/05_GitPullOptions.png) + +* Wait while download is in progress, you will see this as info in the bottom bar. When it's done, you will see a success message. + + ```{note} + The files that were updated may vary! This is not an indication + ``` + + ![Android Studio - Pull successful](../images/update/06_GitPullSuccess.png) + +* Gradle Sync will be running to download some dependencies. Wait until it is finished. + + ![Android Studio - Gradle Sync](../images/studioSetup/40_BackgroundTasks.png) + +### Check JVM version + +This check is particularly indicated if you have already built a previous version of **AAPS** on the same computer. + +Check in the [Building Instructions](#Building-APK-recommended-specification-of-computer-for-building-apk-file) the required version for JVM, matching the **AAPS** version you are now building. Then follow the steps described at [Incompatible Gradle JVM](#incompatible-gradle-jvm) to make sure you currently use the correct version. + +(Update-to-new-version-build-the-signed-apk)= +### Build the Signed APK + +Your sourcecode is now the current released version, and all prerequisites have been checked. It's time to build the signed apk as described in the [build signed apk section](#Building-APK-generate-signed-apk). + +(Update-to-new-version-transfer-and-install)= + +### Transfer and install the apk +You need to transfer the apk to your phone so you can install it. + +```{note} +If you completed the build with the same existing key store in Android Studio, then you do not need to remove the existing app on your phone. When you install the apk, follow the prompts to install updates. +For other scenarios such as establishing a new key store in Android Studio for your signed apk, you will need to delete the old app before installing the apk. **Make sure to export your settings!** +``` + +See the instructions for [transferring and installing AAPS](../SettingUpAaps/TransferringAndInstallingAaps.md) + +Continue [here](#Update-to-new-version-check-aaps-version-on-phone). + +## Troubleshooting + +If anything goes wrong, don't panic. + +Take a breath! + +Then see the separate page [troubleshooting Android Studio](../GettingHelp/TroubleshootingAndroidStudio) if your problem is already documented! + +If you need further help, please reach out to other **AAPS** users on [Facebook](https://www.facebook.com/groups/AndroidAPSUsers) or [Discord](https://discord.gg/4fQUWHZ4Mw). \ No newline at end of file diff --git a/docs/CROWDIN/pl/Maintenance/UpdateToNewVersion.md b/docs/CROWDIN/pl/Maintenance/UpdateToNewVersion.md index 59782ec6562a..f35cc58bef0f 100644 --- a/docs/CROWDIN/pl/Maintenance/UpdateToNewVersion.md +++ b/docs/CROWDIN/pl/Maintenance/UpdateToNewVersion.md @@ -10,91 +10,14 @@ * When a new release is available, in the **AAPS** app itself, you will receive an information banner about the new version. * The new version will also be announced on Facebook at the time of release. * Following the release, please read the [Release Notes](ReleaseNotes.md) in detail, and clarify any queries with the community on Facebook or Discord, before proceeding with the update. - - ```{note} - 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 +## Update AAPS with browser build -```{contents} Steps for updating to a new version of AAPS :depth: 1 :local: true +If you already built your AAPS app with the Browser Build method, follow [these instructions](./UpdateBrowserBuild.md). -
In case you experience problems, see separate page for [troubleshooting Android Studio](../GettingHelp/TroubleshootingAndroidStudio). - - ### Export your settings - - Export your settings from the existing **AAPS** version on your phone. You might not need it, but better be safe than sorry. - - See the [Export & import settings](ExportImportSettings.md) page if you don't remember how to do this. - - ### Check your Android Studio version - - The minimal version required is described in the [Building Instructions](#Building-APK-recommended-specification-of-computer-for-building-apk-file). If your version is older, please [update Android Studio first](#Building-APK-install-android-studio)! - - (Update-to-new-version-update-your-local-copy)= - ### Update your local copy - - ```{admonition} WARNING - :class: warning - If you update from versions prior to 2.8.x, please follow the instructions to do a [New clone](../SettingUpAaps/BuildingAaps.md), as this guide will not work for you! - +## Update AAPS with a computer -* Open your existing AAPS project with Android Studio. You might need to select your project. (Double) click on the AAPS project. - - ![Android Studio - Select Project](../images/update/01_ProjectSelection.png) - -* In the menu bar of Android Studio, select Git -> Fetch - - ![Android Studio Menu - Git - Fetch](../images/update/02_GitFetch.png) - -* You will see a message in the lower right corner that Fetch was successful. - - ![Android Studio Menu - Git - Fetch successful](../images/update/03_GitFetchSuccessful.png) - -* In the menu bar, now select Git -> Pull - - ![Android Studio Menu - Git - Pull](../images/update/04_GitPull.png) - -* Leave all options as they are (origin/master) and select Pull - - ![Android Studio - Git - Pull dialog](../images/update/05_GitPullOptions.png) - -* Wait while download is in progress, you will see this as info in the bottom bar. When it's done, you will see a success message. - - ```{note} - The files that were updated may vary! This is not an indication - ``` - - ![Android Studio - Pull successful](../images/update/06_GitPullSuccess.png) - -* Gradle Sync will be running to download some dependencies. Wait until it is finished. - - ![Android Studio - Gradle Sync](../images/studioSetup/40_BackgroundTasks.png) - -### Check JVM version - -This check is particularly indicated if you have already built a previous version of **AAPS** on the same computer. - -Check in the [Building Instructions](#Building-APK-recommended-specification-of-computer-for-building-apk-file) the required version for JVM, matching the **AAPS** version you are now building. Then follow the steps described at [Incompatible Gradle JVM](#incompatible-gradle-jvm) to make sure you currently use the correct version. - -(Update-to-new-version-build-the-signed-apk)= - -### Build the Signed APK - -Your sourcecode is now the current released version, and all prerequisites have been checked. It's time to build the signed apk as described in the [build signed apk section](#Building-APK-generate-signed-apk). - -(Update-to-new-version-transfer-and-install)= - -### Transfer and install the apk - -You need to transfer the apk to your phone so you can install it. - -```{note} -If you completed the build with the same existing key store in Android Studio, then you do not need to remove the existing app on your phone. When you install the apk, follow the prompts to install updates. -For other scenarios such as establishing a new key store in Android Studio for your signed apk, you will need to delete the old app before installing the apk. **Make sure to export your settings!** -``` - -See the instructions for [transferring and installing AAPS](../SettingUpAaps/TransferringAndInstallingAaps.md) +Follow [these instructions.](./UpdateComputerBuild.md). (Update-to-new-version-check-aaps-version-on-phone)= @@ -104,14 +27,4 @@ After you installed the new apk, you can check the AAPS version on your phone by ![AAPS version installed](../images/Update_VersionCheck.png) -Check in the [Release Notes](../Maintenance/ReleaseNotes.md) if there are any specific instructions after update. - -## Troubleshooting - -If anything goes wrong, don't panic. - -Take a breath! - -Then see the separate page [troubleshooting Android Studio](../GettingHelp/TroubleshootingAndroidStudio) if your problem is already documented! - -If you need further help, please reach out to other **AAPS** users on [Facebook](https://www.facebook.com/groups/AndroidAPSUsers) or [Discord](https://discord.gg/4fQUWHZ4Mw). \ No newline at end of file +Check in the [Release Notes](../Maintenance/ReleaseNotes.md) if there are any specific instructions after update. \ No newline at end of file diff --git a/docs/CROWDIN/pl/SettingUpAaps/BrowserBuild.md b/docs/CROWDIN/pl/SettingUpAaps/BrowserBuild.md index a3ad592f33dc..cef7e7098fd8 100644 --- a/docs/CROWDIN/pl/SettingUpAaps/BrowserBuild.md +++ b/docs/CROWDIN/pl/SettingUpAaps/BrowserBuild.md @@ -1,3 +1,5 @@ +(browser-build)= + # Browser build Building AAPS with GitHub Actions. diff --git a/docs/CROWDIN/pl/images/Building-the-App/CI/aaps_ci_simple_http_server.png b/docs/CROWDIN/pl/images/Building-the-App/CI/aaps_ci_simple_http_server.png index 95ac2d4eb443..2e2fb47e5ca2 100644 Binary files a/docs/CROWDIN/pl/images/Building-the-App/CI/aaps_ci_simple_http_server.png and b/docs/CROWDIN/pl/images/Building-the-App/CI/aaps_ci_simple_http_server.png differ diff --git a/docs/CROWDIN/pl/images/Building-the-App/CI/aaps_ci_simple_http_server_step1.png b/docs/CROWDIN/pl/images/Building-the-App/CI/aaps_ci_simple_http_server_step1.png index 78f52682b58d..b348162dcb1c 100644 Binary files a/docs/CROWDIN/pl/images/Building-the-App/CI/aaps_ci_simple_http_server_step1.png and b/docs/CROWDIN/pl/images/Building-the-App/CI/aaps_ci_simple_http_server_step1.png differ diff --git a/docs/CROWDIN/pl/images/Building-the-App/CI/aaps_ci_simple_http_server_step2.png b/docs/CROWDIN/pl/images/Building-the-App/CI/aaps_ci_simple_http_server_step2.png index c292ac667f63..cabadeefb97a 100644 Binary files a/docs/CROWDIN/pl/images/Building-the-App/CI/aaps_ci_simple_http_server_step2.png and b/docs/CROWDIN/pl/images/Building-the-App/CI/aaps_ci_simple_http_server_step2.png differ diff --git a/docs/CROWDIN/pl/images/Building-the-App/CI/aaps_ci_simple_http_server_step3.png b/docs/CROWDIN/pl/images/Building-the-App/CI/aaps_ci_simple_http_server_step3.png index bd31cd0ffb3d..9a26d3526369 100644 Binary files a/docs/CROWDIN/pl/images/Building-the-App/CI/aaps_ci_simple_http_server_step3.png and b/docs/CROWDIN/pl/images/Building-the-App/CI/aaps_ci_simple_http_server_step3.png differ diff --git a/docs/CROWDIN/pl/images/Building-the-App/CI/aaps_ci_simple_http_server_step4.png b/docs/CROWDIN/pl/images/Building-the-App/CI/aaps_ci_simple_http_server_step4.png index cc187ec72a14..285492424351 100644 Binary files a/docs/CROWDIN/pl/images/Building-the-App/CI/aaps_ci_simple_http_server_step4.png and b/docs/CROWDIN/pl/images/Building-the-App/CI/aaps_ci_simple_http_server_step4.png differ diff --git a/docs/CROWDIN/pl/images/Building-the-App/CI/aaps_ci_simple_http_server_store.png b/docs/CROWDIN/pl/images/Building-the-App/CI/aaps_ci_simple_http_server_store.png index 4b157ca8d3d8..65bf101f55e4 100644 Binary files a/docs/CROWDIN/pl/images/Building-the-App/CI/aaps_ci_simple_http_server_store.png and b/docs/CROWDIN/pl/images/Building-the-App/CI/aaps_ci_simple_http_server_store.png differ diff --git a/docs/CROWDIN/pl/images/update/CI/GitHubActions1.png b/docs/CROWDIN/pl/images/update/CI/GitHubActions1.png new file mode 100644 index 000000000000..e04ce6e76d8b Binary files /dev/null and b/docs/CROWDIN/pl/images/update/CI/GitHubActions1.png differ diff --git a/docs/CROWDIN/pl/images/update/CI/GitHubActions2.png b/docs/CROWDIN/pl/images/update/CI/GitHubActions2.png new file mode 100644 index 000000000000..7b5c5a842d16 Binary files /dev/null and b/docs/CROWDIN/pl/images/update/CI/GitHubActions2.png differ diff --git a/docs/CROWDIN/pl/images/update/CI/GitHubActions3.png b/docs/CROWDIN/pl/images/update/CI/GitHubActions3.png new file mode 100644 index 000000000000..cff0ed34b214 Binary files /dev/null and b/docs/CROWDIN/pl/images/update/CI/GitHubActions3.png differ diff --git a/docs/CROWDIN/pl/images/update/CI/GitHubActions4.png b/docs/CROWDIN/pl/images/update/CI/GitHubActions4.png new file mode 100644 index 000000000000..bede3c2dfe08 Binary files /dev/null and b/docs/CROWDIN/pl/images/update/CI/GitHubActions4.png differ diff --git a/docs/CROWDIN/pl/images/update/CI/GitHubActions5.png b/docs/CROWDIN/pl/images/update/CI/GitHubActions5.png new file mode 100644 index 000000000000..d96e31cf084d Binary files /dev/null and b/docs/CROWDIN/pl/images/update/CI/GitHubActions5.png differ diff --git a/docs/CROWDIN/pl/images/update/CI/GitHubUpdate1.png b/docs/CROWDIN/pl/images/update/CI/GitHubUpdate1.png new file mode 100644 index 000000000000..3058dc270d28 Binary files /dev/null and b/docs/CROWDIN/pl/images/update/CI/GitHubUpdate1.png differ diff --git a/docs/CROWDIN/pl/images/update/CI/GitHubUpdate2.png b/docs/CROWDIN/pl/images/update/CI/GitHubUpdate2.png new file mode 100644 index 000000000000..1ae9568c8107 Binary files /dev/null and b/docs/CROWDIN/pl/images/update/CI/GitHubUpdate2.png differ diff --git a/docs/CROWDIN/pl/images/update/CI/GitHubUpdate3.png b/docs/CROWDIN/pl/images/update/CI/GitHubUpdate3.png new file mode 100644 index 000000000000..d18f9119c76d Binary files /dev/null and b/docs/CROWDIN/pl/images/update/CI/GitHubUpdate3.png differ diff --git a/docs/CROWDIN/pl/images/update/CI/GitHubUpdate4.png b/docs/CROWDIN/pl/images/update/CI/GitHubUpdate4.png new file mode 100644 index 000000000000..8c38c071cb8f Binary files /dev/null and b/docs/CROWDIN/pl/images/update/CI/GitHubUpdate4.png differ diff --git a/docs/CROWDIN/pl/images/update/CI/GitHubUpdate5.png b/docs/CROWDIN/pl/images/update/CI/GitHubUpdate5.png new file mode 100644 index 000000000000..409aef1f34dc Binary files /dev/null and b/docs/CROWDIN/pl/images/update/CI/GitHubUpdate5.png differ diff --git a/docs/CROWDIN/pl/index.md b/docs/CROWDIN/pl/index.md index f8ce6c2d3016..f36b155f25f6 100644 --- a/docs/CROWDIN/pl/index.md +++ b/docs/CROWDIN/pl/index.md @@ -2,10 +2,10 @@ ![image](./images/basic-outline-of-AAPS.png) -```{admonition} Version 3.3 +```{admonition} Latest Release :class: note -29/12/2024 : Version 3.3 is out. Check the [Release Notes](#version3300) to see what's new and get update instructions. +14/08/2025 : Version 3.3.2.1 is out. Check the [Release Notes](#latestrelease) to see what's new and get update instructions. ``` @@ -21,7 +21,7 @@ Section **2) Getting Started**, the [Introduction](Getting-Started/Introduction. Now that you have a solid understanding of the process, you can start assembling your **AAPS** loop. -Section **3) Setting up AAPS** contains step-by-step instructions to do this. It covers choosing and [setting up your reporting server](./SettingUpAaps/SettingUpTheReportingServer.md) (Nightscout or Tidepool) so you can review and share your data, getting your computer ready for building the AAPS app, building the AAPS app and transferring the AAPS app to your phone. It also covers setting up the **AAPS** app using the setup Wizard, linking it with your CGM app, and either a real or virtual insulin pump, as well as linking **AAPS** to your reporting server. You are then slowly introduced to the full usage of what **AAPS** has to offer via a safe and carefully calibrated step-by-step process designed to make sure that you/your child are thoroughly familiar and comfortable navigating all the different levels and menu configurations before graduating on the next phase, commonly referred to as the next "Objective", until you are have enough experience to begin using the more advanced options available within the app. These Objectives are specially designed in such a way that will gradually unlock more possibilities of **AAPS** and switch from Open Loop to Closed Loop. +Section **3) Setting up AAPS** contains step-by-step instructions to do this. It covers choosing and [setting up your reporting server](./SettingUpAaps/SettingUpTheReportingServer.md) (Nightscout or Tidepool) so you can review and share your data, getting ready for building the AAPS app, building the AAPS app and transferring the AAPS app to your phone. It also covers setting up the **AAPS** app using the setup Wizard, linking it with your CGM app, and either a real or virtual insulin pump, as well as linking **AAPS** to your reporting server. You are then slowly introduced to the full usage of what **AAPS** has to offer via a safe and carefully calibrated step-by-step process designed to make sure that you/your child are thoroughly familiar and comfortable navigating all the different levels and menu configurations before graduating on the next phase, commonly referred to as the next "Objective", until you are have enough experience to begin using the more advanced options available within the app. These Objectives are specially designed in such a way that will gradually unlock more possibilities of **AAPS** and switch from Open Loop to Closed Loop. Section **4) Daily life with AAPS** covers key **AAPS** features, to help you use (and customise) **AAPS**. This including understanding the screens, carbs-on-board, sensitivity, profile switching, temp targets, extended carbs (or eCarbs), automations, and DynamicISF. It also covers frequent topics like how to manage different types of meals, how to deal with cannula and sensor changes, smartphone updates, daylight saving changes, and [travelling with AAPS](DailyLifeWithAaps/TimezoneTraveling-DaylightSavingTime.md) and sports. Common questions and answers are located within the troubleshooting section. diff --git a/docs/CROWDIN/pt/Maintenance/DocumentationUpdate.md b/docs/CROWDIN/pt/Maintenance/DocumentationUpdate.md index 456826bba34f..ef623e577dcc 100644 --- a/docs/CROWDIN/pt/Maintenance/DocumentationUpdate.md +++ b/docs/CROWDIN/pt/Maintenance/DocumentationUpdate.md @@ -4,7 +4,7 @@ - Updated versions and Android Studio prerequisites - Added [3.3.2.1](#version3321) release, removed Android 16 references (fixed) -- Added [Browser Build](browser-build) @Angus +- Added [Browser Build](#browser-build) @Angus ## May 2025 diff --git a/docs/CROWDIN/pt/Maintenance/ReleaseNotes.md b/docs/CROWDIN/pt/Maintenance/ReleaseNotes.md index ad439432dd0f..13cca042d6e5 100644 --- a/docs/CROWDIN/pt/Maintenance/ReleaseNotes.md +++ b/docs/CROWDIN/pt/Maintenance/ReleaseNotes.md @@ -55,6 +55,8 @@ In order to allow users with older Android to use older version of AAPS new vers WearOS 5, API level 34 (Android 14) has [limitations](#BuildingAapsWearOs-WearOS5). ``` +(latestrelease)= + (version3321)= ## Version 3.3.2.1 diff --git a/docs/CROWDIN/pt/Maintenance/UpdateBrowserBuild.md b/docs/CROWDIN/pt/Maintenance/UpdateBrowserBuild.md new file mode 100644 index 000000000000..18fdfc02ee51 --- /dev/null +++ b/docs/CROWDIN/pt/Maintenance/UpdateBrowserBuild.md @@ -0,0 +1,101 @@ +# Update with a browser + +## Construa você em vez de fazer download + +**AAPS** is not available to download, due to regulations concerning medical devices. It is legal to build the app for your own use, but you must not give a copy to others! See [FAQ page](../UsefulLinks/FAQ.md) for details. + +```{note} +In case you want to upgrade **AAPS** with a browser for the first time : copy your back-up keystore file to your Google Drive. Then follow the [Browser Build **AAPS** procedure](../SettingUpAaps/BrowserBuild.md) instead of this guide. Instead of creating a new keystore, you must select the one you have copied from your computer. +This operation will be mandatory only the first time, then for successive upgrades you will be able to follow this guide. +``` + +## Overview for updating to a new version of AAPS with a browser + +```{contents} Steps for updating to a new version of AAPS +:depth: 1 +:local: true +``` + +In case you experience problems, see separate page for [troubleshooting Android Studio](../GettingHelp/TroubleshootingAndroidStudio). + +### Export your settings + +Export your settings from the existing **AAPS** version on your phone. You might not need it, but better be safe than sorry. + +See the [Export & import settings](ExportImportSettings.md) page if you don't remember how to do this. + +(Update-to-new-version-update-your-repo)= +### Update your GitHub repository + +```{admonition} WARNING +:class: warning +Browser Build is available from AAPS version 3.3.2.1. +``` + +[Log into GitHub](https://github.com/login). + +1. Select Repositories. +2. Scroll down and select your own AndroidAPS repository. + +![Select AndroidAPS repo](../images/update/CI/GitHubUpdate1.png) + +3. Verify you are using your own copy of AndroidAPS (Forked from nightscout/AndroidAPS) +4. Tap Sync Fork to update it (the number of commits behind might differ from the picture) + + + +![Sync AndroidAPS repo](../images/update/CI/GitHubUpdate2.png) + +5. Tap Update Branch + +![Update AndroidAPS repo](../images/update/CI/GitHubUpdate3.png) + +Note: if you have modified your copy of AndroidAPS by mistake, you will see this screen. Discard all changes (commits) to return to the released version. + +![Discard rogue modifications](../images/update/CI/GitHubUpdate4.png) + +You have now synchronized (updated) your own copy with the latest release of Android APS. Good job. + +![Repo sync'ed](../images/update/CI/GitHubUpdate5.png) + +### Run the Workflow to Build the Signed APK + +1. In your GitHub copy of AndroidAPS, select Actions. +2. Expand All Workflows. +3. Select AAPS-CI + +![Actions AAPS-CI](../images/update/CI/GitHubActions1.png) + +4. Scroll down and tap Run Workflow. + +![Run Workflow](../images/update/CI/GitHubActions2.png) + +5. Select the branch you want to deploy (master), the [variant](variant) (fullRelease) and tap Run Workflow. + + + +![Run Workflow](../images/update/CI/GitHubActions3.png) + +6. You will see the message Workflow run was successfully requested. Refresh your browser page and you will be able to monitor the build progress. When the action completes, the AAPS CI action will show a green tick mark. You have successfully built the updated version of Android APS. + +![Monitor Workflow](../images/update/CI/GitHubActions4.png) + +### Install the AAPS APK + +1. Open your Google Drive +2. Browse into AAPS, select the new version folder and you will find both the phone and Android Wear versions. + +![Google Drive Location](../images/update/CI/GitHubActions5.png) + + +Continue [here](#Update-to-new-version-check-aaps-version-on-phone) + +## Troubleshooting + +If anything goes wrong, don't panic. + +Take a breath! + +Then see the [troubleshooting tips](#aaps-ci-preparation) if your problem is already documented! + +If you need further help, please reach out to other **AAPS** users on [Facebook](https://www.facebook.com/groups/AndroidAPSUsers) or [Discord](https://discord.gg/4fQUWHZ4Mw). \ No newline at end of file diff --git a/docs/CROWDIN/pt/Maintenance/UpdateComputerBuild.md b/docs/CROWDIN/pt/Maintenance/UpdateComputerBuild.md new file mode 100644 index 000000000000..6620c6787f22 --- /dev/null +++ b/docs/CROWDIN/pt/Maintenance/UpdateComputerBuild.md @@ -0,0 +1,103 @@ +# Update with a computer + +## Construa você em vez de fazer download + +**AAPS** is not available to download, due to regulations concerning medical devices. It is legal to build the app for your own use, but you must not give a copy to others! See [FAQ page](../UsefulLinks/FAQ.md) for details. + +```{note} +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 + +```{contents} Steps for updating to a new version of AAPS +:depth: 1 +:local: true +``` + +In case you experience problems, see separate page for [troubleshooting Android Studio](../GettingHelp/TroubleshootingAndroidStudio). + +### Export your settings + +Export your settings from the existing **AAPS** version on your phone. You might not need it, but better be safe than sorry. + +See the [Export & import settings](ExportImportSettings.md) page if you don't remember how to do this. + +### Check your Android Studio version + +The minimal version required is described in the [Building Instructions](#Building-APK-recommended-specification-of-computer-for-building-apk-file). If your version is older, please [update Android Studio first](#Building-APK-install-android-studio)! + +(Update-to-new-version-update-your-local-copy)= +### Update your local copy + +```{admonition} WARNING +:class: warning +If you update from versions prior to 2.8.x, please follow the instructions to do a [New clone](../SettingUpAaps/BuildingAaps.md), as this guide will not work for you! +``` + +* Open your existing AAPS project with Android Studio. You might need to select your project. (Double) click on the AAPS project. + + ![Android Studio - Select Project](../images/update/01_ProjectSelection.png) + +* In the menu bar of Android Studio, select Git -> Fetch + + ![Android Studio Menu - Git - Fetch](../images/update/02_GitFetch.png) + +* You will see a message in the lower right corner that Fetch was successful. + + ![Android Studio Menu - Git - Fetch successful](../images/update/03_GitFetchSuccessful.png) + +* In the menu bar, now select Git -> Pull + + ![Android Studio Menu - Git - Pull](../images/update/04_GitPull.png) + +* Leave all options as they are (origin/master) and select Pull + + ![Android Studio - Git - Pull dialog](../images/update/05_GitPullOptions.png) + +* Wait while download is in progress, you will see this as info in the bottom bar. When it's done, you will see a success message. + + ```{note} + The files that were updated may vary! This is not an indication + ``` + + ![Android Studio - Pull successful](../images/update/06_GitPullSuccess.png) + +* Gradle Sync will be running to download some dependencies. Wait until it is finished. + + ![Android Studio - Gradle Sync](../images/studioSetup/40_BackgroundTasks.png) + +### Check JVM version + +This check is particularly indicated if you have already built a previous version of **AAPS** on the same computer. + +Check in the [Building Instructions](#Building-APK-recommended-specification-of-computer-for-building-apk-file) the required version for JVM, matching the **AAPS** version you are now building. Then follow the steps described at [Incompatible Gradle JVM](#incompatible-gradle-jvm) to make sure you currently use the correct version. + +(Update-to-new-version-build-the-signed-apk)= +### Build the Signed APK + +Your sourcecode is now the current released version, and all prerequisites have been checked. It's time to build the signed apk as described in the [build signed apk section](#Building-APK-generate-signed-apk). + +(Update-to-new-version-transfer-and-install)= + +### Transfer and install the apk +You need to transfer the apk to your phone so you can install it. + +```{note} +If you completed the build with the same existing key store in Android Studio, then you do not need to remove the existing app on your phone. When you install the apk, follow the prompts to install updates. +For other scenarios such as establishing a new key store in Android Studio for your signed apk, you will need to delete the old app before installing the apk. **Make sure to export your settings!** +``` + +See the instructions for [transferring and installing AAPS](../SettingUpAaps/TransferringAndInstallingAaps.md) + +Continue [here](#Update-to-new-version-check-aaps-version-on-phone). + +## Troubleshooting + +If anything goes wrong, don't panic. + +Take a breath! + +Then see the separate page [troubleshooting Android Studio](../GettingHelp/TroubleshootingAndroidStudio) if your problem is already documented! + +If you need further help, please reach out to other **AAPS** users on [Facebook](https://www.facebook.com/groups/AndroidAPSUsers) or [Discord](https://discord.gg/4fQUWHZ4Mw). \ No newline at end of file diff --git a/docs/CROWDIN/pt/Maintenance/UpdateToNewVersion.md b/docs/CROWDIN/pt/Maintenance/UpdateToNewVersion.md index 0f6b01a8ae33..ba44f9973d28 100644 --- a/docs/CROWDIN/pt/Maintenance/UpdateToNewVersion.md +++ b/docs/CROWDIN/pt/Maintenance/UpdateToNewVersion.md @@ -10,91 +10,14 @@ * When a new release is available, in the **AAPS** app itself, you will receive an information banner about the new version. * The new version will also be announced on Facebook at the time of release. * Following the release, please read the [Release Notes](ReleaseNotes.md) in detail, and clarify any queries with the community on Facebook or Discord, before proceeding with the update. - - ```{note} - 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 +## Update AAPS with browser build -```{contents} Steps for updating to a new version of AAPS :depth: 1 :local: true +If you already built your AAPS app with the Browser Build method, follow [these instructions](./UpdateBrowserBuild.md). -
In case you experience problems, see separate page for [troubleshooting Android Studio](../GettingHelp/TroubleshootingAndroidStudio). - - ### Export your settings - - Export your settings from the existing **AAPS** version on your phone. You might not need it, but better be safe than sorry. - - See the [Export & import settings](ExportImportSettings.md) page if you don't remember how to do this. - - ### Check your Android Studio version - - The minimal version required is described in the [Building Instructions](#Building-APK-recommended-specification-of-computer-for-building-apk-file). If your version is older, please [update Android Studio first](#Building-APK-install-android-studio)! - - (Update-to-new-version-update-your-local-copy)= - ### Update your local copy - - ```{admonition} WARNING - :class: warning - If you update from versions prior to 2.8.x, please follow the instructions to do a [New clone](../SettingUpAaps/BuildingAaps.md), as this guide will not work for you! - +## Update AAPS with a computer -* Open your existing AAPS project with Android Studio. You might need to select your project. (Double) click on the AAPS project. - - ![Android Studio - Select Project](../images/update/01_ProjectSelection.png) - -* In the menu bar of Android Studio, select Git -> Fetch - - ![Android Studio Menu - Git - Fetch](../images/update/02_GitFetch.png) - -* You will see a message in the lower right corner that Fetch was successful. - - ![Android Studio Menu - Git - Fetch successful](../images/update/03_GitFetchSuccessful.png) - -* In the menu bar, now select Git -> Pull - - ![Android Studio Menu - Git - Pull](../images/update/04_GitPull.png) - -* Leave all options as they are (origin/master) and select Pull - - ![Android Studio - Git - Pull dialog](../images/update/05_GitPullOptions.png) - -* Wait while download is in progress, you will see this as info in the bottom bar. When it's done, you will see a success message. - - ```{note} - The files that were updated may vary! This is not an indication - ``` - - ![Android Studio - Pull successful](../images/update/06_GitPullSuccess.png) - -* Gradle Sync will be running to download some dependencies. Wait until it is finished. - - ![Android Studio - Gradle Sync](../images/studioSetup/40_BackgroundTasks.png) - -### Check JVM version - -This check is particularly indicated if you have already built a previous version of **AAPS** on the same computer. - -Check in the [Building Instructions](#Building-APK-recommended-specification-of-computer-for-building-apk-file) the required version for JVM, matching the **AAPS** version you are now building. Then follow the steps described at [Incompatible Gradle JVM](#incompatible-gradle-jvm) to make sure you currently use the correct version. - -(Update-to-new-version-build-the-signed-apk)= - -### Build the Signed APK - -Your sourcecode is now the current released version, and all prerequisites have been checked. It's time to build the signed apk as described in the [build signed apk section](#Building-APK-generate-signed-apk). - -(Update-to-new-version-transfer-and-install)= - -### Transfer and install the apk - -You need to transfer the apk to your phone so you can install it. - -```{note} -If you completed the build with the same existing key store in Android Studio, then you do not need to remove the existing app on your phone. When you install the apk, follow the prompts to install updates. -For other scenarios such as establishing a new key store in Android Studio for your signed apk, you will need to delete the old app before installing the apk. **Make sure to export your settings!** -``` - -See the instructions for [transferring and installing AAPS](../SettingUpAaps/TransferringAndInstallingAaps.md) +Follow [these instructions.](./UpdateComputerBuild.md). (Update-to-new-version-check-aaps-version-on-phone)= @@ -104,14 +27,4 @@ After you installed the new apk, you can check the AAPS version on your phone by ![AAPS version installed](../images/Update_VersionCheck.png) -Check in the [Release Notes](../Maintenance/ReleaseNotes.md) if there are any specific instructions after update. - -## Troubleshooting - -If anything goes wrong, don't panic. - -Take a breath! - -Then see the separate page [troubleshooting Android Studio](../GettingHelp/TroubleshootingAndroidStudio) if your problem is already documented! - -If you need further help, please reach out to other **AAPS** users on [Facebook](https://www.facebook.com/groups/AndroidAPSUsers) or [Discord](https://discord.gg/4fQUWHZ4Mw). \ No newline at end of file +Check in the [Release Notes](../Maintenance/ReleaseNotes.md) if there are any specific instructions after update. \ No newline at end of file diff --git a/docs/CROWDIN/pt/SettingUpAaps/BrowserBuild.md b/docs/CROWDIN/pt/SettingUpAaps/BrowserBuild.md index 1fc8d4d178ed..23f756dac11a 100644 --- a/docs/CROWDIN/pt/SettingUpAaps/BrowserBuild.md +++ b/docs/CROWDIN/pt/SettingUpAaps/BrowserBuild.md @@ -1,3 +1,5 @@ +(browser-build)= + # Browser build Building AAPS with GitHub Actions. diff --git a/docs/CROWDIN/pt/images/Building-the-App/CI/aaps_ci_simple_http_server.png b/docs/CROWDIN/pt/images/Building-the-App/CI/aaps_ci_simple_http_server.png index 95ac2d4eb443..2e2fb47e5ca2 100644 Binary files a/docs/CROWDIN/pt/images/Building-the-App/CI/aaps_ci_simple_http_server.png and b/docs/CROWDIN/pt/images/Building-the-App/CI/aaps_ci_simple_http_server.png differ diff --git a/docs/CROWDIN/pt/images/Building-the-App/CI/aaps_ci_simple_http_server_step1.png b/docs/CROWDIN/pt/images/Building-the-App/CI/aaps_ci_simple_http_server_step1.png index 78f52682b58d..b348162dcb1c 100644 Binary files a/docs/CROWDIN/pt/images/Building-the-App/CI/aaps_ci_simple_http_server_step1.png and b/docs/CROWDIN/pt/images/Building-the-App/CI/aaps_ci_simple_http_server_step1.png differ diff --git a/docs/CROWDIN/pt/images/Building-the-App/CI/aaps_ci_simple_http_server_step2.png b/docs/CROWDIN/pt/images/Building-the-App/CI/aaps_ci_simple_http_server_step2.png index c292ac667f63..cabadeefb97a 100644 Binary files a/docs/CROWDIN/pt/images/Building-the-App/CI/aaps_ci_simple_http_server_step2.png and b/docs/CROWDIN/pt/images/Building-the-App/CI/aaps_ci_simple_http_server_step2.png differ diff --git a/docs/CROWDIN/pt/images/Building-the-App/CI/aaps_ci_simple_http_server_step3.png b/docs/CROWDIN/pt/images/Building-the-App/CI/aaps_ci_simple_http_server_step3.png index bd31cd0ffb3d..9a26d3526369 100644 Binary files a/docs/CROWDIN/pt/images/Building-the-App/CI/aaps_ci_simple_http_server_step3.png and b/docs/CROWDIN/pt/images/Building-the-App/CI/aaps_ci_simple_http_server_step3.png differ diff --git a/docs/CROWDIN/pt/images/Building-the-App/CI/aaps_ci_simple_http_server_step4.png b/docs/CROWDIN/pt/images/Building-the-App/CI/aaps_ci_simple_http_server_step4.png index cc187ec72a14..285492424351 100644 Binary files a/docs/CROWDIN/pt/images/Building-the-App/CI/aaps_ci_simple_http_server_step4.png and b/docs/CROWDIN/pt/images/Building-the-App/CI/aaps_ci_simple_http_server_step4.png differ diff --git a/docs/CROWDIN/pt/images/Building-the-App/CI/aaps_ci_simple_http_server_store.png b/docs/CROWDIN/pt/images/Building-the-App/CI/aaps_ci_simple_http_server_store.png index 4b157ca8d3d8..65bf101f55e4 100644 Binary files a/docs/CROWDIN/pt/images/Building-the-App/CI/aaps_ci_simple_http_server_store.png and b/docs/CROWDIN/pt/images/Building-the-App/CI/aaps_ci_simple_http_server_store.png differ diff --git a/docs/CROWDIN/pt/images/update/CI/GitHubActions1.png b/docs/CROWDIN/pt/images/update/CI/GitHubActions1.png new file mode 100644 index 000000000000..e04ce6e76d8b Binary files /dev/null and b/docs/CROWDIN/pt/images/update/CI/GitHubActions1.png differ diff --git a/docs/CROWDIN/pt/images/update/CI/GitHubActions2.png b/docs/CROWDIN/pt/images/update/CI/GitHubActions2.png new file mode 100644 index 000000000000..7b5c5a842d16 Binary files /dev/null and b/docs/CROWDIN/pt/images/update/CI/GitHubActions2.png differ diff --git a/docs/CROWDIN/pt/images/update/CI/GitHubActions3.png b/docs/CROWDIN/pt/images/update/CI/GitHubActions3.png new file mode 100644 index 000000000000..cff0ed34b214 Binary files /dev/null and b/docs/CROWDIN/pt/images/update/CI/GitHubActions3.png differ diff --git a/docs/CROWDIN/pt/images/update/CI/GitHubActions4.png b/docs/CROWDIN/pt/images/update/CI/GitHubActions4.png new file mode 100644 index 000000000000..bede3c2dfe08 Binary files /dev/null and b/docs/CROWDIN/pt/images/update/CI/GitHubActions4.png differ diff --git a/docs/CROWDIN/pt/images/update/CI/GitHubActions5.png b/docs/CROWDIN/pt/images/update/CI/GitHubActions5.png new file mode 100644 index 000000000000..d96e31cf084d Binary files /dev/null and b/docs/CROWDIN/pt/images/update/CI/GitHubActions5.png differ diff --git a/docs/CROWDIN/pt/images/update/CI/GitHubUpdate1.png b/docs/CROWDIN/pt/images/update/CI/GitHubUpdate1.png new file mode 100644 index 000000000000..3058dc270d28 Binary files /dev/null and b/docs/CROWDIN/pt/images/update/CI/GitHubUpdate1.png differ diff --git a/docs/CROWDIN/pt/images/update/CI/GitHubUpdate2.png b/docs/CROWDIN/pt/images/update/CI/GitHubUpdate2.png new file mode 100644 index 000000000000..1ae9568c8107 Binary files /dev/null and b/docs/CROWDIN/pt/images/update/CI/GitHubUpdate2.png differ diff --git a/docs/CROWDIN/pt/images/update/CI/GitHubUpdate3.png b/docs/CROWDIN/pt/images/update/CI/GitHubUpdate3.png new file mode 100644 index 000000000000..d18f9119c76d Binary files /dev/null and b/docs/CROWDIN/pt/images/update/CI/GitHubUpdate3.png differ diff --git a/docs/CROWDIN/pt/images/update/CI/GitHubUpdate4.png b/docs/CROWDIN/pt/images/update/CI/GitHubUpdate4.png new file mode 100644 index 000000000000..8c38c071cb8f Binary files /dev/null and b/docs/CROWDIN/pt/images/update/CI/GitHubUpdate4.png differ diff --git a/docs/CROWDIN/pt/images/update/CI/GitHubUpdate5.png b/docs/CROWDIN/pt/images/update/CI/GitHubUpdate5.png new file mode 100644 index 000000000000..409aef1f34dc Binary files /dev/null and b/docs/CROWDIN/pt/images/update/CI/GitHubUpdate5.png differ diff --git a/docs/CROWDIN/pt/index.md b/docs/CROWDIN/pt/index.md index eb2665ae1387..0c5e6973be4e 100644 --- a/docs/CROWDIN/pt/index.md +++ b/docs/CROWDIN/pt/index.md @@ -2,10 +2,10 @@ ![image](./images/basic-outline-of-AAPS.png) -```{admonition} Version 3.3 +```{admonition} Latest Release :class: note -29/12/2024 : Version 3.3 is out. Check the [Release Notes](#version3300) to see what's new and get update instructions. +14/08/2025 : Version 3.3.2.1 is out. Check the [Release Notes](#latestrelease) to see what's new and get update instructions. ``` @@ -21,7 +21,7 @@ Section **2) Getting Started**, the [Introduction](Getting-Started/Introduction. Now that you have a solid understanding of the process, you can start assembling your **AAPS** loop. -Section **3) Setting up AAPS** contains step-by-step instructions to do this. It covers choosing and [setting up your reporting server](./SettingUpAaps/SettingUpTheReportingServer.md) (Nightscout or Tidepool) so you can review and share your data, getting your computer ready for building the AAPS app, building the AAPS app and transferring the AAPS app to your phone. It also covers setting up the **AAPS** app using the setup Wizard, linking it with your CGM app, and either a real or virtual insulin pump, as well as linking **AAPS** to your reporting server. You are then slowly introduced to the full usage of what **AAPS** has to offer via a safe and carefully calibrated step-by-step process designed to make sure that you/your child are thoroughly familiar and comfortable navigating all the different levels and menu configurations before graduating on the next phase, commonly referred to as the next "Objective", until you are have enough experience to begin using the more advanced options available within the app. These Objectives are specially designed in such a way that will gradually unlock more possibilities of **AAPS** and switch from Open Loop to Closed Loop. +Section **3) Setting up AAPS** contains step-by-step instructions to do this. It covers choosing and [setting up your reporting server](./SettingUpAaps/SettingUpTheReportingServer.md) (Nightscout or Tidepool) so you can review and share your data, getting ready for building the AAPS app, building the AAPS app and transferring the AAPS app to your phone. It also covers setting up the **AAPS** app using the setup Wizard, linking it with your CGM app, and either a real or virtual insulin pump, as well as linking **AAPS** to your reporting server. You are then slowly introduced to the full usage of what **AAPS** has to offer via a safe and carefully calibrated step-by-step process designed to make sure that you/your child are thoroughly familiar and comfortable navigating all the different levels and menu configurations before graduating on the next phase, commonly referred to as the next "Objective", until you are have enough experience to begin using the more advanced options available within the app. These Objectives are specially designed in such a way that will gradually unlock more possibilities of **AAPS** and switch from Open Loop to Closed Loop. Section **4) Daily life with AAPS** covers key **AAPS** features, to help you use (and customise) **AAPS**. This including understanding the screens, carbs-on-board, sensitivity, profile switching, temp targets, extended carbs (or eCarbs), automations, and DynamicISF. It also covers frequent topics like how to manage different types of meals, how to deal with cannula and sensor changes, smartphone updates, daylight saving changes, and [travelling with AAPS](DailyLifeWithAaps/TimezoneTraveling-DaylightSavingTime.md) and sports. Common questions and answers are located within the troubleshooting section. diff --git a/docs/CROWDIN/ro/Maintenance/DocumentationUpdate.md b/docs/CROWDIN/ro/Maintenance/DocumentationUpdate.md index c5766a8c5310..f9e4cbaeef86 100644 --- a/docs/CROWDIN/ro/Maintenance/DocumentationUpdate.md +++ b/docs/CROWDIN/ro/Maintenance/DocumentationUpdate.md @@ -4,7 +4,7 @@ - Updated versions and Android Studio prerequisites - Added [3.3.2.1](#version3321) release, removed Android 16 references (fixed) -- Added [Browser Build](browser-build) @Angus +- Added [Browser Build](#browser-build) @Angus ## May 2025 diff --git a/docs/CROWDIN/ro/Maintenance/ReleaseNotes.md b/docs/CROWDIN/ro/Maintenance/ReleaseNotes.md index cb9af84db671..5d9468c62ec9 100644 --- a/docs/CROWDIN/ro/Maintenance/ReleaseNotes.md +++ b/docs/CROWDIN/ro/Maintenance/ReleaseNotes.md @@ -55,6 +55,8 @@ In order to allow users with older Android to use older version of AAPS new vers WearOS 5, API level 34 (Android 14) has [limitations](#BuildingAapsWearOs-WearOS5). ``` +(latestrelease)= + (version3321)= ## Version 3.3.2.1 diff --git a/docs/CROWDIN/ro/Maintenance/UpdateBrowserBuild.md b/docs/CROWDIN/ro/Maintenance/UpdateBrowserBuild.md new file mode 100644 index 000000000000..6bfef1fe4e10 --- /dev/null +++ b/docs/CROWDIN/ro/Maintenance/UpdateBrowserBuild.md @@ -0,0 +1,101 @@ +# Update with a browser + +## Build yourself instead of download + +**AAPS** is not available to download, due to regulations concerning medical devices. It is legal to build the app for your own use, but you must not give a copy to others! See [FAQ page](../UsefulLinks/FAQ.md) for details. + +```{note} +In case you want to upgrade **AAPS** with a browser for the first time : copy your back-up keystore file to your Google Drive. Then follow the [Browser Build **AAPS** procedure](../SettingUpAaps/BrowserBuild.md) instead of this guide. Instead of creating a new keystore, you must select the one you have copied from your computer. +This operation will be mandatory only the first time, then for successive upgrades you will be able to follow this guide. +``` + +## Overview for updating to a new version of AAPS with a browser + +```{contents} Steps for updating to a new version of AAPS +:depth: 1 +:local: true +``` + +In case you experience problems, see separate page for [troubleshooting Android Studio](../GettingHelp/TroubleshootingAndroidStudio). + +### Export your settings + +Export your settings from the existing **AAPS** version on your phone. You might not need it, but better be safe than sorry. + +See the [Export & import settings](ExportImportSettings.md) page if you don't remember how to do this. + +(Update-to-new-version-update-your-repo)= +### Update your GitHub repository + +```{admonition} WARNING +:class: warning +Browser Build is available from AAPS version 3.3.2.1. +``` + +[Log into GitHub](https://github.com/login). + +1. Select Repositories. +2. Scroll down and select your own AndroidAPS repository. + +![Select AndroidAPS repo](../images/update/CI/GitHubUpdate1.png) + +3. Verify you are using your own copy of AndroidAPS (Forked from nightscout/AndroidAPS) +4. Tap Sync Fork to update it (the number of commits behind might differ from the picture) + + + +![Sync AndroidAPS repo](../images/update/CI/GitHubUpdate2.png) + +5. Tap Update Branch + +![Update AndroidAPS repo](../images/update/CI/GitHubUpdate3.png) + +Note: if you have modified your copy of AndroidAPS by mistake, you will see this screen. Discard all changes (commits) to return to the released version. + +![Discard rogue modifications](../images/update/CI/GitHubUpdate4.png) + +You have now synchronized (updated) your own copy with the latest release of Android APS. Good job. + +![Repo sync'ed](../images/update/CI/GitHubUpdate5.png) + +### Run the Workflow to Build the Signed APK + +1. In your GitHub copy of AndroidAPS, select Actions. +2. Expand All Workflows. +3. Select AAPS-CI + +![Actions AAPS-CI](../images/update/CI/GitHubActions1.png) + +4. Scroll down and tap Run Workflow. + +![Run Workflow](../images/update/CI/GitHubActions2.png) + +5. Select the branch you want to deploy (master), the [variant](variant) (fullRelease) and tap Run Workflow. + + + +![Run Workflow](../images/update/CI/GitHubActions3.png) + +6. You will see the message Workflow run was successfully requested. Refresh your browser page and you will be able to monitor the build progress. When the action completes, the AAPS CI action will show a green tick mark. You have successfully built the updated version of Android APS. + +![Monitor Workflow](../images/update/CI/GitHubActions4.png) + +### Install the AAPS APK + +1. Open your Google Drive +2. Browse into AAPS, select the new version folder and you will find both the phone and Android Wear versions. + +![Google Drive Location](../images/update/CI/GitHubActions5.png) + + +Continue [here](#Update-to-new-version-check-aaps-version-on-phone) + +## Troubleshooting + +If anything goes wrong, don't panic. + +Take a breath! + +Then see the [troubleshooting tips](#aaps-ci-preparation) if your problem is already documented! + +If you need further help, please reach out to other **AAPS** users on [Facebook](https://www.facebook.com/groups/AndroidAPSUsers) or [Discord](https://discord.gg/4fQUWHZ4Mw). \ No newline at end of file diff --git a/docs/CROWDIN/ro/Maintenance/UpdateComputerBuild.md b/docs/CROWDIN/ro/Maintenance/UpdateComputerBuild.md new file mode 100644 index 000000000000..6a55381526f5 --- /dev/null +++ b/docs/CROWDIN/ro/Maintenance/UpdateComputerBuild.md @@ -0,0 +1,103 @@ +# Update with a computer + +## Build yourself instead of download + +**AAPS** is not available to download, due to regulations concerning medical devices. It is legal to build the app for your own use, but you must not give a copy to others! See [FAQ page](../UsefulLinks/FAQ.md) for details. + +```{note} +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 + +```{contents} Steps for updating to a new version of AAPS +:depth: 1 +:local: true +``` + +In case you experience problems, see separate page for [troubleshooting Android Studio](../GettingHelp/TroubleshootingAndroidStudio). + +### Export your settings + +Export your settings from the existing **AAPS** version on your phone. You might not need it, but better be safe than sorry. + +See the [Export & import settings](ExportImportSettings.md) page if you don't remember how to do this. + +### Check your Android Studio version + +The minimal version required is described in the [Building Instructions](#Building-APK-recommended-specification-of-computer-for-building-apk-file). If your version is older, please [update Android Studio first](#Building-APK-install-android-studio)! + +(Update-to-new-version-update-your-local-copy)= +### Update your local copy + +```{admonition} WARNING +:class: warning +If you update from versions prior to 2.8.x, please follow the instructions to do a [New clone](../SettingUpAaps/BuildingAaps.md), as this guide will not work for you! +``` + +* Open your existing AAPS project with Android Studio. You might need to select your project. (Double) click on the AAPS project. + + ![Android Studio - Select Project](../images/update/01_ProjectSelection.png) + +* In the menu bar of Android Studio, select Git -> Fetch + + ![Android Studio Menu - Git - Fetch](../images/update/02_GitFetch.png) + +* You will see a message in the lower right corner that Fetch was successful. + + ![Android Studio Menu - Git - Fetch successful](../images/update/03_GitFetchSuccessful.png) + +* In the menu bar, now select Git -> Pull + + ![Android Studio Menu - Git - Pull](../images/update/04_GitPull.png) + +* Leave all options as they are (origin/master) and select Pull + + ![Android Studio - Git - Pull dialog](../images/update/05_GitPullOptions.png) + +* Wait while download is in progress, you will see this as info in the bottom bar. When it's done, you will see a success message. + + ```{note} + The files that were updated may vary! This is not an indication + ``` + + ![Android Studio - Pull successful](../images/update/06_GitPullSuccess.png) + +* Gradle Sync will be running to download some dependencies. Wait until it is finished. + + ![Android Studio - Gradle Sync](../images/studioSetup/40_BackgroundTasks.png) + +### Check JVM version + +This check is particularly indicated if you have already built a previous version of **AAPS** on the same computer. + +Check in the [Building Instructions](#Building-APK-recommended-specification-of-computer-for-building-apk-file) the required version for JVM, matching the **AAPS** version you are now building. Then follow the steps described at [Incompatible Gradle JVM](#incompatible-gradle-jvm) to make sure you currently use the correct version. + +(Update-to-new-version-build-the-signed-apk)= +### Build the Signed APK + +Your sourcecode is now the current released version, and all prerequisites have been checked. It's time to build the signed apk as described in the [build signed apk section](#Building-APK-generate-signed-apk). + +(Update-to-new-version-transfer-and-install)= + +### Transfer and install the apk +You need to transfer the apk to your phone so you can install it. + +```{note} +If you completed the build with the same existing key store in Android Studio, then you do not need to remove the existing app on your phone. When you install the apk, follow the prompts to install updates. +For other scenarios such as establishing a new key store in Android Studio for your signed apk, you will need to delete the old app before installing the apk. **Make sure to export your settings!** +``` + +See the instructions for [transferring and installing AAPS](../SettingUpAaps/TransferringAndInstallingAaps.md) + +Continue [here](#Update-to-new-version-check-aaps-version-on-phone). + +## Troubleshooting + +If anything goes wrong, don't panic. + +Take a breath! + +Then see the separate page [troubleshooting Android Studio](../GettingHelp/TroubleshootingAndroidStudio) if your problem is already documented! + +If you need further help, please reach out to other **AAPS** users on [Facebook](https://www.facebook.com/groups/AndroidAPSUsers) or [Discord](https://discord.gg/4fQUWHZ4Mw). \ No newline at end of file diff --git a/docs/CROWDIN/ro/Maintenance/UpdateToNewVersion.md b/docs/CROWDIN/ro/Maintenance/UpdateToNewVersion.md index d7eac798f670..e31ab758029f 100644 --- a/docs/CROWDIN/ro/Maintenance/UpdateToNewVersion.md +++ b/docs/CROWDIN/ro/Maintenance/UpdateToNewVersion.md @@ -10,91 +10,14 @@ * When a new release is available, in the **AAPS** app itself, you will receive an information banner about the new version. * The new version will also be announced on Facebook at the time of release. * Following the release, please read the [Release Notes](ReleaseNotes.md) in detail, and clarify any queries with the community on Facebook or Discord, before proceeding with the update. - - ```{note} - 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 +## Update AAPS with browser build -```{contents} Steps for updating to a new version of AAPS :depth: 1 :local: true +If you already built your AAPS app with the Browser Build method, follow [these instructions](./UpdateBrowserBuild.md). -
In case you experience problems, see separate page for [troubleshooting Android Studio](../GettingHelp/TroubleshootingAndroidStudio). - - ### Export your settings - - Export your settings from the existing **AAPS** version on your phone. You might not need it, but better be safe than sorry. - - See the [Export & import settings](ExportImportSettings.md) page if you don't remember how to do this. - - ### Check your Android Studio version - - The minimal version required is described in the [Building Instructions](#Building-APK-recommended-specification-of-computer-for-building-apk-file). If your version is older, please [update Android Studio first](#Building-APK-install-android-studio)! - - (Update-to-new-version-update-your-local-copy)= - ### Update your local copy - - ```{admonition} WARNING - :class: warning - If you update from versions prior to 2.8.x, please follow the instructions to do a [New clone](../SettingUpAaps/BuildingAaps.md), as this guide will not work for you! - +## Update AAPS with a computer -* Open your existing AAPS project with Android Studio. You might need to select your project. (Double) click on the AAPS project. - - ![Android Studio - Select Project](../images/update/01_ProjectSelection.png) - -* In the menu bar of Android Studio, select Git -> Fetch - - ![Android Studio Menu - Git - Fetch](../images/update/02_GitFetch.png) - -* You will see a message in the lower right corner that Fetch was successful. - - ![Android Studio Menu - Git - Fetch successful](../images/update/03_GitFetchSuccessful.png) - -* In the menu bar, now select Git -> Pull - - ![Android Studio Menu - Git - Pull](../images/update/04_GitPull.png) - -* Leave all options as they are (origin/master) and select Pull - - ![Android Studio - Git - Pull dialog](../images/update/05_GitPullOptions.png) - -* Wait while download is in progress, you will see this as info in the bottom bar. When it's done, you will see a success message. - - ```{note} - The files that were updated may vary! This is not an indication - ``` - - ![Android Studio - Pull successful](../images/update/06_GitPullSuccess.png) - -* Gradle Sync will be running to download some dependencies. Wait until it is finished. - - ![Android Studio - Gradle Sync](../images/studioSetup/40_BackgroundTasks.png) - -### Check JVM version - -This check is particularly indicated if you have already built a previous version of **AAPS** on the same computer. - -Check in the [Building Instructions](#Building-APK-recommended-specification-of-computer-for-building-apk-file) the required version for JVM, matching the **AAPS** version you are now building. Then follow the steps described at [Incompatible Gradle JVM](#incompatible-gradle-jvm) to make sure you currently use the correct version. - -(Update-to-new-version-build-the-signed-apk)= - -### Build the Signed APK - -Your sourcecode is now the current released version, and all prerequisites have been checked. It's time to build the signed apk as described in the [build signed apk section](#Building-APK-generate-signed-apk). - -(Update-to-new-version-transfer-and-install)= - -### Transfer and install the apk - -You need to transfer the apk to your phone so you can install it. - -```{note} -If you completed the build with the same existing key store in Android Studio, then you do not need to remove the existing app on your phone. When you install the apk, follow the prompts to install updates. -For other scenarios such as establishing a new key store in Android Studio for your signed apk, you will need to delete the old app before installing the apk. **Make sure to export your settings!** -``` - -See the instructions for [transferring and installing AAPS](../SettingUpAaps/TransferringAndInstallingAaps.md) +Follow [these instructions.](./UpdateComputerBuild.md). (Update-to-new-version-check-aaps-version-on-phone)= @@ -104,14 +27,4 @@ After you installed the new apk, you can check the AAPS version on your phone by ![AAPS version installed](../images/Update_VersionCheck.png) -Check in the [Release Notes](../Maintenance/ReleaseNotes.md) if there are any specific instructions after update. - -## Troubleshooting - -If anything goes wrong, don't panic. - -Take a breath! - -Then see the separate page [troubleshooting Android Studio](../GettingHelp/TroubleshootingAndroidStudio) if your problem is already documented! - -If you need further help, please reach out to other **AAPS** users on [Facebook](https://www.facebook.com/groups/AndroidAPSUsers) or [Discord](https://discord.gg/4fQUWHZ4Mw). \ No newline at end of file +Check in the [Release Notes](../Maintenance/ReleaseNotes.md) if there are any specific instructions after update. \ No newline at end of file diff --git a/docs/CROWDIN/ro/SettingUpAaps/BrowserBuild.md b/docs/CROWDIN/ro/SettingUpAaps/BrowserBuild.md index a3ad592f33dc..cef7e7098fd8 100644 --- a/docs/CROWDIN/ro/SettingUpAaps/BrowserBuild.md +++ b/docs/CROWDIN/ro/SettingUpAaps/BrowserBuild.md @@ -1,3 +1,5 @@ +(browser-build)= + # Browser build Building AAPS with GitHub Actions. diff --git a/docs/CROWDIN/ro/images/Building-the-App/CI/aaps_ci_simple_http_server.png b/docs/CROWDIN/ro/images/Building-the-App/CI/aaps_ci_simple_http_server.png index 95ac2d4eb443..2e2fb47e5ca2 100644 Binary files a/docs/CROWDIN/ro/images/Building-the-App/CI/aaps_ci_simple_http_server.png and b/docs/CROWDIN/ro/images/Building-the-App/CI/aaps_ci_simple_http_server.png differ diff --git a/docs/CROWDIN/ro/images/Building-the-App/CI/aaps_ci_simple_http_server_step1.png b/docs/CROWDIN/ro/images/Building-the-App/CI/aaps_ci_simple_http_server_step1.png index 78f52682b58d..b348162dcb1c 100644 Binary files a/docs/CROWDIN/ro/images/Building-the-App/CI/aaps_ci_simple_http_server_step1.png and b/docs/CROWDIN/ro/images/Building-the-App/CI/aaps_ci_simple_http_server_step1.png differ diff --git a/docs/CROWDIN/ro/images/Building-the-App/CI/aaps_ci_simple_http_server_step2.png b/docs/CROWDIN/ro/images/Building-the-App/CI/aaps_ci_simple_http_server_step2.png index c292ac667f63..cabadeefb97a 100644 Binary files a/docs/CROWDIN/ro/images/Building-the-App/CI/aaps_ci_simple_http_server_step2.png and b/docs/CROWDIN/ro/images/Building-the-App/CI/aaps_ci_simple_http_server_step2.png differ diff --git a/docs/CROWDIN/ro/images/Building-the-App/CI/aaps_ci_simple_http_server_step3.png b/docs/CROWDIN/ro/images/Building-the-App/CI/aaps_ci_simple_http_server_step3.png index bd31cd0ffb3d..9a26d3526369 100644 Binary files a/docs/CROWDIN/ro/images/Building-the-App/CI/aaps_ci_simple_http_server_step3.png and b/docs/CROWDIN/ro/images/Building-the-App/CI/aaps_ci_simple_http_server_step3.png differ diff --git a/docs/CROWDIN/ro/images/Building-the-App/CI/aaps_ci_simple_http_server_step4.png b/docs/CROWDIN/ro/images/Building-the-App/CI/aaps_ci_simple_http_server_step4.png index cc187ec72a14..285492424351 100644 Binary files a/docs/CROWDIN/ro/images/Building-the-App/CI/aaps_ci_simple_http_server_step4.png and b/docs/CROWDIN/ro/images/Building-the-App/CI/aaps_ci_simple_http_server_step4.png differ diff --git a/docs/CROWDIN/ro/images/Building-the-App/CI/aaps_ci_simple_http_server_store.png b/docs/CROWDIN/ro/images/Building-the-App/CI/aaps_ci_simple_http_server_store.png index 4b157ca8d3d8..65bf101f55e4 100644 Binary files a/docs/CROWDIN/ro/images/Building-the-App/CI/aaps_ci_simple_http_server_store.png and b/docs/CROWDIN/ro/images/Building-the-App/CI/aaps_ci_simple_http_server_store.png differ diff --git a/docs/CROWDIN/ro/images/update/CI/GitHubActions1.png b/docs/CROWDIN/ro/images/update/CI/GitHubActions1.png new file mode 100644 index 000000000000..e04ce6e76d8b Binary files /dev/null and b/docs/CROWDIN/ro/images/update/CI/GitHubActions1.png differ diff --git a/docs/CROWDIN/ro/images/update/CI/GitHubActions2.png b/docs/CROWDIN/ro/images/update/CI/GitHubActions2.png new file mode 100644 index 000000000000..7b5c5a842d16 Binary files /dev/null and b/docs/CROWDIN/ro/images/update/CI/GitHubActions2.png differ diff --git a/docs/CROWDIN/ro/images/update/CI/GitHubActions3.png b/docs/CROWDIN/ro/images/update/CI/GitHubActions3.png new file mode 100644 index 000000000000..cff0ed34b214 Binary files /dev/null and b/docs/CROWDIN/ro/images/update/CI/GitHubActions3.png differ diff --git a/docs/CROWDIN/ro/images/update/CI/GitHubActions4.png b/docs/CROWDIN/ro/images/update/CI/GitHubActions4.png new file mode 100644 index 000000000000..bede3c2dfe08 Binary files /dev/null and b/docs/CROWDIN/ro/images/update/CI/GitHubActions4.png differ diff --git a/docs/CROWDIN/ro/images/update/CI/GitHubActions5.png b/docs/CROWDIN/ro/images/update/CI/GitHubActions5.png new file mode 100644 index 000000000000..d96e31cf084d Binary files /dev/null and b/docs/CROWDIN/ro/images/update/CI/GitHubActions5.png differ diff --git a/docs/CROWDIN/ro/images/update/CI/GitHubUpdate1.png b/docs/CROWDIN/ro/images/update/CI/GitHubUpdate1.png new file mode 100644 index 000000000000..3058dc270d28 Binary files /dev/null and b/docs/CROWDIN/ro/images/update/CI/GitHubUpdate1.png differ diff --git a/docs/CROWDIN/ro/images/update/CI/GitHubUpdate2.png b/docs/CROWDIN/ro/images/update/CI/GitHubUpdate2.png new file mode 100644 index 000000000000..1ae9568c8107 Binary files /dev/null and b/docs/CROWDIN/ro/images/update/CI/GitHubUpdate2.png differ diff --git a/docs/CROWDIN/ro/images/update/CI/GitHubUpdate3.png b/docs/CROWDIN/ro/images/update/CI/GitHubUpdate3.png new file mode 100644 index 000000000000..d18f9119c76d Binary files /dev/null and b/docs/CROWDIN/ro/images/update/CI/GitHubUpdate3.png differ diff --git a/docs/CROWDIN/ro/images/update/CI/GitHubUpdate4.png b/docs/CROWDIN/ro/images/update/CI/GitHubUpdate4.png new file mode 100644 index 000000000000..8c38c071cb8f Binary files /dev/null and b/docs/CROWDIN/ro/images/update/CI/GitHubUpdate4.png differ diff --git a/docs/CROWDIN/ro/images/update/CI/GitHubUpdate5.png b/docs/CROWDIN/ro/images/update/CI/GitHubUpdate5.png new file mode 100644 index 000000000000..409aef1f34dc Binary files /dev/null and b/docs/CROWDIN/ro/images/update/CI/GitHubUpdate5.png differ diff --git a/docs/CROWDIN/ro/index.md b/docs/CROWDIN/ro/index.md index d22fe12f061e..076e981a23b9 100644 --- a/docs/CROWDIN/ro/index.md +++ b/docs/CROWDIN/ro/index.md @@ -2,10 +2,10 @@ ![image](./images/basic-outline-of-AAPS.png) -```{admonition} Version 3.3 +```{admonition} Latest Release :class: note -29/12/2024 : Version 3.3 is out. Check the [Release Notes](#version3300) to see what's new and get update instructions. +14/08/2025 : Version 3.3.2.1 is out. Check the [Release Notes](#latestrelease) to see what's new and get update instructions. ``` @@ -21,7 +21,7 @@ Section **2) Getting Started**, the [Introduction](Getting-Started/Introduction. Now that you have a solid understanding of the process, you can start assembling your **AAPS** loop. -Section **3) Setting up AAPS** contains step-by-step instructions to do this. It covers choosing and [setting up your reporting server](./SettingUpAaps/SettingUpTheReportingServer.md) (Nightscout or Tidepool) so you can review and share your data, getting your computer ready for building the AAPS app, building the AAPS app and transferring the AAPS app to your phone. It also covers setting up the **AAPS** app using the setup Wizard, linking it with your CGM app, and either a real or virtual insulin pump, as well as linking **AAPS** to your reporting server. You are then slowly introduced to the full usage of what **AAPS** has to offer via a safe and carefully calibrated step-by-step process designed to make sure that you/your child are thoroughly familiar and comfortable navigating all the different levels and menu configurations before graduating on the next phase, commonly referred to as the next "Objective", until you are have enough experience to begin using the more advanced options available within the app. These Objectives are specially designed in such a way that will gradually unlock more possibilities of **AAPS** and switch from Open Loop to Closed Loop. +Section **3) Setting up AAPS** contains step-by-step instructions to do this. It covers choosing and [setting up your reporting server](./SettingUpAaps/SettingUpTheReportingServer.md) (Nightscout or Tidepool) so you can review and share your data, getting ready for building the AAPS app, building the AAPS app and transferring the AAPS app to your phone. It also covers setting up the **AAPS** app using the setup Wizard, linking it with your CGM app, and either a real or virtual insulin pump, as well as linking **AAPS** to your reporting server. You are then slowly introduced to the full usage of what **AAPS** has to offer via a safe and carefully calibrated step-by-step process designed to make sure that you/your child are thoroughly familiar and comfortable navigating all the different levels and menu configurations before graduating on the next phase, commonly referred to as the next "Objective", until you are have enough experience to begin using the more advanced options available within the app. These Objectives are specially designed in such a way that will gradually unlock more possibilities of **AAPS** and switch from Open Loop to Closed Loop. Section **4) Daily life with AAPS** covers key **AAPS** features, to help you use (and customise) **AAPS**. This including understanding the screens, carbs-on-board, sensitivity, profile switching, temp targets, extended carbs (or eCarbs), automations, and DynamicISF. It also covers frequent topics like how to manage different types of meals, how to deal with cannula and sensor changes, smartphone updates, daylight saving changes, and [travelling with AAPS](DailyLifeWithAaps/TimezoneTraveling-DaylightSavingTime.md) and sports. Common questions and answers are located within the troubleshooting section. diff --git a/docs/CROWDIN/ru/Maintenance/DocumentationUpdate.md b/docs/CROWDIN/ru/Maintenance/DocumentationUpdate.md index 2a7aba3e0326..6ea4c7063330 100644 --- a/docs/CROWDIN/ru/Maintenance/DocumentationUpdate.md +++ b/docs/CROWDIN/ru/Maintenance/DocumentationUpdate.md @@ -4,7 +4,7 @@ - Updated versions and Android Studio prerequisites - Added [3.3.2.1](#version3321) release, removed Android 16 references (fixed) -- Added [Browser Build](browser-build) @Angus +- Added [Browser Build](#browser-build) @Angus ## May 2025 diff --git a/docs/CROWDIN/ru/Maintenance/ReleaseNotes.md b/docs/CROWDIN/ru/Maintenance/ReleaseNotes.md index 005805480654..676cf4ec47b9 100644 --- a/docs/CROWDIN/ru/Maintenance/ReleaseNotes.md +++ b/docs/CROWDIN/ru/Maintenance/ReleaseNotes.md @@ -55,6 +55,8 @@ If your smartphone uses an Android Version older than Android 11 you will not be WearOS 5, API level 34 (Android 14) has [limitations](#BuildingAapsWearOs-WearOS5). ``` +(latestrelease)= + (version3321)= ## Version 3.3.2.1 diff --git a/docs/CROWDIN/ru/Maintenance/UpdateBrowserBuild.md b/docs/CROWDIN/ru/Maintenance/UpdateBrowserBuild.md new file mode 100644 index 000000000000..29bebb49a179 --- /dev/null +++ b/docs/CROWDIN/ru/Maintenance/UpdateBrowserBuild.md @@ -0,0 +1,101 @@ +# Update with a browser + +## Постройте сами вместо скачивания + +**AAPS** is not available to download, due to regulations concerning medical devices. Построить приложение для собственного использования вполне законно, но передавать копию другим не разрешается! See [FAQ page](../UsefulLinks/FAQ.md) for details. + +```{note} +In case you want to upgrade **AAPS** with a browser for the first time : copy your back-up keystore file to your Google Drive. Then follow the [Browser Build **AAPS** procedure](../SettingUpAaps/BrowserBuild.md) instead of this guide. Instead of creating a new keystore, you must select the one you have copied from your computer. +This operation will be mandatory only the first time, then for successive upgrades you will be able to follow this guide. +``` + +## Overview for updating to a new version of AAPS with a browser + +```{contents} Steps for updating to a new version of AAPS +:depth: 1 +:local: true +``` + +In case you experience problems, see separate page for [troubleshooting Android Studio](../GettingHelp/TroubleshootingAndroidStudio). + +### Export your settings + +Export your settings from the existing **AAPS** version on your phone. Возможно, это не потребуется, но лучше обезопасить себя, чем потом жалеть. + +See the [Export & import settings](ExportImportSettings.md) page if you don't remember how to do this. + +(Update-to-new-version-update-your-repo)= +### Update your GitHub repository + +```{admonition} WARNING +:class: warning +Browser Build is available from AAPS version 3.3.2.1. +``` + +[Log into GitHub](https://github.com/login). + +1. Select Repositories. +2. Scroll down and select your own AndroidAPS repository. + +![Select AndroidAPS repo](../images/update/CI/GitHubUpdate1.png) + +3. Verify you are using your own copy of AndroidAPS (Forked from nightscout/AndroidAPS) +4. Tap Sync Fork to update it (the number of commits behind might differ from the picture) + + + +![Sync AndroidAPS repo](../images/update/CI/GitHubUpdate2.png) + +5. Tap Update Branch + +![Update AndroidAPS repo](../images/update/CI/GitHubUpdate3.png) + +Note: if you have modified your copy of AndroidAPS by mistake, you will see this screen. Discard all changes (commits) to return to the released version. + +![Discard rogue modifications](../images/update/CI/GitHubUpdate4.png) + +You have now synchronized (updated) your own copy with the latest release of Android APS. Good job. + +![Repo sync'ed](../images/update/CI/GitHubUpdate5.png) + +### Run the Workflow to Build the Signed APK + +1. In your GitHub copy of AndroidAPS, select Actions. +2. Expand All Workflows. +3. Select AAPS-CI + +![Actions AAPS-CI](../images/update/CI/GitHubActions1.png) + +4. Scroll down and tap Run Workflow. + +![Run Workflow](../images/update/CI/GitHubActions2.png) + +5. Select the branch you want to deploy (master), the [variant](variant) (fullRelease) and tap Run Workflow. + + + +![Run Workflow](../images/update/CI/GitHubActions3.png) + +6. You will see the message Workflow run was successfully requested. Refresh your browser page and you will be able to monitor the build progress. When the action completes, the AAPS CI action will show a green tick mark. You have successfully built the updated version of Android APS. + +![Monitor Workflow](../images/update/CI/GitHubActions4.png) + +### Install the AAPS APK + +1. Open your Google Drive +2. Browse into AAPS, select the new version folder and you will find both the phone and Android Wear versions. + +![Google Drive Location](../images/update/CI/GitHubActions5.png) + + +Continue [here](#Update-to-new-version-check-aaps-version-on-phone) + +## Устранение неполадок + +Если что-то пойдёт не так, не паникуйте. + +Выдохните! + +Then see the [troubleshooting tips](#aaps-ci-preparation) if your problem is already documented! + +If you need further help, please reach out to other **AAPS** users on [Facebook](https://www.facebook.com/groups/AndroidAPSUsers) or [Discord](https://discord.gg/4fQUWHZ4Mw). \ No newline at end of file diff --git a/docs/CROWDIN/ru/Maintenance/UpdateComputerBuild.md b/docs/CROWDIN/ru/Maintenance/UpdateComputerBuild.md new file mode 100644 index 000000000000..fa4c94cb1b3a --- /dev/null +++ b/docs/CROWDIN/ru/Maintenance/UpdateComputerBuild.md @@ -0,0 +1,103 @@ +# Update with a computer + +## Постройте сами вместо скачивания + +**AAPS** is not available to download, due to regulations concerning medical devices. Построить приложение для собственного использования вполне законно, но передавать копию другим не разрешается! See [FAQ page](../UsefulLinks/FAQ.md) for details. + +```{note} +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 + +```{contents} Steps for updating to a new version of AAPS +:depth: 1 +:local: true +``` + +In case you experience problems, see separate page for [troubleshooting Android Studio](../GettingHelp/TroubleshootingAndroidStudio). + +### Export your settings + +Export your settings from the existing **AAPS** version on your phone. Возможно, это не потребуется, но лучше обезопасить себя, чем потом жалеть. + +See the [Export & import settings](ExportImportSettings.md) page if you don't remember how to do this. + +### Check your Android Studio version + +The minimal version required is described in the [Building Instructions](#Building-APK-recommended-specification-of-computer-for-building-apk-file). If your version is older, please [update Android Studio first](#Building-APK-install-android-studio)! + +(Update-to-new-version-update-your-local-copy)= +### Update your local copy + +```{admonition} WARNING +:class: warning +If you update from versions prior to 2.8.x, please follow the instructions to do a [New clone](../SettingUpAaps/BuildingAaps.md), as this guide will not work for you! +``` + +* Open your existing AAPS project with Android Studio. You might need to select your project. (Double) click on the AAPS project. + + ![Android Studio - Select Project](../images/update/01_ProjectSelection.png) + +* In the menu bar of Android Studio, select Git -> Fetch + + ![Android Studio Menu - Git - Fetch](../images/update/02_GitFetch.png) + +* You will see a message in the lower right corner that Fetch was successful. + + ![Android Studio Menu - Git - Fetch successful](../images/update/03_GitFetchSuccessful.png) + +* In the menu bar, now select Git -> Pull + + ![Android Studio Menu - Git - Pull](../images/update/04_GitPull.png) + +* Leave all options as they are (origin/master) and select Pull + + ![Android Studio - Git - Pull dialog](../images/update/05_GitPullOptions.png) + +* Wait while download is in progress, you will see this as info in the bottom bar. По окончании появится сообщение об успехе. + + ```{note} + The files that were updated may vary! This is not an indication + ``` + + ![Android Studio - Pull successful](../images/update/06_GitPullSuccess.png) + +* Gradle Sync will be running to download some dependencies. Дождитесь завершения процесса. + + ![Android Studio - Gradle Sync](../images/studioSetup/40_BackgroundTasks.png) + +### Check JVM version + +This check is particularly indicated if you have already built a previous version of **AAPS** on the same computer. + +Check in the [Building Instructions](#Building-APK-recommended-specification-of-computer-for-building-apk-file) the required version for JVM, matching the **AAPS** version you are now building. Then follow the steps described at [Incompatible Gradle JVM](#incompatible-gradle-jvm) to make sure you currently use the correct version. + +(Update-to-new-version-build-the-signed-apk)= +### Build the Signed APK + +Your sourcecode is now the current released version, and all prerequisites have been checked. It's time to build the signed apk as described in the [build signed apk section](#Building-APK-generate-signed-apk). + +(Update-to-new-version-transfer-and-install)= + +### Transfer and install the apk +You need to transfer the apk to your phone so you can install it. + +```{note} +If you completed the build with the same existing key store in Android Studio, then you do not need to remove the existing app on your phone. Когда вы устанавливаете apk, следуйте подсказкам для установки обновлений. +Для других сценариев, таких как создание нового хранилища ключей в Android Studio, нужно удалить старое приложение перед установкой apk. **Make sure to export your settings!** +``` + +See the instructions for [transferring and installing AAPS](../SettingUpAaps/TransferringAndInstallingAaps.md) + +Continue [here](#Update-to-new-version-check-aaps-version-on-phone). + +## Устранение неполадок + +Если что-то пойдёт не так, не паникуйте. + +Выдохните! + +Then see the separate page [troubleshooting Android Studio](../GettingHelp/TroubleshootingAndroidStudio) if your problem is already documented! + +If you need further help, please reach out to other **AAPS** users on [Facebook](https://www.facebook.com/groups/AndroidAPSUsers) or [Discord](https://discord.gg/4fQUWHZ4Mw). \ No newline at end of file diff --git a/docs/CROWDIN/ru/Maintenance/UpdateToNewVersion.md b/docs/CROWDIN/ru/Maintenance/UpdateToNewVersion.md index 38dae1cb1021..f038df9f4a7a 100644 --- a/docs/CROWDIN/ru/Maintenance/UpdateToNewVersion.md +++ b/docs/CROWDIN/ru/Maintenance/UpdateToNewVersion.md @@ -10,91 +10,14 @@ * Когда доступна новая версия, в самом приложении **AAPS** появляется информационный баннер об этом. * О новой версии также выходит объявление на Facebook во время релиза. * Following the release, please read the [Release Notes](ReleaseNotes.md) in detail, and clarify any queries with the community on Facebook or Discord, before proceeding with the update. - - ```{note} - 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. - ``` -## Обзор порядка обновления до новой версии AAPS +## Update AAPS with browser build -```{contents} Steps for updating to a new version of AAPS :depth: 1 :local: true +If you already built your AAPS app with the Browser Build method, follow [these instructions](./UpdateBrowserBuild.md). -
In case you experience problems, see separate page for [troubleshooting Android Studio](../GettingHelp/TroubleshootingAndroidStudio). - - ### Export your settings - - Export your settings from the existing **AAPS** version on your phone. Возможно, это не потребуется, но лучше обезопасить себя, чем потом жалеть. - - See the [Export & import settings](ExportImportSettings.md) page if you don't remember how to do this. - - ### Check your Android Studio version - - The minimal version required is described in the [Building Instructions](#Building-APK-recommended-specification-of-computer-for-building-apk-file). If your version is older, please [update Android Studio first](#Building-APK-install-android-studio)! - - (Update-to-new-version-update-your-local-copy)= - ### Update your local copy - - ```{admonition} WARNING - :class: warning - If you update from versions prior to 2.8.x, please follow the instructions to do a [New clone](../SettingUpAaps/BuildingAaps.md), as this guide will not work for you! - +## Update AAPS with a computer -* Open your existing AAPS project with Android Studio. You might need to select your project. (Double) click on the AAPS project. - - ![Android Studio - Select Project](../images/update/01_ProjectSelection.png) - -* In the menu bar of Android Studio, select Git -> Fetch - - ![Android Studio Menu - Git - Fetch](../images/update/02_GitFetch.png) - -* You will see a message in the lower right corner that Fetch was successful. - - ![Android Studio Menu - Git - Fetch successful](../images/update/03_GitFetchSuccessful.png) - -* In the menu bar, now select Git -> Pull - - ![Android Studio Menu - Git - Pull](../images/update/04_GitPull.png) - -* Leave all options as they are (origin/master) and select Pull - - ![Android Studio - Git - Pull dialog](../images/update/05_GitPullOptions.png) - -* Wait while download is in progress, you will see this as info in the bottom bar. По окончании появится сообщение об успехе. - - ```{note} - The files that were updated may vary! This is not an indication - ``` - - ![Android Studio - Pull successful](../images/update/06_GitPullSuccess.png) - -* Gradle Sync will be running to download some dependencies. Дождитесь завершения процесса. - - ![Android Studio - Gradle Sync](../images/studioSetup/40_BackgroundTasks.png) - -### Check JVM version - -This check is particularly indicated if you have already built a previous version of **AAPS** on the same computer. - -Check in the [Building Instructions](#Building-APK-recommended-specification-of-computer-for-building-apk-file) the required version for JVM, matching the **AAPS** version you are now building. Then follow the steps described at [Incompatible Gradle JVM](#incompatible-gradle-jvm) to make sure you currently use the correct version. - -(Update-to-new-version-build-the-signed-apk)= - -### Build the Signed APK - -Your sourcecode is now the current released version, and all prerequisites have been checked. It's time to build the signed apk as described in the [build signed apk section](#Building-APK-generate-signed-apk). - -(Update-to-new-version-transfer-and-install)= - -### Transfer and install the apk - -You need to transfer the apk to your phone so you can install it. - -```{note} -If you completed the build with the same existing key store in Android Studio, then you do not need to remove the existing app on your phone. Когда вы устанавливаете apk, следуйте подсказкам для установки обновлений. -Для других сценариев, таких как создание нового хранилища ключей в Android Studio, нужно удалить старое приложение перед установкой apk. **Make sure to export your settings!** -``` - -See the instructions for [transferring and installing AAPS](../SettingUpAaps/TransferringAndInstallingAaps.md) +Follow [these instructions.](./UpdateComputerBuild.md). (Update-to-new-version-check-aaps-version-on-phone)= @@ -104,14 +27,4 @@ See the instructions for [transferring and installing AAPS](../SettingUpAaps/Tra ![Установленная версия AAPS](../images/Update_VersionCheck.png) -Check in the [Release Notes](../Maintenance/ReleaseNotes.md) if there are any specific instructions after update. - -## Устранение неполадок - -Если что-то пойдёт не так, не паникуйте. - -Выдохните! - -Then see the separate page [troubleshooting Android Studio](../GettingHelp/TroubleshootingAndroidStudio) if your problem is already documented! - -:::{admonition} ПРЕДУПРЕЖДЕНИЕ :class: предупреждение Если вам нужна дальнейшая помощь, свяжитесь с другими пользователями **AAPS** на [Facebook](https://www.facebook.com/groups/AndroidAPSUsers), [Discord](https://discord.gg/4fQUWHZ4Mw) и т.п! \ No newline at end of file +Check in the [Release Notes](../Maintenance/ReleaseNotes.md) if there are any specific instructions after update. \ No newline at end of file diff --git a/docs/CROWDIN/ru/SettingUpAaps/BrowserBuild.md b/docs/CROWDIN/ru/SettingUpAaps/BrowserBuild.md index 37284a729d14..57daa6e8d72f 100644 --- a/docs/CROWDIN/ru/SettingUpAaps/BrowserBuild.md +++ b/docs/CROWDIN/ru/SettingUpAaps/BrowserBuild.md @@ -1,3 +1,5 @@ +(browser-build)= + # Browser build Building AAPS with GitHub Actions. diff --git a/docs/CROWDIN/ru/images/Building-the-App/CI/aaps_ci_simple_http_server.png b/docs/CROWDIN/ru/images/Building-the-App/CI/aaps_ci_simple_http_server.png index 95ac2d4eb443..2e2fb47e5ca2 100644 Binary files a/docs/CROWDIN/ru/images/Building-the-App/CI/aaps_ci_simple_http_server.png and b/docs/CROWDIN/ru/images/Building-the-App/CI/aaps_ci_simple_http_server.png differ diff --git a/docs/CROWDIN/ru/images/Building-the-App/CI/aaps_ci_simple_http_server_step1.png b/docs/CROWDIN/ru/images/Building-the-App/CI/aaps_ci_simple_http_server_step1.png index 78f52682b58d..b348162dcb1c 100644 Binary files a/docs/CROWDIN/ru/images/Building-the-App/CI/aaps_ci_simple_http_server_step1.png and b/docs/CROWDIN/ru/images/Building-the-App/CI/aaps_ci_simple_http_server_step1.png differ diff --git a/docs/CROWDIN/ru/images/Building-the-App/CI/aaps_ci_simple_http_server_step2.png b/docs/CROWDIN/ru/images/Building-the-App/CI/aaps_ci_simple_http_server_step2.png index c292ac667f63..cabadeefb97a 100644 Binary files a/docs/CROWDIN/ru/images/Building-the-App/CI/aaps_ci_simple_http_server_step2.png and b/docs/CROWDIN/ru/images/Building-the-App/CI/aaps_ci_simple_http_server_step2.png differ diff --git a/docs/CROWDIN/ru/images/Building-the-App/CI/aaps_ci_simple_http_server_step3.png b/docs/CROWDIN/ru/images/Building-the-App/CI/aaps_ci_simple_http_server_step3.png index bd31cd0ffb3d..9a26d3526369 100644 Binary files a/docs/CROWDIN/ru/images/Building-the-App/CI/aaps_ci_simple_http_server_step3.png and b/docs/CROWDIN/ru/images/Building-the-App/CI/aaps_ci_simple_http_server_step3.png differ diff --git a/docs/CROWDIN/ru/images/Building-the-App/CI/aaps_ci_simple_http_server_step4.png b/docs/CROWDIN/ru/images/Building-the-App/CI/aaps_ci_simple_http_server_step4.png index cc187ec72a14..285492424351 100644 Binary files a/docs/CROWDIN/ru/images/Building-the-App/CI/aaps_ci_simple_http_server_step4.png and b/docs/CROWDIN/ru/images/Building-the-App/CI/aaps_ci_simple_http_server_step4.png differ diff --git a/docs/CROWDIN/ru/images/Building-the-App/CI/aaps_ci_simple_http_server_store.png b/docs/CROWDIN/ru/images/Building-the-App/CI/aaps_ci_simple_http_server_store.png index 4b157ca8d3d8..65bf101f55e4 100644 Binary files a/docs/CROWDIN/ru/images/Building-the-App/CI/aaps_ci_simple_http_server_store.png and b/docs/CROWDIN/ru/images/Building-the-App/CI/aaps_ci_simple_http_server_store.png differ diff --git a/docs/CROWDIN/ru/images/update/CI/GitHubActions1.png b/docs/CROWDIN/ru/images/update/CI/GitHubActions1.png new file mode 100644 index 000000000000..e04ce6e76d8b Binary files /dev/null and b/docs/CROWDIN/ru/images/update/CI/GitHubActions1.png differ diff --git a/docs/CROWDIN/ru/images/update/CI/GitHubActions2.png b/docs/CROWDIN/ru/images/update/CI/GitHubActions2.png new file mode 100644 index 000000000000..7b5c5a842d16 Binary files /dev/null and b/docs/CROWDIN/ru/images/update/CI/GitHubActions2.png differ diff --git a/docs/CROWDIN/ru/images/update/CI/GitHubActions3.png b/docs/CROWDIN/ru/images/update/CI/GitHubActions3.png new file mode 100644 index 000000000000..cff0ed34b214 Binary files /dev/null and b/docs/CROWDIN/ru/images/update/CI/GitHubActions3.png differ diff --git a/docs/CROWDIN/ru/images/update/CI/GitHubActions4.png b/docs/CROWDIN/ru/images/update/CI/GitHubActions4.png new file mode 100644 index 000000000000..bede3c2dfe08 Binary files /dev/null and b/docs/CROWDIN/ru/images/update/CI/GitHubActions4.png differ diff --git a/docs/CROWDIN/ru/images/update/CI/GitHubActions5.png b/docs/CROWDIN/ru/images/update/CI/GitHubActions5.png new file mode 100644 index 000000000000..d96e31cf084d Binary files /dev/null and b/docs/CROWDIN/ru/images/update/CI/GitHubActions5.png differ diff --git a/docs/CROWDIN/ru/images/update/CI/GitHubUpdate1.png b/docs/CROWDIN/ru/images/update/CI/GitHubUpdate1.png new file mode 100644 index 000000000000..3058dc270d28 Binary files /dev/null and b/docs/CROWDIN/ru/images/update/CI/GitHubUpdate1.png differ diff --git a/docs/CROWDIN/ru/images/update/CI/GitHubUpdate2.png b/docs/CROWDIN/ru/images/update/CI/GitHubUpdate2.png new file mode 100644 index 000000000000..1ae9568c8107 Binary files /dev/null and b/docs/CROWDIN/ru/images/update/CI/GitHubUpdate2.png differ diff --git a/docs/CROWDIN/ru/images/update/CI/GitHubUpdate3.png b/docs/CROWDIN/ru/images/update/CI/GitHubUpdate3.png new file mode 100644 index 000000000000..d18f9119c76d Binary files /dev/null and b/docs/CROWDIN/ru/images/update/CI/GitHubUpdate3.png differ diff --git a/docs/CROWDIN/ru/images/update/CI/GitHubUpdate4.png b/docs/CROWDIN/ru/images/update/CI/GitHubUpdate4.png new file mode 100644 index 000000000000..8c38c071cb8f Binary files /dev/null and b/docs/CROWDIN/ru/images/update/CI/GitHubUpdate4.png differ diff --git a/docs/CROWDIN/ru/images/update/CI/GitHubUpdate5.png b/docs/CROWDIN/ru/images/update/CI/GitHubUpdate5.png new file mode 100644 index 000000000000..409aef1f34dc Binary files /dev/null and b/docs/CROWDIN/ru/images/update/CI/GitHubUpdate5.png differ diff --git a/docs/CROWDIN/ru/index.md b/docs/CROWDIN/ru/index.md index 97e307d9f56d..e4a6dd3d1380 100644 --- a/docs/CROWDIN/ru/index.md +++ b/docs/CROWDIN/ru/index.md @@ -2,10 +2,10 @@ ![изображение](./images/basic-outline-of-AAPS.png) -```{admonition} Version 3.3 +```{admonition} Latest Release :class: note -29/12/2024 : Version 3.3 is out. Check the [Release Notes](#version3300) to see what's new and get update instructions. +14/08/2025 : Version 3.3.2.1 is out. Check the [Release Notes](#latestrelease) to see what's new and get update instructions. ``` @@ -21,7 +21,7 @@ Android APS (**AAPS**) является приложением с открыты Теперь, когда у вас есть четкое понимание всего процесса, вы можете начать собирать свой цикл (петлю) на базе **AAPS**. -Раздел **3) Настройка AAPS** содержит пошаговые инструкции того, как это можно сделать. Он покрывает выбор и [настройку вашего сервера отчетов](./SettingUpAaps/SettingUpTheReportingServer.md) (Nightscout или Tidepool) для оценки и передачи своих показателей, подготовку вашего ПК к сборке приложения AAPS, саму его сборку и передачу установочного файла на ваш телефон. Так же он покрывает настройку приложения **AAPS** с помощью мастера установки, его связку с приложением вашего НМГ и либо реальной, либо виртуальной инсулиновой помпой, так же подключение **AAPS** к вашему серверу отчетов. Далее вам медленно будет представлена полная функциональность **AAPS** с помощью безопасного и хорошо отлаженного пошагового процесса, разработанного с целью убедиться в том, что вы или ваш ребенок хорошо ориентируетесь и разбираетесь во всех различных уровнях меню и настройках перед переходом к следующему этапу, часто именуемому следующей "Целью", вплоть до того момента, как у вас наберется достаточно опыта для использования более продвинутых настроек, доступных в программе. Данные цели специально разработаны таким образом, чтобы вы постепенно открывали все больше и больше возможностей **AAPS** и переключились с открытого цикла на замкнутый. +Раздел **3) Настройка AAPS** содержит пошаговые инструкции того, как это можно сделать. It covers choosing and [setting up your reporting server](./SettingUpAaps/SettingUpTheReportingServer.md) (Nightscout or Tidepool) so you can review and share your data, getting ready for building the AAPS app, building the AAPS app and transferring the AAPS app to your phone. Так же он покрывает настройку приложения **AAPS** с помощью мастера установки, его связку с приложением вашего НМГ и либо реальной, либо виртуальной инсулиновой помпой, так же подключение **AAPS** к вашему серверу отчетов. Далее вам медленно будет представлена полная функциональность **AAPS** с помощью безопасного и хорошо отлаженного пошагового процесса, разработанного с целью убедиться в том, что вы или ваш ребенок хорошо ориентируетесь и разбираетесь во всех различных уровнях меню и настройках перед переходом к следующему этапу, часто именуемому следующей "Целью", вплоть до того момента, как у вас наберется достаточно опыта для использования более продвинутых настроек, доступных в программе. Данные цели специально разработаны таким образом, чтобы вы постепенно открывали все больше и больше возможностей **AAPS** и переключились с открытого цикла на замкнутый. Раздел **4) Жизнь с AAPS** покрывает основные возможности **AAPS**, помогая с использованием (и настройкой) **AAPS**. В том числе понимание всех экранов, активных углеводов (англ: COB, carbs on board), чувствительности, смены профилей, временных целей, растянутых углеводов (англ: eCarbs), автоматизаций и DynamicISF (динамического фактора чувствительности к инсулину). Так же он отвечает на часто задаваемые вопросы по типу того, что делать с различными типами еды, как отрабатывать смену канюли или сенсора НМГ, что делать с обновлениями ПО на смартфоне, переходом на летнее время, как путешествовать и заниматься спортом с [AAPS](DailyLifeWithAaps/TimezoneTraveling-DaylightSavingTime.md). Частые вопросы и ответы на них находятся в секции "Решение проблем". diff --git a/docs/CROWDIN/sk/Maintenance/DocumentationUpdate.md b/docs/CROWDIN/sk/Maintenance/DocumentationUpdate.md index 84732e5a21a4..a087c255dd94 100644 --- a/docs/CROWDIN/sk/Maintenance/DocumentationUpdate.md +++ b/docs/CROWDIN/sk/Maintenance/DocumentationUpdate.md @@ -4,7 +4,7 @@ - Updated versions and Android Studio prerequisites - Added [3.3.2.1](#version3321) release, removed Android 16 references (fixed) -- Added [Browser Build](browser-build) @Angus +- Added [Browser Build](#browser-build) @Angus ## May 2025 diff --git a/docs/CROWDIN/sk/Maintenance/ReleaseNotes.md b/docs/CROWDIN/sk/Maintenance/ReleaseNotes.md index 7ba23eaa25d7..78534579cc99 100644 --- a/docs/CROWDIN/sk/Maintenance/ReleaseNotes.md +++ b/docs/CROWDIN/sk/Maintenance/ReleaseNotes.md @@ -55,6 +55,8 @@ In order to allow users with older Android to use older version of AAPS new vers WearOS 5, API level 34 (Android 14) has [limitations](#BuildingAapsWearOs-WearOS5). ``` +(latestrelease)= + (version3321)= ## Version 3.3.2.1 diff --git a/docs/CROWDIN/sk/Maintenance/UpdateBrowserBuild.md b/docs/CROWDIN/sk/Maintenance/UpdateBrowserBuild.md new file mode 100644 index 000000000000..6bfef1fe4e10 --- /dev/null +++ b/docs/CROWDIN/sk/Maintenance/UpdateBrowserBuild.md @@ -0,0 +1,101 @@ +# Update with a browser + +## Build yourself instead of download + +**AAPS** is not available to download, due to regulations concerning medical devices. It is legal to build the app for your own use, but you must not give a copy to others! See [FAQ page](../UsefulLinks/FAQ.md) for details. + +```{note} +In case you want to upgrade **AAPS** with a browser for the first time : copy your back-up keystore file to your Google Drive. Then follow the [Browser Build **AAPS** procedure](../SettingUpAaps/BrowserBuild.md) instead of this guide. Instead of creating a new keystore, you must select the one you have copied from your computer. +This operation will be mandatory only the first time, then for successive upgrades you will be able to follow this guide. +``` + +## Overview for updating to a new version of AAPS with a browser + +```{contents} Steps for updating to a new version of AAPS +:depth: 1 +:local: true +``` + +In case you experience problems, see separate page for [troubleshooting Android Studio](../GettingHelp/TroubleshootingAndroidStudio). + +### Export your settings + +Export your settings from the existing **AAPS** version on your phone. You might not need it, but better be safe than sorry. + +See the [Export & import settings](ExportImportSettings.md) page if you don't remember how to do this. + +(Update-to-new-version-update-your-repo)= +### Update your GitHub repository + +```{admonition} WARNING +:class: warning +Browser Build is available from AAPS version 3.3.2.1. +``` + +[Log into GitHub](https://github.com/login). + +1. Select Repositories. +2. Scroll down and select your own AndroidAPS repository. + +![Select AndroidAPS repo](../images/update/CI/GitHubUpdate1.png) + +3. Verify you are using your own copy of AndroidAPS (Forked from nightscout/AndroidAPS) +4. Tap Sync Fork to update it (the number of commits behind might differ from the picture) + + + +![Sync AndroidAPS repo](../images/update/CI/GitHubUpdate2.png) + +5. Tap Update Branch + +![Update AndroidAPS repo](../images/update/CI/GitHubUpdate3.png) + +Note: if you have modified your copy of AndroidAPS by mistake, you will see this screen. Discard all changes (commits) to return to the released version. + +![Discard rogue modifications](../images/update/CI/GitHubUpdate4.png) + +You have now synchronized (updated) your own copy with the latest release of Android APS. Good job. + +![Repo sync'ed](../images/update/CI/GitHubUpdate5.png) + +### Run the Workflow to Build the Signed APK + +1. In your GitHub copy of AndroidAPS, select Actions. +2. Expand All Workflows. +3. Select AAPS-CI + +![Actions AAPS-CI](../images/update/CI/GitHubActions1.png) + +4. Scroll down and tap Run Workflow. + +![Run Workflow](../images/update/CI/GitHubActions2.png) + +5. Select the branch you want to deploy (master), the [variant](variant) (fullRelease) and tap Run Workflow. + + + +![Run Workflow](../images/update/CI/GitHubActions3.png) + +6. You will see the message Workflow run was successfully requested. Refresh your browser page and you will be able to monitor the build progress. When the action completes, the AAPS CI action will show a green tick mark. You have successfully built the updated version of Android APS. + +![Monitor Workflow](../images/update/CI/GitHubActions4.png) + +### Install the AAPS APK + +1. Open your Google Drive +2. Browse into AAPS, select the new version folder and you will find both the phone and Android Wear versions. + +![Google Drive Location](../images/update/CI/GitHubActions5.png) + + +Continue [here](#Update-to-new-version-check-aaps-version-on-phone) + +## Troubleshooting + +If anything goes wrong, don't panic. + +Take a breath! + +Then see the [troubleshooting tips](#aaps-ci-preparation) if your problem is already documented! + +If you need further help, please reach out to other **AAPS** users on [Facebook](https://www.facebook.com/groups/AndroidAPSUsers) or [Discord](https://discord.gg/4fQUWHZ4Mw). \ No newline at end of file diff --git a/docs/CROWDIN/sk/Maintenance/UpdateComputerBuild.md b/docs/CROWDIN/sk/Maintenance/UpdateComputerBuild.md new file mode 100644 index 000000000000..6a55381526f5 --- /dev/null +++ b/docs/CROWDIN/sk/Maintenance/UpdateComputerBuild.md @@ -0,0 +1,103 @@ +# Update with a computer + +## Build yourself instead of download + +**AAPS** is not available to download, due to regulations concerning medical devices. It is legal to build the app for your own use, but you must not give a copy to others! See [FAQ page](../UsefulLinks/FAQ.md) for details. + +```{note} +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 + +```{contents} Steps for updating to a new version of AAPS +:depth: 1 +:local: true +``` + +In case you experience problems, see separate page for [troubleshooting Android Studio](../GettingHelp/TroubleshootingAndroidStudio). + +### Export your settings + +Export your settings from the existing **AAPS** version on your phone. You might not need it, but better be safe than sorry. + +See the [Export & import settings](ExportImportSettings.md) page if you don't remember how to do this. + +### Check your Android Studio version + +The minimal version required is described in the [Building Instructions](#Building-APK-recommended-specification-of-computer-for-building-apk-file). If your version is older, please [update Android Studio first](#Building-APK-install-android-studio)! + +(Update-to-new-version-update-your-local-copy)= +### Update your local copy + +```{admonition} WARNING +:class: warning +If you update from versions prior to 2.8.x, please follow the instructions to do a [New clone](../SettingUpAaps/BuildingAaps.md), as this guide will not work for you! +``` + +* Open your existing AAPS project with Android Studio. You might need to select your project. (Double) click on the AAPS project. + + ![Android Studio - Select Project](../images/update/01_ProjectSelection.png) + +* In the menu bar of Android Studio, select Git -> Fetch + + ![Android Studio Menu - Git - Fetch](../images/update/02_GitFetch.png) + +* You will see a message in the lower right corner that Fetch was successful. + + ![Android Studio Menu - Git - Fetch successful](../images/update/03_GitFetchSuccessful.png) + +* In the menu bar, now select Git -> Pull + + ![Android Studio Menu - Git - Pull](../images/update/04_GitPull.png) + +* Leave all options as they are (origin/master) and select Pull + + ![Android Studio - Git - Pull dialog](../images/update/05_GitPullOptions.png) + +* Wait while download is in progress, you will see this as info in the bottom bar. When it's done, you will see a success message. + + ```{note} + The files that were updated may vary! This is not an indication + ``` + + ![Android Studio - Pull successful](../images/update/06_GitPullSuccess.png) + +* Gradle Sync will be running to download some dependencies. Wait until it is finished. + + ![Android Studio - Gradle Sync](../images/studioSetup/40_BackgroundTasks.png) + +### Check JVM version + +This check is particularly indicated if you have already built a previous version of **AAPS** on the same computer. + +Check in the [Building Instructions](#Building-APK-recommended-specification-of-computer-for-building-apk-file) the required version for JVM, matching the **AAPS** version you are now building. Then follow the steps described at [Incompatible Gradle JVM](#incompatible-gradle-jvm) to make sure you currently use the correct version. + +(Update-to-new-version-build-the-signed-apk)= +### Build the Signed APK + +Your sourcecode is now the current released version, and all prerequisites have been checked. It's time to build the signed apk as described in the [build signed apk section](#Building-APK-generate-signed-apk). + +(Update-to-new-version-transfer-and-install)= + +### Transfer and install the apk +You need to transfer the apk to your phone so you can install it. + +```{note} +If you completed the build with the same existing key store in Android Studio, then you do not need to remove the existing app on your phone. When you install the apk, follow the prompts to install updates. +For other scenarios such as establishing a new key store in Android Studio for your signed apk, you will need to delete the old app before installing the apk. **Make sure to export your settings!** +``` + +See the instructions for [transferring and installing AAPS](../SettingUpAaps/TransferringAndInstallingAaps.md) + +Continue [here](#Update-to-new-version-check-aaps-version-on-phone). + +## Troubleshooting + +If anything goes wrong, don't panic. + +Take a breath! + +Then see the separate page [troubleshooting Android Studio](../GettingHelp/TroubleshootingAndroidStudio) if your problem is already documented! + +If you need further help, please reach out to other **AAPS** users on [Facebook](https://www.facebook.com/groups/AndroidAPSUsers) or [Discord](https://discord.gg/4fQUWHZ4Mw). \ No newline at end of file diff --git a/docs/CROWDIN/sk/Maintenance/UpdateToNewVersion.md b/docs/CROWDIN/sk/Maintenance/UpdateToNewVersion.md index d7eac798f670..e31ab758029f 100644 --- a/docs/CROWDIN/sk/Maintenance/UpdateToNewVersion.md +++ b/docs/CROWDIN/sk/Maintenance/UpdateToNewVersion.md @@ -10,91 +10,14 @@ * When a new release is available, in the **AAPS** app itself, you will receive an information banner about the new version. * The new version will also be announced on Facebook at the time of release. * Following the release, please read the [Release Notes](ReleaseNotes.md) in detail, and clarify any queries with the community on Facebook or Discord, before proceeding with the update. - - ```{note} - 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 +## Update AAPS with browser build -```{contents} Steps for updating to a new version of AAPS :depth: 1 :local: true +If you already built your AAPS app with the Browser Build method, follow [these instructions](./UpdateBrowserBuild.md). -
In case you experience problems, see separate page for [troubleshooting Android Studio](../GettingHelp/TroubleshootingAndroidStudio). - - ### Export your settings - - Export your settings from the existing **AAPS** version on your phone. You might not need it, but better be safe than sorry. - - See the [Export & import settings](ExportImportSettings.md) page if you don't remember how to do this. - - ### Check your Android Studio version - - The minimal version required is described in the [Building Instructions](#Building-APK-recommended-specification-of-computer-for-building-apk-file). If your version is older, please [update Android Studio first](#Building-APK-install-android-studio)! - - (Update-to-new-version-update-your-local-copy)= - ### Update your local copy - - ```{admonition} WARNING - :class: warning - If you update from versions prior to 2.8.x, please follow the instructions to do a [New clone](../SettingUpAaps/BuildingAaps.md), as this guide will not work for you! - +## Update AAPS with a computer -* Open your existing AAPS project with Android Studio. You might need to select your project. (Double) click on the AAPS project. - - ![Android Studio - Select Project](../images/update/01_ProjectSelection.png) - -* In the menu bar of Android Studio, select Git -> Fetch - - ![Android Studio Menu - Git - Fetch](../images/update/02_GitFetch.png) - -* You will see a message in the lower right corner that Fetch was successful. - - ![Android Studio Menu - Git - Fetch successful](../images/update/03_GitFetchSuccessful.png) - -* In the menu bar, now select Git -> Pull - - ![Android Studio Menu - Git - Pull](../images/update/04_GitPull.png) - -* Leave all options as they are (origin/master) and select Pull - - ![Android Studio - Git - Pull dialog](../images/update/05_GitPullOptions.png) - -* Wait while download is in progress, you will see this as info in the bottom bar. When it's done, you will see a success message. - - ```{note} - The files that were updated may vary! This is not an indication - ``` - - ![Android Studio - Pull successful](../images/update/06_GitPullSuccess.png) - -* Gradle Sync will be running to download some dependencies. Wait until it is finished. - - ![Android Studio - Gradle Sync](../images/studioSetup/40_BackgroundTasks.png) - -### Check JVM version - -This check is particularly indicated if you have already built a previous version of **AAPS** on the same computer. - -Check in the [Building Instructions](#Building-APK-recommended-specification-of-computer-for-building-apk-file) the required version for JVM, matching the **AAPS** version you are now building. Then follow the steps described at [Incompatible Gradle JVM](#incompatible-gradle-jvm) to make sure you currently use the correct version. - -(Update-to-new-version-build-the-signed-apk)= - -### Build the Signed APK - -Your sourcecode is now the current released version, and all prerequisites have been checked. It's time to build the signed apk as described in the [build signed apk section](#Building-APK-generate-signed-apk). - -(Update-to-new-version-transfer-and-install)= - -### Transfer and install the apk - -You need to transfer the apk to your phone so you can install it. - -```{note} -If you completed the build with the same existing key store in Android Studio, then you do not need to remove the existing app on your phone. When you install the apk, follow the prompts to install updates. -For other scenarios such as establishing a new key store in Android Studio for your signed apk, you will need to delete the old app before installing the apk. **Make sure to export your settings!** -``` - -See the instructions for [transferring and installing AAPS](../SettingUpAaps/TransferringAndInstallingAaps.md) +Follow [these instructions.](./UpdateComputerBuild.md). (Update-to-new-version-check-aaps-version-on-phone)= @@ -104,14 +27,4 @@ After you installed the new apk, you can check the AAPS version on your phone by ![AAPS version installed](../images/Update_VersionCheck.png) -Check in the [Release Notes](../Maintenance/ReleaseNotes.md) if there are any specific instructions after update. - -## Troubleshooting - -If anything goes wrong, don't panic. - -Take a breath! - -Then see the separate page [troubleshooting Android Studio](../GettingHelp/TroubleshootingAndroidStudio) if your problem is already documented! - -If you need further help, please reach out to other **AAPS** users on [Facebook](https://www.facebook.com/groups/AndroidAPSUsers) or [Discord](https://discord.gg/4fQUWHZ4Mw). \ No newline at end of file +Check in the [Release Notes](../Maintenance/ReleaseNotes.md) if there are any specific instructions after update. \ No newline at end of file diff --git a/docs/CROWDIN/sk/SettingUpAaps/BrowserBuild.md b/docs/CROWDIN/sk/SettingUpAaps/BrowserBuild.md index a3ad592f33dc..cef7e7098fd8 100644 --- a/docs/CROWDIN/sk/SettingUpAaps/BrowserBuild.md +++ b/docs/CROWDIN/sk/SettingUpAaps/BrowserBuild.md @@ -1,3 +1,5 @@ +(browser-build)= + # Browser build Building AAPS with GitHub Actions. diff --git a/docs/CROWDIN/sk/images/Building-the-App/CI/aaps_ci_simple_http_server.png b/docs/CROWDIN/sk/images/Building-the-App/CI/aaps_ci_simple_http_server.png index 95ac2d4eb443..2e2fb47e5ca2 100644 Binary files a/docs/CROWDIN/sk/images/Building-the-App/CI/aaps_ci_simple_http_server.png and b/docs/CROWDIN/sk/images/Building-the-App/CI/aaps_ci_simple_http_server.png differ diff --git a/docs/CROWDIN/sk/images/Building-the-App/CI/aaps_ci_simple_http_server_step1.png b/docs/CROWDIN/sk/images/Building-the-App/CI/aaps_ci_simple_http_server_step1.png index 78f52682b58d..b348162dcb1c 100644 Binary files a/docs/CROWDIN/sk/images/Building-the-App/CI/aaps_ci_simple_http_server_step1.png and b/docs/CROWDIN/sk/images/Building-the-App/CI/aaps_ci_simple_http_server_step1.png differ diff --git a/docs/CROWDIN/sk/images/Building-the-App/CI/aaps_ci_simple_http_server_step2.png b/docs/CROWDIN/sk/images/Building-the-App/CI/aaps_ci_simple_http_server_step2.png index c292ac667f63..cabadeefb97a 100644 Binary files a/docs/CROWDIN/sk/images/Building-the-App/CI/aaps_ci_simple_http_server_step2.png and b/docs/CROWDIN/sk/images/Building-the-App/CI/aaps_ci_simple_http_server_step2.png differ diff --git a/docs/CROWDIN/sk/images/Building-the-App/CI/aaps_ci_simple_http_server_step3.png b/docs/CROWDIN/sk/images/Building-the-App/CI/aaps_ci_simple_http_server_step3.png index bd31cd0ffb3d..9a26d3526369 100644 Binary files a/docs/CROWDIN/sk/images/Building-the-App/CI/aaps_ci_simple_http_server_step3.png and b/docs/CROWDIN/sk/images/Building-the-App/CI/aaps_ci_simple_http_server_step3.png differ diff --git a/docs/CROWDIN/sk/images/Building-the-App/CI/aaps_ci_simple_http_server_step4.png b/docs/CROWDIN/sk/images/Building-the-App/CI/aaps_ci_simple_http_server_step4.png index cc187ec72a14..285492424351 100644 Binary files a/docs/CROWDIN/sk/images/Building-the-App/CI/aaps_ci_simple_http_server_step4.png and b/docs/CROWDIN/sk/images/Building-the-App/CI/aaps_ci_simple_http_server_step4.png differ diff --git a/docs/CROWDIN/sk/images/Building-the-App/CI/aaps_ci_simple_http_server_store.png b/docs/CROWDIN/sk/images/Building-the-App/CI/aaps_ci_simple_http_server_store.png index 4b157ca8d3d8..65bf101f55e4 100644 Binary files a/docs/CROWDIN/sk/images/Building-the-App/CI/aaps_ci_simple_http_server_store.png and b/docs/CROWDIN/sk/images/Building-the-App/CI/aaps_ci_simple_http_server_store.png differ diff --git a/docs/CROWDIN/sk/images/update/CI/GitHubActions1.png b/docs/CROWDIN/sk/images/update/CI/GitHubActions1.png new file mode 100644 index 000000000000..e04ce6e76d8b Binary files /dev/null and b/docs/CROWDIN/sk/images/update/CI/GitHubActions1.png differ diff --git a/docs/CROWDIN/sk/images/update/CI/GitHubActions2.png b/docs/CROWDIN/sk/images/update/CI/GitHubActions2.png new file mode 100644 index 000000000000..7b5c5a842d16 Binary files /dev/null and b/docs/CROWDIN/sk/images/update/CI/GitHubActions2.png differ diff --git a/docs/CROWDIN/sk/images/update/CI/GitHubActions3.png b/docs/CROWDIN/sk/images/update/CI/GitHubActions3.png new file mode 100644 index 000000000000..cff0ed34b214 Binary files /dev/null and b/docs/CROWDIN/sk/images/update/CI/GitHubActions3.png differ diff --git a/docs/CROWDIN/sk/images/update/CI/GitHubActions4.png b/docs/CROWDIN/sk/images/update/CI/GitHubActions4.png new file mode 100644 index 000000000000..bede3c2dfe08 Binary files /dev/null and b/docs/CROWDIN/sk/images/update/CI/GitHubActions4.png differ diff --git a/docs/CROWDIN/sk/images/update/CI/GitHubActions5.png b/docs/CROWDIN/sk/images/update/CI/GitHubActions5.png new file mode 100644 index 000000000000..d96e31cf084d Binary files /dev/null and b/docs/CROWDIN/sk/images/update/CI/GitHubActions5.png differ diff --git a/docs/CROWDIN/sk/images/update/CI/GitHubUpdate1.png b/docs/CROWDIN/sk/images/update/CI/GitHubUpdate1.png new file mode 100644 index 000000000000..3058dc270d28 Binary files /dev/null and b/docs/CROWDIN/sk/images/update/CI/GitHubUpdate1.png differ diff --git a/docs/CROWDIN/sk/images/update/CI/GitHubUpdate2.png b/docs/CROWDIN/sk/images/update/CI/GitHubUpdate2.png new file mode 100644 index 000000000000..1ae9568c8107 Binary files /dev/null and b/docs/CROWDIN/sk/images/update/CI/GitHubUpdate2.png differ diff --git a/docs/CROWDIN/sk/images/update/CI/GitHubUpdate3.png b/docs/CROWDIN/sk/images/update/CI/GitHubUpdate3.png new file mode 100644 index 000000000000..d18f9119c76d Binary files /dev/null and b/docs/CROWDIN/sk/images/update/CI/GitHubUpdate3.png differ diff --git a/docs/CROWDIN/sk/images/update/CI/GitHubUpdate4.png b/docs/CROWDIN/sk/images/update/CI/GitHubUpdate4.png new file mode 100644 index 000000000000..8c38c071cb8f Binary files /dev/null and b/docs/CROWDIN/sk/images/update/CI/GitHubUpdate4.png differ diff --git a/docs/CROWDIN/sk/images/update/CI/GitHubUpdate5.png b/docs/CROWDIN/sk/images/update/CI/GitHubUpdate5.png new file mode 100644 index 000000000000..409aef1f34dc Binary files /dev/null and b/docs/CROWDIN/sk/images/update/CI/GitHubUpdate5.png differ diff --git a/docs/CROWDIN/sk/index.md b/docs/CROWDIN/sk/index.md index d22fe12f061e..076e981a23b9 100644 --- a/docs/CROWDIN/sk/index.md +++ b/docs/CROWDIN/sk/index.md @@ -2,10 +2,10 @@ ![image](./images/basic-outline-of-AAPS.png) -```{admonition} Version 3.3 +```{admonition} Latest Release :class: note -29/12/2024 : Version 3.3 is out. Check the [Release Notes](#version3300) to see what's new and get update instructions. +14/08/2025 : Version 3.3.2.1 is out. Check the [Release Notes](#latestrelease) to see what's new and get update instructions. ``` @@ -21,7 +21,7 @@ Section **2) Getting Started**, the [Introduction](Getting-Started/Introduction. Now that you have a solid understanding of the process, you can start assembling your **AAPS** loop. -Section **3) Setting up AAPS** contains step-by-step instructions to do this. It covers choosing and [setting up your reporting server](./SettingUpAaps/SettingUpTheReportingServer.md) (Nightscout or Tidepool) so you can review and share your data, getting your computer ready for building the AAPS app, building the AAPS app and transferring the AAPS app to your phone. It also covers setting up the **AAPS** app using the setup Wizard, linking it with your CGM app, and either a real or virtual insulin pump, as well as linking **AAPS** to your reporting server. You are then slowly introduced to the full usage of what **AAPS** has to offer via a safe and carefully calibrated step-by-step process designed to make sure that you/your child are thoroughly familiar and comfortable navigating all the different levels and menu configurations before graduating on the next phase, commonly referred to as the next "Objective", until you are have enough experience to begin using the more advanced options available within the app. These Objectives are specially designed in such a way that will gradually unlock more possibilities of **AAPS** and switch from Open Loop to Closed Loop. +Section **3) Setting up AAPS** contains step-by-step instructions to do this. It covers choosing and [setting up your reporting server](./SettingUpAaps/SettingUpTheReportingServer.md) (Nightscout or Tidepool) so you can review and share your data, getting ready for building the AAPS app, building the AAPS app and transferring the AAPS app to your phone. It also covers setting up the **AAPS** app using the setup Wizard, linking it with your CGM app, and either a real or virtual insulin pump, as well as linking **AAPS** to your reporting server. You are then slowly introduced to the full usage of what **AAPS** has to offer via a safe and carefully calibrated step-by-step process designed to make sure that you/your child are thoroughly familiar and comfortable navigating all the different levels and menu configurations before graduating on the next phase, commonly referred to as the next "Objective", until you are have enough experience to begin using the more advanced options available within the app. These Objectives are specially designed in such a way that will gradually unlock more possibilities of **AAPS** and switch from Open Loop to Closed Loop. Section **4) Daily life with AAPS** covers key **AAPS** features, to help you use (and customise) **AAPS**. This including understanding the screens, carbs-on-board, sensitivity, profile switching, temp targets, extended carbs (or eCarbs), automations, and DynamicISF. It also covers frequent topics like how to manage different types of meals, how to deal with cannula and sensor changes, smartphone updates, daylight saving changes, and [travelling with AAPS](DailyLifeWithAaps/TimezoneTraveling-DaylightSavingTime.md) and sports. Common questions and answers are located within the troubleshooting section. diff --git a/docs/CROWDIN/tr/Maintenance/DocumentationUpdate.md b/docs/CROWDIN/tr/Maintenance/DocumentationUpdate.md index 6a069df5d407..2fd70c30c5d2 100644 --- a/docs/CROWDIN/tr/Maintenance/DocumentationUpdate.md +++ b/docs/CROWDIN/tr/Maintenance/DocumentationUpdate.md @@ -4,7 +4,7 @@ - Updated versions and Android Studio prerequisites - Added [3.3.2.1](#version3321) release, removed Android 16 references (fixed) -- Added [Browser Build](browser-build) @Angus +- Added [Browser Build](#browser-build) @Angus ## May 2025 diff --git a/docs/CROWDIN/tr/Maintenance/ReleaseNotes.md b/docs/CROWDIN/tr/Maintenance/ReleaseNotes.md index d3ddf03063bf..852259b7967f 100644 --- a/docs/CROWDIN/tr/Maintenance/ReleaseNotes.md +++ b/docs/CROWDIN/tr/Maintenance/ReleaseNotes.md @@ -55,6 +55,8 @@ Daha eski Android'e sahip kullanıcıların AAPS'nin eski sürümünü kullanmas WearOS 5, API level 34 (Android 14) has [limitations](#BuildingAapsWearOs-WearOS5). ``` +(latestrelease)= + (version3321)= ## Version 3.3.2.1 diff --git a/docs/CROWDIN/tr/Maintenance/UpdateBrowserBuild.md b/docs/CROWDIN/tr/Maintenance/UpdateBrowserBuild.md new file mode 100644 index 000000000000..e37823d5e492 --- /dev/null +++ b/docs/CROWDIN/tr/Maintenance/UpdateBrowserBuild.md @@ -0,0 +1,101 @@ +# Update with a browser + +## Programı İndirmek yerine kendiniz oluşturun... + +**AAPS** is not available to download, due to regulations concerning medical devices. Uygulamayı kendi kullanımınız için oluşturmak yasaldır, ancak bir kopyasını başkasına vermemelisiniz! See [FAQ page](../UsefulLinks/FAQ.md) for details. + +```{note} +In case you want to upgrade **AAPS** with a browser for the first time : copy your back-up keystore file to your Google Drive. Then follow the [Browser Build **AAPS** procedure](../SettingUpAaps/BrowserBuild.md) instead of this guide. Instead of creating a new keystore, you must select the one you have copied from your computer. +This operation will be mandatory only the first time, then for successive upgrades you will be able to follow this guide. +``` + +## Overview for updating to a new version of AAPS with a browser + +```{contents} Steps for updating to a new version of AAPS +:depth: 1 +:local: true +``` + +In case you experience problems, see separate page for [troubleshooting Android Studio](../GettingHelp/TroubleshootingAndroidStudio). + +### Export your settings + +Export your settings from the existing **AAPS** version on your phone. You might not need it, but better be safe than sorry. + +See the [Export & import settings](ExportImportSettings.md) page if you don't remember how to do this. + +(Update-to-new-version-update-your-repo)= +### Update your GitHub repository + +```{admonition} WARNING +:class: warning +Browser Build is available from AAPS version 3.3.2.1. +``` + +[Log into GitHub](https://github.com/login). + +1. Select Repositories. +2. Scroll down and select your own AndroidAPS repository. + +![Select AndroidAPS repo](../images/update/CI/GitHubUpdate1.png) + +3. Verify you are using your own copy of AndroidAPS (Forked from nightscout/AndroidAPS) +4. Tap Sync Fork to update it (the number of commits behind might differ from the picture) + + + +![Sync AndroidAPS repo](../images/update/CI/GitHubUpdate2.png) + +5. Tap Update Branch + +![Update AndroidAPS repo](../images/update/CI/GitHubUpdate3.png) + +Note: if you have modified your copy of AndroidAPS by mistake, you will see this screen. Discard all changes (commits) to return to the released version. + +![Discard rogue modifications](../images/update/CI/GitHubUpdate4.png) + +You have now synchronized (updated) your own copy with the latest release of Android APS. Good job. + +![Repo sync'ed](../images/update/CI/GitHubUpdate5.png) + +### Run the Workflow to Build the Signed APK + +1. In your GitHub copy of AndroidAPS, select Actions. +2. Expand All Workflows. +3. Select AAPS-CI + +![Actions AAPS-CI](../images/update/CI/GitHubActions1.png) + +4. Scroll down and tap Run Workflow. + +![Run Workflow](../images/update/CI/GitHubActions2.png) + +5. Select the branch you want to deploy (master), the [variant](variant) (fullRelease) and tap Run Workflow. + + + +![Run Workflow](../images/update/CI/GitHubActions3.png) + +6. You will see the message Workflow run was successfully requested. Refresh your browser page and you will be able to monitor the build progress. When the action completes, the AAPS CI action will show a green tick mark. You have successfully built the updated version of Android APS. + +![Monitor Workflow](../images/update/CI/GitHubActions4.png) + +### Install the AAPS APK + +1. Open your Google Drive +2. Browse into AAPS, select the new version folder and you will find both the phone and Android Wear versions. + +![Google Drive Location](../images/update/CI/GitHubActions5.png) + + +Continue [here](#Update-to-new-version-check-aaps-version-on-phone) + +## Troubleshooting + +Bir şeyler ters giderse, panik yapmayın. + +Bir Nefes Alın! + +Then see the [troubleshooting tips](#aaps-ci-preparation) if your problem is already documented! + +If you need further help, please reach out to other **AAPS** users on [Facebook](https://www.facebook.com/groups/AndroidAPSUsers) or [Discord](https://discord.gg/4fQUWHZ4Mw). \ No newline at end of file diff --git a/docs/CROWDIN/tr/Maintenance/UpdateComputerBuild.md b/docs/CROWDIN/tr/Maintenance/UpdateComputerBuild.md new file mode 100644 index 000000000000..c3fb4aa8a63c --- /dev/null +++ b/docs/CROWDIN/tr/Maintenance/UpdateComputerBuild.md @@ -0,0 +1,103 @@ +# Update with a computer + +## Programı İndirmek yerine kendiniz oluşturun... + +**AAPS** is not available to download, due to regulations concerning medical devices. Uygulamayı kendi kullanımınız için oluşturmak yasaldır, ancak bir kopyasını başkasına vermemelisiniz! See [FAQ page](../UsefulLinks/FAQ.md) for details. + +```{note} +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 + +```{contents} Steps for updating to a new version of AAPS +:depth: 1 +:local: true +``` + +In case you experience problems, see separate page for [troubleshooting Android Studio](../GettingHelp/TroubleshootingAndroidStudio). + +### Export your settings + +Export your settings from the existing **AAPS** version on your phone. You might not need it, but better be safe than sorry. + +See the [Export & import settings](ExportImportSettings.md) page if you don't remember how to do this. + +### Check your Android Studio version + +The minimal version required is described in the [Building Instructions](#Building-APK-recommended-specification-of-computer-for-building-apk-file). If your version is older, please [update Android Studio first](#Building-APK-install-android-studio)! + +(Update-to-new-version-update-your-local-copy)= +### Update your local copy + +```{admonition} WARNING +:class: warning +If you update from versions prior to 2.8.x, please follow the instructions to do a [New clone](../SettingUpAaps/BuildingAaps.md), as this guide will not work for you! +``` + +* Open your existing AAPS project with Android Studio. You might need to select your project. (Double) click on the AAPS project. + + ![Android Studio - Select Project](../images/update/01_ProjectSelection.png) + +* In the menu bar of Android Studio, select Git -> Fetch + + ![Android Studio Menu - Git - Fetch](../images/update/02_GitFetch.png) + +* You will see a message in the lower right corner that Fetch was successful. + + ![Android Studio Menu - Git - Fetch successful](../images/update/03_GitFetchSuccessful.png) + +* In the menu bar, now select Git -> Pull + + ![Android Studio Menu - Git - Pull](../images/update/04_GitPull.png) + +* Leave all options as they are (origin/master) and select Pull + + ![Android Studio - Git - Pull dialog](../images/update/05_GitPullOptions.png) + +* Wait while download is in progress, you will see this as info in the bottom bar. Tamamlandığında, bir başarı mesajı göreceksiniz. + + ```{note} + The files that were updated may vary! This is not an indication + ``` + + ![Android Studio - Pull successful](../images/update/06_GitPullSuccess.png) + +* Gradle Sync will be running to download some dependencies. Tamamlanana kadar bekleyin. + + ![Android Studio - Gradle Sync](../images/studioSetup/40_BackgroundTasks.png) + +### Check JVM version + +This check is particularly indicated if you have already built a previous version of **AAPS** on the same computer. + +Check in the [Building Instructions](#Building-APK-recommended-specification-of-computer-for-building-apk-file) the required version for JVM, matching the **AAPS** version you are now building. Then follow the steps described at [Incompatible Gradle JVM](#incompatible-gradle-jvm) to make sure you currently use the correct version. + +(Update-to-new-version-build-the-signed-apk)= +### Build the Signed APK + +Your sourcecode is now the current released version, and all prerequisites have been checked. It's time to build the signed apk as described in the [build signed apk section](#Building-APK-generate-signed-apk). + +(Update-to-new-version-transfer-and-install)= + +### Transfer and install the apk +You need to transfer the apk to your phone so you can install it. + +```{note} +If you completed the build with the same existing key store in Android Studio, then you do not need to remove the existing app on your phone. Apk'yi kurduğunuzda, güncellemeleri yüklemek için talimatları izleyin. +Android Studio'da yeni bir anahtar deposu oluşturarak imzaladığınız apk senaryosu için, apk'yi yüklemeden önce eski uygulamayı silmeniz gerekecektir. **Make sure to export your settings!** +``` + +See the instructions for [transferring and installing AAPS](../SettingUpAaps/TransferringAndInstallingAaps.md) + +Continue [here](#Update-to-new-version-check-aaps-version-on-phone). + +## Troubleshooting + +Bir şeyler ters giderse, panik yapmayın. + +Bir Nefes Alın! + +Then see the separate page [troubleshooting Android Studio](../GettingHelp/TroubleshootingAndroidStudio) if your problem is already documented! + +If you need further help, please reach out to other **AAPS** users on [Facebook](https://www.facebook.com/groups/AndroidAPSUsers) or [Discord](https://discord.gg/4fQUWHZ4Mw). \ No newline at end of file diff --git a/docs/CROWDIN/tr/Maintenance/UpdateToNewVersion.md b/docs/CROWDIN/tr/Maintenance/UpdateToNewVersion.md index b221a062b1f4..853026cb7c51 100644 --- a/docs/CROWDIN/tr/Maintenance/UpdateToNewVersion.md +++ b/docs/CROWDIN/tr/Maintenance/UpdateToNewVersion.md @@ -10,91 +10,14 @@ * When a new release is available, in the **AAPS** app itself, you will receive an information banner about the new version. * The new version will also be announced on Facebook at the time of release. * Following the release, please read the [Release Notes](ReleaseNotes.md) in detail, and clarify any queries with the community on Facebook or Discord, before proceeding with the update. - - ```{note} - 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 +## Update AAPS with browser build -```{contents} Steps for updating to a new version of AAPS :depth: 1 :local: true +If you already built your AAPS app with the Browser Build method, follow [these instructions](./UpdateBrowserBuild.md). -
In case you experience problems, see separate page for [troubleshooting Android Studio](../GettingHelp/TroubleshootingAndroidStudio). - - ### Export your settings - - Export your settings from the existing **AAPS** version on your phone. You might not need it, but better be safe than sorry. - - See the [Export & import settings](ExportImportSettings.md) page if you don't remember how to do this. - - ### Check your Android Studio version - - The minimal version required is described in the [Building Instructions](#Building-APK-recommended-specification-of-computer-for-building-apk-file). If your version is older, please [update Android Studio first](#Building-APK-install-android-studio)! - - (Update-to-new-version-update-your-local-copy)= - ### Update your local copy - - ```{admonition} WARNING - :class: warning - If you update from versions prior to 2.8.x, please follow the instructions to do a [New clone](../SettingUpAaps/BuildingAaps.md), as this guide will not work for you! - +## Update AAPS with a computer -* Open your existing AAPS project with Android Studio. You might need to select your project. (Double) click on the AAPS project. - - ![Android Studio - Select Project](../images/update/01_ProjectSelection.png) - -* In the menu bar of Android Studio, select Git -> Fetch - - ![Android Studio Menu - Git - Fetch](../images/update/02_GitFetch.png) - -* You will see a message in the lower right corner that Fetch was successful. - - ![Android Studio Menu - Git - Fetch successful](../images/update/03_GitFetchSuccessful.png) - -* In the menu bar, now select Git -> Pull - - ![Android Studio Menu - Git - Pull](../images/update/04_GitPull.png) - -* Leave all options as they are (origin/master) and select Pull - - ![Android Studio - Git - Pull dialog](../images/update/05_GitPullOptions.png) - -* Wait while download is in progress, you will see this as info in the bottom bar. Tamamlandığında, bir başarı mesajı göreceksiniz. - - ```{note} - The files that were updated may vary! This is not an indication - ``` - - ![Android Studio - Pull successful](../images/update/06_GitPullSuccess.png) - -* Gradle Sync will be running to download some dependencies. Tamamlanana kadar bekleyin. - - ![Android Studio - Gradle Sync](../images/studioSetup/40_BackgroundTasks.png) - -### Check JVM version - -This check is particularly indicated if you have already built a previous version of **AAPS** on the same computer. - -Check in the [Building Instructions](#Building-APK-recommended-specification-of-computer-for-building-apk-file) the required version for JVM, matching the **AAPS** version you are now building. Then follow the steps described at [Incompatible Gradle JVM](#incompatible-gradle-jvm) to make sure you currently use the correct version. - -(Update-to-new-version-build-the-signed-apk)= - -### Build the Signed APK - -Your sourcecode is now the current released version, and all prerequisites have been checked. It's time to build the signed apk as described in the [build signed apk section](#Building-APK-generate-signed-apk). - -(Update-to-new-version-transfer-and-install)= - -### Transfer and install the apk - -You need to transfer the apk to your phone so you can install it. - -```{note} -If you completed the build with the same existing key store in Android Studio, then you do not need to remove the existing app on your phone. Apk'yi kurduğunuzda, güncellemeleri yüklemek için talimatları izleyin. -Android Studio'da yeni bir anahtar deposu oluşturarak imzaladığınız apk senaryosu için, apk'yi yüklemeden önce eski uygulamayı silmeniz gerekecektir. **Make sure to export your settings!** -``` - -See the instructions for [transferring and installing AAPS](../SettingUpAaps/TransferringAndInstallingAaps.md) +Follow [these instructions.](./UpdateComputerBuild.md). (Update-to-new-version-check-aaps-version-on-phone)= @@ -104,14 +27,4 @@ Yeni apk'yı yükledikten sonra, sağ üstteki üç nokta menüsüne ve ardında ![Yüklü AAPS sürümü](../images/Update_VersionCheck.png) -Check in the [Release Notes](../Maintenance/ReleaseNotes.md) if there are any specific instructions after update. - -## Troubleshooting - -Bir şeyler ters giderse, panik yapmayın. - -Bir Nefes Alın! - -Then see the separate page [troubleshooting Android Studio](../GettingHelp/TroubleshootingAndroidStudio) if your problem is already documented! - -If you need further help, please reach out to other **AAPS** users on [Facebook](https://www.facebook.com/groups/AndroidAPSUsers) or [Discord](https://discord.gg/4fQUWHZ4Mw). \ No newline at end of file +Check in the [Release Notes](../Maintenance/ReleaseNotes.md) if there are any specific instructions after update. \ No newline at end of file diff --git a/docs/CROWDIN/tr/SettingUpAaps/BrowserBuild.md b/docs/CROWDIN/tr/SettingUpAaps/BrowserBuild.md index aca228053b3e..e16fdd8c4f75 100644 --- a/docs/CROWDIN/tr/SettingUpAaps/BrowserBuild.md +++ b/docs/CROWDIN/tr/SettingUpAaps/BrowserBuild.md @@ -1,3 +1,5 @@ +(browser-build)= + # Browser build Building AAPS with GitHub Actions. diff --git a/docs/CROWDIN/tr/images/Building-the-App/CI/aaps_ci_simple_http_server.png b/docs/CROWDIN/tr/images/Building-the-App/CI/aaps_ci_simple_http_server.png index 95ac2d4eb443..2e2fb47e5ca2 100644 Binary files a/docs/CROWDIN/tr/images/Building-the-App/CI/aaps_ci_simple_http_server.png and b/docs/CROWDIN/tr/images/Building-the-App/CI/aaps_ci_simple_http_server.png differ diff --git a/docs/CROWDIN/tr/images/Building-the-App/CI/aaps_ci_simple_http_server_step1.png b/docs/CROWDIN/tr/images/Building-the-App/CI/aaps_ci_simple_http_server_step1.png index 78f52682b58d..b348162dcb1c 100644 Binary files a/docs/CROWDIN/tr/images/Building-the-App/CI/aaps_ci_simple_http_server_step1.png and b/docs/CROWDIN/tr/images/Building-the-App/CI/aaps_ci_simple_http_server_step1.png differ diff --git a/docs/CROWDIN/tr/images/Building-the-App/CI/aaps_ci_simple_http_server_step2.png b/docs/CROWDIN/tr/images/Building-the-App/CI/aaps_ci_simple_http_server_step2.png index c292ac667f63..cabadeefb97a 100644 Binary files a/docs/CROWDIN/tr/images/Building-the-App/CI/aaps_ci_simple_http_server_step2.png and b/docs/CROWDIN/tr/images/Building-the-App/CI/aaps_ci_simple_http_server_step2.png differ diff --git a/docs/CROWDIN/tr/images/Building-the-App/CI/aaps_ci_simple_http_server_step3.png b/docs/CROWDIN/tr/images/Building-the-App/CI/aaps_ci_simple_http_server_step3.png index bd31cd0ffb3d..9a26d3526369 100644 Binary files a/docs/CROWDIN/tr/images/Building-the-App/CI/aaps_ci_simple_http_server_step3.png and b/docs/CROWDIN/tr/images/Building-the-App/CI/aaps_ci_simple_http_server_step3.png differ diff --git a/docs/CROWDIN/tr/images/Building-the-App/CI/aaps_ci_simple_http_server_step4.png b/docs/CROWDIN/tr/images/Building-the-App/CI/aaps_ci_simple_http_server_step4.png index cc187ec72a14..285492424351 100644 Binary files a/docs/CROWDIN/tr/images/Building-the-App/CI/aaps_ci_simple_http_server_step4.png and b/docs/CROWDIN/tr/images/Building-the-App/CI/aaps_ci_simple_http_server_step4.png differ diff --git a/docs/CROWDIN/tr/images/Building-the-App/CI/aaps_ci_simple_http_server_store.png b/docs/CROWDIN/tr/images/Building-the-App/CI/aaps_ci_simple_http_server_store.png index 4b157ca8d3d8..65bf101f55e4 100644 Binary files a/docs/CROWDIN/tr/images/Building-the-App/CI/aaps_ci_simple_http_server_store.png and b/docs/CROWDIN/tr/images/Building-the-App/CI/aaps_ci_simple_http_server_store.png differ diff --git a/docs/CROWDIN/tr/images/update/CI/GitHubActions1.png b/docs/CROWDIN/tr/images/update/CI/GitHubActions1.png new file mode 100644 index 000000000000..e04ce6e76d8b Binary files /dev/null and b/docs/CROWDIN/tr/images/update/CI/GitHubActions1.png differ diff --git a/docs/CROWDIN/tr/images/update/CI/GitHubActions2.png b/docs/CROWDIN/tr/images/update/CI/GitHubActions2.png new file mode 100644 index 000000000000..7b5c5a842d16 Binary files /dev/null and b/docs/CROWDIN/tr/images/update/CI/GitHubActions2.png differ diff --git a/docs/CROWDIN/tr/images/update/CI/GitHubActions3.png b/docs/CROWDIN/tr/images/update/CI/GitHubActions3.png new file mode 100644 index 000000000000..cff0ed34b214 Binary files /dev/null and b/docs/CROWDIN/tr/images/update/CI/GitHubActions3.png differ diff --git a/docs/CROWDIN/tr/images/update/CI/GitHubActions4.png b/docs/CROWDIN/tr/images/update/CI/GitHubActions4.png new file mode 100644 index 000000000000..bede3c2dfe08 Binary files /dev/null and b/docs/CROWDIN/tr/images/update/CI/GitHubActions4.png differ diff --git a/docs/CROWDIN/tr/images/update/CI/GitHubActions5.png b/docs/CROWDIN/tr/images/update/CI/GitHubActions5.png new file mode 100644 index 000000000000..d96e31cf084d Binary files /dev/null and b/docs/CROWDIN/tr/images/update/CI/GitHubActions5.png differ diff --git a/docs/CROWDIN/tr/images/update/CI/GitHubUpdate1.png b/docs/CROWDIN/tr/images/update/CI/GitHubUpdate1.png new file mode 100644 index 000000000000..3058dc270d28 Binary files /dev/null and b/docs/CROWDIN/tr/images/update/CI/GitHubUpdate1.png differ diff --git a/docs/CROWDIN/tr/images/update/CI/GitHubUpdate2.png b/docs/CROWDIN/tr/images/update/CI/GitHubUpdate2.png new file mode 100644 index 000000000000..1ae9568c8107 Binary files /dev/null and b/docs/CROWDIN/tr/images/update/CI/GitHubUpdate2.png differ diff --git a/docs/CROWDIN/tr/images/update/CI/GitHubUpdate3.png b/docs/CROWDIN/tr/images/update/CI/GitHubUpdate3.png new file mode 100644 index 000000000000..d18f9119c76d Binary files /dev/null and b/docs/CROWDIN/tr/images/update/CI/GitHubUpdate3.png differ diff --git a/docs/CROWDIN/tr/images/update/CI/GitHubUpdate4.png b/docs/CROWDIN/tr/images/update/CI/GitHubUpdate4.png new file mode 100644 index 000000000000..8c38c071cb8f Binary files /dev/null and b/docs/CROWDIN/tr/images/update/CI/GitHubUpdate4.png differ diff --git a/docs/CROWDIN/tr/images/update/CI/GitHubUpdate5.png b/docs/CROWDIN/tr/images/update/CI/GitHubUpdate5.png new file mode 100644 index 000000000000..409aef1f34dc Binary files /dev/null and b/docs/CROWDIN/tr/images/update/CI/GitHubUpdate5.png differ diff --git a/docs/CROWDIN/tr/index.md b/docs/CROWDIN/tr/index.md index 83128699d658..f1cd18dcd201 100644 --- a/docs/CROWDIN/tr/index.md +++ b/docs/CROWDIN/tr/index.md @@ -2,10 +2,10 @@ ![image](./images/basic-outline-of-AAPS.png) -```{admonition} Version 3.3 +```{admonition} Latest Release :class: note -29/12/2024 : Version 3.3 is out. Check the [Release Notes](#version3300) to see what's new and get update instructions. +14/08/2025 : Version 3.3.2.1 is out. Check the [Release Notes](#latestrelease) to see what's new and get update instructions. ``` @@ -21,7 +21,7 @@ Section **2) Getting Started**, the [Introduction](Getting-Started/Introduction. Now that you have a solid understanding of the process, you can start assembling your **AAPS** loop. -Section **3) Setting up AAPS** contains step-by-step instructions to do this. It covers choosing and [setting up your reporting server](./SettingUpAaps/SettingUpTheReportingServer.md) (Nightscout or Tidepool) so you can review and share your data, getting your computer ready for building the AAPS app, building the AAPS app and transferring the AAPS app to your phone. It also covers setting up the **AAPS** app using the setup Wizard, linking it with your CGM app, and either a real or virtual insulin pump, as well as linking **AAPS** to your reporting server. You are then slowly introduced to the full usage of what **AAPS** has to offer via a safe and carefully calibrated step-by-step process designed to make sure that you/your child are thoroughly familiar and comfortable navigating all the different levels and menu configurations before graduating on the next phase, commonly referred to as the next "Objective", until you are have enough experience to begin using the more advanced options available within the app. These Objectives are specially designed in such a way that will gradually unlock more possibilities of **AAPS** and switch from Open Loop to Closed Loop. +Section **3) Setting up AAPS** contains step-by-step instructions to do this. It covers choosing and [setting up your reporting server](./SettingUpAaps/SettingUpTheReportingServer.md) (Nightscout or Tidepool) so you can review and share your data, getting ready for building the AAPS app, building the AAPS app and transferring the AAPS app to your phone. It also covers setting up the **AAPS** app using the setup Wizard, linking it with your CGM app, and either a real or virtual insulin pump, as well as linking **AAPS** to your reporting server. You are then slowly introduced to the full usage of what **AAPS** has to offer via a safe and carefully calibrated step-by-step process designed to make sure that you/your child are thoroughly familiar and comfortable navigating all the different levels and menu configurations before graduating on the next phase, commonly referred to as the next "Objective", until you are have enough experience to begin using the more advanced options available within the app. These Objectives are specially designed in such a way that will gradually unlock more possibilities of **AAPS** and switch from Open Loop to Closed Loop. Section **4) Daily life with AAPS** covers key **AAPS** features, to help you use (and customise) **AAPS**. This including understanding the screens, carbs-on-board, sensitivity, profile switching, temp targets, extended carbs (or eCarbs), automations, and DynamicISF. It also covers frequent topics like how to manage different types of meals, how to deal with cannula and sensor changes, smartphone updates, daylight saving changes, and [travelling with AAPS](DailyLifeWithAaps/TimezoneTraveling-DaylightSavingTime.md) and sports. Common questions and answers are located within the troubleshooting section. diff --git a/docs/CROWDIN/zh_CN/Maintenance/DocumentationUpdate.md b/docs/CROWDIN/zh_CN/Maintenance/DocumentationUpdate.md index 7a98f633a16e..5aa3ae34ccc9 100644 --- a/docs/CROWDIN/zh_CN/Maintenance/DocumentationUpdate.md +++ b/docs/CROWDIN/zh_CN/Maintenance/DocumentationUpdate.md @@ -4,7 +4,7 @@ - Updated versions and Android Studio prerequisites - Added [3.3.2.1](#version3321) release, removed Android 16 references (fixed) -- Added [Browser Build](browser-build) @Angus +- Added [Browser Build](#browser-build) @Angus ## 2025年5月 diff --git a/docs/CROWDIN/zh_CN/Maintenance/ReleaseNotes.md b/docs/CROWDIN/zh_CN/Maintenance/ReleaseNotes.md index ce741160db79..e0229ecd9a51 100644 --- a/docs/CROWDIN/zh_CN/Maintenance/ReleaseNotes.md +++ b/docs/CROWDIN/zh_CN/Maintenance/ReleaseNotes.md @@ -54,6 +54,8 @@ WearOS 5（API级别34，基于Android 14）存在[限制](#BuildingAapsWearOs-WearOS5)。 ``` +(latestrelease)= + (version3321)= ## Version 3.3.2.1 diff --git a/docs/CROWDIN/zh_CN/Maintenance/UpdateBrowserBuild.md b/docs/CROWDIN/zh_CN/Maintenance/UpdateBrowserBuild.md new file mode 100644 index 000000000000..99e5fd23a9e9 --- /dev/null +++ b/docs/CROWDIN/zh_CN/Maintenance/UpdateBrowserBuild.md @@ -0,0 +1,101 @@ +# Update with a browser + +## 自行构建而非下载 + +**AAPS** is not available to download, due to regulations concerning medical devices. 构建该应用供自己使用是合法的，但不得将副本提供给他人 详情请参阅[常见问题页面](../UsefulLinks/FAQ.md)。 + +```{note} +In case you want to upgrade **AAPS** with a browser for the first time : copy your back-up keystore file to your Google Drive. Then follow the [Browser Build **AAPS** procedure](../SettingUpAaps/BrowserBuild.md) instead of this guide. Instead of creating a new keystore, you must select the one you have copied from your computer. +This operation will be mandatory only the first time, then for successive upgrades you will be able to follow this guide. +``` + +## Overview for updating to a new version of AAPS with a browser + +```{contents} Steps for updating to a new version of AAPS +:depth: 1 +:local: true +``` + +In case you experience problems, see separate page for [troubleshooting Android Studio](../GettingHelp/TroubleshootingAndroidStudio). + +### Export your settings + +从手机现有**AAPS**版本导出设置。 您可能用不到它，但以防万一最好保存。 + +若忘记操作方法，请参阅[导出与导入设置](ExportImportSettings.md)。 + +(Update-to-new-version-update-your-repo)= +### Update your GitHub repository + +```{admonition} WARNING +:class: warning +Browser Build is available from AAPS version 3.3.2.1. +``` + +[Log into GitHub](https://github.com/login). + +1. Select Repositories. +2. Scroll down and select your own AndroidAPS repository. + +![Select AndroidAPS repo](../images/update/CI/GitHubUpdate1.png) + +3. Verify you are using your own copy of AndroidAPS (Forked from nightscout/AndroidAPS) +4. Tap Sync Fork to update it (the number of commits behind might differ from the picture) + + + +![Sync AndroidAPS repo](../images/update/CI/GitHubUpdate2.png) + +5. Tap Update Branch + +![Update AndroidAPS repo](../images/update/CI/GitHubUpdate3.png) + +Note: if you have modified your copy of AndroidAPS by mistake, you will see this screen. Discard all changes (commits) to return to the released version. + +![Discard rogue modifications](../images/update/CI/GitHubUpdate4.png) + +You have now synchronized (updated) your own copy with the latest release of Android APS. Good job. + +![Repo sync'ed](../images/update/CI/GitHubUpdate5.png) + +### Run the Workflow to Build the Signed APK + +1. In your GitHub copy of AndroidAPS, select Actions. +2. Expand All Workflows. +3. Select AAPS-CI + +![Actions AAPS-CI](../images/update/CI/GitHubActions1.png) + +4. Scroll down and tap Run Workflow. + +![Run Workflow](../images/update/CI/GitHubActions2.png) + +5. Select the branch you want to deploy (master), the [variant](variant) (fullRelease) and tap Run Workflow. + + + +![Run Workflow](../images/update/CI/GitHubActions3.png) + +6. You will see the message Workflow run was successfully requested. Refresh your browser page and you will be able to monitor the build progress. When the action completes, the AAPS CI action will show a green tick mark. You have successfully built the updated version of Android APS. + +![Monitor Workflow](../images/update/CI/GitHubActions4.png) + +### Install the AAPS APK + +1. Open your Google Drive +2. Browse into AAPS, select the new version folder and you will find both the phone and Android Wear versions. + +![Google Drive Location](../images/update/CI/GitHubActions5.png) + + +Continue [here](#Update-to-new-version-check-aaps-version-on-phone) + +## 故障排除 + +如果出现问题，请不要惊慌。 + +深呼吸！ + +Then see the [troubleshooting tips](#aaps-ci-preparation) if your problem is already documented! + +If you need further help, please reach out to other **AAPS** users on [Facebook](https://www.facebook.com/groups/AndroidAPSUsers) or [Discord](https://discord.gg/4fQUWHZ4Mw). \ No newline at end of file diff --git a/docs/CROWDIN/zh_CN/Maintenance/UpdateComputerBuild.md b/docs/CROWDIN/zh_CN/Maintenance/UpdateComputerBuild.md new file mode 100644 index 000000000000..f39c2e102589 --- /dev/null +++ b/docs/CROWDIN/zh_CN/Maintenance/UpdateComputerBuild.md @@ -0,0 +1,103 @@ +# Update with a computer + +## 自行构建而非下载 + +**AAPS** is not available to download, due to regulations concerning medical devices. 构建该应用供自己使用是合法的，但不得将副本提供给他人 详情请参阅[常见问题页面](../UsefulLinks/FAQ.md)。 + +```{note} +如果您想在新电脑上构建 **AAPS**：请将备份的密钥库文件复制到新电脑。 然后按照 [首次构建 **AAPS** 流程](../SettingUpAaps/BuildingAaps.md) 操作，而非本指南。 唯一区别在于您可以选择已复制的密钥库文件而无需新建。 +``` + +## Overview for updating to a new version of AAPS with a computer + +```{contents} Steps for updating to a new version of AAPS +:depth: 1 +:local: true +``` + +In case you experience problems, see separate page for [troubleshooting Android Studio](../GettingHelp/TroubleshootingAndroidStudio). + +### Export your settings + +从手机现有**AAPS**版本导出设置。 您可能用不到它，但以防万一最好保存。 + +若忘记操作方法，请参阅[导出与导入设置](ExportImportSettings.md)。 + +### Check your Android Studio version + +The minimal version required is described in the [Building Instructions](#Building-APK-recommended-specification-of-computer-for-building-apk-file). If your version is older, please [update Android Studio first](#Building-APK-install-android-studio)! + +(Update-to-new-version-update-your-local-copy)= +### Update your local copy + +```{admonition} WARNING +:class: warning +If you update from versions prior to 2.8.x, please follow the instructions to do a [New clone](../SettingUpAaps/BuildingAaps.md), as this guide will not work for you! +``` + +* 在 Android Studio 中打开现有的 AAPS 项目。 可能需要选择您的项目。 （双击）AAPS项目。 + + ![Android Studio - 选择项目](../images/update/01_ProjectSelection.png) + +* 在Android Studio菜单栏选择Git -> Fetch + + ![Android Studio 菜单 - Git - Fetch](../images/update/02_GitFetch.png) + +* 右下角会显示 Fetch 成功的消息。 + + ![Android Studio 菜单 - Git - Fetch 成功](../images/update/03_GitFetchSuccessful.png) + +* 在菜单栏选择Git -> Pull + + ![Android Studio 菜单 - Git - Pull](../images/update/04_GitPull.png) + +* 保持所有选项默认（origin/master）并点击 Pull + + ![Android Studio - Git - Pull 对话框](../images/update/05_GitPullOptions.png) + +* 等待下载完成，底部状态栏会显示进度。 完成后，会显示成功消息。 + + ```{note} + 更新的文件可能不同！ 这并不意味着有问题。 + ``` + + ![Android Studio - Pull 成功](../images/update/06_GitPullSuccess.png) + +* Gradle Sync 会自动运行以下载依赖项。 请等待它完成。 + + ![Android Studio - Gradle Sync](../images/studioSetup/40_BackgroundTasks.png) + +### 检查 JVM 版本 + +This check is particularly indicated if you have already built a previous version of **AAPS** on the same computer. + +Check in the [Building Instructions](#Building-APK-recommended-specification-of-computer-for-building-apk-file) the required version for JVM, matching the **AAPS** version you are now building. 然后按照[不兼容的 Gradle JVM](#incompatible-gradle-jvm)中的步骤确保当前使用正确版本。 + +(Update-to-new-version-build-the-signed-apk)= +### 构建签名 APK + +您的源代码现在是当前发布的版本，并且已检查所有前提条件。 请按 [构建签名 APK 章节](#Building-APK-generate-signed-apk) 的描述构建签名 APK。 + +(Update-to-new-version-transfer-and-install)= + +### 传输并安装 APK +需将 APK 传输至手机后进行安装。 + +```{note} +若您使用 Android Studio 中已有的密钥库完成构建，则无需删除手机上的现有应用。 安装APK时，按照提示安装更新。 +对于其他场景，例如在Android Studio中为您的签名APK建立新的密钥库，您需要在安装APK之前删除旧的应用程序。 **确保导出您的设置！** +``` + +具体操作请参考 [传输与安装 AAPS](../SettingUpAaps/TransferringAndInstallingAaps.md) 说明。 + +Continue [here](#Update-to-new-version-check-aaps-version-on-phone). + +## 故障排除 + +如果出现问题，请不要惊慌。 + +深呼吸！ + +若您的问题已有记录，请参考 [Android Studio 故障排除](../GettingHelp/TroubleshootingAndroidStudio) 页面！ + +If you need further help, please reach out to other **AAPS** users on [Facebook](https://www.facebook.com/groups/AndroidAPSUsers) or [Discord](https://discord.gg/4fQUWHZ4Mw). \ No newline at end of file diff --git a/docs/CROWDIN/zh_CN/Maintenance/UpdateToNewVersion.md b/docs/CROWDIN/zh_CN/Maintenance/UpdateToNewVersion.md index 6b4c49c8803f..7e8ff174fb02 100644 --- a/docs/CROWDIN/zh_CN/Maintenance/UpdateToNewVersion.md +++ b/docs/CROWDIN/zh_CN/Maintenance/UpdateToNewVersion.md @@ -9,91 +9,15 @@ * 当有新版本发布时，请尽快更新至最新版本的 **AAPS**。 * 当有新版本可用时，**AAPS** 应用内会显示新版本的信息横幅。 * 新版本发布时也会在 Facebook 上同步公告。 -* 更新前请仔细阅读 [版本说明](ReleaseNotes.md)，并通过 Facebook 或 Discord 与社区确认所有疑问。 - - ```{note} - 如果您想在新电脑上构建 **AAPS**：请将备份的密钥库文件复制到新电脑。 然后按照 [首次构建 **AAPS** 流程](../SettingUpAaps/BuildingAaps.md) 操作，而非本指南。 唯一区别在于您可以选择已复制的密钥库文件而无需新建。 - ``` +* Following the release, please read the [Release Notes](ReleaseNotes.md) in detail, and clarify any queries with the community on Facebook or Discord, before proceeding with the update. -## 更新至新版本 AAPS 的概览 +## Update AAPS with browser build -```{contents} 更新至新版本 AAPS 的步骤 :depth: 1 :local: true +If you already built your AAPS app with the Browser Build method, follow [these instructions](./UpdateBrowserBuild.md). -
如果遇到问题，请参阅[Android Studio故障排除]的单独页面(../GettingHelp/TroubleshootingAndroidStudio). - - ###导出您的设置 - - 从手机上的现有 **AAPS** 版本导出您的设置。 您可能用不到它，但以防万一最好保存。 - - 如果您不记得如何操作，请参阅[导出和导入设置](ExportImportSettings.md) 页面。 - - ###检查您的Android Studio版本 - - 最低版本要求请参阅 [构建说明](#Building-APK-recommended-specification-of-computer-for-building-apk-file). 如果您的版本较旧，请先 [更新Android Studio](#Building-APK-install-android-studio)! - - (Update-to-new-version-update-your-local-copy)= - ###更新您的本地副本 - ```{admonition}警告 - :class: 警告 - 如果您从2.8.x之前的版本更新，请按照[新克隆](../SettingUpAaps/BuildingAaps.md)的说明进行操作，因为本指南不适用于您！ - +## Update AAPS with a computer -* 在 Android Studio 中打开现有的 AAPS 项目。 可能需要选择您的项目。 （双击）AAPS项目。 - - ![Android Studio - 选择项目](../images/update/01_ProjectSelection.png) - -* 在 Android Studio 菜单栏选择 Git -> Fetch - - ![Android Studio 菜单 - Git - Fetch](../images/update/02_GitFetch.png) - -* 右下角会显示 Fetch 成功的消息。 - - ![Android Studio 菜单 - Git - Fetch 成功](../images/update/03_GitFetchSuccessful.png) - -* 在菜单栏选择 Git -> Pull - - ![Android Studio 菜单 - Git - Pull](../images/update/04_GitPull.png) - -* 保持所有选项默认（origin/master）并点击 Pull - - ![Android Studio - Git - Pull 对话框](../images/update/05_GitPullOptions.png) - -* 等待下载完成，底部状态栏会显示进度。 完成后，会显示成功消息。 - - ```{note} - 更新的文件可能不同！ 这并不意味着有问题。 - ``` - - ![Android Studio - Pull 成功](../images/update/06_GitPullSuccess.png) - -* Gradle Sync 会自动运行以下载依赖项。 请等待它完成。 - - ![Android Studio - Gradle Sync](../images/studioSetup/40_BackgroundTasks.png) - -### 检查 JVM 版本 - -若您曾在同一台电脑上构建过旧版 **AAPS**，此步骤尤为重要。 - -在 [构建说明](#Building-APK-recommended-specification-of-computer-for-building-apk-file) 中核对当前构建的 **AAPS** 版本所需的 JVM 版本。 然后按照[不兼容的 Gradle JVM](#incompatible-gradle-jvm)中的步骤确保当前使用正确版本。 - -(Update-to-new-version-build-the-signed-apk)= - -### 构建签名 APK - -您的源代码现在是当前发布的版本，并且已检查所有前提条件。 请按 [构建签名 APK 章节](#Building-APK-generate-signed-apk) 的描述构建签名 APK。 - -(Update-to-new-version-transfer-and-install)= - -### 传输并安装 APK - -需将 APK 传输至手机后进行安装。 - -```{note} -若您使用 Android Studio 中已有的密钥库完成构建，则无需删除手机上的现有应用。 安装APK时，按照提示安装更新。 -对于其他场景，例如在Android Studio中为您的签名APK建立新的密钥库，您需要在安装APK之前删除旧的应用程序。 **确保导出您的设置！** -``` - -具体操作请参考 [传输与安装 AAPS](../SettingUpAaps/TransferringAndInstallingAaps.md) 说明。 +Follow [these instructions.](./UpdateComputerBuild.md). (Update-to-new-version-check-aaps-version-on-phone)= @@ -103,14 +27,4 @@ ![已安装的 AAPS 版本](../images/Update_VersionCheck.png) -请查阅 [版本说明](../Maintenance/ReleaseNotes.md) 确认是否有更新后的特别注意事项。 - -## 故障排除 - -如果出现问题，请不要惊慌。 - -深呼吸！ - -若您的问题已有记录，请参考 [Android Studio 故障排除](../GettingHelp/TroubleshootingAndroidStudio) 页面！ - -如需更多帮助，请通过 [Facebook](https://www.facebook.com/groups/AndroidAPSUsers) 或 [Discord](https://discord.gg/4fQUWHZ4Mw) 联系其他 **AAPS** 用户。 \ No newline at end of file +请查阅 [版本说明](../Maintenance/ReleaseNotes.md) 确认是否有更新后的特别注意事项。 \ No newline at end of file diff --git a/docs/CROWDIN/zh_CN/SettingUpAaps/BrowserBuild.md b/docs/CROWDIN/zh_CN/SettingUpAaps/BrowserBuild.md index 82aa0f15d39d..e86fea03a2f9 100644 --- a/docs/CROWDIN/zh_CN/SettingUpAaps/BrowserBuild.md +++ b/docs/CROWDIN/zh_CN/SettingUpAaps/BrowserBuild.md @@ -1,3 +1,5 @@ +(browser-build)= + # Browser build Building AAPS with GitHub Actions. diff --git a/docs/CROWDIN/zh_CN/images/Building-the-App/CI/aaps_ci_simple_http_server.png b/docs/CROWDIN/zh_CN/images/Building-the-App/CI/aaps_ci_simple_http_server.png index 95ac2d4eb443..2e2fb47e5ca2 100644 Binary files a/docs/CROWDIN/zh_CN/images/Building-the-App/CI/aaps_ci_simple_http_server.png and b/docs/CROWDIN/zh_CN/images/Building-the-App/CI/aaps_ci_simple_http_server.png differ diff --git a/docs/CROWDIN/zh_CN/images/Building-the-App/CI/aaps_ci_simple_http_server_step1.png b/docs/CROWDIN/zh_CN/images/Building-the-App/CI/aaps_ci_simple_http_server_step1.png index 78f52682b58d..b348162dcb1c 100644 Binary files a/docs/CROWDIN/zh_CN/images/Building-the-App/CI/aaps_ci_simple_http_server_step1.png and b/docs/CROWDIN/zh_CN/images/Building-the-App/CI/aaps_ci_simple_http_server_step1.png differ diff --git a/docs/CROWDIN/zh_CN/images/Building-the-App/CI/aaps_ci_simple_http_server_step2.png b/docs/CROWDIN/zh_CN/images/Building-the-App/CI/aaps_ci_simple_http_server_step2.png index c292ac667f63..cabadeefb97a 100644 Binary files a/docs/CROWDIN/zh_CN/images/Building-the-App/CI/aaps_ci_simple_http_server_step2.png and b/docs/CROWDIN/zh_CN/images/Building-the-App/CI/aaps_ci_simple_http_server_step2.png differ diff --git a/docs/CROWDIN/zh_CN/images/Building-the-App/CI/aaps_ci_simple_http_server_step3.png b/docs/CROWDIN/zh_CN/images/Building-the-App/CI/aaps_ci_simple_http_server_step3.png index bd31cd0ffb3d..9a26d3526369 100644 Binary files a/docs/CROWDIN/zh_CN/images/Building-the-App/CI/aaps_ci_simple_http_server_step3.png and b/docs/CROWDIN/zh_CN/images/Building-the-App/CI/aaps_ci_simple_http_server_step3.png differ diff --git a/docs/CROWDIN/zh_CN/images/Building-the-App/CI/aaps_ci_simple_http_server_step4.png b/docs/CROWDIN/zh_CN/images/Building-the-App/CI/aaps_ci_simple_http_server_step4.png index cc187ec72a14..285492424351 100644 Binary files a/docs/CROWDIN/zh_CN/images/Building-the-App/CI/aaps_ci_simple_http_server_step4.png and b/docs/CROWDIN/zh_CN/images/Building-the-App/CI/aaps_ci_simple_http_server_step4.png differ diff --git a/docs/CROWDIN/zh_CN/images/Building-the-App/CI/aaps_ci_simple_http_server_store.png b/docs/CROWDIN/zh_CN/images/Building-the-App/CI/aaps_ci_simple_http_server_store.png index 4b157ca8d3d8..65bf101f55e4 100644 Binary files a/docs/CROWDIN/zh_CN/images/Building-the-App/CI/aaps_ci_simple_http_server_store.png and b/docs/CROWDIN/zh_CN/images/Building-the-App/CI/aaps_ci_simple_http_server_store.png differ diff --git a/docs/CROWDIN/zh_CN/images/update/CI/GitHubActions1.png b/docs/CROWDIN/zh_CN/images/update/CI/GitHubActions1.png new file mode 100644 index 000000000000..e04ce6e76d8b Binary files /dev/null and b/docs/CROWDIN/zh_CN/images/update/CI/GitHubActions1.png differ diff --git a/docs/CROWDIN/zh_CN/images/update/CI/GitHubActions2.png b/docs/CROWDIN/zh_CN/images/update/CI/GitHubActions2.png new file mode 100644 index 000000000000..7b5c5a842d16 Binary files /dev/null and b/docs/CROWDIN/zh_CN/images/update/CI/GitHubActions2.png differ diff --git a/docs/CROWDIN/zh_CN/images/update/CI/GitHubActions3.png b/docs/CROWDIN/zh_CN/images/update/CI/GitHubActions3.png new file mode 100644 index 000000000000..cff0ed34b214 Binary files /dev/null and b/docs/CROWDIN/zh_CN/images/update/CI/GitHubActions3.png differ diff --git a/docs/CROWDIN/zh_CN/images/update/CI/GitHubActions4.png b/docs/CROWDIN/zh_CN/images/update/CI/GitHubActions4.png new file mode 100644 index 000000000000..bede3c2dfe08 Binary files /dev/null and b/docs/CROWDIN/zh_CN/images/update/CI/GitHubActions4.png differ diff --git a/docs/CROWDIN/zh_CN/images/update/CI/GitHubActions5.png b/docs/CROWDIN/zh_CN/images/update/CI/GitHubActions5.png new file mode 100644 index 000000000000..d96e31cf084d Binary files /dev/null and b/docs/CROWDIN/zh_CN/images/update/CI/GitHubActions5.png differ diff --git a/docs/CROWDIN/zh_CN/images/update/CI/GitHubUpdate1.png b/docs/CROWDIN/zh_CN/images/update/CI/GitHubUpdate1.png new file mode 100644 index 000000000000..3058dc270d28 Binary files /dev/null and b/docs/CROWDIN/zh_CN/images/update/CI/GitHubUpdate1.png differ diff --git a/docs/CROWDIN/zh_CN/images/update/CI/GitHubUpdate2.png b/docs/CROWDIN/zh_CN/images/update/CI/GitHubUpdate2.png new file mode 100644 index 000000000000..1ae9568c8107 Binary files /dev/null and b/docs/CROWDIN/zh_CN/images/update/CI/GitHubUpdate2.png differ diff --git a/docs/CROWDIN/zh_CN/images/update/CI/GitHubUpdate3.png b/docs/CROWDIN/zh_CN/images/update/CI/GitHubUpdate3.png new file mode 100644 index 000000000000..d18f9119c76d Binary files /dev/null and b/docs/CROWDIN/zh_CN/images/update/CI/GitHubUpdate3.png differ diff --git a/docs/CROWDIN/zh_CN/images/update/CI/GitHubUpdate4.png b/docs/CROWDIN/zh_CN/images/update/CI/GitHubUpdate4.png new file mode 100644 index 000000000000..8c38c071cb8f Binary files /dev/null and b/docs/CROWDIN/zh_CN/images/update/CI/GitHubUpdate4.png differ diff --git a/docs/CROWDIN/zh_CN/images/update/CI/GitHubUpdate5.png b/docs/CROWDIN/zh_CN/images/update/CI/GitHubUpdate5.png new file mode 100644 index 000000000000..409aef1f34dc Binary files /dev/null and b/docs/CROWDIN/zh_CN/images/update/CI/GitHubUpdate5.png differ diff --git a/docs/CROWDIN/zh_CN/index.md b/docs/CROWDIN/zh_CN/index.md index 97a8dc8a0830..9ea680972652 100644 --- a/docs/CROWDIN/zh_CN/index.md +++ b/docs/CROWDIN/zh_CN/index.md @@ -2,10 +2,10 @@ ![image](./images/basic-outline-of-AAPS.png) -```{admonition} Version 3.3 +```{admonition} Latest Release :class: note -29/12/2024 : 3.3版本发布. 查看[发行说明](#version3300)以了解新功能并获取更新说明。 +14/08/2025 : Version 3.3.2.1 is out. Check the [Release Notes](#latestrelease) to see what's new and get update instructions. ``` @@ -21,7 +21,7 @@ Android APS (**AAPS**) 是一个开放源码的安卓应用程序，适用于糖 现在，您已充分了解整个流程，可以开始组建您的**AAPS**闭环系统了。 -第3节**设置AAPS** 包含具体的分步操作说明。 包括选择和[配置远程数据服务器](./SettingUpAaps/SettingUpTheReportingServer.md)（Nightscout或Tidepool），以便您可以查看和分享数据，准备好电脑以构建AAPS应用程序，构建（build）AAPS应用程序并将其传输到手机上。 同时指导您通过“设置向导”来完成 **AAPS** 应用的初始化配置，将其与动态血糖仪（CGM）应用及真实/虚拟胰岛素泵进行联动，并将 **AAPS** 连接到您的远程数据服务器。 接下来，您将通过一个安全审慎的分阶段训练流程，一步一步地掌握**AAPS**的全部功能，该流程旨在确保您/您的孩子能完全熟悉并熟练操作所有不同层级的功能和菜单设置，然后才进入下一阶段（AAPS界面上称之为"目标（Objectives）"）。 这些目标（Objectives）都经过专门的设计，将循序渐进地解锁**AAPS**更多可能性，最终实现从开环模式向闭环模式的过渡。 +第3节**设置AAPS** 包含具体的分步操作说明。 It covers choosing and [setting up your reporting server](./SettingUpAaps/SettingUpTheReportingServer.md) (Nightscout or Tidepool) so you can review and share your data, getting ready for building the AAPS app, building the AAPS app and transferring the AAPS app to your phone. 同时指导您通过“设置向导”来完成 **AAPS** 应用的初始化配置，将其与动态血糖仪（CGM）应用及真实/虚拟胰岛素泵进行联动，并将 **AAPS** 连接到您的远程数据服务器。 接下来，您将通过一个安全审慎的分阶段训练流程，一步一步地掌握**AAPS**的全部功能，该流程旨在确保您/您的孩子能完全熟悉并熟练操作所有不同层级的功能和菜单设置，然后才进入下一阶段（AAPS界面上称之为"目标（Objectives）"）。 这些目标（Objectives）都经过专门的设计，将循序渐进地解锁**AAPS**更多可能性，最终实现从开环模式向闭环模式的过渡。 第4节**AAPS的日常** 涵盖 **AAPS** 的关键功能，帮助您使用（和自定义）**AAPS**。 内容包括理解操作界面、活性碳水（COB，carbs-on-board）、敏感度、配置文件（profile）切换、临时目标（TT，temp targets）、扩展碳水（extended carbs，eCarbs）、自动化规则（automations）和动态ISF（DynamicISF）。 同时涉及常见主题，例如如何管理不同类型的餐食、处理管路（cannula）与探头（sensor）更换、智能手机更新、夏令时调整、[使用AAPS旅行](DailyLifeWithAaps/TimezoneTraveling-DaylightSavingTime.md)及运动场景。 常见问答详见故障排查章节。 diff --git a/docs/CROWDIN/zh_TW/Maintenance/DocumentationUpdate.md b/docs/CROWDIN/zh_TW/Maintenance/DocumentationUpdate.md index 092b5c693a10..62e20a432b28 100644 --- a/docs/CROWDIN/zh_TW/Maintenance/DocumentationUpdate.md +++ b/docs/CROWDIN/zh_TW/Maintenance/DocumentationUpdate.md @@ -4,7 +4,7 @@ - 已更新版本和 Android Studio 的前置需求 - 新增 [3.3.2.1](#version3321) 版本，移除 Android 16 參考 (已修正) -- 新增 [瀏覽器版](browser-build) @Angus +- 新增 [瀏覽器版](#browser-build) @Angus ## 2025年5月 diff --git a/docs/CROWDIN/zh_TW/Maintenance/ReleaseNotes.md b/docs/CROWDIN/zh_TW/Maintenance/ReleaseNotes.md index 39a1121614d4..94483bc05885 100644 --- a/docs/CROWDIN/zh_TW/Maintenance/ReleaseNotes.md +++ b/docs/CROWDIN/zh_TW/Maintenance/ReleaseNotes.md @@ -55,6 +55,8 @@ WearOS 5, API 等級 34 (Android 14) 有[限制](#BuildingAapsWearOs-WearOS5)。 ``` +(latestrelease)= + (version3321)= ## 版本 3.3.2.1 diff --git a/docs/CROWDIN/zh_TW/Maintenance/UpdateBrowserBuild.md b/docs/CROWDIN/zh_TW/Maintenance/UpdateBrowserBuild.md new file mode 100644 index 000000000000..50f0c7ad6109 --- /dev/null +++ b/docs/CROWDIN/zh_TW/Maintenance/UpdateBrowserBuild.md @@ -0,0 +1,101 @@ +# 使用瀏覽器更新 + +## 自行建置，而不是下載 + +**AAPS** 無法下載，因為這涉及醫療設備的法規。 自行建置應用程式以供個人使用是合法的，但你不得將副本提供給他人！ 詳細資訊請參閱 [FAQ 頁面](../UsefulLinks/FAQ.md)。 + +```{note} +如果你想第一次使用瀏覽器升級 **AAPS** : 請將你的備份金鑰檔案複製到你的 Google 雲端硬碟。 然後請遵循 [瀏覽器版本 **AAPS** 程序](../SettingUpAaps/BrowserBuild.md) 而不是本指南。 與其建立新的金鑰庫，更好的方法，是選擇你電腦中現有的。 +這個操作僅在第一次時才需要，之後的升級可以遵循這個指南。 +``` + +## 更新 AAPS 新版本的總覽 + +```{contents} Steps for updating to a new version of AAPS +:depth: 1 +:local: true +``` + +如果您遇到問題，請參見單獨的[問題排除Android Studio](../GettingHelp/TroubleshootingAndroidStudio)頁面。 + +### 匯出你的設定 + +從您手機上現有的 **AAPS** 版本匯出您的設定。 你可能不需要這樣做，但防患於未然更好。 + +如果您忘記如何做，請參見[匯出與匯入設定](ExportImportSettings.md)頁面。 + +(Update-to-new-version-update-your-repo)= +### 更新你的 GitHub 儲存庫 + +```{admonition} WARNING +:class: warning +從 AAPS 版本 3.3.2.1 起，瀏覽器建置已釋出。 +``` + +[登入 GitHub](https://github.com/login)。 + +1. 選擇儲存庫。 +2. 向下滾動並選擇你自己的 AndroidAPS 儲存庫。 + +![選擇 AndroidAPS 儲存庫](../images/update/CI/GitHubUpdate1.png) + +3. 確保你使用的是自己複製的 AndroidAPS 版本（從 nightscout/AndroidAPS 分支出來的） +4. 點擊同步分支以更新它（提交的數量可能與圖片不同） + + + +![同步 AndroidAPS 儲存庫](../images/update/CI/GitHubUpdate2.png) + +5. 點擊更新分支 + +![更新 AndroidAPS 儲存庫](../images/update/CI/GitHubUpdate3.png) + +注意：如果你不小心修改了自己複製的 AndroidAPS，將會看到此畫面。 放棄所有更改（提交）以便恢復到官方版本。 + +![放棄修改](../images/update/CI/GitHubUpdate4.png) + +你現在已經將自己的複製版本與 AndroidAPS 的最新發布同步（更新）了。 做得很好。 + +![儲存庫已同步](../images/update/CI/GitHubUpdate5.png) + +### 執行工作流程，以建置簽名的 APK + +1. 在你的 GitHub 複製版 AndroidAPS 中，選擇操作。 +2. 擴展所有工作流程。 +3. 選擇 AAPS-CI + +![操作 AAPS-CI](../images/update/CI/GitHubActions1.png) + +4. 向下滾動並點擊運行工作流程。 + +![運行工作流程](../images/update/CI/GitHubActions2.png) + +5. 選擇你想要部署的分支（主分支）、[版本](variant)（fullRelease）並點擊運行工作流程。 + + + +![運行工作流程](../images/update/CI/GitHubActions3.png) + +6. 你將會看到工作流程運行成功請求的訊息。 重新整理你的瀏覽器頁面，你將能夠監控建置進度。 當操作完成時，AAPS CI 的行動將顯示綠色勾選標記。 你已成功建置 AndroidAPS 的更新版本。 + +![監控工作流程](../images/update/CI/GitHubActions4.png) + +### 安裝 AAPS APK + +1. 打開你的 Google 雲端硬碟 +2. 瀏覽到 AAPS，選擇新版本資料夾，你會找到手機版和 Android Wear 版本。 + +![Google 雲端硬碟位置](../images/update/CI/GitHubActions5.png) + + +繼續 [這裡](#Update-to-new-version-check-aaps-version-on-phone) + +## 問題排除 + +如果發生任何錯誤，不要慌張。 + +先深呼吸！ + +然後如果你的問題已經有文檔，請參閱 [問題排除](#aaps-ci-preparation)！ + +如果你需要進一步幫助，請聯繫其他**AAPS**使用者，透過[Facebook](https://www.facebook.com/groups/AndroidAPSUsers)或[Discord](https://discord.gg/4fQUWHZ4Mw)。 \ No newline at end of file diff --git a/docs/CROWDIN/zh_TW/Maintenance/UpdateComputerBuild.md b/docs/CROWDIN/zh_TW/Maintenance/UpdateComputerBuild.md new file mode 100644 index 000000000000..04cecde9d0db --- /dev/null +++ b/docs/CROWDIN/zh_TW/Maintenance/UpdateComputerBuild.md @@ -0,0 +1,103 @@ +# 透過電腦進行更新 + +## 自行建置，而不是下載 + +**AAPS** 無法下載，因為這涉及醫療設備的法規。 自行建置應用程式以供個人使用是合法的，但你不得將副本提供給他人！ 詳細資訊請參閱 [FAQ 頁面](../UsefulLinks/FAQ.md)。 + +```{note} +如果你想在新電腦上建立 **AAPS**：請將你的備份金鑰存檔複製到新電腦上。 然後按照 [初始建置 **AAPS** 程序](../SettingUpAaps/BuildingAaps.md) 的步驟，而不是這個指導。 唯一的不同之處在於，你可以選擇你在新電腦上複製的金鑰存檔，而不必建立新的金鑰存檔。 +``` + +## 使用電腦更新 AAPS 的總覽 + +```{contents} Steps for updating to a new version of AAPS +:depth: 1 +:local: true +``` + +如果您遇到問題，請參見單獨的[問題排除Android Studio](../GettingHelp/TroubleshootingAndroidStudio)頁面。 + +### 匯出你的設定 + +從您手機上現有的 **AAPS** 版本匯出您的設定。 你可能不需要這樣做，但防患於未然更好。 + +如果您忘記如何做，請參見[匯出與匯入設定](ExportImportSettings.md)頁面。 + +### 檢查你的 Android Studio 版本 + +所需的最低版本已在 [建置指南](#Building-APK-recommended-specification-of-computer-for-building-apk-file)中描述。 如果你的版本過舊，請 [先更新 Android Studio](#Building-APK-install-android-studio)！ + +(Update-to-new-version-update-your-local-copy)= +### 更新本地副本 + +```{admonition} WARNING +:class: warning +如果你從 2.8.x 之前的版本更新，請遵循指示進行 [新複製](../SettingUpAaps/BuildingAaps.md)，因為這個指南對你無效！ +``` + +* 使用 Android Studio 開啟你現有的 AAPS 項目。 你可能需要選擇你的項目。 (雙擊) 點擊 AAPS 項目。 + + ![Android Studio - 選擇項目](../images/update/01_ProjectSelection.png) + +* 在 Android Studio 的選單列中，選擇 Git -> 取回 + + ![Android Studio 選單 - Git - Fetch](../images/update/02_GitFetch.png) + +* 你將在右下角看到 Fetch 成功的訊息。 + + ![Android Studio 選單 - Git - Fetch 成功](../images/update/03_GitFetchSuccessful.png) + +* 在選單列中，現在選擇 Git -> 拉取 + + ![Android Studio 選單 - Git - Pull](../images/update/04_GitPull.png) + +* 保持所有選項不變（origin/master），然後選擇 Pull + + ![Android Studio - Git - Pull 對話框](../images/update/05_GitPullOptions.png) + +* 等待下載過程進行，你會在底部欄看到進度資訊。 完成後，你將看到成功訊息。 + + ```{note} + 更新的檔案可能會有所不同！ 這並不代表指示 + ``` + + ![Android Studio - Pull 成功](../images/update/06_GitPullSuccess.png) + +* Gradle 同步將運行以下載一些相依套件。 等待他完成。 + + ![Android Studio - Gradle Sync](../images/studioSetup/40_BackgroundTasks.png) + +### 檢查 JVM 版本 + +此檢查特別適合如果你已經在同一台電腦上建置過之前版本的 **AAPS**。 + +在 [建置指示](#Building-APK-recommended-specification-of-computer-for-building-apk-file)中查詢 JVM 的所需版本，該版本應與你目前建置的 **AAPS** 版本相匹配。 然後按照在 [不相容的 Gradle JVM](#incompatible-gradle-jvm) 中描述的步驟，以確保你當前使用的是正確的版本。 + +Update-to-new-version-build-the-signed-apk)= +### 建置簽章 APK + +你的原始碼現在是當前已發佈的版本，並且所有前置條件已經檢查過。 現在是時候按照[建立簽署的 APK 部分](#Building-APK-generate-signed-apk)中的說明來建立簽署的 APK。 + +(Update-to-new-version-transfer-and-install)= + +### 轉移並安裝 APK +你需要將 apk 傳送到手機以便你安裝他。 + +```{note} +如果你使用相同的現有金鑰庫在 Android Studio 中完成了構建，那麼你不需要刪除手機上的現有應用。 當你安裝 apk 時，按照提示安裝更新。 +對於其他情況，例如在 Android Studio 中為你的簽章 apk 建立新密鑰庫，你將需要刪除舊應用程式後再安裝 apk。 **確保匯出你的設定！** +``` + +請參閱有關[傳送和安裝 AAPS](../SettingUpAaps/TransferringAndInstallingAaps.md)的說明。 + +繼續 [這裡](#Update-to-new-version-check-aaps-version-on-phone)。 + +## 問題排除 + +如果發生任何錯誤，不要慌張。 + +先深呼吸！ + +然後查看專門頁面[問題排除 Android Studio](../GettingHelp/TroubleshootingAndroidStudio)，看看你的問題是否已經紀錄在案！ + +如果你需要進一步幫助，請聯繫其他**AAPS**使用者，透過[Facebook](https://www.facebook.com/groups/AndroidAPSUsers)或[Discord](https://discord.gg/4fQUWHZ4Mw)。 \ No newline at end of file diff --git a/docs/CROWDIN/zh_TW/Maintenance/UpdateToNewVersion.md b/docs/CROWDIN/zh_TW/Maintenance/UpdateToNewVersion.md index 63c89e715609..35b610e00b99 100644 --- a/docs/CROWDIN/zh_TW/Maintenance/UpdateToNewVersion.md +++ b/docs/CROWDIN/zh_TW/Maintenance/UpdateToNewVersion.md @@ -10,91 +10,14 @@ * 當有新版本發布時，你將在 **AAPS** 應用中收到關於新版本的訊息橫幅。 * 新版本也會在發布時於 Facebook 上公佈。 * 發布後，請詳細閱讀[發布說明](ReleaseNotes.md)，如有任何疑問，請在Facebook或Discord社群中澄清後再進行更新。 - - ```{note} - 如果你想在新電腦上建立 **AAPS**：請將你的備份金鑰存檔複製到新電腦上。 然後按照 [初始建置 **AAPS** 程序](../SettingUpAaps/BuildingAaps.md) 的步驟，而不是這個指導。 唯一的不同之處在於，你可以選擇你在新電腦上複製的金鑰存檔，而不必建立新的金鑰存檔。 - ``` -## 更新到新版本 AAPS 的總覽 +## 使用瀏覽器版本更新 AAPS -```{contents} 更新到新版本 AAPS 的步驟 :depth: 1 :local: true +如果你已使用瀏覽器版本方法建置了 AAPS 應用程式，請遵循 [這些指示](./UpdateBrowserBuild.md)。 -
如果遇到問題，請參閱針對 [Android Studio 的問題排除](../GettingHelp/TroubleshootingAndroidStudio) 的單獨頁面。 - - ### 匯出你的設定 - - 從你手機上現有的 **AAPS** 版本匯出你的設定。 你可能不需要這樣做，但防患於未然更好。 - - 如果你不記得如何進行，請參閱 [匯出與匯入設定](ExportImportSettings.md) 頁面。 - - ### 檢查你的 Android Studio 版本 - - 所需的最小版本已在 [建立指導](#Building-APK-recommended-specification-of-computer-for-building-apk-file) 中說明。 如果你的版本較舊，請 [先更新 Android Studio](#Building-APK-install-android-studio)！ - - (Update-to-new-version-update-your-local-copy)= - ### 更新你的本地副本 - - ```{admonition} 警告 - :class: warning - 如果你是從 2.8.x 之前的版本更新，請遵循指示進行 [新複製](../SettingUpAaps/BuildingAaps.md)，因為本指南對你無效！ - +## 使用電腦更新 AAPS -* 使用 Android Studio 開啟你現有的 AAPS 項目。 你可能需要選擇你的項目。 (雙擊) 點擊 AAPS 項目。 - - ![Android Studio - 選擇項目](../images/update/01_ProjectSelection.png) - -* 在 Android Studio 的選單欄中，選擇 Git -> Fetch - - ![Android Studio 選單 - Git - Fetch](../images/update/02_GitFetch.png) - -* 你將在右下角看到 Fetch 成功的訊息。 - - ![Android Studio 選單 - Git - Fetch 成功](../images/update/03_GitFetchSuccessful.png) - -* 在選單欄中，現在選擇 Git -> Pull - - ![Android Studio 選單 - Git - Pull](../images/update/04_GitPull.png) - -* 保持所有選項不變（origin/master），然後選擇 Pull - - ![Android Studio - Git - Pull 對話框](../images/update/05_GitPullOptions.png) - -* 等待下載過程進行，你會在底部欄看到進度資訊。 完成後，你將看到成功訊息。 - - ```{note} - 更新的檔案可能會有所不同！ 這並不代表指示 - ``` - - ![Android Studio - Pull 成功](../images/update/06_GitPullSuccess.png) - -* Gradle 同步將運行以下載一些相依套件。 等待他完成。 - - ![Android Studio - Gradle Sync](../images/studioSetup/40_BackgroundTasks.png) - -### 檢查 JVM 版本 - -如果你已經在同一台電腦上建立了 **AAPS** 的先前版本，特別建議進行此檢查。 - -請在 [建置指示](#Building-APK-recommended-specification-of-computer-for-building-apk-file) 中檢查與你現在要建置的 **AAPS** 版本對應的 JVM 所需版本。 然後按照在 [不相容的 Gradle JVM](#incompatible-gradle-jvm) 中描述的步驟，以確保你當前使用的是正確的版本。 - -Update-to-new-version-build-the-signed-apk)= - -### 建置簽章 APK - -你的原始碼現在是當前已發佈的版本，並且所有前置條件已經檢查過。 現在是時候按照[建立簽署的 APK 部分](#Building-APK-generate-signed-apk)中的說明來建立簽署的 APK。 - -(Update-to-new-version-transfer-and-install)= - -### 轉移並安裝 APK - -你需要將 apk 傳送到手機以便你安裝他。 - -```{note} -如果你使用相同的現有金鑰庫在 Android Studio 中完成了構建，那麼你不需要刪除手機上的現有應用。 當你安裝 apk 時，按照提示安裝更新。 -對於其他情況，例如在 Android Studio 中為你的簽章 apk 建立新密鑰庫，你將需要刪除舊應用程式後再安裝 apk。 **確保匯出你的設定！** -``` - -請參閱有關[傳送和安裝 AAPS](../SettingUpAaps/TransferringAndInstallingAaps.md)的說明。 +請遵循 [這些指示。](./UpdateComputerBuild.md) (Update-to-new-version-check-aaps-version-on-phone)= @@ -104,14 +27,4 @@ Update-to-new-version-build-the-signed-apk)= ![已安裝的 AAPS 版本](../images/Update_VersionCheck.png) -檢查[發佈說明](../Maintenance/ReleaseNotes.md)以了解更新後是否有任何特定的指示。 - -## 問題排除 - -如果發生任何錯誤，不要慌張。 - -先深呼吸！ - -然後查看專門頁面[問題排除 Android Studio](../GettingHelp/TroubleshootingAndroidStudio)，看看你的問題是否已經紀錄在案！ - -如果你需要進一步幫助，請聯繫其他**AAPS**使用者，透過[Facebook](https://www.facebook.com/groups/AndroidAPSUsers)或[Discord](https://discord.gg/4fQUWHZ4Mw)。 \ No newline at end of file +檢查[發佈說明](../Maintenance/ReleaseNotes.md)以了解更新後是否有任何特定的指示。 \ No newline at end of file diff --git a/docs/CROWDIN/zh_TW/SettingUpAaps/BrowserBuild.md b/docs/CROWDIN/zh_TW/SettingUpAaps/BrowserBuild.md index 0ede94494fd7..0bacb562a223 100644 --- a/docs/CROWDIN/zh_TW/SettingUpAaps/BrowserBuild.md +++ b/docs/CROWDIN/zh_TW/SettingUpAaps/BrowserBuild.md @@ -1,3 +1,5 @@ +(browser-build)= + # 瀏覽器建置 使用 GitHub Actions 建置 AAPS。 diff --git a/docs/CROWDIN/zh_TW/images/Building-the-App/CI/aaps_ci_simple_http_server.png b/docs/CROWDIN/zh_TW/images/Building-the-App/CI/aaps_ci_simple_http_server.png index 95ac2d4eb443..2e2fb47e5ca2 100644 Binary files a/docs/CROWDIN/zh_TW/images/Building-the-App/CI/aaps_ci_simple_http_server.png and b/docs/CROWDIN/zh_TW/images/Building-the-App/CI/aaps_ci_simple_http_server.png differ diff --git a/docs/CROWDIN/zh_TW/images/Building-the-App/CI/aaps_ci_simple_http_server_step1.png b/docs/CROWDIN/zh_TW/images/Building-the-App/CI/aaps_ci_simple_http_server_step1.png index 78f52682b58d..b348162dcb1c 100644 Binary files a/docs/CROWDIN/zh_TW/images/Building-the-App/CI/aaps_ci_simple_http_server_step1.png and b/docs/CROWDIN/zh_TW/images/Building-the-App/CI/aaps_ci_simple_http_server_step1.png differ diff --git a/docs/CROWDIN/zh_TW/images/Building-the-App/CI/aaps_ci_simple_http_server_step2.png b/docs/CROWDIN/zh_TW/images/Building-the-App/CI/aaps_ci_simple_http_server_step2.png index c292ac667f63..cabadeefb97a 100644 Binary files a/docs/CROWDIN/zh_TW/images/Building-the-App/CI/aaps_ci_simple_http_server_step2.png and b/docs/CROWDIN/zh_TW/images/Building-the-App/CI/aaps_ci_simple_http_server_step2.png differ diff --git a/docs/CROWDIN/zh_TW/images/Building-the-App/CI/aaps_ci_simple_http_server_step3.png b/docs/CROWDIN/zh_TW/images/Building-the-App/CI/aaps_ci_simple_http_server_step3.png index bd31cd0ffb3d..9a26d3526369 100644 Binary files a/docs/CROWDIN/zh_TW/images/Building-the-App/CI/aaps_ci_simple_http_server_step3.png and b/docs/CROWDIN/zh_TW/images/Building-the-App/CI/aaps_ci_simple_http_server_step3.png differ diff --git a/docs/CROWDIN/zh_TW/images/Building-the-App/CI/aaps_ci_simple_http_server_step4.png b/docs/CROWDIN/zh_TW/images/Building-the-App/CI/aaps_ci_simple_http_server_step4.png index cc187ec72a14..285492424351 100644 Binary files a/docs/CROWDIN/zh_TW/images/Building-the-App/CI/aaps_ci_simple_http_server_step4.png and b/docs/CROWDIN/zh_TW/images/Building-the-App/CI/aaps_ci_simple_http_server_step4.png differ diff --git a/docs/CROWDIN/zh_TW/images/Building-the-App/CI/aaps_ci_simple_http_server_store.png b/docs/CROWDIN/zh_TW/images/Building-the-App/CI/aaps_ci_simple_http_server_store.png index 4b157ca8d3d8..65bf101f55e4 100644 Binary files a/docs/CROWDIN/zh_TW/images/Building-the-App/CI/aaps_ci_simple_http_server_store.png and b/docs/CROWDIN/zh_TW/images/Building-the-App/CI/aaps_ci_simple_http_server_store.png differ diff --git a/docs/CROWDIN/zh_TW/images/update/CI/GitHubActions1.png b/docs/CROWDIN/zh_TW/images/update/CI/GitHubActions1.png new file mode 100644 index 000000000000..e04ce6e76d8b Binary files /dev/null and b/docs/CROWDIN/zh_TW/images/update/CI/GitHubActions1.png differ diff --git a/docs/CROWDIN/zh_TW/images/update/CI/GitHubActions2.png b/docs/CROWDIN/zh_TW/images/update/CI/GitHubActions2.png new file mode 100644 index 000000000000..7b5c5a842d16 Binary files /dev/null and b/docs/CROWDIN/zh_TW/images/update/CI/GitHubActions2.png differ diff --git a/docs/CROWDIN/zh_TW/images/update/CI/GitHubActions3.png b/docs/CROWDIN/zh_TW/images/update/CI/GitHubActions3.png new file mode 100644 index 000000000000..cff0ed34b214 Binary files /dev/null and b/docs/CROWDIN/zh_TW/images/update/CI/GitHubActions3.png differ diff --git a/docs/CROWDIN/zh_TW/images/update/CI/GitHubActions4.png b/docs/CROWDIN/zh_TW/images/update/CI/GitHubActions4.png new file mode 100644 index 000000000000..bede3c2dfe08 Binary files /dev/null and b/docs/CROWDIN/zh_TW/images/update/CI/GitHubActions4.png differ diff --git a/docs/CROWDIN/zh_TW/images/update/CI/GitHubActions5.png b/docs/CROWDIN/zh_TW/images/update/CI/GitHubActions5.png new file mode 100644 index 000000000000..d96e31cf084d Binary files /dev/null and b/docs/CROWDIN/zh_TW/images/update/CI/GitHubActions5.png differ diff --git a/docs/CROWDIN/zh_TW/images/update/CI/GitHubUpdate1.png b/docs/CROWDIN/zh_TW/images/update/CI/GitHubUpdate1.png new file mode 100644 index 000000000000..3058dc270d28 Binary files /dev/null and b/docs/CROWDIN/zh_TW/images/update/CI/GitHubUpdate1.png differ diff --git a/docs/CROWDIN/zh_TW/images/update/CI/GitHubUpdate2.png b/docs/CROWDIN/zh_TW/images/update/CI/GitHubUpdate2.png new file mode 100644 index 000000000000..1ae9568c8107 Binary files /dev/null and b/docs/CROWDIN/zh_TW/images/update/CI/GitHubUpdate2.png differ diff --git a/docs/CROWDIN/zh_TW/images/update/CI/GitHubUpdate3.png b/docs/CROWDIN/zh_TW/images/update/CI/GitHubUpdate3.png new file mode 100644 index 000000000000..d18f9119c76d Binary files /dev/null and b/docs/CROWDIN/zh_TW/images/update/CI/GitHubUpdate3.png differ diff --git a/docs/CROWDIN/zh_TW/images/update/CI/GitHubUpdate4.png b/docs/CROWDIN/zh_TW/images/update/CI/GitHubUpdate4.png new file mode 100644 index 000000000000..8c38c071cb8f Binary files /dev/null and b/docs/CROWDIN/zh_TW/images/update/CI/GitHubUpdate4.png differ diff --git a/docs/CROWDIN/zh_TW/images/update/CI/GitHubUpdate5.png b/docs/CROWDIN/zh_TW/images/update/CI/GitHubUpdate5.png new file mode 100644 index 000000000000..409aef1f34dc Binary files /dev/null and b/docs/CROWDIN/zh_TW/images/update/CI/GitHubUpdate5.png differ diff --git a/docs/CROWDIN/zh_TW/index.md b/docs/CROWDIN/zh_TW/index.md index c974ac1f2eae..1fc452f44bd0 100644 --- a/docs/CROWDIN/zh_TW/index.md +++ b/docs/CROWDIN/zh_TW/index.md @@ -2,10 +2,10 @@ ![圖像](./images/basic-outline-of-AAPS.png) -```{admonition} Version 3.3 +```{admonition} Latest Release :class: note -2024/12/29 : 版本 3.3 已發布。 檢查[發行說明](#version3300)以查看新功能並獲取更新說明。 +2025/08/14 : 版本 3.3.2.1 已發布。 檢查[發行說明](#latestrelease)以查看新功能並獲取更新說明。 ``` @@ -21,7 +21,7 @@ Android APS (**AAPS**) 是一款開源應用程式，專為胰島素依賴型的 現在你已經對過程有了深入的了解，可以開始建置你的**AAPS** 循環系統了。 -本章節 **三) 設置 AAPS** 包含逐步指導來進行此操作。 他涵蓋了選擇和 [設置你的報告伺服器](./SettingUpAaps/SettingUpTheReportingServer.md)（Nightscout 或 Tidepool），你可以檢視和分享你的資料，準備電腦來建置 AAPS 應用程式，並傳輸到你的手機。 他還涵蓋了使用設置嚮導來設定 **AAPS** 應用程式，與你的 CGM 應用程式連結，並與實體或虛擬胰島素幫浦連結，以及將 **AAPS** 連結到你的報告伺服器。 你將透過一個安全且經過精心設計的逐步流程，慢慢了解**AAPS**所提供的全部功能。此流程主要在確保你或你的孩子能夠充分熟悉，並能操作所有不同的層級和選單配置，然後再進入下一階段，通常稱為下一個「目標」，直到你累積足夠的經驗，再開始使用應用程式內更進階的選項。 這些目標被特別設計為逐步解鎖更多 **AAPS** 的可能性，並從開環轉為閉環。 +本章節 **三) 設置 AAPS** 包含逐步指導來進行此操作。 它涵蓋了選擇和 [設置報告伺服器](./SettingUpAaps/SettingUpTheReportingServer.md)（Nightscout 或 Tidepool），使你能夠檢視和分享你的資料，準備建立 AAPS 應用程式，建置 AAPS 應用程式並將其傳送到你的手機。 他還涵蓋了使用設置嚮導來設定 **AAPS** 應用程式，與你的 CGM 應用程式連結，並與實體或虛擬胰島素幫浦連結，以及將 **AAPS** 連結到你的報告伺服器。 你將透過一個安全且經過精心設計的逐步流程，慢慢了解**AAPS**所提供的全部功能。此流程主要在確保你或你的孩子能夠充分熟悉，並能操作所有不同的層級和選單配置，然後再進入下一階段，通常稱為下一個「目標」，直到你累積足夠的經驗，再開始使用應用程式內更進階的選項。 這些目標被特別設計為逐步解鎖更多 **AAPS** 的可能性，並從開環轉為閉環。 第**4)**節使用**AAPS**的日常生活涵蓋關鍵的**AAPS**功能，以協助你使用（並自訂）**AAPS**。 包括暸解各個畫面、碳水化合物計算、敏感度、設定檔切換、臨時目標、延展碳水化合物（或 eCarbs）、自動化和 動態ISF。 此外，還涵蓋了如何處理不同類型的餐食、更換套管和傳感器、手機更新、夏令時間更改、[與 AAPS 一起旅行](DailyLifeWithAaps/TimezoneTraveling-DaylightSavingTime.md) 和運動等常見問題與解答。 常見問題和答案位於問題排除部分。