Merge branch '922-documentation-of-s7-upgrade-to-r-with-sd-card-as-internal-storage' into 'master'

- [Need Help? Support?](https://e.foundation/contact/)

- [Report a bug in /e/OS or apps](https://gitlab.e.foundation/e/backlog/-/issues/new)

- [Add your Smartphone to the supported list](https://community.e.foundation/c/e-devices/request-a-device)

    <li><a href="{% translate_link support-topics/fairphone-3-plus-v-1-point-6-fix %}">Fix your Fairphone 3+ after v1.6 update</a></li>

    <li><a href="{% translate_link support-topics/teracube-2e-sdcard-update %}">Steps to install a SDCard and update Teracube 2e from it</a></li>

    <li><a href="{% translate_link support-topics/upgrade-fp3-from-a9 %}">Upgrade Fairphone 3 from Android 9</a></li>

    <li><a href="{% translate_link support-topics/s7-upgrade-to-r-guide %}">Upgrade the Samsung s7/s7+ to /e/OS R with SD card as internal storage</a></li>

</ul>

<h2>Tips</h2>

<ul>

## Introduction:

Devices using an external SD card as internal storage (adoptable storage) can present some challenges during an Android upgrade. So, this guide exists to help those using an SD card as internal storage, and wish to upgrade to Android 11 on Samsung S7 devices (specifically the herolte or hero2lte).

The contents of an external SD card used as internal storage are encrypted with a unique encryption key generated by hardware and specific to your device, even other devices of the same make and model can't access the SD card's content.

The unique encryption key can't be extracted and ported to another device because the [key is based on the adopted partition's GUID](https://source.android.com/docs/core/storage).

Starting from /e/OS Android 11, we will stop supporting Adoptable storage on all Samsung S7 Devices due to lack of support for Adoptable storage from OEMs (Original Equipment Manufacturers) and issues mentioned above.

Further reading:

- [SDCardFS Deprecation](https://source.android.com/devices/storage/sdcardfs-deprecate?hl=en)

- [AOSP Adoptable Storage Documentation](https://source.android.com/docs/core/storage/adoptable)

## Installation of Android R Upgrade

1. Prepare for the Upgrade:

    `IMPORTANT STEP`

    - Create a full backup of all data stored on the device and the SD card. Create two backups - one local (like on an USB drive) and one offsite (like Murena cloud) to ensure you never lose your files, apps, and settings.

    - Create a back-up of apps potentially using the SD card to store their data and settings

    - Charge your device above 50% to prevent mishaps and interruptions during the upgrade.

2. Format the SD Card as Portable Storage:

    `WARNING: This step will turn OFF the option to use SD card as Adoptable Storage and DELETE all data stored on the SD card.`

    - Navigate to Settings -> Storage -> SDCard -> Tap on 3 Dots at top and Select `Format as Portable Storage` -> Tap on `Format`.

    Navigate to Settings ![alt text](/images/howtos/s7-upgrade-to-r/open-system-settings.jpg "Go to Settings") | Navigate to Storage ![alt text](/images/howtos/s7-upgrade-to-r/navigate-to-storage.png "Navigation to Storage")

    Tap on SDCard ![alt text](/images/howtos/s7-upgrade-to-r/tap-on-sd-card.png "Tap on SDCard") | Tap on 3 Dots at top ![alt text](/images/howtos/s7-upgrade-to-r/tap-on-three-dots-top-right.png "Tap on 3 Dots at top")

    Tap on `Format as Portable Storage` ![alt text](/images/howtos/s7-upgrade-to-r/tap-on-format-as-portable.png "Format as Portable Storage") | Tap on `Format Button` to format SDCard ![alt text](/images/howtos/s7-upgrade-to-r/tap-on-format-to-format-sd-card.png "Tap on format to format SDCard")

    Your SDCard is now Portable Storage. ![alt text](/images/howtos/s7-upgrade-to-r/storage-menu-after-sd-card-format.png "SDCard is now Portable Storage") |

3. Perform the Upgrade:

    - Initiate the upgrade process as per the OTA Updater instructions, ensuring a stable internet connection and adequate storage space.

## Frequently Asked Questions (FAQs)

1. **Will apps installed on SD Card lose their app data?:** 

    - It's best to assume that apps installed on the SD card will lose their app data and need to be setup again using the backup you created.

    - During our tests, some apps didn't lose their data after removal SD card as Adoptable Storage, but please don't assume that an app won't lose it's data. Please backup your data before performing this upgrade.

2. **Is there possibility to use SD card as Adoptable Storage after upgrading to Android 11:** 

    - No, Adoptable storage options will not be supported starting with Android 11.