diff --git a/docs/CROWDIN/cs/Maintenance/ExportImportSettings.md b/docs/CROWDIN/cs/Maintenance/ExportImportSettings.md index e0f20d5155b1..150b0fd8f834 100644 --- a/docs/CROWDIN/cs/Maintenance/ExportImportSettings.md +++ b/docs/CROWDIN/cs/Maintenance/ExportImportSettings.md @@ -36,9 +36,16 @@ In case your main **AAPS** phone is lost or damaged, having a copy of the APK av **How to back-up:** Maintain a copy on the computer used to build the APK with Android Studio. Additionally, it is recommended to use a cloud platform to store a copy of the installer APK. Make sure you know how to locate both backups when needed. Consider setting up dedicated folders to store these backups. ### AAPS settings file (also referred to as 'Preferences') + +```{admonition} Where are preferences stored on my phone? +:class: tip +You will find your settings in the **AAPS Directory** you have selected during [AAPS setup](#SetupWizard-StoragePermission).
+You can also change the **AAPS Directory** in Preferences > [Maintenance Settings](#preferences-maintenance-settings). +``` + With a copy of the APK installer file (see above) and your **Settings** file, you can quickly get up and running on an existing or new phone. -The **Settings** file is used t customize the AAPS application to fit your specific setup. They encompass details such as your config builder settings, objective status, third-party communication settings (e.g., Nightscout, Tidepool), automations, and profiles. +The **Settings** file is used to customize the AAPS application to fit your specific setup. They encompass details such as your config builder settings, objective status, third-party communication settings (e.g., Nightscout, Tidepool), automations, and profiles. Exporting the AAPS settings to file enables you to restore its configuration to a specific point in time. As mentioned, in addition to all configuration settings, the export file also contains the status of your objectives, which you need to restore when **(re)installing** AAPS. Without this you will be required to redo all objectives from start to enable closed loop. Settings files also enable you to restore "last known good" settings for undoing any configuration changes. @@ -63,6 +70,12 @@ Exporting the AAPS settings to file enables you to restore its configuration to ## Settings Export +```{admonition} Where are preferences stored on my phone? +:class: tip +You will find your settings in the **AAPS Directory** you have selected during [AAPS setup](#SetupWizard-StoragePermission).
+You can also change the **AAPS Directory** in Preferences > [Maintenance Settings](#preferences-maintenance-settings). +``` + It is recommended to do regular settings exports, especially before and after making configuration changes. You can choose to do exports **manually or (preferred) through automation**. Make sure to take a note of your AAPS master password and to backup your settings files by copying them off your phone to for instance a cloud storage location. **Note**: _The exported settings will be encrypted with your AAPS master password: without the master password used for exporting you will be unable to import the settings file!_ @@ -85,6 +98,13 @@ _**Note:** On importing settings to user always needs to enter the AAPS password (ExportImportSettings-restoring-from-your-backups-on-a-new-phone-or-fresh-installation-of-aaps)= ## Restoring from your backups on a new phone or fresh installation of AAPS + +```{admonition} Where are preferences stored on my phone? +:class: tip +You will find your settings in the **AAPS Directory** you have selected during [AAPS setup](#SetupWizard-StoragePermission).
+You can also change the **AAPS Directory** in Preferences > [Maintenance Settings](#preferences-maintenance-settings). +``` + Use these instructions if you have a back-up of your APK and **Preferences** that you want to load on to a new phone or if you needed to delete and reinstall the APK on your existing phone for any reason. _If you are updating **AAPS** using an APK built with the same keystore you should not need to follow this process. However, it is still advised to create a back-up before you apply the update._ @@ -108,13 +128,15 @@ Importing a **Preferences** file will deactivate your current pod if those **Pre 5. From the **AAPS** home screen, set the master password in [Preferences > General > Protection](#Preferences-master-password) to the same password as you used with your back-ups. -6. From the **AAPS** home screen, select the three line (hamburger) menu in the top left > Maintenance > Export settings > type in Master password set above > Ok. This will create the preferences folder if it does not already exist on your phone. +6. If you haven't done it yet, [set the **AAPS Directory**](#preferences-maintenance-settings): from the **AAPS** home screen, select the three line (hamburger) menu in the top left > Maintenance > AAPS DIRECTORY. + +7. From the **AAPS** home screen, select the three line (hamburger) menu in the top left > Maintenance > Export settings > type in Master password set above > Ok. This will create the preferences folder if it does not already exist on your phone. -7. Download the back-up of your **Preferences** file from your cloud platform. +8. Download the back-up of your **Preferences** file from your cloud platform. -8. Use your file explorer (commonly called “Files” or “My Files”) to move the file from your downloads to `/internal storage/AAPS/preferences` +9. Use your file explorer (commonly called “Files” or “My Files”) to move the file from your downloads to `/internal storage/AAPS/preferences` if your **AAPS Directory** has been set `/internal storage/AAPS` -9. From the **AAPS** home screen, select the three line (hamburger) menu in the top left > Maintenance > Import settings > select the preferences file you want to back-up from > Ok > type in Master password set above > Ok. Make sure you select the correct preferences file, all .json files from the preferences folder will be shown. +10. From the **AAPS** home screen, select the three line (hamburger) menu in the top left > Maintenance > Import settings > select the preferences file you want to back-up from > Ok > type in Master password set above > Ok. Make sure you select the correct preferences file, all .json files from the preferences folder will be shown. ![AAPS import settings 1](../images/Maintenance/AAPS_ImportSettings1.png) ![AAPS import settings 2](../images/Maintenance/AAPS_ImportSettings2.png) diff --git a/docs/CROWDIN/cs/SettingUpAaps/SetupWizard.md b/docs/CROWDIN/cs/SettingUpAaps/SetupWizard.md index 4bc5ed22a112..429470b4bf52 100644 --- a/docs/CROWDIN/cs/SettingUpAaps/SetupWizard.md +++ b/docs/CROWDIN/cs/SettingUpAaps/SetupWizard.md @@ -125,6 +125,8 @@ Follow these steps on Android 16, other versions will varies slightly from the p ![settings_apps](../images/setup-wizard/app_bluetooth_allow_background_unrestrict.png) +(SetupWizard-StoragePermission)= + ### Storage permission **AAPS** needs to log information to the permanent storage of your smartphone. Trvalá paměť znamená, že data budou k dispozici i po restartu vašeho telefonu. Informace uložené pouze v operační paměti a nikoli v paměti trvalé mohou být ztracené. diff --git a/docs/CROWDIN/cs/images/GoogleDriveInWebbrowser.png b/docs/CROWDIN/cs/images/GoogleDriveInWebbrowser.png index 159f03ff2370..e682af001b15 100644 Binary files a/docs/CROWDIN/cs/images/GoogleDriveInWebbrowser.png and b/docs/CROWDIN/cs/images/GoogleDriveInWebbrowser.png differ diff --git a/docs/CROWDIN/cs/images/GoogleDriveMobileAPPLaunch.png b/docs/CROWDIN/cs/images/GoogleDriveMobileAPPLaunch.png index a021dd716fcf..f4ed9aa742a1 100644 Binary files a/docs/CROWDIN/cs/images/GoogleDriveMobileAPPLaunch.png and b/docs/CROWDIN/cs/images/GoogleDriveMobileAPPLaunch.png differ diff --git a/docs/CROWDIN/cs/images/GoogleDriveMobileMissingSecuritySetting.png b/docs/CROWDIN/cs/images/GoogleDriveMobileMissingSecuritySetting.png index ffc850fc5fe7..f53714dfbe20 100644 Binary files a/docs/CROWDIN/cs/images/GoogleDriveMobileMissingSecuritySetting.png and b/docs/CROWDIN/cs/images/GoogleDriveMobileMissingSecuritySetting.png differ diff --git a/docs/CROWDIN/cs/images/GoogleDriveMobileSettingSecuritySetting.png b/docs/CROWDIN/cs/images/GoogleDriveMobileSettingSecuritySetting.png index d0669d4fe98a..f53fec931a73 100644 Binary files a/docs/CROWDIN/cs/images/GoogleDriveMobileSettingSecuritySetting.png and b/docs/CROWDIN/cs/images/GoogleDriveMobileSettingSecuritySetting.png differ diff --git a/docs/CROWDIN/cs/images/GoogleDriveMobileUploadedAPK.png b/docs/CROWDIN/cs/images/GoogleDriveMobileUploadedAPK.png index dcb1a91655b6..ed45f83ad166 100644 Binary files a/docs/CROWDIN/cs/images/GoogleDriveMobileUploadedAPK.png and b/docs/CROWDIN/cs/images/GoogleDriveMobileUploadedAPK.png differ diff --git a/docs/CROWDIN/de/Maintenance/ExportImportSettings.md b/docs/CROWDIN/de/Maintenance/ExportImportSettings.md index 27cb45a73139..9f54be5e2798 100644 --- a/docs/CROWDIN/de/Maintenance/ExportImportSettings.md +++ b/docs/CROWDIN/de/Maintenance/ExportImportSettings.md @@ -2,9 +2,9 @@ Sobald Du AAPS auf Deinem Smartphone installierst, wird es zu einem "medizinischen Gerät" auf das Du Dich jeden Tag verlässt. Es wird dringend empfohlen, für den Fall, dass Dein Smartphone defekt, gestohlen oder verloren geht, einen Notfall-Plan zu haben. Daher ist es wichtig, Dich darauf vorzubereiten, indem Du Dich fragst "Was passiert, wenn?" -Um Deine AAPS-Konfiguration auf einem bestehenden oder neuen Smartphone wiederherzustellen, ist es wichtig, die folgenden Elemente an einem sicheren Ort zu behalten (nicht auf Deinem Smartphone). Es hat sich bewährt, mindestens zwei separate Sicherungen zu haben: auf einer lokalen Festplatte, USB-Stick und (bevorzugt) im Cloud-Speicher wie Google Drive oder Microsoft 365 OneDrive. Indem Du Deine Backups in der Cloud speicherst, hast Du von Deinem Smartphone aus alles, was zum Wiederherstellen Deiner Konfiguration benötigt wird, immer und überall verfügbar. +Um Deine AAPS-Konfiguration auf einem bestehenden oder neuen Smartphone wiederherzustellen, ist es wichtig, die folgenden Elemente an einem sicheren Ort zu behalten (nicht auf Deinem Smartphone). Best practice is to keep at least two separate backups: on a local hard drive, USB stick and (preferred) on Cloud storage like Google Drive or Microsoft 365 OneDrive. By storing your backups in the cloud you'll always have everything needed accessible from your phone to restore your setup anywhere and anytime. -Überlege, ob Du Dir ein zweites Backup-Smartphone zulegen möchtest und das Wiederherstellen von AAPS übst, bis Dein Backup-Smartphone wie erwartet funktioniert. Dieser Schritt gibt Dir Gewissheit darüber, dass Dein Notfallplan funktioniert und Du beim Ausfall Deines primären Smartphones AAPS problemlos weiter nutzen kannst. +Überlege, ob Du Dir ein zweites Backup-Smartphone zulegen möchtest und das Wiederherstellen von AAPS übst, bis Dein Backup-Smartphone wie erwartet funktioniert. This step will give you confidence that your emergency plan is effective and that you can seamlessly continue using AAPS if your primary phone becomes unavailable. Um wiederherstellen zu können, ist es wichtig, die folgenden Dinge zur Hand zu haben: @@ -36,14 +36,21 @@ Für den Fall, dass Dein **AAPS** Haupt-Smartphone verloren geht oder beschädig **So sicherst Du:** Halte eine Kopie auf dem Computer, mit dem Du die APK mit Android Studio erstellt hast, aktuell. Zusätzlich wird empfohlen, eine Kopie der APK-Installationsdatei in einer Cloud zu speichern. Stelle sicher, dass Du beide Backups bei Bedarf findest. Überlege, ob Du für die Speicherung der Backups eigene Ordner anlegen möchtest. ### AAPS-Einstellungsdatei (auch 'Einstellungen' genannt) + +```{admonition} Where are preferences stored on my phone? +:class: tip +You will find your settings in the **AAPS Directory** you have selected during [AAPS setup](#SetupWizard-StoragePermission).
+You can also change the **AAPS Directory** in Preferences > [Maintenance Settings](#preferences-maintenance-settings). +``` + Mit einer Kopie der APK-Installationsdatei (siehe oben) und Deiner **Einstellungs**-Datei, bist Du auf einem bestehenden oder neuen Smartphone schnell wieder einsatzbereit. -Die **Einstellungsdatei** wird verwendet, um die AAPS-Anwendung an Deine spezifischen Bedürfnisse anzupassen. Sie beinhalten Details wie z. B. Deine Konfigurationseinstellungen, Status der Ziele, Kommunikationseinstellungen zu Drittanbietern (z. B. Nightscout, Tidepool), Automatisierungen und Profile. +The **Settings** file is used to customize the AAPS application to fit your specific setup. They encompass details such as your config builder settings, objective status, third-party communication settings (e.g., Nightscout, Tidepool), automations, and profiles. -Durch den Export der AAPS-Einstellungen in die Datei kannst Du die Konfiguration zu einem bestimmten Zeitpunkt wiederherstellen. Wie bereits erwähnt, enthält die Exportdatei zusätzlich zu allen Konfigurationseinstellungen auch den Status Deiner Ziele, den Du bei einer AAPS-**(Neu-)Installation** wiederherstellen musst. Ohne diese Wiederherstellung musst Du alle Ziele erneut von Anfang an durchlaufen, um einen Closed Loop aktivieren zu können. Einstellungsdateien ermöglichen es Dir auch, die "letzten funktionierenden" Einstellungen wiederherzustellen. Damit machst Du alle Konfigurationsänderungen rückgängig. +Durch den Export der AAPS-Einstellungen in die Datei kannst Du die Konfiguration zu einem bestimmten Zeitpunkt wiederherstellen. As mentioned, in addition to all configuration settings, the export file also contains the status of your objectives, which you need to restore when **(re)installing** AAPS. Without this you will be required to redo all objectives from start to enable closed loop. Settings files also enable you to restore "last known good" settings for undoing any configuration changes. **Wann die AAPS-Einstellungen gesichert werden sollten:** -* Jedes Mal, wenn Du ein Ziel erfüllst. Damit verhinderst Du den Fortschritt möglicherweise zu verlieren. _Ohne eine Kopie Deiner **Einstellungen** musst Du, wenn Du AAPS neu installierst oder Dein Smartphone tauschst, alle Ziele erneut abschließen._ +* Jedes Mal, wenn Du ein Ziel erfüllst. Damit verhinderst Du den Fortschritt möglicherweise zu verlieren. _Without a copy of your **Settings** you will have to complete all objectives again in the event you need to re-install AAPS or replace your phone._ * Immer dann, wenn Du größere Änderungen an der Konfiguration vornimmst (SMB-Einstellungen änderst, Insulintyp änderst, Pumpe änderst, Änderungen an Automatisierungen vornimmst), solltest Du sowohl vor als auch nach der Änderung die **Einstellungen** sichern. Auf diese Weise hast Du für den Fall eines "Rollback" sowohl die aktuellen Einstellungen als auch eine Kopie des Zustands vor den Änderungen. @@ -63,7 +70,13 @@ Durch den Export der AAPS-Einstellungen in die Datei kannst Du die Konfiguration ## Einstellungen exportieren -Insbesondere vor und nach den Konfigurationsänderungen, wird empfohlen, die Einstellungen regelmäßig zu exportieren. Du kannst wählen, ob Du die Exporte **manuell oder (vorzugsweise) durch eine Automatisierung** durchführen möchtest. Stelle sicher, dass Du Dir Dein AAPS Master-Passwort notierst und die Datei mit Deinen Einstellungen regelmäßig sicherst, indem Du sie von Deinem Smartphone zum Beispiel in einen Cloud-Speicher kopierst. +```{admonition} Where are preferences stored on my phone? +:class: tip +You will find your settings in the **AAPS Directory** you have selected during [AAPS setup](#SetupWizard-StoragePermission).
+You can also change the **AAPS Directory** in Preferences > [Maintenance Settings](#preferences-maintenance-settings). +``` + +Insbesondere vor und nach den Konfigurationsänderungen, wird empfohlen, die Einstellungen regelmäßig zu exportieren. You can choose to do exports **manually or (preferred) through automation**. Make sure to take a note of your AAPS master password and to backup your settings files by copying them off your phone to for instance a cloud storage location. **Hinweis**: _Die exportierten Einstellungen werden mit Deinem AAPS Master-Passwort verschlüsselt: Ohne das Master-Passwort, das für den Export genutzt wurde, kannst Du die Datei mit Deinen Einstellungen nicht importieren!_ @@ -85,6 +98,13 @@ _**Hinweis:** Beim Importieren der Einstellungen musst Du immer das AAPS-Passwor (ExportImportSettings-restoring-from-your-backups-on-a-new-phone-or-fresh-installation-of-aaps)= ## Wiederherstellen Deines Backups auf einem neuen Smartphone oder AAPS-Neuinstallation + +```{admonition} Where are preferences stored on my phone? +:class: tip +You will find your settings in the **AAPS Directory** you have selected during [AAPS setup](#SetupWizard-StoragePermission).
+You can also change the **AAPS Directory** in Preferences > [Maintenance Settings](#preferences-maintenance-settings). +``` + Nutze diese Anleitung, wenn Du ein Backup Deiner APK-Datei oder der **Einstellungen** hast und das auf Dein Smartphone laden möchtest oder Du die bestehende APK-Datei auf Deinem aktuellen Smartphone - aus welchem Grund auch immer - löschen und neu installieren möchtest. _Wenn Du **AAPS** mit einer APK aktualisieren möchtest, die mit demselben Keystore erstellt wurde, sollte der folgende Prozess nicht notwendig sein. Es wird trotzdem empfohlen, ein Backup vor dem Update zu erstellen._ @@ -108,13 +128,15 @@ Der Import einer Datei mit den **Einstellungen** wird den aktiven Pod deaktivier 5. Vom **AAPS**-Startbildschirm, das Master-Passwort in [Einstellungen > Allgemein > Schutz](#Preferences-master-password) auf das gleiche Passwort setzen, wie Du es bei Deiner Sicherungen verwendet hast. -6. Vom **AAPS**-Startbildschirm aus wähle das Drei-Linien-Menü (Hamburger-Menü) oben links > Wartung > Einstellungen exportieren > gib das festgelegte Master-Passwort ein > Ok. Damit wird der Ordner 'preferences' - sofern noch nicht vorhanden - auf Deinem Smartphone erstellt. +6. If you haven't done it yet, [set the **AAPS Directory**](#preferences-maintenance-settings): from the **AAPS** home screen, select the three line (hamburger) menu in the top left > Maintenance > AAPS DIRECTORY. + +7. Vom **AAPS**-Startbildschirm aus wähle das Drei-Linien-Menü (Hamburger-Menü) oben links > Wartung > Einstellungen exportieren > gib das festgelegte Master-Passwort ein > Ok. Damit wird der Ordner 'preferences' - sofern noch nicht vorhanden - auf Deinem Smartphone erstellt. -7. Lade die Datei mit der Sicherung Deiner **Einstellungen** aus Deiner Cloud-Plattform herunter. +8. Lade die Datei mit der Sicherung Deiner **Einstellungen** aus Deiner Cloud-Plattform herunter. -8. Verschiebe die Datei mit dem Datei-Explorer (meist „Dateien“ oder „Meine Dateien“ genannt) aus dem Ordner „Downloads“ nach `/Interner Speicher/AAPS/preferences` +9. Use your file explorer (commonly called “Files” or “My Files”) to move the file from your downloads to `/internal storage/AAPS/preferences` if your **AAPS Directory** has been set `/internal storage/AAPS` -9. Vom **AAPS**-Startbildschirm aus wähle das Drei-Linien-Menü (Hamburger-Menü) oben links > Wartung > Einstellungen importieren > wähle die Einstellungsdatei aus, aus der Du wiederherstellen möchtest > Ok > Gib Dein Master-Passwort ein > Ok. Da alle vorhandenen .json Dateien im "preferences"-Verzeichnis angezeigt werden, ist Vorsicht bei Auswahl der richtigen Datei erforderlich. +10. Vom **AAPS**-Startbildschirm aus wähle das Drei-Linien-Menü (Hamburger-Menü) oben links > Wartung > Einstellungen importieren > wähle die Einstellungsdatei aus, aus der Du wiederherstellen möchtest > Ok > Gib Dein Master-Passwort ein > Ok. Da alle vorhandenen .json Dateien im "preferences"-Verzeichnis angezeigt werden, ist Vorsicht bei Auswahl der richtigen Datei erforderlich. ![AAPS Import der Einstellungen 1](../images/Maintenance/AAPS_ImportSettings1.png) ![AAPS Import der Einstellungen 2](../images/Maintenance/AAPS_ImportSettings2.png) diff --git a/docs/CROWDIN/de/SettingUpAaps/SetupWizard.md b/docs/CROWDIN/de/SettingUpAaps/SetupWizard.md index 315c99c918aa..1e07c8b4a602 100644 --- a/docs/CROWDIN/de/SettingUpAaps/SetupWizard.md +++ b/docs/CROWDIN/de/SettingUpAaps/SetupWizard.md @@ -125,6 +125,8 @@ Für Android 16 arbeite die folgenden Schritte ab. Bei anderen Versionen können ![settings_apps](../images/setup-wizard/app_bluetooth_allow_background_unrestrict.png) +(SetupWizard-StoragePermission)= + ### Speicherberechtigung Um Log-Dateien zu sichern und Einstellungen exportieren zu können, benötigt **AAPS** Zugriff auf den permanenten Speicher Deines Smartphones. Permanenter Speicher bedeutet, dass es auch nach dem Neustarten Deines Smartphones verfügbar sein wird. Andere Informationen gehen einfach verloren, da sie nicht im permanenten Speicher abgelegt sind. diff --git a/docs/CROWDIN/el/Maintenance/ExportImportSettings.md b/docs/CROWDIN/el/Maintenance/ExportImportSettings.md index 4261e83070c2..06faac8f0fb4 100644 --- a/docs/CROWDIN/el/Maintenance/ExportImportSettings.md +++ b/docs/CROWDIN/el/Maintenance/ExportImportSettings.md @@ -36,9 +36,16 @@ In case your main **AAPS** phone is lost or damaged, having a copy of the APK av **How to back-up:** Maintain a copy on the computer used to build the APK with Android Studio. Additionally, it is recommended to use a cloud platform to store a copy of the installer APK. Make sure you know how to locate both backups when needed. Consider setting up dedicated folders to store these backups. ### AAPS settings file (also referred to as 'Preferences') + +```{admonition} Where are preferences stored on my phone? +:class: tip +You will find your settings in the **AAPS Directory** you have selected during [AAPS setup](#SetupWizard-StoragePermission).
+You can also change the **AAPS Directory** in Preferences > [Maintenance Settings](#preferences-maintenance-settings). +``` + With a copy of the APK installer file (see above) and your **Settings** file, you can quickly get up and running on an existing or new phone. -The **Settings** file is used t customize the AAPS application to fit your specific setup. They encompass details such as your config builder settings, objective status, third-party communication settings (e.g., Nightscout, Tidepool), automations, and profiles. +The **Settings** file is used to customize the AAPS application to fit your specific setup. They encompass details such as your config builder settings, objective status, third-party communication settings (e.g., Nightscout, Tidepool), automations, and profiles. Exporting the AAPS settings to file enables you to restore its configuration to a specific point in time. As mentioned, in addition to all configuration settings, the export file also contains the status of your objectives, which you need to restore when **(re)installing** AAPS. Without this you will be required to redo all objectives from start to enable closed loop. Settings files also enable you to restore "last known good" settings for undoing any configuration changes. @@ -63,6 +70,12 @@ Exporting the AAPS settings to file enables you to restore its configuration to ## Settings Export +```{admonition} Where are preferences stored on my phone? +:class: tip +You will find your settings in the **AAPS Directory** you have selected during [AAPS setup](#SetupWizard-StoragePermission).
+You can also change the **AAPS Directory** in Preferences > [Maintenance Settings](#preferences-maintenance-settings). +``` + It is recommended to do regular settings exports, especially before and after making configuration changes. You can choose to do exports **manually or (preferred) through automation**. Make sure to take a note of your AAPS master password and to backup your settings files by copying them off your phone to for instance a cloud storage location. **Note**: _The exported settings will be encrypted with your AAPS master password: without the master password used for exporting you will be unable to import the settings file!_ @@ -85,6 +98,13 @@ _**Note:** On importing settings to user always needs to enter the AAPS password (ExportImportSettings-restoring-from-your-backups-on-a-new-phone-or-fresh-installation-of-aaps)= ## Restoring from your backups on a new phone or fresh installation of AAPS + +```{admonition} Where are preferences stored on my phone? +:class: tip +You will find your settings in the **AAPS Directory** you have selected during [AAPS setup](#SetupWizard-StoragePermission).
+You can also change the **AAPS Directory** in Preferences > [Maintenance Settings](#preferences-maintenance-settings). +``` + Use these instructions if you have a back-up of your APK and **Preferences** that you want to load on to a new phone or if you needed to delete and reinstall the APK on your existing phone for any reason. _If you are updating **AAPS** using an APK built with the same keystore you should not need to follow this process. However, it is still advised to create a back-up before you apply the update._ @@ -108,13 +128,15 @@ Importing a **Preferences** file will deactivate your current pod if those **Pre 5. From the **AAPS** home screen, set the master password in [Preferences > General > Protection](#Preferences-master-password) to the same password as you used with your back-ups. -6. From the **AAPS** home screen, select the three line (hamburger) menu in the top left > Maintenance > Export settings > type in Master password set above > Ok. This will create the preferences folder if it does not already exist on your phone. +6. If you haven't done it yet, [set the **AAPS Directory**](#preferences-maintenance-settings): from the **AAPS** home screen, select the three line (hamburger) menu in the top left > Maintenance > AAPS DIRECTORY. + +7. From the **AAPS** home screen, select the three line (hamburger) menu in the top left > Maintenance > Export settings > type in Master password set above > Ok. This will create the preferences folder if it does not already exist on your phone. -7. Download the back-up of your **Preferences** file from your cloud platform. +8. Download the back-up of your **Preferences** file from your cloud platform. -8. Use your file explorer (commonly called “Files” or “My Files”) to move the file from your downloads to `/internal storage/AAPS/preferences` +9. Use your file explorer (commonly called “Files” or “My Files”) to move the file from your downloads to `/internal storage/AAPS/preferences` if your **AAPS Directory** has been set `/internal storage/AAPS` -9. From the **AAPS** home screen, select the three line (hamburger) menu in the top left > Maintenance > Import settings > select the preferences file you want to back-up from > Ok > type in Master password set above > Ok. Make sure you select the correct preferences file, all .json files from the preferences folder will be shown. +10. From the **AAPS** home screen, select the three line (hamburger) menu in the top left > Maintenance > Import settings > select the preferences file you want to back-up from > Ok > type in Master password set above > Ok. Make sure you select the correct preferences file, all .json files from the preferences folder will be shown. ![AAPS import settings 1](../images/Maintenance/AAPS_ImportSettings1.png) ![AAPS import settings 2](../images/Maintenance/AAPS_ImportSettings2.png) diff --git a/docs/CROWDIN/el/SettingUpAaps/SetupWizard.md b/docs/CROWDIN/el/SettingUpAaps/SetupWizard.md index 214ed03cf2ad..3dd0b0ba984c 100644 --- a/docs/CROWDIN/el/SettingUpAaps/SetupWizard.md +++ b/docs/CROWDIN/el/SettingUpAaps/SetupWizard.md @@ -125,6 +125,8 @@ Follow these steps on Android 16, other versions will varies slightly from the p ![settings_apps](../images/setup-wizard/app_bluetooth_allow_background_unrestrict.png) +(SetupWizard-StoragePermission)= + ### Storage permission **AAPS** needs to log information to the permanent storage of your smartphone. Permanent storage means that it will be available even after rebooting your smartphone. Other information is just lost, as it is not saved to permanent storage. diff --git a/docs/CROWDIN/el/images/GoogleDriveInWebbrowser.png b/docs/CROWDIN/el/images/GoogleDriveInWebbrowser.png index 159f03ff2370..e682af001b15 100644 Binary files a/docs/CROWDIN/el/images/GoogleDriveInWebbrowser.png and b/docs/CROWDIN/el/images/GoogleDriveInWebbrowser.png differ diff --git a/docs/CROWDIN/el/images/GoogleDriveMobileAPPLaunch.png b/docs/CROWDIN/el/images/GoogleDriveMobileAPPLaunch.png index a021dd716fcf..f4ed9aa742a1 100644 Binary files a/docs/CROWDIN/el/images/GoogleDriveMobileAPPLaunch.png and b/docs/CROWDIN/el/images/GoogleDriveMobileAPPLaunch.png differ diff --git a/docs/CROWDIN/el/images/GoogleDriveMobileMissingSecuritySetting.png b/docs/CROWDIN/el/images/GoogleDriveMobileMissingSecuritySetting.png index ffc850fc5fe7..f53714dfbe20 100644 Binary files a/docs/CROWDIN/el/images/GoogleDriveMobileMissingSecuritySetting.png and b/docs/CROWDIN/el/images/GoogleDriveMobileMissingSecuritySetting.png differ diff --git a/docs/CROWDIN/el/images/GoogleDriveMobileSettingSecuritySetting.png b/docs/CROWDIN/el/images/GoogleDriveMobileSettingSecuritySetting.png index d0669d4fe98a..f53fec931a73 100644 Binary files a/docs/CROWDIN/el/images/GoogleDriveMobileSettingSecuritySetting.png and b/docs/CROWDIN/el/images/GoogleDriveMobileSettingSecuritySetting.png differ diff --git a/docs/CROWDIN/el/images/GoogleDriveMobileUploadedAPK.png b/docs/CROWDIN/el/images/GoogleDriveMobileUploadedAPK.png index dcb1a91655b6..ed45f83ad166 100644 Binary files a/docs/CROWDIN/el/images/GoogleDriveMobileUploadedAPK.png and b/docs/CROWDIN/el/images/GoogleDriveMobileUploadedAPK.png differ diff --git a/docs/CROWDIN/es/Maintenance/ExportImportSettings.md b/docs/CROWDIN/es/Maintenance/ExportImportSettings.md index 4261e83070c2..06faac8f0fb4 100644 --- a/docs/CROWDIN/es/Maintenance/ExportImportSettings.md +++ b/docs/CROWDIN/es/Maintenance/ExportImportSettings.md @@ -36,9 +36,16 @@ In case your main **AAPS** phone is lost or damaged, having a copy of the APK av **How to back-up:** Maintain a copy on the computer used to build the APK with Android Studio. Additionally, it is recommended to use a cloud platform to store a copy of the installer APK. Make sure you know how to locate both backups when needed. Consider setting up dedicated folders to store these backups. ### AAPS settings file (also referred to as 'Preferences') + +```{admonition} Where are preferences stored on my phone? +:class: tip +You will find your settings in the **AAPS Directory** you have selected during [AAPS setup](#SetupWizard-StoragePermission).
+You can also change the **AAPS Directory** in Preferences > [Maintenance Settings](#preferences-maintenance-settings). +``` + With a copy of the APK installer file (see above) and your **Settings** file, you can quickly get up and running on an existing or new phone. -The **Settings** file is used t customize the AAPS application to fit your specific setup. They encompass details such as your config builder settings, objective status, third-party communication settings (e.g., Nightscout, Tidepool), automations, and profiles. +The **Settings** file is used to customize the AAPS application to fit your specific setup. They encompass details such as your config builder settings, objective status, third-party communication settings (e.g., Nightscout, Tidepool), automations, and profiles. Exporting the AAPS settings to file enables you to restore its configuration to a specific point in time. As mentioned, in addition to all configuration settings, the export file also contains the status of your objectives, which you need to restore when **(re)installing** AAPS. Without this you will be required to redo all objectives from start to enable closed loop. Settings files also enable you to restore "last known good" settings for undoing any configuration changes. @@ -63,6 +70,12 @@ Exporting the AAPS settings to file enables you to restore its configuration to ## Settings Export +```{admonition} Where are preferences stored on my phone? +:class: tip +You will find your settings in the **AAPS Directory** you have selected during [AAPS setup](#SetupWizard-StoragePermission).
+You can also change the **AAPS Directory** in Preferences > [Maintenance Settings](#preferences-maintenance-settings). +``` + It is recommended to do regular settings exports, especially before and after making configuration changes. You can choose to do exports **manually or (preferred) through automation**. Make sure to take a note of your AAPS master password and to backup your settings files by copying them off your phone to for instance a cloud storage location. **Note**: _The exported settings will be encrypted with your AAPS master password: without the master password used for exporting you will be unable to import the settings file!_ @@ -85,6 +98,13 @@ _**Note:** On importing settings to user always needs to enter the AAPS password (ExportImportSettings-restoring-from-your-backups-on-a-new-phone-or-fresh-installation-of-aaps)= ## Restoring from your backups on a new phone or fresh installation of AAPS + +```{admonition} Where are preferences stored on my phone? +:class: tip +You will find your settings in the **AAPS Directory** you have selected during [AAPS setup](#SetupWizard-StoragePermission).
+You can also change the **AAPS Directory** in Preferences > [Maintenance Settings](#preferences-maintenance-settings). +``` + Use these instructions if you have a back-up of your APK and **Preferences** that you want to load on to a new phone or if you needed to delete and reinstall the APK on your existing phone for any reason. _If you are updating **AAPS** using an APK built with the same keystore you should not need to follow this process. However, it is still advised to create a back-up before you apply the update._ @@ -108,13 +128,15 @@ Importing a **Preferences** file will deactivate your current pod if those **Pre 5. From the **AAPS** home screen, set the master password in [Preferences > General > Protection](#Preferences-master-password) to the same password as you used with your back-ups. -6. From the **AAPS** home screen, select the three line (hamburger) menu in the top left > Maintenance > Export settings > type in Master password set above > Ok. This will create the preferences folder if it does not already exist on your phone. +6. If you haven't done it yet, [set the **AAPS Directory**](#preferences-maintenance-settings): from the **AAPS** home screen, select the three line (hamburger) menu in the top left > Maintenance > AAPS DIRECTORY. + +7. From the **AAPS** home screen, select the three line (hamburger) menu in the top left > Maintenance > Export settings > type in Master password set above > Ok. This will create the preferences folder if it does not already exist on your phone. -7. Download the back-up of your **Preferences** file from your cloud platform. +8. Download the back-up of your **Preferences** file from your cloud platform. -8. Use your file explorer (commonly called “Files” or “My Files”) to move the file from your downloads to `/internal storage/AAPS/preferences` +9. Use your file explorer (commonly called “Files” or “My Files”) to move the file from your downloads to `/internal storage/AAPS/preferences` if your **AAPS Directory** has been set `/internal storage/AAPS` -9. From the **AAPS** home screen, select the three line (hamburger) menu in the top left > Maintenance > Import settings > select the preferences file you want to back-up from > Ok > type in Master password set above > Ok. Make sure you select the correct preferences file, all .json files from the preferences folder will be shown. +10. From the **AAPS** home screen, select the three line (hamburger) menu in the top left > Maintenance > Import settings > select the preferences file you want to back-up from > Ok > type in Master password set above > Ok. Make sure you select the correct preferences file, all .json files from the preferences folder will be shown. ![AAPS import settings 1](../images/Maintenance/AAPS_ImportSettings1.png) ![AAPS import settings 2](../images/Maintenance/AAPS_ImportSettings2.png) diff --git a/docs/CROWDIN/es/SettingUpAaps/SetupWizard.md b/docs/CROWDIN/es/SettingUpAaps/SetupWizard.md index f442a5accdaa..c235322f1786 100644 --- a/docs/CROWDIN/es/SettingUpAaps/SetupWizard.md +++ b/docs/CROWDIN/es/SettingUpAaps/SetupWizard.md @@ -125,6 +125,8 @@ Follow these steps on Android 16, other versions will varies slightly from the p ![settings_apps](../images/setup-wizard/app_bluetooth_allow_background_unrestrict.png) +(SetupWizard-StoragePermission)= + ### Storage permission **AAPS** needs to log information to the permanent storage of your smartphone. Permanent storage means that it will be available even after rebooting your smartphone. Other information is just lost, as it is not saved to permanent storage. diff --git a/docs/CROWDIN/es/images/GoogleDriveInWebbrowser.png b/docs/CROWDIN/es/images/GoogleDriveInWebbrowser.png index 159f03ff2370..e682af001b15 100644 Binary files a/docs/CROWDIN/es/images/GoogleDriveInWebbrowser.png and b/docs/CROWDIN/es/images/GoogleDriveInWebbrowser.png differ diff --git a/docs/CROWDIN/es/images/GoogleDriveMobileAPPLaunch.png b/docs/CROWDIN/es/images/GoogleDriveMobileAPPLaunch.png index a021dd716fcf..f4ed9aa742a1 100644 Binary files a/docs/CROWDIN/es/images/GoogleDriveMobileAPPLaunch.png and b/docs/CROWDIN/es/images/GoogleDriveMobileAPPLaunch.png differ diff --git a/docs/CROWDIN/es/images/GoogleDriveMobileMissingSecuritySetting.png b/docs/CROWDIN/es/images/GoogleDriveMobileMissingSecuritySetting.png index ffc850fc5fe7..f53714dfbe20 100644 Binary files a/docs/CROWDIN/es/images/GoogleDriveMobileMissingSecuritySetting.png and b/docs/CROWDIN/es/images/GoogleDriveMobileMissingSecuritySetting.png differ diff --git a/docs/CROWDIN/es/images/GoogleDriveMobileSettingSecuritySetting.png b/docs/CROWDIN/es/images/GoogleDriveMobileSettingSecuritySetting.png index d0669d4fe98a..f53fec931a73 100644 Binary files a/docs/CROWDIN/es/images/GoogleDriveMobileSettingSecuritySetting.png and b/docs/CROWDIN/es/images/GoogleDriveMobileSettingSecuritySetting.png differ diff --git a/docs/CROWDIN/es/images/GoogleDriveMobileUploadedAPK.png b/docs/CROWDIN/es/images/GoogleDriveMobileUploadedAPK.png index dcb1a91655b6..ed45f83ad166 100644 Binary files a/docs/CROWDIN/es/images/GoogleDriveMobileUploadedAPK.png and b/docs/CROWDIN/es/images/GoogleDriveMobileUploadedAPK.png differ diff --git a/docs/CROWDIN/fr/Maintenance/ExportImportSettings.md b/docs/CROWDIN/fr/Maintenance/ExportImportSettings.md index 590ce5552fdd..492bbc4c05c0 100644 --- a/docs/CROWDIN/fr/Maintenance/ExportImportSettings.md +++ b/docs/CROWDIN/fr/Maintenance/ExportImportSettings.md @@ -36,9 +36,16 @@ In case your main **AAPS** phone is lost or damaged, having a copy of the APK av **How to back-up:** Maintain a copy on the computer used to build the APK with Android Studio. Additionally, it is recommended to use a cloud platform to store a copy of the installer APK. Make sure you know how to locate both backups when needed. Consider setting up dedicated folders to store these backups. ### AAPS settings file (also referred to as 'Preferences') + +```{admonition} Where are preferences stored on my phone? +:class: tip +You will find your settings in the **AAPS Directory** you have selected during [AAPS setup](#SetupWizard-StoragePermission).
+You can also change the **AAPS Directory** in Preferences > [Maintenance Settings](#preferences-maintenance-settings). +``` + With a copy of the APK installer file (see above) and your **Settings** file, you can quickly get up and running on an existing or new phone. -The **Settings** file is used t customize the AAPS application to fit your specific setup. They encompass details such as your config builder settings, objective status, third-party communication settings (e.g., Nightscout, Tidepool), automations, and profiles. +The **Settings** file is used to customize the AAPS application to fit your specific setup. They encompass details such as your config builder settings, objective status, third-party communication settings (e.g., Nightscout, Tidepool), automations, and profiles. Exporting the AAPS settings to file enables you to restore its configuration to a specific point in time. As mentioned, in addition to all configuration settings, the export file also contains the status of your objectives, which you need to restore when **(re)installing** AAPS. Without this you will be required to redo all objectives from start to enable closed loop. Settings files also enable you to restore "last known good" settings for undoing any configuration changes. @@ -63,6 +70,12 @@ Exporting the AAPS settings to file enables you to restore its configuration to ## Settings Export +```{admonition} Where are preferences stored on my phone? +:class: tip +You will find your settings in the **AAPS Directory** you have selected during [AAPS setup](#SetupWizard-StoragePermission).
+You can also change the **AAPS Directory** in Preferences > [Maintenance Settings](#preferences-maintenance-settings). +``` + It is recommended to do regular settings exports, especially before and after making configuration changes. You can choose to do exports **manually or (preferred) through automation**. Make sure to take a note of your AAPS master password and to backup your settings files by copying them off your phone to for instance a cloud storage location. **Note**: _The exported settings will be encrypted with your AAPS master password: without the master password used for exporting you will be unable to import the settings file!_ @@ -85,6 +98,13 @@ _**Note:** On importing settings to user always needs to enter the AAPS password (ExportImportSettings-restoring-from-your-backups-on-a-new-phone-or-fresh-installation-of-aaps)= ## Restoring from your backups on a new phone or fresh installation of AAPS + +```{admonition} Where are preferences stored on my phone? +:class: tip +You will find your settings in the **AAPS Directory** you have selected during [AAPS setup](#SetupWizard-StoragePermission).
+You can also change the **AAPS Directory** in Preferences > [Maintenance Settings](#preferences-maintenance-settings). +``` + Use these instructions if you have a back-up of your APK and **Preferences** that you want to load on to a new phone or if you needed to delete and reinstall the APK on your existing phone for any reason. _If you are updating **AAPS** using an APK built with the same keystore you should not need to follow this process. However, it is still advised to create a back-up before you apply the update._ @@ -108,13 +128,15 @@ Importing a **Preferences** file will deactivate your current pod if those **Pre 5. From the **AAPS** home screen, set the master password in [Preferences > General > Protection](#Preferences-master-password) to the same password as you used with your back-ups. -6. From the **AAPS** home screen, select the three line (hamburger) menu in the top left > Maintenance > Export settings > type in Master password set above > Ok. This will create the preferences folder if it does not already exist on your phone. +6. If you haven't done it yet, [set the **AAPS Directory**](#preferences-maintenance-settings): from the **AAPS** home screen, select the three line (hamburger) menu in the top left > Maintenance > AAPS DIRECTORY. + +7. From the **AAPS** home screen, select the three line (hamburger) menu in the top left > Maintenance > Export settings > type in Master password set above > Ok. This will create the preferences folder if it does not already exist on your phone. -7. Download the back-up of your **Preferences** file from your cloud platform. +8. Download the back-up of your **Preferences** file from your cloud platform. -8. Use your file explorer (commonly called “Files” or “My Files”) to move the file from your downloads to `/internal storage/AAPS/preferences` +9. Use your file explorer (commonly called “Files” or “My Files”) to move the file from your downloads to `/internal storage/AAPS/preferences` if your **AAPS Directory** has been set `/internal storage/AAPS` -9. From the **AAPS** home screen, select the three line (hamburger) menu in the top left > Maintenance > Import settings > select the preferences file you want to back-up from > Ok > type in Master password set above > Ok. Make sure you select the correct preferences file, all .json files from the preferences folder will be shown. +10. From the **AAPS** home screen, select the three line (hamburger) menu in the top left > Maintenance > Import settings > select the preferences file you want to back-up from > Ok > type in Master password set above > Ok. Make sure you select the correct preferences file, all .json files from the preferences folder will be shown. ![AAPS import settings 1](../images/Maintenance/AAPS_ImportSettings1.png) ![AAPS import settings 2](../images/Maintenance/AAPS_ImportSettings2.png) diff --git a/docs/CROWDIN/fr/SettingUpAaps/SetupWizard.md b/docs/CROWDIN/fr/SettingUpAaps/SetupWizard.md index 001e0b1881e9..eae47eb21499 100644 --- a/docs/CROWDIN/fr/SettingUpAaps/SetupWizard.md +++ b/docs/CROWDIN/fr/SettingUpAaps/SetupWizard.md @@ -125,6 +125,8 @@ Follow these steps on Android 16, other versions will varies slightly from the p ![settings_apps](../images/setup-wizard/app_bluetooth_allow_background_unrestrict.png) +(SetupWizard-StoragePermission)= + ### Storage permission **AAPS** needs to log information to the permanent storage of your smartphone. Ce stockage permanent sur la mémoire interne signifie que les fichiers seront toujours disponibles, même après le redémarrage de votre smartphone. D'autres données sont simplement perdues, car elles ne sont pas enregistrées sur la mémoire interne. diff --git a/docs/CROWDIN/fr/images/GoogleDriveInWebbrowser.png b/docs/CROWDIN/fr/images/GoogleDriveInWebbrowser.png index 159f03ff2370..e682af001b15 100644 Binary files a/docs/CROWDIN/fr/images/GoogleDriveInWebbrowser.png and b/docs/CROWDIN/fr/images/GoogleDriveInWebbrowser.png differ diff --git a/docs/CROWDIN/fr/images/GoogleDriveMobileAPPLaunch.png b/docs/CROWDIN/fr/images/GoogleDriveMobileAPPLaunch.png index a021dd716fcf..f4ed9aa742a1 100644 Binary files a/docs/CROWDIN/fr/images/GoogleDriveMobileAPPLaunch.png and b/docs/CROWDIN/fr/images/GoogleDriveMobileAPPLaunch.png differ diff --git a/docs/CROWDIN/fr/images/GoogleDriveMobileMissingSecuritySetting.png b/docs/CROWDIN/fr/images/GoogleDriveMobileMissingSecuritySetting.png index ffc850fc5fe7..f53714dfbe20 100644 Binary files a/docs/CROWDIN/fr/images/GoogleDriveMobileMissingSecuritySetting.png and b/docs/CROWDIN/fr/images/GoogleDriveMobileMissingSecuritySetting.png differ diff --git a/docs/CROWDIN/fr/images/GoogleDriveMobileSettingSecuritySetting.png b/docs/CROWDIN/fr/images/GoogleDriveMobileSettingSecuritySetting.png index d0669d4fe98a..f53fec931a73 100644 Binary files a/docs/CROWDIN/fr/images/GoogleDriveMobileSettingSecuritySetting.png and b/docs/CROWDIN/fr/images/GoogleDriveMobileSettingSecuritySetting.png differ diff --git a/docs/CROWDIN/fr/images/GoogleDriveMobileUploadedAPK.png b/docs/CROWDIN/fr/images/GoogleDriveMobileUploadedAPK.png index dcb1a91655b6..ed45f83ad166 100644 Binary files a/docs/CROWDIN/fr/images/GoogleDriveMobileUploadedAPK.png and b/docs/CROWDIN/fr/images/GoogleDriveMobileUploadedAPK.png differ diff --git a/docs/CROWDIN/he/Maintenance/ExportImportSettings.md b/docs/CROWDIN/he/Maintenance/ExportImportSettings.md index e0eb637a53c2..78771c7325b6 100644 --- a/docs/CROWDIN/he/Maintenance/ExportImportSettings.md +++ b/docs/CROWDIN/he/Maintenance/ExportImportSettings.md @@ -36,9 +36,16 @@ In case your main **AAPS** phone is lost or damaged, having a copy of the APK av **How to back-up:** Maintain a copy on the computer used to build the APK with Android Studio. Additionally, it is recommended to use a cloud platform to store a copy of the installer APK. Make sure you know how to locate both backups when needed. Consider setting up dedicated folders to store these backups. ### AAPS settings file (also referred to as 'Preferences') + +```{admonition} Where are preferences stored on my phone? +:class: tip +You will find your settings in the **AAPS Directory** you have selected during [AAPS setup](#SetupWizard-StoragePermission).
+You can also change the **AAPS Directory** in Preferences > [Maintenance Settings](#preferences-maintenance-settings). +``` + With a copy of the APK installer file (see above) and your **Settings** file, you can quickly get up and running on an existing or new phone. -The **Settings** file is used t customize the AAPS application to fit your specific setup. They encompass details such as your config builder settings, objective status, third-party communication settings (e.g., Nightscout, Tidepool), automations, and profiles. +The **Settings** file is used to customize the AAPS application to fit your specific setup. They encompass details such as your config builder settings, objective status, third-party communication settings (e.g., Nightscout, Tidepool), automations, and profiles. Exporting the AAPS settings to file enables you to restore its configuration to a specific point in time. As mentioned, in addition to all configuration settings, the export file also contains the status of your objectives, which you need to restore when **(re)installing** AAPS. Without this you will be required to redo all objectives from start to enable closed loop. Settings files also enable you to restore "last known good" settings for undoing any configuration changes. @@ -63,6 +70,12 @@ Exporting the AAPS settings to file enables you to restore its configuration to ## Settings Export +```{admonition} Where are preferences stored on my phone? +:class: tip +You will find your settings in the **AAPS Directory** you have selected during [AAPS setup](#SetupWizard-StoragePermission).
+You can also change the **AAPS Directory** in Preferences > [Maintenance Settings](#preferences-maintenance-settings). +``` + It is recommended to do regular settings exports, especially before and after making configuration changes. You can choose to do exports **manually or (preferred) through automation**. Make sure to take a note of your AAPS master password and to backup your settings files by copying them off your phone to for instance a cloud storage location. **Note**: _The exported settings will be encrypted with your AAPS master password: without the master password used for exporting you will be unable to import the settings file!_ @@ -85,6 +98,13 @@ _**Note:** On importing settings to user always needs to enter the AAPS password (ExportImportSettings-restoring-from-your-backups-on-a-new-phone-or-fresh-installation-of-aaps)= ## Restoring from your backups on a new phone or fresh installation of AAPS + +```{admonition} Where are preferences stored on my phone? +:class: tip +You will find your settings in the **AAPS Directory** you have selected during [AAPS setup](#SetupWizard-StoragePermission).
+You can also change the **AAPS Directory** in Preferences > [Maintenance Settings](#preferences-maintenance-settings). +``` + Use these instructions if you have a back-up of your APK and **Preferences** that you want to load on to a new phone or if you needed to delete and reinstall the APK on your existing phone for any reason. _If you are updating **AAPS** using an APK built with the same keystore you should not need to follow this process. However, it is still advised to create a back-up before you apply the update._ @@ -108,13 +128,15 @@ Importing a **Preferences** file will deactivate your current pod if those **Pre 5. From the **AAPS** home screen, set the master password in [Preferences > General > Protection](#Preferences-master-password) to the same password as you used with your back-ups. -6. From the **AAPS** home screen, select the three line (hamburger) menu in the top left > Maintenance > Export settings > type in Master password set above > Ok. This will create the preferences folder if it does not already exist on your phone. +6. If you haven't done it yet, [set the **AAPS Directory**](#preferences-maintenance-settings): from the **AAPS** home screen, select the three line (hamburger) menu in the top left > Maintenance > AAPS DIRECTORY. + +7. From the **AAPS** home screen, select the three line (hamburger) menu in the top left > Maintenance > Export settings > type in Master password set above > Ok. This will create the preferences folder if it does not already exist on your phone. -7. Download the back-up of your **Preferences** file from your cloud platform. +8. Download the back-up of your **Preferences** file from your cloud platform. -8. Use your file explorer (commonly called “Files” or “My Files”) to move the file from your downloads to `/internal storage/AAPS/preferences` +9. Use your file explorer (commonly called “Files” or “My Files”) to move the file from your downloads to `/internal storage/AAPS/preferences` if your **AAPS Directory** has been set `/internal storage/AAPS` -9. From the **AAPS** home screen, select the three line (hamburger) menu in the top left > Maintenance > Import settings > select the preferences file you want to back-up from > Ok > type in Master password set above > Ok. Make sure you select the correct preferences file, all .json files from the preferences folder will be shown. +10. From the **AAPS** home screen, select the three line (hamburger) menu in the top left > Maintenance > Import settings > select the preferences file you want to back-up from > Ok > type in Master password set above > Ok. Make sure you select the correct preferences file, all .json files from the preferences folder will be shown. ![AAPS import settings 1](../images/Maintenance/AAPS_ImportSettings1.png) ![AAPS import settings 2](../images/Maintenance/AAPS_ImportSettings2.png) diff --git a/docs/CROWDIN/he/SettingUpAaps/SetupWizard.md b/docs/CROWDIN/he/SettingUpAaps/SetupWizard.md index df8026bda586..2f439663dd23 100644 --- a/docs/CROWDIN/he/SettingUpAaps/SetupWizard.md +++ b/docs/CROWDIN/he/SettingUpAaps/SetupWizard.md @@ -125,6 +125,8 @@ Follow these steps on Android 16, other versions will varies slightly from the p ![settings_apps](../images/setup-wizard/app_bluetooth_allow_background_unrestrict.png) +(SetupWizard-StoragePermission)= + ### Storage permission **AAPS** needs to log information to the permanent storage of your smartphone. Permanent storage means that it will be available even after rebooting your smartphone. Other information is just lost, as it is not saved to permanent storage. diff --git a/docs/CROWDIN/he/images/GoogleDriveInWebbrowser.png b/docs/CROWDIN/he/images/GoogleDriveInWebbrowser.png index 159f03ff2370..e682af001b15 100644 Binary files a/docs/CROWDIN/he/images/GoogleDriveInWebbrowser.png and b/docs/CROWDIN/he/images/GoogleDriveInWebbrowser.png differ diff --git a/docs/CROWDIN/he/images/GoogleDriveMobileAPPLaunch.png b/docs/CROWDIN/he/images/GoogleDriveMobileAPPLaunch.png index a021dd716fcf..f4ed9aa742a1 100644 Binary files a/docs/CROWDIN/he/images/GoogleDriveMobileAPPLaunch.png and b/docs/CROWDIN/he/images/GoogleDriveMobileAPPLaunch.png differ diff --git a/docs/CROWDIN/he/images/GoogleDriveMobileMissingSecuritySetting.png b/docs/CROWDIN/he/images/GoogleDriveMobileMissingSecuritySetting.png index ffc850fc5fe7..f53714dfbe20 100644 Binary files a/docs/CROWDIN/he/images/GoogleDriveMobileMissingSecuritySetting.png and b/docs/CROWDIN/he/images/GoogleDriveMobileMissingSecuritySetting.png differ diff --git a/docs/CROWDIN/he/images/GoogleDriveMobileSettingSecuritySetting.png b/docs/CROWDIN/he/images/GoogleDriveMobileSettingSecuritySetting.png index d0669d4fe98a..f53fec931a73 100644 Binary files a/docs/CROWDIN/he/images/GoogleDriveMobileSettingSecuritySetting.png and b/docs/CROWDIN/he/images/GoogleDriveMobileSettingSecuritySetting.png differ diff --git a/docs/CROWDIN/he/images/GoogleDriveMobileUploadedAPK.png b/docs/CROWDIN/he/images/GoogleDriveMobileUploadedAPK.png index dcb1a91655b6..ed45f83ad166 100644 Binary files a/docs/CROWDIN/he/images/GoogleDriveMobileUploadedAPK.png and b/docs/CROWDIN/he/images/GoogleDriveMobileUploadedAPK.png differ diff --git a/docs/CROWDIN/ko/Maintenance/ExportImportSettings.md b/docs/CROWDIN/ko/Maintenance/ExportImportSettings.md index 4261e83070c2..06faac8f0fb4 100644 --- a/docs/CROWDIN/ko/Maintenance/ExportImportSettings.md +++ b/docs/CROWDIN/ko/Maintenance/ExportImportSettings.md @@ -36,9 +36,16 @@ In case your main **AAPS** phone is lost or damaged, having a copy of the APK av **How to back-up:** Maintain a copy on the computer used to build the APK with Android Studio. Additionally, it is recommended to use a cloud platform to store a copy of the installer APK. Make sure you know how to locate both backups when needed. Consider setting up dedicated folders to store these backups. ### AAPS settings file (also referred to as 'Preferences') + +```{admonition} Where are preferences stored on my phone? +:class: tip +You will find your settings in the **AAPS Directory** you have selected during [AAPS setup](#SetupWizard-StoragePermission).
+You can also change the **AAPS Directory** in Preferences > [Maintenance Settings](#preferences-maintenance-settings). +``` + With a copy of the APK installer file (see above) and your **Settings** file, you can quickly get up and running on an existing or new phone. -The **Settings** file is used t customize the AAPS application to fit your specific setup. They encompass details such as your config builder settings, objective status, third-party communication settings (e.g., Nightscout, Tidepool), automations, and profiles. +The **Settings** file is used to customize the AAPS application to fit your specific setup. They encompass details such as your config builder settings, objective status, third-party communication settings (e.g., Nightscout, Tidepool), automations, and profiles. Exporting the AAPS settings to file enables you to restore its configuration to a specific point in time. As mentioned, in addition to all configuration settings, the export file also contains the status of your objectives, which you need to restore when **(re)installing** AAPS. Without this you will be required to redo all objectives from start to enable closed loop. Settings files also enable you to restore "last known good" settings for undoing any configuration changes. @@ -63,6 +70,12 @@ Exporting the AAPS settings to file enables you to restore its configuration to ## Settings Export +```{admonition} Where are preferences stored on my phone? +:class: tip +You will find your settings in the **AAPS Directory** you have selected during [AAPS setup](#SetupWizard-StoragePermission).
+You can also change the **AAPS Directory** in Preferences > [Maintenance Settings](#preferences-maintenance-settings). +``` + It is recommended to do regular settings exports, especially before and after making configuration changes. You can choose to do exports **manually or (preferred) through automation**. Make sure to take a note of your AAPS master password and to backup your settings files by copying them off your phone to for instance a cloud storage location. **Note**: _The exported settings will be encrypted with your AAPS master password: without the master password used for exporting you will be unable to import the settings file!_ @@ -85,6 +98,13 @@ _**Note:** On importing settings to user always needs to enter the AAPS password (ExportImportSettings-restoring-from-your-backups-on-a-new-phone-or-fresh-installation-of-aaps)= ## Restoring from your backups on a new phone or fresh installation of AAPS + +```{admonition} Where are preferences stored on my phone? +:class: tip +You will find your settings in the **AAPS Directory** you have selected during [AAPS setup](#SetupWizard-StoragePermission).
+You can also change the **AAPS Directory** in Preferences > [Maintenance Settings](#preferences-maintenance-settings). +``` + Use these instructions if you have a back-up of your APK and **Preferences** that you want to load on to a new phone or if you needed to delete and reinstall the APK on your existing phone for any reason. _If you are updating **AAPS** using an APK built with the same keystore you should not need to follow this process. However, it is still advised to create a back-up before you apply the update._ @@ -108,13 +128,15 @@ Importing a **Preferences** file will deactivate your current pod if those **Pre 5. From the **AAPS** home screen, set the master password in [Preferences > General > Protection](#Preferences-master-password) to the same password as you used with your back-ups. -6. From the **AAPS** home screen, select the three line (hamburger) menu in the top left > Maintenance > Export settings > type in Master password set above > Ok. This will create the preferences folder if it does not already exist on your phone. +6. If you haven't done it yet, [set the **AAPS Directory**](#preferences-maintenance-settings): from the **AAPS** home screen, select the three line (hamburger) menu in the top left > Maintenance > AAPS DIRECTORY. + +7. From the **AAPS** home screen, select the three line (hamburger) menu in the top left > Maintenance > Export settings > type in Master password set above > Ok. This will create the preferences folder if it does not already exist on your phone. -7. Download the back-up of your **Preferences** file from your cloud platform. +8. Download the back-up of your **Preferences** file from your cloud platform. -8. Use your file explorer (commonly called “Files” or “My Files”) to move the file from your downloads to `/internal storage/AAPS/preferences` +9. Use your file explorer (commonly called “Files” or “My Files”) to move the file from your downloads to `/internal storage/AAPS/preferences` if your **AAPS Directory** has been set `/internal storage/AAPS` -9. From the **AAPS** home screen, select the three line (hamburger) menu in the top left > Maintenance > Import settings > select the preferences file you want to back-up from > Ok > type in Master password set above > Ok. Make sure you select the correct preferences file, all .json files from the preferences folder will be shown. +10. From the **AAPS** home screen, select the three line (hamburger) menu in the top left > Maintenance > Import settings > select the preferences file you want to back-up from > Ok > type in Master password set above > Ok. Make sure you select the correct preferences file, all .json files from the preferences folder will be shown. ![AAPS import settings 1](../images/Maintenance/AAPS_ImportSettings1.png) ![AAPS import settings 2](../images/Maintenance/AAPS_ImportSettings2.png) diff --git a/docs/CROWDIN/ko/SettingUpAaps/SetupWizard.md b/docs/CROWDIN/ko/SettingUpAaps/SetupWizard.md index 312beca6b00b..b1579d6c3653 100644 --- a/docs/CROWDIN/ko/SettingUpAaps/SetupWizard.md +++ b/docs/CROWDIN/ko/SettingUpAaps/SetupWizard.md @@ -125,6 +125,8 @@ Follow these steps on Android 16, other versions will varies slightly from the p ![settings_apps](../images/setup-wizard/app_bluetooth_allow_background_unrestrict.png) +(SetupWizard-StoragePermission)= + ### Storage permission **AAPS** needs to log information to the permanent storage of your smartphone. Permanent storage means that it will be available even after rebooting your smartphone. Other information is just lost, as it is not saved to permanent storage. diff --git a/docs/CROWDIN/ko/images/GoogleDriveInWebbrowser.png b/docs/CROWDIN/ko/images/GoogleDriveInWebbrowser.png index 159f03ff2370..e682af001b15 100644 Binary files a/docs/CROWDIN/ko/images/GoogleDriveInWebbrowser.png and b/docs/CROWDIN/ko/images/GoogleDriveInWebbrowser.png differ diff --git a/docs/CROWDIN/ko/images/GoogleDriveMobileAPPLaunch.png b/docs/CROWDIN/ko/images/GoogleDriveMobileAPPLaunch.png index a021dd716fcf..f4ed9aa742a1 100644 Binary files a/docs/CROWDIN/ko/images/GoogleDriveMobileAPPLaunch.png and b/docs/CROWDIN/ko/images/GoogleDriveMobileAPPLaunch.png differ diff --git a/docs/CROWDIN/ko/images/GoogleDriveMobileMissingSecuritySetting.png b/docs/CROWDIN/ko/images/GoogleDriveMobileMissingSecuritySetting.png index ffc850fc5fe7..f53714dfbe20 100644 Binary files a/docs/CROWDIN/ko/images/GoogleDriveMobileMissingSecuritySetting.png and b/docs/CROWDIN/ko/images/GoogleDriveMobileMissingSecuritySetting.png differ diff --git a/docs/CROWDIN/ko/images/GoogleDriveMobileSettingSecuritySetting.png b/docs/CROWDIN/ko/images/GoogleDriveMobileSettingSecuritySetting.png index d0669d4fe98a..f53fec931a73 100644 Binary files a/docs/CROWDIN/ko/images/GoogleDriveMobileSettingSecuritySetting.png and b/docs/CROWDIN/ko/images/GoogleDriveMobileSettingSecuritySetting.png differ diff --git a/docs/CROWDIN/ko/images/GoogleDriveMobileUploadedAPK.png b/docs/CROWDIN/ko/images/GoogleDriveMobileUploadedAPK.png index dcb1a91655b6..ed45f83ad166 100644 Binary files a/docs/CROWDIN/ko/images/GoogleDriveMobileUploadedAPK.png and b/docs/CROWDIN/ko/images/GoogleDriveMobileUploadedAPK.png differ diff --git a/docs/CROWDIN/lt/Maintenance/ExportImportSettings.md b/docs/CROWDIN/lt/Maintenance/ExportImportSettings.md index 0fd61733fd49..d9d99f781aac 100644 --- a/docs/CROWDIN/lt/Maintenance/ExportImportSettings.md +++ b/docs/CROWDIN/lt/Maintenance/ExportImportSettings.md @@ -36,9 +36,16 @@ In case your main **AAPS** phone is lost or damaged, having a copy of the APK av **How to back-up:** Maintain a copy on the computer used to build the APK with Android Studio. Additionally, it is recommended to use a cloud platform to store a copy of the installer APK. Make sure you know how to locate both backups when needed. Consider setting up dedicated folders to store these backups. ### AAPS settings file (also referred to as 'Preferences') + +```{admonition} Where are preferences stored on my phone? +:class: tip +You will find your settings in the **AAPS Directory** you have selected during [AAPS setup](#SetupWizard-StoragePermission).
+You can also change the **AAPS Directory** in Preferences > [Maintenance Settings](#preferences-maintenance-settings). +``` + With a copy of the APK installer file (see above) and your **Settings** file, you can quickly get up and running on an existing or new phone. -The **Settings** file is used t customize the AAPS application to fit your specific setup. They encompass details such as your config builder settings, objective status, third-party communication settings (e.g., Nightscout, Tidepool), automations, and profiles. +The **Settings** file is used to customize the AAPS application to fit your specific setup. They encompass details such as your config builder settings, objective status, third-party communication settings (e.g., Nightscout, Tidepool), automations, and profiles. Exporting the AAPS settings to file enables you to restore its configuration to a specific point in time. As mentioned, in addition to all configuration settings, the export file also contains the status of your objectives, which you need to restore when **(re)installing** AAPS. Without this you will be required to redo all objectives from start to enable closed loop. Settings files also enable you to restore "last known good" settings for undoing any configuration changes. @@ -63,6 +70,12 @@ Exporting the AAPS settings to file enables you to restore its configuration to ## Settings Export +```{admonition} Where are preferences stored on my phone? +:class: tip +You will find your settings in the **AAPS Directory** you have selected during [AAPS setup](#SetupWizard-StoragePermission).
+You can also change the **AAPS Directory** in Preferences > [Maintenance Settings](#preferences-maintenance-settings). +``` + It is recommended to do regular settings exports, especially before and after making configuration changes. You can choose to do exports **manually or (preferred) through automation**. Make sure to take a note of your AAPS master password and to backup your settings files by copying them off your phone to for instance a cloud storage location. **Note**: _The exported settings will be encrypted with your AAPS master password: without the master password used for exporting you will be unable to import the settings file!_ @@ -85,6 +98,13 @@ _**Note:** On importing settings to user always needs to enter the AAPS password (ExportImportSettings-restoring-from-your-backups-on-a-new-phone-or-fresh-installation-of-aaps)= ## Restoring from your backups on a new phone or fresh installation of AAPS + +```{admonition} Where are preferences stored on my phone? +:class: tip +You will find your settings in the **AAPS Directory** you have selected during [AAPS setup](#SetupWizard-StoragePermission).
+You can also change the **AAPS Directory** in Preferences > [Maintenance Settings](#preferences-maintenance-settings). +``` + Use these instructions if you have a back-up of your APK and **Preferences** that you want to load on to a new phone or if you needed to delete and reinstall the APK on your existing phone for any reason. _If you are updating **AAPS** using an APK built with the same keystore you should not need to follow this process. However, it is still advised to create a back-up before you apply the update._ @@ -108,13 +128,15 @@ Importing a **Preferences** file will deactivate your current pod if those **Pre 5. From the **AAPS** home screen, set the master password in [Preferences > General > Protection](#Preferences-master-password) to the same password as you used with your back-ups. -6. From the **AAPS** home screen, select the three line (hamburger) menu in the top left > Maintenance > Export settings > type in Master password set above > Ok. This will create the preferences folder if it does not already exist on your phone. +6. If you haven't done it yet, [set the **AAPS Directory**](#preferences-maintenance-settings): from the **AAPS** home screen, select the three line (hamburger) menu in the top left > Maintenance > AAPS DIRECTORY. + +7. From the **AAPS** home screen, select the three line (hamburger) menu in the top left > Maintenance > Export settings > type in Master password set above > Ok. This will create the preferences folder if it does not already exist on your phone. -7. Download the back-up of your **Preferences** file from your cloud platform. +8. Download the back-up of your **Preferences** file from your cloud platform. -8. Use your file explorer (commonly called “Files” or “My Files”) to move the file from your downloads to `/internal storage/AAPS/preferences` +9. Use your file explorer (commonly called “Files” or “My Files”) to move the file from your downloads to `/internal storage/AAPS/preferences` if your **AAPS Directory** has been set `/internal storage/AAPS` -9. From the **AAPS** home screen, select the three line (hamburger) menu in the top left > Maintenance > Import settings > select the preferences file you want to back-up from > Ok > type in Master password set above > Ok. Make sure you select the correct preferences file, all .json files from the preferences folder will be shown. +10. From the **AAPS** home screen, select the three line (hamburger) menu in the top left > Maintenance > Import settings > select the preferences file you want to back-up from > Ok > type in Master password set above > Ok. Make sure you select the correct preferences file, all .json files from the preferences folder will be shown. ![AAPS import settings 1](../images/Maintenance/AAPS_ImportSettings1.png) ![AAPS import settings 2](../images/Maintenance/AAPS_ImportSettings2.png) diff --git a/docs/CROWDIN/lt/SettingUpAaps/SetupWizard.md b/docs/CROWDIN/lt/SettingUpAaps/SetupWizard.md index a3ff3063147f..d2a1091605b1 100644 --- a/docs/CROWDIN/lt/SettingUpAaps/SetupWizard.md +++ b/docs/CROWDIN/lt/SettingUpAaps/SetupWizard.md @@ -125,6 +125,8 @@ Follow these steps on Android 16, other versions will varies slightly from the p ![settings_apps](../images/setup-wizard/app_bluetooth_allow_background_unrestrict.png) +(SetupWizard-StoragePermission)= + ### Storage permission **AAPS** needs to log information to the permanent storage of your smartphone. Permanent storage means that it will be available even after rebooting your smartphone. Other information is just lost, as it is not saved to permanent storage. diff --git a/docs/CROWDIN/lt/images/GoogleDriveInWebbrowser.png b/docs/CROWDIN/lt/images/GoogleDriveInWebbrowser.png index 159f03ff2370..e682af001b15 100644 Binary files a/docs/CROWDIN/lt/images/GoogleDriveInWebbrowser.png and b/docs/CROWDIN/lt/images/GoogleDriveInWebbrowser.png differ diff --git a/docs/CROWDIN/lt/images/GoogleDriveMobileAPPLaunch.png b/docs/CROWDIN/lt/images/GoogleDriveMobileAPPLaunch.png index a021dd716fcf..f4ed9aa742a1 100644 Binary files a/docs/CROWDIN/lt/images/GoogleDriveMobileAPPLaunch.png and b/docs/CROWDIN/lt/images/GoogleDriveMobileAPPLaunch.png differ diff --git a/docs/CROWDIN/lt/images/GoogleDriveMobileMissingSecuritySetting.png b/docs/CROWDIN/lt/images/GoogleDriveMobileMissingSecuritySetting.png index ffc850fc5fe7..f53714dfbe20 100644 Binary files a/docs/CROWDIN/lt/images/GoogleDriveMobileMissingSecuritySetting.png and b/docs/CROWDIN/lt/images/GoogleDriveMobileMissingSecuritySetting.png differ diff --git a/docs/CROWDIN/lt/images/GoogleDriveMobileSettingSecuritySetting.png b/docs/CROWDIN/lt/images/GoogleDriveMobileSettingSecuritySetting.png index d0669d4fe98a..f53fec931a73 100644 Binary files a/docs/CROWDIN/lt/images/GoogleDriveMobileSettingSecuritySetting.png and b/docs/CROWDIN/lt/images/GoogleDriveMobileSettingSecuritySetting.png differ diff --git a/docs/CROWDIN/lt/images/GoogleDriveMobileUploadedAPK.png b/docs/CROWDIN/lt/images/GoogleDriveMobileUploadedAPK.png index dcb1a91655b6..ed45f83ad166 100644 Binary files a/docs/CROWDIN/lt/images/GoogleDriveMobileUploadedAPK.png and b/docs/CROWDIN/lt/images/GoogleDriveMobileUploadedAPK.png differ diff --git a/docs/CROWDIN/nl/Maintenance/ExportImportSettings.md b/docs/CROWDIN/nl/Maintenance/ExportImportSettings.md index 978e02684170..ac5514e5f907 100644 --- a/docs/CROWDIN/nl/Maintenance/ExportImportSettings.md +++ b/docs/CROWDIN/nl/Maintenance/ExportImportSettings.md @@ -36,9 +36,16 @@ In case your main **AAPS** phone is lost or damaged, having a copy of the APK av **How to back-up:** Maintain a copy on the computer used to build the APK with Android Studio. Additionally, it is recommended to use a cloud platform to store a copy of the installer APK. Make sure you know how to locate both backups when needed. Consider setting up dedicated folders to store these backups. ### AAPS settings file (also referred to as 'Preferences') + +```{admonition} Where are preferences stored on my phone? +:class: tip +You will find your settings in the **AAPS Directory** you have selected during [AAPS setup](#SetupWizard-StoragePermission).
+You can also change the **AAPS Directory** in Preferences > [Maintenance Settings](#preferences-maintenance-settings). +``` + With a copy of the APK installer file (see above) and your **Settings** file, you can quickly get up and running on an existing or new phone. -The **Settings** file is used t customize the AAPS application to fit your specific setup. They encompass details such as your config builder settings, objective status, third-party communication settings (e.g., Nightscout, Tidepool), automations, and profiles. +The **Settings** file is used to customize the AAPS application to fit your specific setup. They encompass details such as your config builder settings, objective status, third-party communication settings (e.g., Nightscout, Tidepool), automations, and profiles. Exporting the AAPS settings to file enables you to restore its configuration to a specific point in time. As mentioned, in addition to all configuration settings, the export file also contains the status of your objectives, which you need to restore when **(re)installing** AAPS. Without this you will be required to redo all objectives from start to enable closed loop. Settings files also enable you to restore "last known good" settings for undoing any configuration changes. @@ -63,6 +70,12 @@ Exporting the AAPS settings to file enables you to restore its configuration to ## Settings Export +```{admonition} Where are preferences stored on my phone? +:class: tip +You will find your settings in the **AAPS Directory** you have selected during [AAPS setup](#SetupWizard-StoragePermission).
+You can also change the **AAPS Directory** in Preferences > [Maintenance Settings](#preferences-maintenance-settings). +``` + It is recommended to do regular settings exports, especially before and after making configuration changes. You can choose to do exports **manually or (preferred) through automation**. Make sure to take a note of your AAPS master password and to backup your settings files by copying them off your phone to for instance a cloud storage location. **Note**: _The exported settings will be encrypted with your AAPS master password: without the master password used for exporting you will be unable to import the settings file!_ @@ -85,6 +98,13 @@ _**Note:** On importing settings to user always needs to enter the AAPS password (ExportImportSettings-restoring-from-your-backups-on-a-new-phone-or-fresh-installation-of-aaps)= ## Restoring from your backups on a new phone or fresh installation of AAPS + +```{admonition} Where are preferences stored on my phone? +:class: tip +You will find your settings in the **AAPS Directory** you have selected during [AAPS setup](#SetupWizard-StoragePermission).
+You can also change the **AAPS Directory** in Preferences > [Maintenance Settings](#preferences-maintenance-settings). +``` + Use these instructions if you have a back-up of your APK and **Preferences** that you want to load on to a new phone or if you needed to delete and reinstall the APK on your existing phone for any reason. _If you are updating **AAPS** using an APK built with the same keystore you should not need to follow this process. However, it is still advised to create a back-up before you apply the update._ @@ -108,13 +128,15 @@ Importing a **Preferences** file will deactivate your current pod if those **Pre 5. From the **AAPS** home screen, set the master password in [Preferences > General > Protection](#Preferences-master-password) to the same password as you used with your back-ups. -6. From the **AAPS** home screen, select the three line (hamburger) menu in the top left > Maintenance > Export settings > type in Master password set above > Ok. This will create the preferences folder if it does not already exist on your phone. +6. If you haven't done it yet, [set the **AAPS Directory**](#preferences-maintenance-settings): from the **AAPS** home screen, select the three line (hamburger) menu in the top left > Maintenance > AAPS DIRECTORY. + +7. From the **AAPS** home screen, select the three line (hamburger) menu in the top left > Maintenance > Export settings > type in Master password set above > Ok. This will create the preferences folder if it does not already exist on your phone. -7. Download the back-up of your **Preferences** file from your cloud platform. +8. Download the back-up of your **Preferences** file from your cloud platform. -8. Use your file explorer (commonly called “Files” or “My Files”) to move the file from your downloads to `/internal storage/AAPS/preferences` +9. Use your file explorer (commonly called “Files” or “My Files”) to move the file from your downloads to `/internal storage/AAPS/preferences` if your **AAPS Directory** has been set `/internal storage/AAPS` -9. From the **AAPS** home screen, select the three line (hamburger) menu in the top left > Maintenance > Import settings > select the preferences file you want to back-up from > Ok > type in Master password set above > Ok. Make sure you select the correct preferences file, all .json files from the preferences folder will be shown. +10. From the **AAPS** home screen, select the three line (hamburger) menu in the top left > Maintenance > Import settings > select the preferences file you want to back-up from > Ok > type in Master password set above > Ok. Make sure you select the correct preferences file, all .json files from the preferences folder will be shown. ![AAPS import settings 1](../images/Maintenance/AAPS_ImportSettings1.png) ![AAPS import settings 2](../images/Maintenance/AAPS_ImportSettings2.png) diff --git a/docs/CROWDIN/nl/SettingUpAaps/SetupWizard.md b/docs/CROWDIN/nl/SettingUpAaps/SetupWizard.md index cf4125704f3b..9fa8cfdf5235 100644 --- a/docs/CROWDIN/nl/SettingUpAaps/SetupWizard.md +++ b/docs/CROWDIN/nl/SettingUpAaps/SetupWizard.md @@ -125,6 +125,8 @@ Follow these steps on Android 16, other versions will varies slightly from the p ![settings_apps](../images/setup-wizard/app_bluetooth_allow_background_unrestrict.png) +(SetupWizard-StoragePermission)= + ### Storage permission **AAPS** needs to log information to the permanent storage of your smartphone. Permanent storage means that it will be available even after rebooting your smartphone. Other information is just lost, as it is not saved to permanent storage. diff --git a/docs/CROWDIN/nl/images/GoogleDriveInWebbrowser.png b/docs/CROWDIN/nl/images/GoogleDriveInWebbrowser.png index 159f03ff2370..e682af001b15 100644 Binary files a/docs/CROWDIN/nl/images/GoogleDriveInWebbrowser.png and b/docs/CROWDIN/nl/images/GoogleDriveInWebbrowser.png differ diff --git a/docs/CROWDIN/nl/images/GoogleDriveMobileAPPLaunch.png b/docs/CROWDIN/nl/images/GoogleDriveMobileAPPLaunch.png index a021dd716fcf..f4ed9aa742a1 100644 Binary files a/docs/CROWDIN/nl/images/GoogleDriveMobileAPPLaunch.png and b/docs/CROWDIN/nl/images/GoogleDriveMobileAPPLaunch.png differ diff --git a/docs/CROWDIN/nl/images/GoogleDriveMobileMissingSecuritySetting.png b/docs/CROWDIN/nl/images/GoogleDriveMobileMissingSecuritySetting.png index ffc850fc5fe7..f53714dfbe20 100644 Binary files a/docs/CROWDIN/nl/images/GoogleDriveMobileMissingSecuritySetting.png and b/docs/CROWDIN/nl/images/GoogleDriveMobileMissingSecuritySetting.png differ diff --git a/docs/CROWDIN/nl/images/GoogleDriveMobileSettingSecuritySetting.png b/docs/CROWDIN/nl/images/GoogleDriveMobileSettingSecuritySetting.png index d0669d4fe98a..f53fec931a73 100644 Binary files a/docs/CROWDIN/nl/images/GoogleDriveMobileSettingSecuritySetting.png and b/docs/CROWDIN/nl/images/GoogleDriveMobileSettingSecuritySetting.png differ diff --git a/docs/CROWDIN/nl/images/GoogleDriveMobileUploadedAPK.png b/docs/CROWDIN/nl/images/GoogleDriveMobileUploadedAPK.png index dcb1a91655b6..ed45f83ad166 100644 Binary files a/docs/CROWDIN/nl/images/GoogleDriveMobileUploadedAPK.png and b/docs/CROWDIN/nl/images/GoogleDriveMobileUploadedAPK.png differ diff --git a/docs/CROWDIN/pb/Maintenance/ExportImportSettings.md b/docs/CROWDIN/pb/Maintenance/ExportImportSettings.md index 4261e83070c2..06faac8f0fb4 100644 --- a/docs/CROWDIN/pb/Maintenance/ExportImportSettings.md +++ b/docs/CROWDIN/pb/Maintenance/ExportImportSettings.md @@ -36,9 +36,16 @@ In case your main **AAPS** phone is lost or damaged, having a copy of the APK av **How to back-up:** Maintain a copy on the computer used to build the APK with Android Studio. Additionally, it is recommended to use a cloud platform to store a copy of the installer APK. Make sure you know how to locate both backups when needed. Consider setting up dedicated folders to store these backups. ### AAPS settings file (also referred to as 'Preferences') + +```{admonition} Where are preferences stored on my phone? +:class: tip +You will find your settings in the **AAPS Directory** you have selected during [AAPS setup](#SetupWizard-StoragePermission).
+You can also change the **AAPS Directory** in Preferences > [Maintenance Settings](#preferences-maintenance-settings). +``` + With a copy of the APK installer file (see above) and your **Settings** file, you can quickly get up and running on an existing or new phone. -The **Settings** file is used t customize the AAPS application to fit your specific setup. They encompass details such as your config builder settings, objective status, third-party communication settings (e.g., Nightscout, Tidepool), automations, and profiles. +The **Settings** file is used to customize the AAPS application to fit your specific setup. They encompass details such as your config builder settings, objective status, third-party communication settings (e.g., Nightscout, Tidepool), automations, and profiles. Exporting the AAPS settings to file enables you to restore its configuration to a specific point in time. As mentioned, in addition to all configuration settings, the export file also contains the status of your objectives, which you need to restore when **(re)installing** AAPS. Without this you will be required to redo all objectives from start to enable closed loop. Settings files also enable you to restore "last known good" settings for undoing any configuration changes. @@ -63,6 +70,12 @@ Exporting the AAPS settings to file enables you to restore its configuration to ## Settings Export +```{admonition} Where are preferences stored on my phone? +:class: tip +You will find your settings in the **AAPS Directory** you have selected during [AAPS setup](#SetupWizard-StoragePermission).
+You can also change the **AAPS Directory** in Preferences > [Maintenance Settings](#preferences-maintenance-settings). +``` + It is recommended to do regular settings exports, especially before and after making configuration changes. You can choose to do exports **manually or (preferred) through automation**. Make sure to take a note of your AAPS master password and to backup your settings files by copying them off your phone to for instance a cloud storage location. **Note**: _The exported settings will be encrypted with your AAPS master password: without the master password used for exporting you will be unable to import the settings file!_ @@ -85,6 +98,13 @@ _**Note:** On importing settings to user always needs to enter the AAPS password (ExportImportSettings-restoring-from-your-backups-on-a-new-phone-or-fresh-installation-of-aaps)= ## Restoring from your backups on a new phone or fresh installation of AAPS + +```{admonition} Where are preferences stored on my phone? +:class: tip +You will find your settings in the **AAPS Directory** you have selected during [AAPS setup](#SetupWizard-StoragePermission).
+You can also change the **AAPS Directory** in Preferences > [Maintenance Settings](#preferences-maintenance-settings). +``` + Use these instructions if you have a back-up of your APK and **Preferences** that you want to load on to a new phone or if you needed to delete and reinstall the APK on your existing phone for any reason. _If you are updating **AAPS** using an APK built with the same keystore you should not need to follow this process. However, it is still advised to create a back-up before you apply the update._ @@ -108,13 +128,15 @@ Importing a **Preferences** file will deactivate your current pod if those **Pre 5. From the **AAPS** home screen, set the master password in [Preferences > General > Protection](#Preferences-master-password) to the same password as you used with your back-ups. -6. From the **AAPS** home screen, select the three line (hamburger) menu in the top left > Maintenance > Export settings > type in Master password set above > Ok. This will create the preferences folder if it does not already exist on your phone. +6. If you haven't done it yet, [set the **AAPS Directory**](#preferences-maintenance-settings): from the **AAPS** home screen, select the three line (hamburger) menu in the top left > Maintenance > AAPS DIRECTORY. + +7. From the **AAPS** home screen, select the three line (hamburger) menu in the top left > Maintenance > Export settings > type in Master password set above > Ok. This will create the preferences folder if it does not already exist on your phone. -7. Download the back-up of your **Preferences** file from your cloud platform. +8. Download the back-up of your **Preferences** file from your cloud platform. -8. Use your file explorer (commonly called “Files” or “My Files”) to move the file from your downloads to `/internal storage/AAPS/preferences` +9. Use your file explorer (commonly called “Files” or “My Files”) to move the file from your downloads to `/internal storage/AAPS/preferences` if your **AAPS Directory** has been set `/internal storage/AAPS` -9. From the **AAPS** home screen, select the three line (hamburger) menu in the top left > Maintenance > Import settings > select the preferences file you want to back-up from > Ok > type in Master password set above > Ok. Make sure you select the correct preferences file, all .json files from the preferences folder will be shown. +10. From the **AAPS** home screen, select the three line (hamburger) menu in the top left > Maintenance > Import settings > select the preferences file you want to back-up from > Ok > type in Master password set above > Ok. Make sure you select the correct preferences file, all .json files from the preferences folder will be shown. ![AAPS import settings 1](../images/Maintenance/AAPS_ImportSettings1.png) ![AAPS import settings 2](../images/Maintenance/AAPS_ImportSettings2.png) diff --git a/docs/CROWDIN/pb/SettingUpAaps/SetupWizard.md b/docs/CROWDIN/pb/SettingUpAaps/SetupWizard.md index c20849fd1103..ea8bf903e493 100644 --- a/docs/CROWDIN/pb/SettingUpAaps/SetupWizard.md +++ b/docs/CROWDIN/pb/SettingUpAaps/SetupWizard.md @@ -125,6 +125,8 @@ Follow these steps on Android 16, other versions will varies slightly from the p ![settings_apps](../images/setup-wizard/app_bluetooth_allow_background_unrestrict.png) +(SetupWizard-StoragePermission)= + ### Storage permission **AAPS** needs to log information to the permanent storage of your smartphone. Permanent storage means that it will be available even after rebooting your smartphone. Other information is just lost, as it is not saved to permanent storage. diff --git a/docs/CROWDIN/pb/images/GoogleDriveInWebbrowser.png b/docs/CROWDIN/pb/images/GoogleDriveInWebbrowser.png index 159f03ff2370..e682af001b15 100644 Binary files a/docs/CROWDIN/pb/images/GoogleDriveInWebbrowser.png and b/docs/CROWDIN/pb/images/GoogleDriveInWebbrowser.png differ diff --git a/docs/CROWDIN/pb/images/GoogleDriveMobileAPPLaunch.png b/docs/CROWDIN/pb/images/GoogleDriveMobileAPPLaunch.png index a021dd716fcf..f4ed9aa742a1 100644 Binary files a/docs/CROWDIN/pb/images/GoogleDriveMobileAPPLaunch.png and b/docs/CROWDIN/pb/images/GoogleDriveMobileAPPLaunch.png differ diff --git a/docs/CROWDIN/pb/images/GoogleDriveMobileMissingSecuritySetting.png b/docs/CROWDIN/pb/images/GoogleDriveMobileMissingSecuritySetting.png index ffc850fc5fe7..f53714dfbe20 100644 Binary files a/docs/CROWDIN/pb/images/GoogleDriveMobileMissingSecuritySetting.png and b/docs/CROWDIN/pb/images/GoogleDriveMobileMissingSecuritySetting.png differ diff --git a/docs/CROWDIN/pb/images/GoogleDriveMobileSettingSecuritySetting.png b/docs/CROWDIN/pb/images/GoogleDriveMobileSettingSecuritySetting.png index d0669d4fe98a..f53fec931a73 100644 Binary files a/docs/CROWDIN/pb/images/GoogleDriveMobileSettingSecuritySetting.png and b/docs/CROWDIN/pb/images/GoogleDriveMobileSettingSecuritySetting.png differ diff --git a/docs/CROWDIN/pb/images/GoogleDriveMobileUploadedAPK.png b/docs/CROWDIN/pb/images/GoogleDriveMobileUploadedAPK.png index dcb1a91655b6..ed45f83ad166 100644 Binary files a/docs/CROWDIN/pb/images/GoogleDriveMobileUploadedAPK.png and b/docs/CROWDIN/pb/images/GoogleDriveMobileUploadedAPK.png differ diff --git a/docs/CROWDIN/pl/Maintenance/ExportImportSettings.md b/docs/CROWDIN/pl/Maintenance/ExportImportSettings.md index 4261e83070c2..06faac8f0fb4 100644 --- a/docs/CROWDIN/pl/Maintenance/ExportImportSettings.md +++ b/docs/CROWDIN/pl/Maintenance/ExportImportSettings.md @@ -36,9 +36,16 @@ In case your main **AAPS** phone is lost or damaged, having a copy of the APK av **How to back-up:** Maintain a copy on the computer used to build the APK with Android Studio. Additionally, it is recommended to use a cloud platform to store a copy of the installer APK. Make sure you know how to locate both backups when needed. Consider setting up dedicated folders to store these backups. ### AAPS settings file (also referred to as 'Preferences') + +```{admonition} Where are preferences stored on my phone? +:class: tip +You will find your settings in the **AAPS Directory** you have selected during [AAPS setup](#SetupWizard-StoragePermission).
+You can also change the **AAPS Directory** in Preferences > [Maintenance Settings](#preferences-maintenance-settings). +``` + With a copy of the APK installer file (see above) and your **Settings** file, you can quickly get up and running on an existing or new phone. -The **Settings** file is used t customize the AAPS application to fit your specific setup. They encompass details such as your config builder settings, objective status, third-party communication settings (e.g., Nightscout, Tidepool), automations, and profiles. +The **Settings** file is used to customize the AAPS application to fit your specific setup. They encompass details such as your config builder settings, objective status, third-party communication settings (e.g., Nightscout, Tidepool), automations, and profiles. Exporting the AAPS settings to file enables you to restore its configuration to a specific point in time. As mentioned, in addition to all configuration settings, the export file also contains the status of your objectives, which you need to restore when **(re)installing** AAPS. Without this you will be required to redo all objectives from start to enable closed loop. Settings files also enable you to restore "last known good" settings for undoing any configuration changes. @@ -63,6 +70,12 @@ Exporting the AAPS settings to file enables you to restore its configuration to ## Settings Export +```{admonition} Where are preferences stored on my phone? +:class: tip +You will find your settings in the **AAPS Directory** you have selected during [AAPS setup](#SetupWizard-StoragePermission).
+You can also change the **AAPS Directory** in Preferences > [Maintenance Settings](#preferences-maintenance-settings). +``` + It is recommended to do regular settings exports, especially before and after making configuration changes. You can choose to do exports **manually or (preferred) through automation**. Make sure to take a note of your AAPS master password and to backup your settings files by copying them off your phone to for instance a cloud storage location. **Note**: _The exported settings will be encrypted with your AAPS master password: without the master password used for exporting you will be unable to import the settings file!_ @@ -85,6 +98,13 @@ _**Note:** On importing settings to user always needs to enter the AAPS password (ExportImportSettings-restoring-from-your-backups-on-a-new-phone-or-fresh-installation-of-aaps)= ## Restoring from your backups on a new phone or fresh installation of AAPS + +```{admonition} Where are preferences stored on my phone? +:class: tip +You will find your settings in the **AAPS Directory** you have selected during [AAPS setup](#SetupWizard-StoragePermission).
+You can also change the **AAPS Directory** in Preferences > [Maintenance Settings](#preferences-maintenance-settings). +``` + Use these instructions if you have a back-up of your APK and **Preferences** that you want to load on to a new phone or if you needed to delete and reinstall the APK on your existing phone for any reason. _If you are updating **AAPS** using an APK built with the same keystore you should not need to follow this process. However, it is still advised to create a back-up before you apply the update._ @@ -108,13 +128,15 @@ Importing a **Preferences** file will deactivate your current pod if those **Pre 5. From the **AAPS** home screen, set the master password in [Preferences > General > Protection](#Preferences-master-password) to the same password as you used with your back-ups. -6. From the **AAPS** home screen, select the three line (hamburger) menu in the top left > Maintenance > Export settings > type in Master password set above > Ok. This will create the preferences folder if it does not already exist on your phone. +6. If you haven't done it yet, [set the **AAPS Directory**](#preferences-maintenance-settings): from the **AAPS** home screen, select the three line (hamburger) menu in the top left > Maintenance > AAPS DIRECTORY. + +7. From the **AAPS** home screen, select the three line (hamburger) menu in the top left > Maintenance > Export settings > type in Master password set above > Ok. This will create the preferences folder if it does not already exist on your phone. -7. Download the back-up of your **Preferences** file from your cloud platform. +8. Download the back-up of your **Preferences** file from your cloud platform. -8. Use your file explorer (commonly called “Files” or “My Files”) to move the file from your downloads to `/internal storage/AAPS/preferences` +9. Use your file explorer (commonly called “Files” or “My Files”) to move the file from your downloads to `/internal storage/AAPS/preferences` if your **AAPS Directory** has been set `/internal storage/AAPS` -9. From the **AAPS** home screen, select the three line (hamburger) menu in the top left > Maintenance > Import settings > select the preferences file you want to back-up from > Ok > type in Master password set above > Ok. Make sure you select the correct preferences file, all .json files from the preferences folder will be shown. +10. From the **AAPS** home screen, select the three line (hamburger) menu in the top left > Maintenance > Import settings > select the preferences file you want to back-up from > Ok > type in Master password set above > Ok. Make sure you select the correct preferences file, all .json files from the preferences folder will be shown. ![AAPS import settings 1](../images/Maintenance/AAPS_ImportSettings1.png) ![AAPS import settings 2](../images/Maintenance/AAPS_ImportSettings2.png) diff --git a/docs/CROWDIN/pl/SettingUpAaps/SetupWizard.md b/docs/CROWDIN/pl/SettingUpAaps/SetupWizard.md index 65d764b72b4c..be83987f03b4 100644 --- a/docs/CROWDIN/pl/SettingUpAaps/SetupWizard.md +++ b/docs/CROWDIN/pl/SettingUpAaps/SetupWizard.md @@ -125,6 +125,8 @@ Follow these steps on Android 16, other versions will varies slightly from the p ![settings_apps](../images/setup-wizard/app_bluetooth_allow_background_unrestrict.png) +(SetupWizard-StoragePermission)= + ### Storage permission **AAPS** needs to log information to the permanent storage of your smartphone. Permanent storage means that it will be available even after rebooting your smartphone. Other information is just lost, as it is not saved to permanent storage. diff --git a/docs/CROWDIN/pl/images/GoogleDriveInWebbrowser.png b/docs/CROWDIN/pl/images/GoogleDriveInWebbrowser.png index 159f03ff2370..e682af001b15 100644 Binary files a/docs/CROWDIN/pl/images/GoogleDriveInWebbrowser.png and b/docs/CROWDIN/pl/images/GoogleDriveInWebbrowser.png differ diff --git a/docs/CROWDIN/pl/images/GoogleDriveMobileAPPLaunch.png b/docs/CROWDIN/pl/images/GoogleDriveMobileAPPLaunch.png index a021dd716fcf..f4ed9aa742a1 100644 Binary files a/docs/CROWDIN/pl/images/GoogleDriveMobileAPPLaunch.png and b/docs/CROWDIN/pl/images/GoogleDriveMobileAPPLaunch.png differ diff --git a/docs/CROWDIN/pl/images/GoogleDriveMobileMissingSecuritySetting.png b/docs/CROWDIN/pl/images/GoogleDriveMobileMissingSecuritySetting.png index ffc850fc5fe7..f53714dfbe20 100644 Binary files a/docs/CROWDIN/pl/images/GoogleDriveMobileMissingSecuritySetting.png and b/docs/CROWDIN/pl/images/GoogleDriveMobileMissingSecuritySetting.png differ diff --git a/docs/CROWDIN/pl/images/GoogleDriveMobileSettingSecuritySetting.png b/docs/CROWDIN/pl/images/GoogleDriveMobileSettingSecuritySetting.png index d0669d4fe98a..f53fec931a73 100644 Binary files a/docs/CROWDIN/pl/images/GoogleDriveMobileSettingSecuritySetting.png and b/docs/CROWDIN/pl/images/GoogleDriveMobileSettingSecuritySetting.png differ diff --git a/docs/CROWDIN/pl/images/GoogleDriveMobileUploadedAPK.png b/docs/CROWDIN/pl/images/GoogleDriveMobileUploadedAPK.png index dcb1a91655b6..ed45f83ad166 100644 Binary files a/docs/CROWDIN/pl/images/GoogleDriveMobileUploadedAPK.png and b/docs/CROWDIN/pl/images/GoogleDriveMobileUploadedAPK.png differ diff --git a/docs/CROWDIN/pt/Maintenance/ExportImportSettings.md b/docs/CROWDIN/pt/Maintenance/ExportImportSettings.md index 4261e83070c2..06faac8f0fb4 100644 --- a/docs/CROWDIN/pt/Maintenance/ExportImportSettings.md +++ b/docs/CROWDIN/pt/Maintenance/ExportImportSettings.md @@ -36,9 +36,16 @@ In case your main **AAPS** phone is lost or damaged, having a copy of the APK av **How to back-up:** Maintain a copy on the computer used to build the APK with Android Studio. Additionally, it is recommended to use a cloud platform to store a copy of the installer APK. Make sure you know how to locate both backups when needed. Consider setting up dedicated folders to store these backups. ### AAPS settings file (also referred to as 'Preferences') + +```{admonition} Where are preferences stored on my phone? +:class: tip +You will find your settings in the **AAPS Directory** you have selected during [AAPS setup](#SetupWizard-StoragePermission).
+You can also change the **AAPS Directory** in Preferences > [Maintenance Settings](#preferences-maintenance-settings). +``` + With a copy of the APK installer file (see above) and your **Settings** file, you can quickly get up and running on an existing or new phone. -The **Settings** file is used t customize the AAPS application to fit your specific setup. They encompass details such as your config builder settings, objective status, third-party communication settings (e.g., Nightscout, Tidepool), automations, and profiles. +The **Settings** file is used to customize the AAPS application to fit your specific setup. They encompass details such as your config builder settings, objective status, third-party communication settings (e.g., Nightscout, Tidepool), automations, and profiles. Exporting the AAPS settings to file enables you to restore its configuration to a specific point in time. As mentioned, in addition to all configuration settings, the export file also contains the status of your objectives, which you need to restore when **(re)installing** AAPS. Without this you will be required to redo all objectives from start to enable closed loop. Settings files also enable you to restore "last known good" settings for undoing any configuration changes. @@ -63,6 +70,12 @@ Exporting the AAPS settings to file enables you to restore its configuration to ## Settings Export +```{admonition} Where are preferences stored on my phone? +:class: tip +You will find your settings in the **AAPS Directory** you have selected during [AAPS setup](#SetupWizard-StoragePermission).
+You can also change the **AAPS Directory** in Preferences > [Maintenance Settings](#preferences-maintenance-settings). +``` + It is recommended to do regular settings exports, especially before and after making configuration changes. You can choose to do exports **manually or (preferred) through automation**. Make sure to take a note of your AAPS master password and to backup your settings files by copying them off your phone to for instance a cloud storage location. **Note**: _The exported settings will be encrypted with your AAPS master password: without the master password used for exporting you will be unable to import the settings file!_ @@ -85,6 +98,13 @@ _**Note:** On importing settings to user always needs to enter the AAPS password (ExportImportSettings-restoring-from-your-backups-on-a-new-phone-or-fresh-installation-of-aaps)= ## Restoring from your backups on a new phone or fresh installation of AAPS + +```{admonition} Where are preferences stored on my phone? +:class: tip +You will find your settings in the **AAPS Directory** you have selected during [AAPS setup](#SetupWizard-StoragePermission).
+You can also change the **AAPS Directory** in Preferences > [Maintenance Settings](#preferences-maintenance-settings). +``` + Use these instructions if you have a back-up of your APK and **Preferences** that you want to load on to a new phone or if you needed to delete and reinstall the APK on your existing phone for any reason. _If you are updating **AAPS** using an APK built with the same keystore you should not need to follow this process. However, it is still advised to create a back-up before you apply the update._ @@ -108,13 +128,15 @@ Importing a **Preferences** file will deactivate your current pod if those **Pre 5. From the **AAPS** home screen, set the master password in [Preferences > General > Protection](#Preferences-master-password) to the same password as you used with your back-ups. -6. From the **AAPS** home screen, select the three line (hamburger) menu in the top left > Maintenance > Export settings > type in Master password set above > Ok. This will create the preferences folder if it does not already exist on your phone. +6. If you haven't done it yet, [set the **AAPS Directory**](#preferences-maintenance-settings): from the **AAPS** home screen, select the three line (hamburger) menu in the top left > Maintenance > AAPS DIRECTORY. + +7. From the **AAPS** home screen, select the three line (hamburger) menu in the top left > Maintenance > Export settings > type in Master password set above > Ok. This will create the preferences folder if it does not already exist on your phone. -7. Download the back-up of your **Preferences** file from your cloud platform. +8. Download the back-up of your **Preferences** file from your cloud platform. -8. Use your file explorer (commonly called “Files” or “My Files”) to move the file from your downloads to `/internal storage/AAPS/preferences` +9. Use your file explorer (commonly called “Files” or “My Files”) to move the file from your downloads to `/internal storage/AAPS/preferences` if your **AAPS Directory** has been set `/internal storage/AAPS` -9. From the **AAPS** home screen, select the three line (hamburger) menu in the top left > Maintenance > Import settings > select the preferences file you want to back-up from > Ok > type in Master password set above > Ok. Make sure you select the correct preferences file, all .json files from the preferences folder will be shown. +10. From the **AAPS** home screen, select the three line (hamburger) menu in the top left > Maintenance > Import settings > select the preferences file you want to back-up from > Ok > type in Master password set above > Ok. Make sure you select the correct preferences file, all .json files from the preferences folder will be shown. ![AAPS import settings 1](../images/Maintenance/AAPS_ImportSettings1.png) ![AAPS import settings 2](../images/Maintenance/AAPS_ImportSettings2.png) diff --git a/docs/CROWDIN/pt/SettingUpAaps/SetupWizard.md b/docs/CROWDIN/pt/SettingUpAaps/SetupWizard.md index c475def46dfe..c19777c874ab 100644 --- a/docs/CROWDIN/pt/SettingUpAaps/SetupWizard.md +++ b/docs/CROWDIN/pt/SettingUpAaps/SetupWizard.md @@ -125,6 +125,8 @@ Follow these steps on Android 16, other versions will varies slightly from the p ![settings_apps](../images/setup-wizard/app_bluetooth_allow_background_unrestrict.png) +(SetupWizard-StoragePermission)= + ### Storage permission **AAPS** needs to log information to the permanent storage of your smartphone. Permanent storage means that it will be available even after rebooting your smartphone. Other information is just lost, as it is not saved to permanent storage. diff --git a/docs/CROWDIN/pt/images/GoogleDriveInWebbrowser.png b/docs/CROWDIN/pt/images/GoogleDriveInWebbrowser.png index 159f03ff2370..e682af001b15 100644 Binary files a/docs/CROWDIN/pt/images/GoogleDriveInWebbrowser.png and b/docs/CROWDIN/pt/images/GoogleDriveInWebbrowser.png differ diff --git a/docs/CROWDIN/pt/images/GoogleDriveMobileAPPLaunch.png b/docs/CROWDIN/pt/images/GoogleDriveMobileAPPLaunch.png index a021dd716fcf..f4ed9aa742a1 100644 Binary files a/docs/CROWDIN/pt/images/GoogleDriveMobileAPPLaunch.png and b/docs/CROWDIN/pt/images/GoogleDriveMobileAPPLaunch.png differ diff --git a/docs/CROWDIN/pt/images/GoogleDriveMobileMissingSecuritySetting.png b/docs/CROWDIN/pt/images/GoogleDriveMobileMissingSecuritySetting.png index ffc850fc5fe7..f53714dfbe20 100644 Binary files a/docs/CROWDIN/pt/images/GoogleDriveMobileMissingSecuritySetting.png and b/docs/CROWDIN/pt/images/GoogleDriveMobileMissingSecuritySetting.png differ diff --git a/docs/CROWDIN/pt/images/GoogleDriveMobileSettingSecuritySetting.png b/docs/CROWDIN/pt/images/GoogleDriveMobileSettingSecuritySetting.png index d0669d4fe98a..f53fec931a73 100644 Binary files a/docs/CROWDIN/pt/images/GoogleDriveMobileSettingSecuritySetting.png and b/docs/CROWDIN/pt/images/GoogleDriveMobileSettingSecuritySetting.png differ diff --git a/docs/CROWDIN/pt/images/GoogleDriveMobileUploadedAPK.png b/docs/CROWDIN/pt/images/GoogleDriveMobileUploadedAPK.png index dcb1a91655b6..ed45f83ad166 100644 Binary files a/docs/CROWDIN/pt/images/GoogleDriveMobileUploadedAPK.png and b/docs/CROWDIN/pt/images/GoogleDriveMobileUploadedAPK.png differ diff --git a/docs/CROWDIN/ro/Maintenance/ExportImportSettings.md b/docs/CROWDIN/ro/Maintenance/ExportImportSettings.md index 4261e83070c2..06faac8f0fb4 100644 --- a/docs/CROWDIN/ro/Maintenance/ExportImportSettings.md +++ b/docs/CROWDIN/ro/Maintenance/ExportImportSettings.md @@ -36,9 +36,16 @@ In case your main **AAPS** phone is lost or damaged, having a copy of the APK av **How to back-up:** Maintain a copy on the computer used to build the APK with Android Studio. Additionally, it is recommended to use a cloud platform to store a copy of the installer APK. Make sure you know how to locate both backups when needed. Consider setting up dedicated folders to store these backups. ### AAPS settings file (also referred to as 'Preferences') + +```{admonition} Where are preferences stored on my phone? +:class: tip +You will find your settings in the **AAPS Directory** you have selected during [AAPS setup](#SetupWizard-StoragePermission).
+You can also change the **AAPS Directory** in Preferences > [Maintenance Settings](#preferences-maintenance-settings). +``` + With a copy of the APK installer file (see above) and your **Settings** file, you can quickly get up and running on an existing or new phone. -The **Settings** file is used t customize the AAPS application to fit your specific setup. They encompass details such as your config builder settings, objective status, third-party communication settings (e.g., Nightscout, Tidepool), automations, and profiles. +The **Settings** file is used to customize the AAPS application to fit your specific setup. They encompass details such as your config builder settings, objective status, third-party communication settings (e.g., Nightscout, Tidepool), automations, and profiles. Exporting the AAPS settings to file enables you to restore its configuration to a specific point in time. As mentioned, in addition to all configuration settings, the export file also contains the status of your objectives, which you need to restore when **(re)installing** AAPS. Without this you will be required to redo all objectives from start to enable closed loop. Settings files also enable you to restore "last known good" settings for undoing any configuration changes. @@ -63,6 +70,12 @@ Exporting the AAPS settings to file enables you to restore its configuration to ## Settings Export +```{admonition} Where are preferences stored on my phone? +:class: tip +You will find your settings in the **AAPS Directory** you have selected during [AAPS setup](#SetupWizard-StoragePermission).
+You can also change the **AAPS Directory** in Preferences > [Maintenance Settings](#preferences-maintenance-settings). +``` + It is recommended to do regular settings exports, especially before and after making configuration changes. You can choose to do exports **manually or (preferred) through automation**. Make sure to take a note of your AAPS master password and to backup your settings files by copying them off your phone to for instance a cloud storage location. **Note**: _The exported settings will be encrypted with your AAPS master password: without the master password used for exporting you will be unable to import the settings file!_ @@ -85,6 +98,13 @@ _**Note:** On importing settings to user always needs to enter the AAPS password (ExportImportSettings-restoring-from-your-backups-on-a-new-phone-or-fresh-installation-of-aaps)= ## Restoring from your backups on a new phone or fresh installation of AAPS + +```{admonition} Where are preferences stored on my phone? +:class: tip +You will find your settings in the **AAPS Directory** you have selected during [AAPS setup](#SetupWizard-StoragePermission).
+You can also change the **AAPS Directory** in Preferences > [Maintenance Settings](#preferences-maintenance-settings). +``` + Use these instructions if you have a back-up of your APK and **Preferences** that you want to load on to a new phone or if you needed to delete and reinstall the APK on your existing phone for any reason. _If you are updating **AAPS** using an APK built with the same keystore you should not need to follow this process. However, it is still advised to create a back-up before you apply the update._ @@ -108,13 +128,15 @@ Importing a **Preferences** file will deactivate your current pod if those **Pre 5. From the **AAPS** home screen, set the master password in [Preferences > General > Protection](#Preferences-master-password) to the same password as you used with your back-ups. -6. From the **AAPS** home screen, select the three line (hamburger) menu in the top left > Maintenance > Export settings > type in Master password set above > Ok. This will create the preferences folder if it does not already exist on your phone. +6. If you haven't done it yet, [set the **AAPS Directory**](#preferences-maintenance-settings): from the **AAPS** home screen, select the three line (hamburger) menu in the top left > Maintenance > AAPS DIRECTORY. + +7. From the **AAPS** home screen, select the three line (hamburger) menu in the top left > Maintenance > Export settings > type in Master password set above > Ok. This will create the preferences folder if it does not already exist on your phone. -7. Download the back-up of your **Preferences** file from your cloud platform. +8. Download the back-up of your **Preferences** file from your cloud platform. -8. Use your file explorer (commonly called “Files” or “My Files”) to move the file from your downloads to `/internal storage/AAPS/preferences` +9. Use your file explorer (commonly called “Files” or “My Files”) to move the file from your downloads to `/internal storage/AAPS/preferences` if your **AAPS Directory** has been set `/internal storage/AAPS` -9. From the **AAPS** home screen, select the three line (hamburger) menu in the top left > Maintenance > Import settings > select the preferences file you want to back-up from > Ok > type in Master password set above > Ok. Make sure you select the correct preferences file, all .json files from the preferences folder will be shown. +10. From the **AAPS** home screen, select the three line (hamburger) menu in the top left > Maintenance > Import settings > select the preferences file you want to back-up from > Ok > type in Master password set above > Ok. Make sure you select the correct preferences file, all .json files from the preferences folder will be shown. ![AAPS import settings 1](../images/Maintenance/AAPS_ImportSettings1.png) ![AAPS import settings 2](../images/Maintenance/AAPS_ImportSettings2.png) diff --git a/docs/CROWDIN/ro/SettingUpAaps/SetupWizard.md b/docs/CROWDIN/ro/SettingUpAaps/SetupWizard.md index 3d9bee54a58b..199c523bbb24 100644 --- a/docs/CROWDIN/ro/SettingUpAaps/SetupWizard.md +++ b/docs/CROWDIN/ro/SettingUpAaps/SetupWizard.md @@ -125,6 +125,8 @@ Follow these steps on Android 16, other versions will varies slightly from the p ![settings_apps](../images/setup-wizard/app_bluetooth_allow_background_unrestrict.png) +(SetupWizard-StoragePermission)= + ### Storage permission **AAPS** needs to log information to the permanent storage of your smartphone. Permanent storage means that it will be available even after rebooting your smartphone. Other information is just lost, as it is not saved to permanent storage. diff --git a/docs/CROWDIN/ro/images/GoogleDriveInWebbrowser.png b/docs/CROWDIN/ro/images/GoogleDriveInWebbrowser.png index 159f03ff2370..e682af001b15 100644 Binary files a/docs/CROWDIN/ro/images/GoogleDriveInWebbrowser.png and b/docs/CROWDIN/ro/images/GoogleDriveInWebbrowser.png differ diff --git a/docs/CROWDIN/ro/images/GoogleDriveMobileAPPLaunch.png b/docs/CROWDIN/ro/images/GoogleDriveMobileAPPLaunch.png index a021dd716fcf..f4ed9aa742a1 100644 Binary files a/docs/CROWDIN/ro/images/GoogleDriveMobileAPPLaunch.png and b/docs/CROWDIN/ro/images/GoogleDriveMobileAPPLaunch.png differ diff --git a/docs/CROWDIN/ro/images/GoogleDriveMobileMissingSecuritySetting.png b/docs/CROWDIN/ro/images/GoogleDriveMobileMissingSecuritySetting.png index ffc850fc5fe7..f53714dfbe20 100644 Binary files a/docs/CROWDIN/ro/images/GoogleDriveMobileMissingSecuritySetting.png and b/docs/CROWDIN/ro/images/GoogleDriveMobileMissingSecuritySetting.png differ diff --git a/docs/CROWDIN/ro/images/GoogleDriveMobileSettingSecuritySetting.png b/docs/CROWDIN/ro/images/GoogleDriveMobileSettingSecuritySetting.png index d0669d4fe98a..f53fec931a73 100644 Binary files a/docs/CROWDIN/ro/images/GoogleDriveMobileSettingSecuritySetting.png and b/docs/CROWDIN/ro/images/GoogleDriveMobileSettingSecuritySetting.png differ diff --git a/docs/CROWDIN/ro/images/GoogleDriveMobileUploadedAPK.png b/docs/CROWDIN/ro/images/GoogleDriveMobileUploadedAPK.png index dcb1a91655b6..ed45f83ad166 100644 Binary files a/docs/CROWDIN/ro/images/GoogleDriveMobileUploadedAPK.png and b/docs/CROWDIN/ro/images/GoogleDriveMobileUploadedAPK.png differ diff --git a/docs/CROWDIN/ru/Maintenance/ExportImportSettings.md b/docs/CROWDIN/ru/Maintenance/ExportImportSettings.md index 9fbaa2ee817d..a758355504f2 100644 --- a/docs/CROWDIN/ru/Maintenance/ExportImportSettings.md +++ b/docs/CROWDIN/ru/Maintenance/ExportImportSettings.md @@ -36,9 +36,16 @@ In case your main **AAPS** phone is lost or damaged, having a copy of the APK av **How to back-up:** Maintain a copy on the computer used to build the APK with Android Studio. Additionally, it is recommended to use a cloud platform to store a copy of the installer APK. Make sure you know how to locate both backups when needed. Consider setting up dedicated folders to store these backups. ### AAPS settings file (also referred to as 'Preferences') + +```{admonition} Where are preferences stored on my phone? +:class: tip +You will find your settings in the **AAPS Directory** you have selected during [AAPS setup](#SetupWizard-StoragePermission).
+You can also change the **AAPS Directory** in Preferences > [Maintenance Settings](#preferences-maintenance-settings). +``` + With a copy of the APK installer file (see above) and your **Settings** file, you can quickly get up and running on an existing or new phone. -The **Settings** file is used t customize the AAPS application to fit your specific setup. They encompass details such as your config builder settings, objective status, third-party communication settings (e.g., Nightscout, Tidepool), automations, and profiles. +The **Settings** file is used to customize the AAPS application to fit your specific setup. They encompass details such as your config builder settings, objective status, third-party communication settings (e.g., Nightscout, Tidepool), automations, and profiles. Exporting the AAPS settings to file enables you to restore its configuration to a specific point in time. As mentioned, in addition to all configuration settings, the export file also contains the status of your objectives, which you need to restore when **(re)installing** AAPS. Without this you will be required to redo all objectives from start to enable closed loop. Settings files also enable you to restore "last known good" settings for undoing any configuration changes. @@ -63,6 +70,12 @@ Exporting the AAPS settings to file enables you to restore its configuration to ## Settings Export +```{admonition} Where are preferences stored on my phone? +:class: tip +You will find your settings in the **AAPS Directory** you have selected during [AAPS setup](#SetupWizard-StoragePermission).
+You can also change the **AAPS Directory** in Preferences > [Maintenance Settings](#preferences-maintenance-settings). +``` + It is recommended to do regular settings exports, especially before and after making configuration changes. You can choose to do exports **manually or (preferred) through automation**. Make sure to take a note of your AAPS master password and to backup your settings files by copying them off your phone to for instance a cloud storage location. **Note**: _The exported settings will be encrypted with your AAPS master password: without the master password used for exporting you will be unable to import the settings file!_ @@ -85,6 +98,13 @@ _**Note:** On importing settings to user always needs to enter the AAPS password (ExportImportSettings-restoring-from-your-backups-on-a-new-phone-or-fresh-installation-of-aaps)= ## Restoring from your backups on a new phone or fresh installation of AAPS + +```{admonition} Where are preferences stored on my phone? +:class: tip +You will find your settings in the **AAPS Directory** you have selected during [AAPS setup](#SetupWizard-StoragePermission).
+You can also change the **AAPS Directory** in Preferences > [Maintenance Settings](#preferences-maintenance-settings). +``` + Use these instructions if you have a back-up of your APK and **Preferences** that you want to load on to a new phone or if you needed to delete and reinstall the APK on your existing phone for any reason. _If you are updating **AAPS** using an APK built with the same keystore you should not need to follow this process. However, it is still advised to create a back-up before you apply the update._ @@ -108,13 +128,15 @@ Importing a **Preferences** file will deactivate your current pod if those **Pre 5. From the **AAPS** home screen, set the master password in [Preferences > General > Protection](#Preferences-master-password) to the same password as you used with your back-ups. -6. From the **AAPS** home screen, select the three line (hamburger) menu in the top left > Maintenance > Export settings > type in Master password set above > Ok. This will create the preferences folder if it does not already exist on your phone. +6. If you haven't done it yet, [set the **AAPS Directory**](#preferences-maintenance-settings): from the **AAPS** home screen, select the three line (hamburger) menu in the top left > Maintenance > AAPS DIRECTORY. + +7. From the **AAPS** home screen, select the three line (hamburger) menu in the top left > Maintenance > Export settings > type in Master password set above > Ok. This will create the preferences folder if it does not already exist on your phone. -7. Download the back-up of your **Preferences** file from your cloud platform. +8. Download the back-up of your **Preferences** file from your cloud platform. -8. Use your file explorer (commonly called “Files” or “My Files”) to move the file from your downloads to `/internal storage/AAPS/preferences` +9. Use your file explorer (commonly called “Files” or “My Files”) to move the file from your downloads to `/internal storage/AAPS/preferences` if your **AAPS Directory** has been set `/internal storage/AAPS` -9. From the **AAPS** home screen, select the three line (hamburger) menu in the top left > Maintenance > Import settings > select the preferences file you want to back-up from > Ok > type in Master password set above > Ok. Make sure you select the correct preferences file, all .json files from the preferences folder will be shown. +10. From the **AAPS** home screen, select the three line (hamburger) menu in the top left > Maintenance > Import settings > select the preferences file you want to back-up from > Ok > type in Master password set above > Ok. Make sure you select the correct preferences file, all .json files from the preferences folder will be shown. ![AAPS import settings 1](../images/Maintenance/AAPS_ImportSettings1.png) ![AAPS import settings 2](../images/Maintenance/AAPS_ImportSettings2.png) diff --git a/docs/CROWDIN/ru/SettingUpAaps/SetupWizard.md b/docs/CROWDIN/ru/SettingUpAaps/SetupWizard.md index 682489e0cb84..11e5eaafc14c 100644 --- a/docs/CROWDIN/ru/SettingUpAaps/SetupWizard.md +++ b/docs/CROWDIN/ru/SettingUpAaps/SetupWizard.md @@ -125,6 +125,8 @@ Follow these steps on Android 16, other versions will varies slightly from the p ![settings_apps](../images/setup-wizard/app_bluetooth_allow_background_unrestrict.png) +(SetupWizard-StoragePermission)= + ### Storage permission **AAPS** needs to log information to the permanent storage of your smartphone. Постоянная память означает, что информация будет доступна даже после перезагрузки телефона. Остальная информация теряется, поскольку она не сохраняется в постоянной памяти. diff --git a/docs/CROWDIN/ru/images/GoogleDriveInWebbrowser.png b/docs/CROWDIN/ru/images/GoogleDriveInWebbrowser.png index 159f03ff2370..e682af001b15 100644 Binary files a/docs/CROWDIN/ru/images/GoogleDriveInWebbrowser.png and b/docs/CROWDIN/ru/images/GoogleDriveInWebbrowser.png differ diff --git a/docs/CROWDIN/ru/images/GoogleDriveMobileAPPLaunch.png b/docs/CROWDIN/ru/images/GoogleDriveMobileAPPLaunch.png index a021dd716fcf..f4ed9aa742a1 100644 Binary files a/docs/CROWDIN/ru/images/GoogleDriveMobileAPPLaunch.png and b/docs/CROWDIN/ru/images/GoogleDriveMobileAPPLaunch.png differ diff --git a/docs/CROWDIN/ru/images/GoogleDriveMobileMissingSecuritySetting.png b/docs/CROWDIN/ru/images/GoogleDriveMobileMissingSecuritySetting.png index ffc850fc5fe7..f53714dfbe20 100644 Binary files a/docs/CROWDIN/ru/images/GoogleDriveMobileMissingSecuritySetting.png and b/docs/CROWDIN/ru/images/GoogleDriveMobileMissingSecuritySetting.png differ diff --git a/docs/CROWDIN/ru/images/GoogleDriveMobileSettingSecuritySetting.png b/docs/CROWDIN/ru/images/GoogleDriveMobileSettingSecuritySetting.png index d0669d4fe98a..f53fec931a73 100644 Binary files a/docs/CROWDIN/ru/images/GoogleDriveMobileSettingSecuritySetting.png and b/docs/CROWDIN/ru/images/GoogleDriveMobileSettingSecuritySetting.png differ diff --git a/docs/CROWDIN/ru/images/GoogleDriveMobileUploadedAPK.png b/docs/CROWDIN/ru/images/GoogleDriveMobileUploadedAPK.png index dcb1a91655b6..ed45f83ad166 100644 Binary files a/docs/CROWDIN/ru/images/GoogleDriveMobileUploadedAPK.png and b/docs/CROWDIN/ru/images/GoogleDriveMobileUploadedAPK.png differ diff --git a/docs/CROWDIN/sk/Maintenance/ExportImportSettings.md b/docs/CROWDIN/sk/Maintenance/ExportImportSettings.md index 4261e83070c2..06faac8f0fb4 100644 --- a/docs/CROWDIN/sk/Maintenance/ExportImportSettings.md +++ b/docs/CROWDIN/sk/Maintenance/ExportImportSettings.md @@ -36,9 +36,16 @@ In case your main **AAPS** phone is lost or damaged, having a copy of the APK av **How to back-up:** Maintain a copy on the computer used to build the APK with Android Studio. Additionally, it is recommended to use a cloud platform to store a copy of the installer APK. Make sure you know how to locate both backups when needed. Consider setting up dedicated folders to store these backups. ### AAPS settings file (also referred to as 'Preferences') + +```{admonition} Where are preferences stored on my phone? +:class: tip +You will find your settings in the **AAPS Directory** you have selected during [AAPS setup](#SetupWizard-StoragePermission).
+You can also change the **AAPS Directory** in Preferences > [Maintenance Settings](#preferences-maintenance-settings). +``` + With a copy of the APK installer file (see above) and your **Settings** file, you can quickly get up and running on an existing or new phone. -The **Settings** file is used t customize the AAPS application to fit your specific setup. They encompass details such as your config builder settings, objective status, third-party communication settings (e.g., Nightscout, Tidepool), automations, and profiles. +The **Settings** file is used to customize the AAPS application to fit your specific setup. They encompass details such as your config builder settings, objective status, third-party communication settings (e.g., Nightscout, Tidepool), automations, and profiles. Exporting the AAPS settings to file enables you to restore its configuration to a specific point in time. As mentioned, in addition to all configuration settings, the export file also contains the status of your objectives, which you need to restore when **(re)installing** AAPS. Without this you will be required to redo all objectives from start to enable closed loop. Settings files also enable you to restore "last known good" settings for undoing any configuration changes. @@ -63,6 +70,12 @@ Exporting the AAPS settings to file enables you to restore its configuration to ## Settings Export +```{admonition} Where are preferences stored on my phone? +:class: tip +You will find your settings in the **AAPS Directory** you have selected during [AAPS setup](#SetupWizard-StoragePermission).
+You can also change the **AAPS Directory** in Preferences > [Maintenance Settings](#preferences-maintenance-settings). +``` + It is recommended to do regular settings exports, especially before and after making configuration changes. You can choose to do exports **manually or (preferred) through automation**. Make sure to take a note of your AAPS master password and to backup your settings files by copying them off your phone to for instance a cloud storage location. **Note**: _The exported settings will be encrypted with your AAPS master password: without the master password used for exporting you will be unable to import the settings file!_ @@ -85,6 +98,13 @@ _**Note:** On importing settings to user always needs to enter the AAPS password (ExportImportSettings-restoring-from-your-backups-on-a-new-phone-or-fresh-installation-of-aaps)= ## Restoring from your backups on a new phone or fresh installation of AAPS + +```{admonition} Where are preferences stored on my phone? +:class: tip +You will find your settings in the **AAPS Directory** you have selected during [AAPS setup](#SetupWizard-StoragePermission).
+You can also change the **AAPS Directory** in Preferences > [Maintenance Settings](#preferences-maintenance-settings). +``` + Use these instructions if you have a back-up of your APK and **Preferences** that you want to load on to a new phone or if you needed to delete and reinstall the APK on your existing phone for any reason. _If you are updating **AAPS** using an APK built with the same keystore you should not need to follow this process. However, it is still advised to create a back-up before you apply the update._ @@ -108,13 +128,15 @@ Importing a **Preferences** file will deactivate your current pod if those **Pre 5. From the **AAPS** home screen, set the master password in [Preferences > General > Protection](#Preferences-master-password) to the same password as you used with your back-ups. -6. From the **AAPS** home screen, select the three line (hamburger) menu in the top left > Maintenance > Export settings > type in Master password set above > Ok. This will create the preferences folder if it does not already exist on your phone. +6. If you haven't done it yet, [set the **AAPS Directory**](#preferences-maintenance-settings): from the **AAPS** home screen, select the three line (hamburger) menu in the top left > Maintenance > AAPS DIRECTORY. + +7. From the **AAPS** home screen, select the three line (hamburger) menu in the top left > Maintenance > Export settings > type in Master password set above > Ok. This will create the preferences folder if it does not already exist on your phone. -7. Download the back-up of your **Preferences** file from your cloud platform. +8. Download the back-up of your **Preferences** file from your cloud platform. -8. Use your file explorer (commonly called “Files” or “My Files”) to move the file from your downloads to `/internal storage/AAPS/preferences` +9. Use your file explorer (commonly called “Files” or “My Files”) to move the file from your downloads to `/internal storage/AAPS/preferences` if your **AAPS Directory** has been set `/internal storage/AAPS` -9. From the **AAPS** home screen, select the three line (hamburger) menu in the top left > Maintenance > Import settings > select the preferences file you want to back-up from > Ok > type in Master password set above > Ok. Make sure you select the correct preferences file, all .json files from the preferences folder will be shown. +10. From the **AAPS** home screen, select the three line (hamburger) menu in the top left > Maintenance > Import settings > select the preferences file you want to back-up from > Ok > type in Master password set above > Ok. Make sure you select the correct preferences file, all .json files from the preferences folder will be shown. ![AAPS import settings 1](../images/Maintenance/AAPS_ImportSettings1.png) ![AAPS import settings 2](../images/Maintenance/AAPS_ImportSettings2.png) diff --git a/docs/CROWDIN/sk/SettingUpAaps/SetupWizard.md b/docs/CROWDIN/sk/SettingUpAaps/SetupWizard.md index df14bc616392..557309a322d1 100644 --- a/docs/CROWDIN/sk/SettingUpAaps/SetupWizard.md +++ b/docs/CROWDIN/sk/SettingUpAaps/SetupWizard.md @@ -125,6 +125,8 @@ Follow these steps on Android 16, other versions will varies slightly from the p ![settings_apps](../images/setup-wizard/app_bluetooth_allow_background_unrestrict.png) +(SetupWizard-StoragePermission)= + ### Storage permission **AAPS** needs to log information to the permanent storage of your smartphone. Permanent storage means that it will be available even after rebooting your smartphone. Other information is just lost, as it is not saved to permanent storage. diff --git a/docs/CROWDIN/sk/images/GoogleDriveInWebbrowser.png b/docs/CROWDIN/sk/images/GoogleDriveInWebbrowser.png index 159f03ff2370..e682af001b15 100644 Binary files a/docs/CROWDIN/sk/images/GoogleDriveInWebbrowser.png and b/docs/CROWDIN/sk/images/GoogleDriveInWebbrowser.png differ diff --git a/docs/CROWDIN/sk/images/GoogleDriveMobileAPPLaunch.png b/docs/CROWDIN/sk/images/GoogleDriveMobileAPPLaunch.png index a021dd716fcf..f4ed9aa742a1 100644 Binary files a/docs/CROWDIN/sk/images/GoogleDriveMobileAPPLaunch.png and b/docs/CROWDIN/sk/images/GoogleDriveMobileAPPLaunch.png differ diff --git a/docs/CROWDIN/sk/images/GoogleDriveMobileMissingSecuritySetting.png b/docs/CROWDIN/sk/images/GoogleDriveMobileMissingSecuritySetting.png index ffc850fc5fe7..f53714dfbe20 100644 Binary files a/docs/CROWDIN/sk/images/GoogleDriveMobileMissingSecuritySetting.png and b/docs/CROWDIN/sk/images/GoogleDriveMobileMissingSecuritySetting.png differ diff --git a/docs/CROWDIN/sk/images/GoogleDriveMobileSettingSecuritySetting.png b/docs/CROWDIN/sk/images/GoogleDriveMobileSettingSecuritySetting.png index d0669d4fe98a..f53fec931a73 100644 Binary files a/docs/CROWDIN/sk/images/GoogleDriveMobileSettingSecuritySetting.png and b/docs/CROWDIN/sk/images/GoogleDriveMobileSettingSecuritySetting.png differ diff --git a/docs/CROWDIN/sk/images/GoogleDriveMobileUploadedAPK.png b/docs/CROWDIN/sk/images/GoogleDriveMobileUploadedAPK.png index dcb1a91655b6..ed45f83ad166 100644 Binary files a/docs/CROWDIN/sk/images/GoogleDriveMobileUploadedAPK.png and b/docs/CROWDIN/sk/images/GoogleDriveMobileUploadedAPK.png differ diff --git a/docs/CROWDIN/tr/Maintenance/ExportImportSettings.md b/docs/CROWDIN/tr/Maintenance/ExportImportSettings.md index 494269768a9e..22a64df2c47f 100644 --- a/docs/CROWDIN/tr/Maintenance/ExportImportSettings.md +++ b/docs/CROWDIN/tr/Maintenance/ExportImportSettings.md @@ -36,9 +36,16 @@ In case your main **AAPS** phone is lost or damaged, having a copy of the APK av **How to back-up:** Maintain a copy on the computer used to build the APK with Android Studio. Additionally, it is recommended to use a cloud platform to store a copy of the installer APK. Make sure you know how to locate both backups when needed. Consider setting up dedicated folders to store these backups. ### AAPS settings file (also referred to as 'Preferences') + +```{admonition} Where are preferences stored on my phone? +:class: tip +You will find your settings in the **AAPS Directory** you have selected during [AAPS setup](#SetupWizard-StoragePermission).
+You can also change the **AAPS Directory** in Preferences > [Maintenance Settings](#preferences-maintenance-settings). +``` + With a copy of the APK installer file (see above) and your **Settings** file, you can quickly get up and running on an existing or new phone. -The **Settings** file is used t customize the AAPS application to fit your specific setup. They encompass details such as your config builder settings, objective status, third-party communication settings (e.g., Nightscout, Tidepool), automations, and profiles. +The **Settings** file is used to customize the AAPS application to fit your specific setup. They encompass details such as your config builder settings, objective status, third-party communication settings (e.g., Nightscout, Tidepool), automations, and profiles. Exporting the AAPS settings to file enables you to restore its configuration to a specific point in time. As mentioned, in addition to all configuration settings, the export file also contains the status of your objectives, which you need to restore when **(re)installing** AAPS. Without this you will be required to redo all objectives from start to enable closed loop. Settings files also enable you to restore "last known good" settings for undoing any configuration changes. @@ -63,6 +70,12 @@ Exporting the AAPS settings to file enables you to restore its configuration to ## Settings Export +```{admonition} Where are preferences stored on my phone? +:class: tip +You will find your settings in the **AAPS Directory** you have selected during [AAPS setup](#SetupWizard-StoragePermission).
+You can also change the **AAPS Directory** in Preferences > [Maintenance Settings](#preferences-maintenance-settings). +``` + It is recommended to do regular settings exports, especially before and after making configuration changes. You can choose to do exports **manually or (preferred) through automation**. Make sure to take a note of your AAPS master password and to backup your settings files by copying them off your phone to for instance a cloud storage location. **Note**: _The exported settings will be encrypted with your AAPS master password: without the master password used for exporting you will be unable to import the settings file!_ @@ -85,6 +98,13 @@ _**Note:** On importing settings to user always needs to enter the AAPS password (ExportImportSettings-restoring-from-your-backups-on-a-new-phone-or-fresh-installation-of-aaps)= ## Restoring from your backups on a new phone or fresh installation of AAPS + +```{admonition} Where are preferences stored on my phone? +:class: tip +You will find your settings in the **AAPS Directory** you have selected during [AAPS setup](#SetupWizard-StoragePermission).
+You can also change the **AAPS Directory** in Preferences > [Maintenance Settings](#preferences-maintenance-settings). +``` + Use these instructions if you have a back-up of your APK and **Preferences** that you want to load on to a new phone or if you needed to delete and reinstall the APK on your existing phone for any reason. _If you are updating **AAPS** using an APK built with the same keystore you should not need to follow this process. However, it is still advised to create a back-up before you apply the update._ @@ -108,13 +128,15 @@ Importing a **Preferences** file will deactivate your current pod if those **Pre 5. From the **AAPS** home screen, set the master password in [Preferences > General > Protection](#Preferences-master-password) to the same password as you used with your back-ups. -6. From the **AAPS** home screen, select the three line (hamburger) menu in the top left > Maintenance > Export settings > type in Master password set above > Ok. This will create the preferences folder if it does not already exist on your phone. +6. If you haven't done it yet, [set the **AAPS Directory**](#preferences-maintenance-settings): from the **AAPS** home screen, select the three line (hamburger) menu in the top left > Maintenance > AAPS DIRECTORY. + +7. From the **AAPS** home screen, select the three line (hamburger) menu in the top left > Maintenance > Export settings > type in Master password set above > Ok. This will create the preferences folder if it does not already exist on your phone. -7. Download the back-up of your **Preferences** file from your cloud platform. +8. Download the back-up of your **Preferences** file from your cloud platform. -8. Use your file explorer (commonly called “Files” or “My Files”) to move the file from your downloads to `/internal storage/AAPS/preferences` +9. Use your file explorer (commonly called “Files” or “My Files”) to move the file from your downloads to `/internal storage/AAPS/preferences` if your **AAPS Directory** has been set `/internal storage/AAPS` -9. From the **AAPS** home screen, select the three line (hamburger) menu in the top left > Maintenance > Import settings > select the preferences file you want to back-up from > Ok > type in Master password set above > Ok. Make sure you select the correct preferences file, all .json files from the preferences folder will be shown. +10. From the **AAPS** home screen, select the three line (hamburger) menu in the top left > Maintenance > Import settings > select the preferences file you want to back-up from > Ok > type in Master password set above > Ok. Make sure you select the correct preferences file, all .json files from the preferences folder will be shown. ![AAPS import settings 1](../images/Maintenance/AAPS_ImportSettings1.png) ![AAPS import settings 2](../images/Maintenance/AAPS_ImportSettings2.png) diff --git a/docs/CROWDIN/tr/SettingUpAaps/SetupWizard.md b/docs/CROWDIN/tr/SettingUpAaps/SetupWizard.md index 4333291ef901..d2d9f3587801 100644 --- a/docs/CROWDIN/tr/SettingUpAaps/SetupWizard.md +++ b/docs/CROWDIN/tr/SettingUpAaps/SetupWizard.md @@ -125,6 +125,8 @@ Follow these steps on Android 16, other versions will varies slightly from the p ![settings_apps](../images/setup-wizard/app_bluetooth_allow_background_unrestrict.png) +(SetupWizard-StoragePermission)= + ### Storage permission **AAPS** needs to log information to the permanent storage of your smartphone. Permanent storage means that it will be available even after rebooting your smartphone. Other information is just lost, as it is not saved to permanent storage. diff --git a/docs/CROWDIN/tr/images/GoogleDriveInWebbrowser.png b/docs/CROWDIN/tr/images/GoogleDriveInWebbrowser.png index 159f03ff2370..e682af001b15 100644 Binary files a/docs/CROWDIN/tr/images/GoogleDriveInWebbrowser.png and b/docs/CROWDIN/tr/images/GoogleDriveInWebbrowser.png differ diff --git a/docs/CROWDIN/tr/images/GoogleDriveMobileAPPLaunch.png b/docs/CROWDIN/tr/images/GoogleDriveMobileAPPLaunch.png index a021dd716fcf..f4ed9aa742a1 100644 Binary files a/docs/CROWDIN/tr/images/GoogleDriveMobileAPPLaunch.png and b/docs/CROWDIN/tr/images/GoogleDriveMobileAPPLaunch.png differ diff --git a/docs/CROWDIN/tr/images/GoogleDriveMobileMissingSecuritySetting.png b/docs/CROWDIN/tr/images/GoogleDriveMobileMissingSecuritySetting.png index ffc850fc5fe7..f53714dfbe20 100644 Binary files a/docs/CROWDIN/tr/images/GoogleDriveMobileMissingSecuritySetting.png and b/docs/CROWDIN/tr/images/GoogleDriveMobileMissingSecuritySetting.png differ diff --git a/docs/CROWDIN/tr/images/GoogleDriveMobileSettingSecuritySetting.png b/docs/CROWDIN/tr/images/GoogleDriveMobileSettingSecuritySetting.png index d0669d4fe98a..f53fec931a73 100644 Binary files a/docs/CROWDIN/tr/images/GoogleDriveMobileSettingSecuritySetting.png and b/docs/CROWDIN/tr/images/GoogleDriveMobileSettingSecuritySetting.png differ diff --git a/docs/CROWDIN/tr/images/GoogleDriveMobileUploadedAPK.png b/docs/CROWDIN/tr/images/GoogleDriveMobileUploadedAPK.png index dcb1a91655b6..ed45f83ad166 100644 Binary files a/docs/CROWDIN/tr/images/GoogleDriveMobileUploadedAPK.png and b/docs/CROWDIN/tr/images/GoogleDriveMobileUploadedAPK.png differ diff --git a/docs/CROWDIN/zh_CN/Maintenance/ExportImportSettings.md b/docs/CROWDIN/zh_CN/Maintenance/ExportImportSettings.md index f341e028e218..d57fc17c7340 100644 --- a/docs/CROWDIN/zh_CN/Maintenance/ExportImportSettings.md +++ b/docs/CROWDIN/zh_CN/Maintenance/ExportImportSettings.md @@ -2,9 +2,9 @@ 在手机上安装AAPS后，它就变成了你每天依赖的“医疗设备”。 强烈建议为手机出现故障、被盗或丢失的情况制定紧急备份计划。 因此，务必做好准备，问问自己：“万一呢？” -为了将你的AAPS设置恢复到现有手机或新手机上，重要的是要将以下项目保存在安全的位置（即：不要保存在手机上）。 最佳实践是至少保留两份独立的备份：一份在本地硬盘或U盘上，另一份（推荐）在云端存储上，如Google Drive或Microsoft 365 OneDrive。 通过将备份存储在云端，你可以随时随地通过手机访问恢复设置所需的一切。 +为了将你的AAPS设置恢复到现有手机或新手机上，重要的是要将以下项目保存在安全的位置（即：不要保存在手机上）。 Best practice is to keep at least two separate backups: on a local hard drive, USB stick and (preferred) on Cloud storage like Google Drive or Microsoft 365 OneDrive. By storing your backups in the cloud you'll always have everything needed accessible from your phone to restore your setup anywhere and anytime. -考虑购买一部备用手机，并练习恢复AAPS，以确保备用手机能按预期工作。 这一步将让你对紧急计划的有效性充满信心，如果你的主手机无法使用，你可以无缝继续使用AAPS。 +考虑购买一部备用手机，并练习恢复AAPS，以确保备用手机能按预期工作。 This step will give you confidence that your emergency plan is effective and that you can seamlessly continue using AAPS if your primary phone becomes unavailable. 为了能够恢复，手头备有以下项目是很重要的： @@ -36,14 +36,21 @@ **如何备份**：使用Android Studio构建APK的计算机上会保留一份副本。 此外，建议使用云平台存储一份安装程序APK的副本。 确保您知道如何在需要时找到这两个位置。 考虑在计算机和云平台上设置专用文件夹来存储这些备份。 ### AAPS设置文件（又称“首选项”） + +```{admonition} Where are preferences stored on my phone? +:class: tip +You will find your settings in the **AAPS Directory** you have selected during [AAPS setup](#SetupWizard-StoragePermission).
+You can also change the **AAPS Directory** in Preferences > [Maintenance Settings](#preferences-maintenance-settings). +``` + 有了APK安装程序文件的副本（见上文）和您的**设置**文件，您就可以快速在现有手机或新手机上开始使用。 -**偏好设置**是根据您的设置定制AAPS应用程序的方式。 它们包含诸如配置构建器设置、目标状态、第三方通信设置（例如，Nightscout、Tidepool）、自动化和配置文件等详细信息。 +The **Settings** file is used to customize the AAPS application to fit your specific setup. They encompass details such as your config builder settings, objective status, third-party communication settings (e.g., Nightscout, Tidepool), automations, and profiles. -将AAPS设置导出到文件，可以使您将配置恢复到特定的时间点。 如前所述，除了所有配置设置外，导出文件还包含您的目标状态，这在**（重新）安装**AAPS时需要恢复。 如果不这样做，您将需要从头开始重新完成所有目标以启用闭环。 设置文件还使您能够恢复“最后一个已知良好”的设置，以撤销任何配置更改。 +将AAPS设置导出到文件，可以使您将配置恢复到特定的时间点。 As mentioned, in addition to all configuration settings, the export file also contains the status of your objectives, which you need to restore when **(re)installing** AAPS. Without this you will be required to redo all objectives from start to enable closed loop. Settings files also enable you to restore "last known good" settings for undoing any configuration changes. **何时备份AAPS设置：** -* 每次完成一个目标时，以防止丢失进度。 _如果没有您的**设置**副本，在您需要重新安装AAPS或更换手机的情况下，您将不得不再次完成所有目标。_ +* 每次完成一个目标时，以防止丢失进度。 _Without a copy of your **Settings** you will have to complete all objectives again in the event you need to re-install AAPS or replace your phone._ * 每当您计划对配置进行重大更改时（更改SMB设置、更改胰岛素类型、更换泵、更改自动化设置），应在更改前后备份您的**偏好设置**。 这样，您既拥有最新的设置，也拥有更改前的副本，以防需要恢复。 @@ -63,7 +70,13 @@ ## 设置导出 -建议定期导出设置，尤其是在进行配置更改之前和之后。 您可以选择**手动导出或（更推荐）通过自动化方式**进行导出。 请务必记下您的AAPS主密码，并通过将手机上的设置文件复制到例如云存储位置来备份这些文件。 +```{admonition} Where are preferences stored on my phone? +:class: tip +You will find your settings in the **AAPS Directory** you have selected during [AAPS setup](#SetupWizard-StoragePermission).
+You can also change the **AAPS Directory** in Preferences > [Maintenance Settings](#preferences-maintenance-settings). +``` + +建议定期导出设置，尤其是在进行配置更改之前和之后。 You can choose to do exports **manually or (preferred) through automation**. Make sure to take a note of your AAPS master password and to backup your settings files by copying them off your phone to for instance a cloud storage location. **注意**：_导出的设置将使用您的AAPS主密码进行加密：如果没有用于导出的主密码，您将无法导入设置文件！_ @@ -85,6 +98,13 @@ _**注意**：在将设置导入用户时，总是需要输入AAPS密码！_ (ExportImportSettings-restoring-from-your-backups-on-a-new-phone-or-fresh-installation-of-aaps)= ## 在新手机或全新安装的AAPS上从备份中恢复 + +```{admonition} Where are preferences stored on my phone? +:class: tip +You will find your settings in the **AAPS Directory** you have selected during [AAPS setup](#SetupWizard-StoragePermission).
+You can also change the **AAPS Directory** in Preferences > [Maintenance Settings](#preferences-maintenance-settings). +``` + 如果您有想要加载到新手机上的APK和**设置**的备份，或者因任何原因需要在现有手机上删除并重新安装APK，请使用以下说明。 _如果您使用相同密钥库构建的APK更新**AAPS**，则无需遵循此过程。 但是，在应用更新之前，仍建议创建备份。_ @@ -108,13 +128,15 @@ _如果您使用相同密钥库构建的APK更新**AAPS**，则无需遵循此 5. 在**AAPS**主屏幕，在[Preferences > General > Protection](#Preferences-master-password)中设置主密码，与您备份时使用的密码相同。 -6. 在**AAPS**主屏幕，选择左上角的三条线（汉堡）菜单 > Maintenance（维护）> Export settings（导出设置）> 输入上面设置的主密码 > Ok（确定）。 如果手机上尚不存在preferences文件夹，这将创建该文件夹。 +6. If you haven't done it yet, [set the **AAPS Directory**](#preferences-maintenance-settings): from the **AAPS** home screen, select the three line (hamburger) menu in the top left > Maintenance > AAPS DIRECTORY. + +7. 在**AAPS**主屏幕，选择左上角的三条线（汉堡）菜单 > Maintenance（维护）> Export settings（导出设置）> 输入上面设置的主密码 > Ok（确定）。 如果手机上尚不存在preferences文件夹，这将创建该文件夹。 -7. 从云平台下载您的**偏好设置**文件备份。 +8. 从云平台下载您的**偏好设置**文件备份。 -8. 使用文件资源管理器（通常称为“Files”或“My Files”）将文件从下载位置移动到`/internal storage/AAPS/preferences`。 +9. Use your file explorer (commonly called “Files” or “My Files”) to move the file from your downloads to `/internal storage/AAPS/preferences` if your **AAPS Directory** has been set `/internal storage/AAPS` -9. 在**AAPS**主屏幕，选择左上角的三条线（汉堡）菜单 > Maintenance（维护）> Import settings（导入设置）> 选择您要从中备份的偏好设置文件 > Ok（确定）> 输入上面设置的主密码 > Ok（确定）。 确保选择正确的偏好设置文件，将显示preferences文件夹中的所有.json文件。 +10. 在**AAPS**主屏幕，选择左上角的三条线（汉堡）菜单 > Maintenance（维护）> Import settings（导入设置）> 选择您要从中备份的偏好设置文件 > Ok（确定）> 输入上面设置的主密码 > Ok（确定）。 确保选择正确的偏好设置文件，将显示preferences文件夹中的所有.json文件。 ![AAPS导入设置1](../images/Maintenance/AAPS_ImportSettings1.png) ![AAPS导入设置2](../images/Maintenance/AAPS_ImportSettings2.png) diff --git a/docs/CROWDIN/zh_CN/SettingUpAaps/SetupWizard.md b/docs/CROWDIN/zh_CN/SettingUpAaps/SetupWizard.md index a038916369de..5001a7d78c18 100644 --- a/docs/CROWDIN/zh_CN/SettingUpAaps/SetupWizard.md +++ b/docs/CROWDIN/zh_CN/SettingUpAaps/SetupWizard.md @@ -125,6 +125,8 @@ Follow these steps on Android 16, other versions will varies slightly from the p ![settings_apps](../images/setup-wizard/app_bluetooth_allow_background_unrestrict.png) +(SetupWizard-StoragePermission)= + ### 存储权限 **AAPS** 需要将信息记录到智能手机的永久存储中。 永久存储意味着即使在重新启动智能手机后，信息仍然可用。（PC硬盘的概念） 其他信息只是丢失了，因为它们没有被保存到永久存储中。 diff --git a/docs/CROWDIN/zh_CN/images/GoogleDriveInWebbrowser.png b/docs/CROWDIN/zh_CN/images/GoogleDriveInWebbrowser.png index 159f03ff2370..e682af001b15 100644 Binary files a/docs/CROWDIN/zh_CN/images/GoogleDriveInWebbrowser.png and b/docs/CROWDIN/zh_CN/images/GoogleDriveInWebbrowser.png differ diff --git a/docs/CROWDIN/zh_CN/images/GoogleDriveMobileAPPLaunch.png b/docs/CROWDIN/zh_CN/images/GoogleDriveMobileAPPLaunch.png index a021dd716fcf..f4ed9aa742a1 100644 Binary files a/docs/CROWDIN/zh_CN/images/GoogleDriveMobileAPPLaunch.png and b/docs/CROWDIN/zh_CN/images/GoogleDriveMobileAPPLaunch.png differ diff --git a/docs/CROWDIN/zh_CN/images/GoogleDriveMobileMissingSecuritySetting.png b/docs/CROWDIN/zh_CN/images/GoogleDriveMobileMissingSecuritySetting.png index ffc850fc5fe7..f53714dfbe20 100644 Binary files a/docs/CROWDIN/zh_CN/images/GoogleDriveMobileMissingSecuritySetting.png and b/docs/CROWDIN/zh_CN/images/GoogleDriveMobileMissingSecuritySetting.png differ diff --git a/docs/CROWDIN/zh_CN/images/GoogleDriveMobileSettingSecuritySetting.png b/docs/CROWDIN/zh_CN/images/GoogleDriveMobileSettingSecuritySetting.png index d0669d4fe98a..f53fec931a73 100644 Binary files a/docs/CROWDIN/zh_CN/images/GoogleDriveMobileSettingSecuritySetting.png and b/docs/CROWDIN/zh_CN/images/GoogleDriveMobileSettingSecuritySetting.png differ diff --git a/docs/CROWDIN/zh_CN/images/GoogleDriveMobileUploadedAPK.png b/docs/CROWDIN/zh_CN/images/GoogleDriveMobileUploadedAPK.png index dcb1a91655b6..ed45f83ad166 100644 Binary files a/docs/CROWDIN/zh_CN/images/GoogleDriveMobileUploadedAPK.png and b/docs/CROWDIN/zh_CN/images/GoogleDriveMobileUploadedAPK.png differ diff --git a/docs/CROWDIN/zh_TW/Maintenance/ExportImportSettings.md b/docs/CROWDIN/zh_TW/Maintenance/ExportImportSettings.md index 63e5f1c3fa5a..67680d2d4171 100644 --- a/docs/CROWDIN/zh_TW/Maintenance/ExportImportSettings.md +++ b/docs/CROWDIN/zh_TW/Maintenance/ExportImportSettings.md @@ -2,9 +2,9 @@ 當你在手機上安裝 AAPS 時，它將成為你每日依賴的「醫療設備」。 強烈建議針對手機故障、被盜或遺失時有一個緊急備份計畫。 因此，事先準備是必要的，問自己：「如果...怎麼辦？」 -要將你的 AAPS 設定恢復到現有或新手機，重要的是將以下項目保存在安全的地方（也就是說：不能放在你的手機上）。 最佳實踐是至少保留兩個獨立的備份：在本地硬碟、USB 隨身碟上，以及（較佳選擇）在雲端儲存服務上，如 Google Drive 或 Microsoft 365 OneDrive。 將備份儲存在雲端，你能隨時隨地從手機取得一切所需，以恢復你的設定。 +要將你的 AAPS 設定恢復到現有或新手機，重要的是將以下項目保存在安全的地方（也就是說：不能放在你的手機上）。 最佳做法是保留至少兩份獨立備份：一份在本機硬碟、USB 隨身碟，並且（建議）再放一份在雲端儲存空間，例如 Google Drive 或 Microsoft 365 OneDrive。 將備份存放在雲端後，你就能隨時隨地從手機讀取所有所需資訊，以便在任何地點、任何時間還原你的設定。 -考慮獲得一部備用手機並練習恢復 AAPS，以確保備用手機正常運作。 這一步將給你信心，相信你的緊急計畫是有效的，如果你的主手機無法使用，你依然可以順利使用 AAPS。 +考慮獲得一部備用手機並練習恢復 AAPS，以確保備用手機正常運作。 此步驟能讓你更有信心你的緊急應變計畫有效，並且在主要手機無法使用時，仍能繼續使用 AAPS。 為了能夠恢復，準備以下項目是很重要的： @@ -36,14 +36,21 @@ **如何備份：** 在用 Android Studio 構建 APK 的電腦上保持一份副本。 此外，建議使用雲端平台儲存安裝檔 APK 的副本。 確保你知道如何在需要時找到這兩個備份。 考慮設置專用資料夾來存放這些備份。 ### AAPS 設定檔案（也稱為「偏好設定」） + +```{admonition} Where are preferences stored on my phone? +:class: tip +你會在你於 [AAPS setup](#SetupWizard-StoragePermission) 過程中所選擇的 **AAPS Directory** 中找到你的設定。
+你也可以在「偏好設定」＞[維護設定](#preferences-maintenance-settings) 中變更 **AAPS Directory**。 +``` + 擁有 APK 安裝檔的副本（見上文）和你的 **設定** 檔後，你可以迅速在現有或新手機上啟動。 -此 **設定** 檔用於自訂 AAPS 應用以符合你的特定設定。 它們包括你的組態建置工具設定、 目標狀態、第三方通訊設定（例如，Nightscout、Tidepool）、自動化和個人檔案。 +**Settings** 檔案用於自訂 AAPS 應用程式，以符合你的特定設定。 其中包含例如你的組態建置工具設定、目標狀態、第三方通訊設定（例如 Nightscout、Tidepool）、自動化，以及設定檔等詳細資訊。 -將 AAPS 設定匯出為檔案使你能夠將其配置恢復到特定的時間點。 如前所述，除了所有 配置設定外，匯出檔案還包含你目標的狀態，當 **(重新)安裝** AAPS 時你需要恢復此狀態。 如果沒有 這個，你將需要從頭開始重新設置所有目標才能啟用封閉迴路。 設定檔也能讓你恢復「最後已知的良好」設定 以撤銷任何配置變更。 +將 AAPS 設定匯出為檔案使你能夠將其配置恢復到特定的時間點。 如前所述，除了所有組態設定外，匯出檔也包含你的目標狀態，當 **(re)installing** AAPS 時需要一併還原。 否則你將必須從頭完成所有目標，才能啟用封閉循環。 設定檔也能讓你還原「最後已知可用」的設定，以撤銷任何組態變更。 **何時備份 AAPS 設定：** -* 每次完成一個目標時，為了避免進度遺失。 _如果沒有你的 **設定** 副本，在需要重新安裝 AAPS 或更換手機時，你將不得不再次完成所有目標。_ +* 每次完成一個目標時，為了避免進度遺失。 _若沒有 **Settings** 的備份，一旦你需要重新安裝 AAPS 或更換手機，你將必須再次完成所有目標。_ * 每當你計畫對你的設定進行重大更改（更改 SMB 設定、更改胰島素類型、更改幫浦、對自動化進行更改）時，應在進行更改之前和之後備份你的**設定**。 這樣你就可以保留最新的設定副本以及變更前的設定副本，萬一需要回滾時可以使用。 @@ -63,7 +70,13 @@ ## 設定匯出 -建議定期執行設定匯出，特別是在進行設定更改之前和之後。 你可以選擇手動執行匯出 **或通過自動化進行（較佳選擇）**。 確保記下你的 AAPS 主密碼，並將你的設定 檔案備份，通過將其從手機複製到雲端儲存位置等方式。 +```{admonition} Where are preferences stored on my phone? +:class: tip +你會在你於 [AAPS setup](#SetupWizard-StoragePermission) 過程中所選擇的 **AAPS Directory** 中找到你的設定。
+你也可以在「偏好設定」＞[維護設定](#preferences-maintenance-settings) 中變更 **AAPS Directory**。 +``` + +建議定期執行設定匯出，特別是在進行設定更改之前和之後。 你可以選擇**手動或（建議）透過自動化**來進行匯出。 務必記下你的 AAPS 主密碼，並將設定檔從手機複製到例如雲端儲存空間等位置進行備份。 **注意**：_匯出的設定將使用你的 AAPS 主密碼進行加密：若沒有用於匯出的主密碼， 你將無法匯入設定檔！_ @@ -85,6 +98,13 @@ _**注意：**在匯入設定時，用戶始終需要輸入 AAPS 密碼！_ (ExportImportSettings-restoring-from-your-backups-on-a-new-phone-or-fresh-installation-of-aaps)= ## 從備份中恢復至新手機或重新安裝 AAPS + +```{admonition} Where are preferences stored on my phone? +:class: tip +你會在你於 [AAPS setup](#SetupWizard-StoragePermission) 過程中所選擇的 **AAPS Directory** 中找到你的設定。
+你也可以在「偏好設定」＞[維護設定](#preferences-maintenance-settings) 中變更 **AAPS Directory**。 +``` + 如果你擁有APK和**偏好設定**的備份，並想將其載入新手機，或因任何原因需要刪除並重新安裝現有手機上的APK，請使用這些指示。 _如果你在使用相同金鑰庫生成的APK更新**AAPS**，則無需遵循此過程。 不過，仍建議在更新前建立備份。_ @@ -108,13 +128,15 @@ _如果你在使用相同金鑰庫生成的APK更新**AAPS**，則無需遵循 5. 在**AAPS**主畫面，將主密碼在[偏好設定 > 一般 > 保護](#Preferences-master-password)中設置為與備份相同的密碼。 -6. 在**AAPS**主畫面，選擇左上角的三條線（漢堡）選單 > 維護 > 匯入設定 > 選擇你要備份的偏好設定檔案 > 確定 > 輸入上述設定的主密碼 > 確定。 這將在手機上建立偏好設定資料夾（如果尚未存在）。 +6. 如果你尚未完成，請[設定 **AAPS Directory**](#preferences-maintenance-settings)：在 AAPS 首頁畫面，點選左上角三線（漢堡）選單 ＞ Maintenance ＞ AAPS DIRECTORY。 + +7. 在**AAPS**主畫面，選擇左上角的三條線（漢堡）選單 > 維護 > 匯入設定 > 選擇你要備份的偏好設定檔案 > 確定 > 輸入上述設定的主密碼 > 確定。 這將在手機上建立偏好設定資料夾（如果尚未存在）。 -7. 從你的雲端平台下載**偏好設定**檔案的備份。 +8. 從你的雲端平台下載**偏好設定**檔案的備份。 -8. 使用你的檔案總管（通常稱為「檔案」或「我的檔案」）將檔案從下載移動到`/internal storage/AAPS/preferences` +9. 使用你的檔案管理器（常見為「Files」或「My Files」），如果你的 **AAPS Directory** 設為 `/internal storage/AAPS`，請將檔案從下載資料夾移動到 `/internal storage/AAPS/preferences` -9. 在**AAPS**主畫面，選擇左上角的三條線（漢堡）選單 > 維護 > 匯入設定 > 選擇你要備份的偏好設定檔案 > 確定 > 輸入上述設定的主密碼 > 確定。 確保選擇正確的偏好設定檔案，所有來自偏好設定資料夾的 .json 檔案將顯示。 +10. 在**AAPS**主畫面，選擇左上角的三條線（漢堡）選單 > 維護 > 匯入設定 > 選擇你要備份的偏好設定檔案 > 確定 > 輸入上述設定的主密碼 > 確定。 確保選擇正確的偏好設定檔案，所有來自偏好設定資料夾的 .json 檔案將顯示。 ![AAPS 匯入設定 1](../images/Maintenance/AAPS_ImportSettings1.png) ![AAPS 匯入設定 2](../images/Maintenance/AAPS_ImportSettings2.png) diff --git a/docs/CROWDIN/zh_TW/SettingUpAaps/SetupWizard.md b/docs/CROWDIN/zh_TW/SettingUpAaps/SetupWizard.md index 67b46fc16e3c..ad5b14c1823d 100644 --- a/docs/CROWDIN/zh_TW/SettingUpAaps/SetupWizard.md +++ b/docs/CROWDIN/zh_TW/SettingUpAaps/SetupWizard.md @@ -125,6 +125,8 @@ ![settings_apps](../images/setup-wizard/app_bluetooth_allow_background_unrestrict.png) +(SetupWizard-StoragePermission)= + ### 儲存權限 **AAPS** 需要將訊息記錄到你的智慧型手機的永久儲存中。 永久儲存意味著即使重啟智慧型手機後，他仍然可用。 其他訊息則會遺失，因為他們沒有儲存到永久儲存中。 diff --git a/docs/CROWDIN/zh_TW/images/GoogleDriveInWebbrowser.png b/docs/CROWDIN/zh_TW/images/GoogleDriveInWebbrowser.png index 159f03ff2370..e682af001b15 100644 Binary files a/docs/CROWDIN/zh_TW/images/GoogleDriveInWebbrowser.png and b/docs/CROWDIN/zh_TW/images/GoogleDriveInWebbrowser.png differ diff --git a/docs/CROWDIN/zh_TW/images/GoogleDriveMobileAPPLaunch.png b/docs/CROWDIN/zh_TW/images/GoogleDriveMobileAPPLaunch.png index a021dd716fcf..f4ed9aa742a1 100644 Binary files a/docs/CROWDIN/zh_TW/images/GoogleDriveMobileAPPLaunch.png and b/docs/CROWDIN/zh_TW/images/GoogleDriveMobileAPPLaunch.png differ diff --git a/docs/CROWDIN/zh_TW/images/GoogleDriveMobileMissingSecuritySetting.png b/docs/CROWDIN/zh_TW/images/GoogleDriveMobileMissingSecuritySetting.png index ffc850fc5fe7..f53714dfbe20 100644 Binary files a/docs/CROWDIN/zh_TW/images/GoogleDriveMobileMissingSecuritySetting.png and b/docs/CROWDIN/zh_TW/images/GoogleDriveMobileMissingSecuritySetting.png differ diff --git a/docs/CROWDIN/zh_TW/images/GoogleDriveMobileSettingSecuritySetting.png b/docs/CROWDIN/zh_TW/images/GoogleDriveMobileSettingSecuritySetting.png index d0669d4fe98a..f53fec931a73 100644 Binary files a/docs/CROWDIN/zh_TW/images/GoogleDriveMobileSettingSecuritySetting.png and b/docs/CROWDIN/zh_TW/images/GoogleDriveMobileSettingSecuritySetting.png differ diff --git a/docs/CROWDIN/zh_TW/images/GoogleDriveMobileUploadedAPK.png b/docs/CROWDIN/zh_TW/images/GoogleDriveMobileUploadedAPK.png index dcb1a91655b6..ed45f83ad166 100644 Binary files a/docs/CROWDIN/zh_TW/images/GoogleDriveMobileUploadedAPK.png and b/docs/CROWDIN/zh_TW/images/GoogleDriveMobileUploadedAPK.png differ