Merge pull request #1902 from LegoChemist/rework-project

updates to section "C" setting up AAPS

docs/EN/Installing-AndroidAPS/Dedicated-Google-account-for-AAPS.md

@@ -0,0 +1,149 @@
+# A dedicated Google account for AAPS (optional)
+
+Some **AAPS** users prefer to use their main email account for **AAPS** as well. Alternatively, some **AAPS** users (or their caregivers) set-up a dedicated **AAPS** email account - this is optional, we give an example of how to do it below.    
+
+If you don't want to set up an **AAPS**-dedicated Gmail account, you can just go straight to the next section, [building AAPS](building-AAPS.md). 
+
+:::{admonition} Advantages of a dedicated Google account for AAPS
+:class: dropdown
+
+- Dedicated Google drive space means you will not risk filling up your personal Google drive limit with **Export Preferences**.
+- Each version of **AAPS** (and supporting apps like xdrip+, BYODA, etc) will be stored in one single place which is independent of your computer hardware. If your PC or phone is stolen/lost/broken you will still have access.
+- By harmonizing the setup, it will make online support simpler across users with similar folder structure.
+- Depending on the setup (see below), you will have a separate identity as an alias to communicate within the community which can protect your privacy. 
+- Children with T1D can preserve their own “everyday” email account as minors while using **AAPS** and associated features which require an adult account.
+- Gmail allows you to register up to 4 accounts under the same phone number.
+  :::
+
+## How to set up a dedicated Google account for AAPS
+
+(⌛About 10 minutes)
+
+![](../images/Building-the-App/building_0001.png)
+
+Requirements:
+
+* You have a Windows’ PC (Windows 10 or newer) and a Android phone (Android 9 or newer) which will host the **AAPS** app. These both have all the latest security updates, internet access and admin privileges, since some steps require downloading and installing programs.
+* The Android phone is already set-up with your personal ”everyday”  email address, such as a Gmail account.
+
+:::{admonition} Things to consider when setting up your new account
+:class: dropdown
+- You could use a name different to your own, which has relevance to the account (like t1dsuperstar) for privacy reasons. You can then use it in **AAPS** public forums while keeping your own identity private. Since Google requires a recovery email and phone number, it is still traceable.
+- The new **AAPS** account will use the same phone number for verification as your “_everyday_” one. It will use the “everyday” email address for verification;
+- We will setup email forwarding such that any email sent to the new dedicated AAPS account will be forwarded to the primary one (so there is no need to check two different mailboxes);
+- Use separate passwords for your _everyday_ Gmail account and the AAPS-dedicated Gmail account
+- If you use google “2-step verification” (aka multifactor) authentication for one Gmail account, you might as well do it for both Gmail accounts.
+- If you plan to use Google “Passkeys”, make sure you register multiple devices. This is so you don’t lock yourself out. Only do it on devices that nobody else can access (_i.e._ not on a PC with a shared account that other people can unlock).
+  :::
+
+
+:::{admonition}  Video Walkthrough! 
+:class: Note
+Click [here](<https://drive.google.com/file/d/1dMZTIolO-kd2eB0soP7boEVtHeCDEQBF/view?usp=drive_link>) for a video walkthrough of how to set up a dedicated Google account.
+:::
+
+ These are the steps outlined in the video:
+
+In this example: 
+- Your existing “_Everyday_” Google account is <[email protected]> ; ![](../images/Building-the-App/building_0002.png)
+- Your new “_AAPS_” Gmail account will be: <[email protected]>; ![](../images/Building-the-App/building_0003.png)
+
+
+#### Go to <https://account.google.com> 
+
+ If you are already logged into Google, this will direct you to your “Everyday” **My Account** page. 
+(1) Click on the top right of the page on your profile picture (in this case, a simple ![](../images/Building-the-App/building_0002.png) 
+(2) select “_add another account_”.
+
+![](../images/Building-the-App/building_0005.png)
+
+
+#### Enter your NEW dedicated account details: 
+
+- Enter the new account: 
+- Create Account
+- for my personal use. 
+
+
+ #### Enter your persona:
+ - Enter firstname
+ - lastname
+ - birthdate (needs to be an Adult age)
+
+#### Choose your NEW email address & password
+
+This example appends “.AAPS” to Donald Muck’s existing one…\
+Set a password
+
+####  Enter a phone number which can receive the SMS verification
+
+Gmail will now send you a unique code to enter for validation.
+
+#### Enter the recovery email address 
+
+In this case it will be your existing “_everyday_” email…
+
+#### Finish setting up the account
+
+Gmail will display the account name. It will ask you to accept Gmail’s terms and conditions & confirm your personalization settings.
+
+#### Customize the new profile display
+
+At this point you should be on Gmail’s MyAccount page showing your new **AAPS**-dedicated email account. The profile picture will be set by default to the first letter of your name. Change it to something unique to avoid confusion… in this example, Donald.Muck.AAPS has replaced ![](../images/Building-the-App/building_0002.png) with ![](../images/Building-the-App/building_0003.png)
+
+![](../images/Building-the-App/building_0007.png)\
+![](../images/Building-the-App/building_0008.png)
+
+#### Open the Gmail website on both windows to configure the new account
+
+So that you don’t need to monitor a separate email account, forward all the emails from the new **AAPS**-dedicated account to your everyday account \
+This part can be a bit confusing, since you will have to switch back and forth between both accounts. To make it easier, open 2 separate browser windows on top of each other:
+
+1. Move your existing browser to the top of your screen and resize it such that it only takes about half of the top of the screen… 
+2. Right click on your Browser logo in your taskbar 
+3. From the menu select “New Window”... and adjust it so it only takes the bottom half of the screen.
+
+Open <https://gmail.com>  in each browser window. Make sure your personal account is on top and the new dedicated **AAPS** account is on the bottom, and is easily identifiable by the profile picture in the top right corner. (if needed you can always switch accounts by clicking on the profile picture and selecting the correct one.
+
+![](../images/Building-the-App/building_0009.png)
+
+Your Gmail homepages screen should look like this:\
+![](../images/Building-the-App/building_0010.png)
+
+ #### In the new Gmail account (bottom window), open Gmail settings… 
+
+- Click on the gear on the left of the profile picture 
+- then select “**See all Settings**”
+
+![](../images/Building-the-App/building_0011.png)
+
+#### Setup forwarding…
+
+- Click on the “Forwarding and POP/IMAP” Setting tab
+- Click on “add a forwarding address”
+- Add your “everyday” email address
+- Gmail will send a verification code to your “everyday” email address. 
+- You will switch back to your everyday profile and click on the link to verify that you accept the forwarding (or get the code from Gmail’s verification email in your “everyday” Gmail window and cut and paste it in your “new AAPS dedicated” Gmail window).
+
+There is quite a bit of back and forth between the windows but this will ensure that when you check your “everyday” account emails you will also see the emails forwarded from your AAPS dedicated account such as Gmail alerts.
+
+![](../images/Building-the-App/building_0012.png)
+
+#### Verify the forwarded email address
+
+- In the “Everyday” gmail (top window), you will get the “Gmail forwarding Confirmation” email. 
+- Open it and “click the link to confirm the request”
+
+#### Archive forwarded emails in the new dedicated Gmail account (bottom window)
+
+<!---->
+
+1. Refresh the bottom window
+2. Check “forward incoming email”
+3. And archive Gmail’s copy (to keep your new dedicated mailbox clean)
+4. Scroll all the way to the bottom to save your changes\
+   ![](../images/Building-the-App/building_0013.png)
+
+![](../images/Building-the-App/building_0014.png)
+
+Congratulations! Now you have created an AAPS-dedicated Google account. The next step is to [build the AAPS app](building-AAPS.md).

docs/EN/Installing-AndroidAPS/Transferring-and-installing-AAPS.md

@@ -0,0 +1,114 @@
+# Transferring, and Installing AAPS on your smartphone
+
+In the previous section, [building **AAPS**](../building-AAPS.md), you built the **AAPS** app (which is an .apk file) on a computer. 
+
+The next steps are to transfer the **AAPS** APK file (and other apps you may need, like BYODA, Xdrip+ or another CGM reciever app) to your Android smartphone and then install the app. 
+
+Following installation of **AAPS** on the smartphone, you will then be able to move onto [**configuring the AAPS loop**](configuring-the-AAPS-loop.md).
+
+There are several ways to transfer the **AAPS** APK file from your computer to the smartphone. Here we explain two different ways: 
+
+* Option 1-  Use a USB cable
+* Option 2 -  Use your Google drive (Gdrive)
+
+The easiest way is with a USB cable, moving the file from the computer to the "downloads" folder on the phone. 
+
+You can also use your **Google Drive** to do the transfer and installation. By using **Google Drive**, you automatically have a **backup copy** of the apk file, which will be very useful if you lose or break your computer or smartphone.
+
+Once you have transferred the AAPS apk as well as the app you intend to use for receiving your CGM data (BYODA, Xdrip+ or ..Juggulo), to your Android phone, you can proceed to the next section, installing AAPS. 
+
+## 1. Transfer using a USB cable
+
+
+
+
+
+
+## 2. Transfer using Google drive
+### **Mount Google drive on your PC & Phone**
+
+(⌛About 10 minutes )\
+![](../images/Building-the-App/building_0015.png)
+
+A Gmail account provides access to free cloud storage from Gdrive which can be accessed directly as a “virtual” drive from both your PC AND your phone. You can use this feature to backup important settings/files in Gdrive and to share files between the phone and the PC.
+If you have not done so already, install Gdrive on your PC: 
+
+
+
+#### Install Google drive (“Gdrive”) on your PC as shown in this walk-through: 
+<https://drive.google.com/file/d/1EnaQ7U8U7M84vOFjcMRoB43dNwqUuLty/view?usp=drive_link>
+
+
+The steps are as follows: 
+
+1. Go to <https://drive.google.com/> 
+
+2. Use your new  “AAPS-dedicated” account to login, (if needed switch the account from the profile window)
+
+3. From the gear icon next to your profile picture select “Get drive for desktop”  
+
+4. Download & Install the Gdrive application on your PC
+
+5. By default,Gdrive will appear on your PC as G:\My Drive, create 3 subfolders under My Drive:
+
+   - AAPS\_APK  \
+     (to store your own versions of the AAPS application as you build it and update it overtime)
+   - AAPS\_CONFIG\_BACKUP\
+     (where you will keep a backup of your AAPS phone configurations overtime)
+   - AAPS\_SECRETS \
+     (where you will keep passwords required to rebuild the application and facilitate updates over time)
+
+6. It is advisable to share these folders with your significant others in case they need to re-access or re-build the app for you. 
+
+   - (1) Right click on the folder 3 vertical dots menu
+   - (2) Click Share 
+   - (3) Click Share 
+   - Enter the email address of the people you will want to grant access to…\
+     ![](../images/Building-the-App/building_0016.png)
+
+7. Download & install the “google drive” on your phone from the playstore link\
+   If you need more details, you can see the step-by-step 2 minutes video here: <https://drive.google.com/file/d/1--qwxp95cG8pwCv1pDFZuuOl6ue22W4H/view?usp=drive_link> 
+
+   - If you use an **AAPS**-dedicated Gmail account, make sure that you configure google drive to use the correct one by clicking on the profile picture.
+
+
+
+Step-by-step guide:
+
+a) Open [Google.com](https://www.google.com/) in your web browser.
+
+b) On the right upper side select the Drive app in the Google menu.
+
+![Start Drive App](../images/GoogleDriveInWebbrowser.png)
+
+c) Right-click in the free area below the files and folders in the **Google Drive** app and select "Upload File".
+
+![Upload apk file with Google Drive App](../images/GoogleDriveUploadFile.png)
+
+d) The apk file should now be uploaded on Google Drive.
+
+## Install  the **AAPS** APK file on your Android smartphone
+
+a) Switch to working on your Android smartphone, and start the **Google Drive** app, which should be preinstalled on the phone. 
+
+![start the Google Drive app](../images/GoogleDriveMobileAPPLaunch.png)
+
+b) Launch installation of the **AAPS** apk by double-clicking on the filename in the **Google Drive** App.
+
+![launch the apk installation](../images/GoogleDriveMobileUploadedAPK.png)
+
+c) If you get a security notice that you are "not allowed to install apps from **Google Drive**", you will need to allow it while you are installing the app, and then disallow it afterwards to prevent it being a security risk.
+
+![Security Notice Google Drive](../images/GoogleDriveMobileMissingSecuritySetting.png)
+
+![Security Notice Google Drive](../images/GoogleDriveMobileSettingSecuritySetting.png)
+
+d) Now that you have installed **AAPS** on the Android smartphone you should see the **AAPS** icon and be able to open the app. 
+
+```{warning}
+**IMPORTANT SAFETY NOTICE**
+
+Did you remember to disallow the installation from Google Drive?
+
+```
+Congratulations! Now you can continue with the next section, [configuring the AAPS loop](configuring-the-AAPS-loop.md).