Back to the overview
Upgrade XPerience on alioth
Important: Please read through the instructions at least once completely before actually following them to avoid any problems because you missed something!
Manually upgrading XPerience
Warning: You must do a factory reset before upgrading, so consider backing up your internal storage.
Tip: In some cases, a newer XPerience version may not install due to an outdated recovery.
Follow your device’s installation guide to see how you can update your recovery image.
The updater app does not support upgrades from one version of XPerience to another, and will block installation to any update for a different version. Upgrading manually requires similar steps to installing XPerience for the first time.
- Download the XPerience install package that you’d like to install or build the package yourself.
- Make sure your computer has working
adb
. Setup instructions can be found here. - Enable USB debugging on your device.
- Reboot into recovery by running
adb reboot recovery
, or by performing the following:- With the device powered off, hold Volume Up + Power. Keep holding both buttons until the “MI” logo appears on the screen, then release.
- Now tap Factory Reset, then Format data / factory reset and continue with the formatting process. This will remove encryption and delete all files stored in the internal storage, as well as format your cache partition (if you have one).
- Return to the main menu.
- Sideload the XPerience
.zip
package:- On the device, select “Apply Update”, then “Apply from ADB” to begin sideload.
- On the host machine, sideload the package using:
adb sideload filename.zip
.Tip: Normally, adb will reportTotal xfer: 1.00x
, but in some cases, even if the process succeeds the output will stop at 47% and reportTotal xfer: 0.98x
oradb: failed to read command: Success
. In some cases it will reportadb: failed to read command: No error
oradb: failed to read command: Undefined error: 0
which is also fine.
- Once you have installed everything successfully, click the back arrow in the top left of the screen, then “Reboot system now”.
Get assistance
If you have any questions or get stuck on any of the steps, feel free to ask on our Telegram group.