Reference Browser

A full-featured browser reference implementation using Mozilla Android Components.

Download Nightly builds

Signed Nightly builds can be downloaded from:

• ⬇️ ARM devices (Android 5+)
• ⬇️ x86 devices (Android 5+)

Note that all builds are signed with a non-production / throw-away key. The latest Nightly build task can be found here.

Getting Involved

We encourage you to participate in this open source project. We love pull requests, bug reports, ideas, (security) code reviews or any kind of positive contribution.

Before you attempt to make a contribution please read the Community Participation Guidelines.

• View current Issues or View current Pull Requests.

• List of good first issues (New contributors start here!) and List of "help wanted" issues.

• IRC: #android-components (irc.mozilla.org) | view logs

• Subscribe to our mailing list android-components@ to keep up to date (Archives).

Local Development

Dependency substitutions

You might be interested in building this project against local versions of some of the dependencies. This could be done either by using a local maven repository (quite cumbersome), or via Gradle's dependency substitutions (not at all cumbersome!).

Currently, the substitution flow is streamlined for some of the core dependencies via configuration flags in local.properties. You can build against a local checkout of the following dependencies by specifying their local paths:

• application-services, specifying its path via substitutions.application-services.dir=../application-services
  • This assumes that you have an application-services project at the same level in the directory hierarchy as the reference-browser.

Do not forget to run a Gradle sync in Android Studio after changing local.properties. If you specified any substitutions, they will be reflected in the modules list, and you'll be able to modify them from a single Android Studio window.

License

This Source Code Form is subject to the terms of the Mozilla Public
License, v. 2.0. If a copy of the MPL was not distributed with this
file, You can obtain one at http://mozilla.org/MPL/2.0/