Fennec Migration

Project board: https://github.com/orgs/mozilla-mobile/projects/40

Testing

⚠️ Warning: Replacing a Fennec (Firefox for Android) installation with Fenix (Firefox Preview) can (and at the time of writing this definitely will) result in DATA LOSS. Do not replace an installation of Fennec (Firefox for Android) that contains data you do not want to risk losing (e.g. open tabs, history, bookmarks, top sites, ..).

The following links point to the latest Fenix (Firefox Preview) builds (Nightly) that are setup to replace a Fennec (Firefox for Android) release version (org.mozilla.firefox).

• ARM64/Aarch64 devices (64 bit; Android 5+)
• ARM devices (32 bit; Android 5+)
• x86_64 devices (64 bit; Android 5+)
• x86 devices (32 bit; Android 5+)

❌ At this point in time you are going to lose data when replacing Fennec (Firefox for Android) with Fenix (Firefox Preview)!

Changelog

The data migration work is tracked on the following project board: https://github.com/orgs/mozilla-mobile/projects/40

• 2019-09-18 - The first migration builds are available now. A Firefox for Android (release) installation can be replaced with them. No actual migration code is in those builds yet. The replaced build is a "clean" Fenix installation.

Development

When working on migration code it is helpful to have a local Fennec build and a local Fenix build that can replace the Fennec build. The following manual setup is needed to achieve that.

Fennec

• Checkout the ESR68 branch and setup a regular Fennec build by following mach bootstrap. An "artifact mode" build should be sufficient for most migration work.

Fenix

TODO