English

✏ Update Guide for a modified FP Open OS (with Gapps, Xposed and more)

xposed
wiki
osupdates
updateguide
staff
Tags: #<Tag:0x00007f1af6ef8838> #<Tag:0x00007f1af6ef8680> #<Tag:0x00007f1af6ef84f0> #<Tag:0x00007f1af6ef8388> #<Tag:0x00007f1af6ef81f8>

#1

When having other packages installed with FP Open OS (e.g. opengapps or xposed) it is possible that you will get stuck in a bootloop after an update, if not installing these packages again.
Because these additional tools are installed on the /system partition, you need to reinstall them after every update, since the /system partition gets overwritten during the update. However, you should not loose data or settings, which are stored on your /data partition.

If you have not modified your FPOOS installation with such packages but run it as it is shipped, you need NOT to follow this guide; just go into the Fairphone updater app and install your update from there.

For everyone who runs a modified FPOOS, following the instructions below should help you avoiding problems, such as the bootloop, and support you by having a smooth update experience.

For now I added the (I guess so) most commonly used extensions of FPOOS, but please feel free to add other things, modify, extend and edit this post. THIS IS A WIKI after all!


Short Version:

  • Prepare: Download the OTA update zip and zips for all your modifications
  • Boot to TWRP
  • Flash the update
  • Flash all your modifications before rebooting
  • Reboot to system.

For more info read on below, but don’t follow any instructions for flashing or modifying something you didn’t flash before the update. If you didn’t need it before, you won’t need it now.


Detailed Version:

1)
Before starting update,

1.1 Create a (Titanium) Backup of your apps and settings, and save all your files (offline maps, photos, music etc.).
Be sure to get your backup off the phone — onto a removable SD card or copied to a computer. It is very easy to wipe everything.

Make sure to have the latest
1.2 OpenGAPPS (choose ARM; 5.1 or 6 according to your version)
1.3 Xposed framework installer (Android 5.1 | Android 6)
1.4 Fdroid.apk from https://f-droid.org/
1.5 optional a prepared platform.xml (see 4b), required on Android 5.1 as needed)
on the SD card

1.6 and manually download the latest fp2*ota-userdebug.zip update file from code.fairphone.com and also save it to your SD card.

Note: If your device is encrypted, you need to save the files to the external SD card, as you cannot access your internal SD card from TWRP unless you use the community port!

1.7 Make sure that USB-debugging (in developer settings) is activated. This is required to use adb.

2)
After you made sure to have the necessary files incl. the latest update file on your SD card, initiate the update process by entering the recovery (TWRP).

You can do either by using the adb command adb reboot recovery or by turning off your phone, and powering it on again while pressing the Vol. Up button until the phone vibrates.

3)
From within the recovery you can install all files in a batch: When you are in the recovery (TWRP), select the install option of the menu, and select all the files you want to install, such as
3.1 fp2-sibon-VERSION_NAME-ota-userdebug.zip
3.2 OpenGAPPS and the
3.3 xposed framework

4)
In order to install FDroid as a system app, you can either use TWRP’s file manager to copy the FDroid.apk file into /system/priv-app, or, while still in the recovery start an ADB shell (will not work on encrypted devices unless you use the community port of TWRP)
4.1 get su rights
4.2 mount -o rw,remount /system
4.3 copy the Fdroid.apk into /system/priv-app
4.4 change the file permissions to 644
ALTERNATIVE: Download “/system App Mover” from F-Droid and make F-Droid a system app (for users who don’t know how to use ADB)

4b) - optional (required on Android 5.1 as needed)
If you want to set writing permissions for Ext SD Card in a safe way copy prepared platform.xml (which line to add you can see here SD Card no writing permission in FP2 for example using Amaze editor) from Ext SD Card to /system/etc/permissions and ensure file permissions of 644.

5)
Reboot to system
(If you are updating from FP Open OS Lollipop to Marshmallow and use GravityBox (in XPosed), don’t forget to download the new module)

