Help

An update will not install

Android will not update an app unless the new file is signed with the same key as the one on your phone. That is the whole of it, and uninstalling is the wrong fix.

Why it happens

Every Android app is signed, and an update has to carry the same signature as the version already installed. A build you compiled yourself, a build from someone else, and the release on GitHub can all be signed with different keys, and none of them can install over another.

It is not a fault, and it is not something Folio can wave through. It is the check that stops anyone else shipping an update to an app you installed.

What to do

1. Save a backup first. Folio Settings › General › Backup › Save Backup… writes it to Download/Folio, and you can name it.
2. Uninstall the build you have.
3. Install the one you want, from the download page.
4. Restore from Backup… in the same Settings page.

Expect widgets from other apps to show Reconnect afterwards. Tap each one and approve Android's prompt. More about that.

What you lose if you skip the backup

Uninstalling takes your layout, your wallpaper and your widget connections with it. There is no undo, so do not uninstall just to try a different build.

Check you have the right file

Every release publishes its SHA-256 and its signing certificate, so you can tell whether the file you have came from the same key as the release before it. Folio 0.6.9 and the commands to check it are onthe download page.

Written for Folio 0.6.8. If something here is wrong, out of date or missing,open an issue and it gets fixed.