Tada!

If the home screen is broken, pull the update for the “Fairphone Launcher” from your (Titanium) Backup, and everything should be as before.

Archived Paragraph

Since v. 16.08 a nasty bug drains a lot of battery due to activity of the proximity sensor. This can be circumvented by installing old modem files. Note that this may potentially opens up other bugs that have been fixed in later modem versions, incl. security fixes. Also the calibration tool for the proximity sensor may not work properly.
To install the old modem files

a) download an old package which includes old version of the modem files
b) extract the downloaded file
c) point your terminal to the extracted folder and execute:

fastboot flash modem ./BP/NON-HLOS.bin
fastboot flash sbl1 ./BP/sbl1.mbn
fastboot flash rpm ./BP/rpm.mbn
fastboot flash tz ./BP/tz.mbn
fastboot flash dbi ./BP/sdi.mbn


Stuck optimizing apps after updating on FP Open OS 16.07.1
Fairphone Open 16.08.0 is now available
What is the advantage of FPOOS + OpenGAPPS over FPOS?
FP Open OS 16.07 is now available
SD Card no writing permission in FP2
Fairphone Open 16.10.0 is now available
:love_letter: YOU should switch to Open OS now! (+Why & How)
Fairphone Open 16.10.0 is now available
SD Card no writing permission in FP2
Gmail cannot send any email from my FP2 since OPEN OS update
Android 6.0 is now available (Fairphone OS 17.04.8)
Fairphone Open 17.04.0 is now available
Fairphone Open 17.03.0 is now available
Search function not working properly/too specific?
How to update FP2 Open + opengapps to the latest software
Fairphone Open 17.02.0 is now available
Fairphone Open 17.02.0 is now available
Fairphone Open 17.02.0 is now available
Endless Optimisation Restart Loop after OOS 17.01 update (encrypted + OpenGAPPS)
Endless Optimisation Restart Loop after OOS 17.01 update (encrypted + OpenGAPPS)
Forced to jump back to FP OS
A guide to install Open GApps with minimal Google dependency
:love_letter: YOU should switch to Open OS now! (+Why & How)
Mounting encypted system with TWRP possible meanwhile?
(Why) Do I need Network-based location? (specifically: µG UnifiedNlp)
No data connection after update to 1.4,2 and rooting
Fairphone Open 16.11.0 release
Stuck in load screen after updating to FP Open OS 16.11
FP Open OS 16.06 with GApps Pico: No Push Notifications for Signal Messenger
Fairphone Open 16.10.0 is now available
No TWRP reboot on Fairphone Open 16.10.0
Fairphone Open 16.10.0 is now available
Fairphone Open 16.10.0 is now available
Fairphone Open 16.09.0 is now available
Fairphone Open 16.08.0 is now available
Forced to jump back to FP OS
A guide to install Open GApps with minimal Google dependency
Fairphone OS 18.04.1 is now available
After OpenOS-Update Playstore and Youtube are broke; battery life is now extremely poor
How to upgrade FP Open OS without deleting apps and data?
Problems after Update to Fairphone Open 18.02.0
Making OTA update with Xposed more secure
How to upgrade versions with Fairphone Open OS and Google Play?
:de: Ganz neues FP 2 und sofortige Open OS-Installation
SD Card no writing permission in FP2
Fairphone Open 17.06.4 (Android 6.0) release
Fairphone Open 17.06.4 (Android 6.0) release
Fairphone Open 17.02.0 is now available
Endless Optimisation Restart Loop after OOS 17.01 update (encrypted + OpenGAPPS)
Fairphone Open 17.01.0 is now available
Fairphone Open 17.01.0 is now available
Reinstall OpenGAPPS Open OS 16.10.0
Fairphone Open OS 17.09.3 (Android 6.0) release
Fairphone Open OS 17.08.1 and 17.08.1.1 (Android 6.0) release