Android components

A collection of Android libraries to build browsers or browser-like applications.

ℹ️ For more information see the website.

A full featured reference browser implementation based on the components can be found in the reference-browser repository.

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).

Maven repository

All components are getting published on maven.mozilla.org. To use them, you need to add the following to your projects top-level build file, in the allprojects block (see e.g. the reference-browser):

repositories {
    maven {
       url "https://maven.mozilla.org/maven2"
    }
}

Components

• 🔴 In Development - Not ready to be used in shipping products.
• ⚪ Preview - This component is almost/partially ready and can be tested in products.
• 🔵 Production ready - Used by shipping products.

Browser

High-level components for building browser(-like) apps.

• ⚪ Awesomebar - A customizable Awesome Bar implementation for browsers.

• 🔵 Domains Localized and customizable domain lists for auto-completion in browsers.

• 🔴 Engine-Gecko - Engine implementation based on GeckoView (Release channel).

• 🔴 Engine-Gecko-Beta - Engine implementation based on GeckoView (Beta channel).

• 🔴 Engine-Gecko-Nightly - Engine implementation based on GeckoView (Nightly channel).

• 🔴 Engine-Servo - Engine implementation based on the Servo Browser Engine.

• ⚪ Engine-System - Engine implementation based on the system's WebView.

• ⚪ Errorpages - Responsive browser error pages for Android apps.

• 🔴 Menu - A generic menu with customizable items primarily for browser toolbars.

• 🔵 Search - Search plugins and companion code to load, parse and use them.

• 🔵 Session - A generic representation of a browser session.

• 🔴 Storage-Memory - An in-memory implementation of browser storage.

• 🔴 Storage-Sync - A syncable implementation of browser storage backed by application-services' Places lib.

• 🔴 Tabstray - A customizable tabs tray for browsers.

• ⚪ Toolbar - A customizable toolbar for browsers.

Concept

API contracts and abstraction layers for browser components.

• 🔴 Awesomebar - An abstract definition of an awesome bar component.

• ⚪ Engine - Abstraction layer that allows hiding the actual browser engine implementation.

• ⚪ Fetch - An abstract definition of an HTTP client for fetching resources.

• 🔴 Storage - Abstract definition of a browser storage component.

• 🔴 Tabstray - Abstract definition of a tabs tray component.

• ⚪ Toolbar - Abstract definition of a browser toolbar component.

Feature

Combined components to implement feature-specific use cases.

• ⚪ Awesomebar - A component that connects a concept-awesomebar implementation to a concept-toolbar implementation and provides implementations of various suggestion providers.

• ⚪ Context Menu - A component for displaying context menus when long-pressing web content.

• 🔴 Custom Tabs - A component for providing Custom Tabs functionality in browsers.

• ⚪ Downloads - A component to perform downloads using the Android downloads manager.

• 🔴 Intent - A component that provides intent processing functionality by combining various other feature modules.

• 🔴 Search - A component that connects an (concept) engine implementation with the browser search module.

• ⚪ Session - A component that connects an (concept) engine implementation with the browser session module.

• 🔴 Storage -A component that connects a (concept) storage implementation with its various consumers, like a (concept) engine implementation for history tracking.

• 🔴 Sync -A component that provides synchronization orchestration for groups of (concept) SyncableStore objects.

• 🔴 Tabs - A component that connects a tabs tray implementation with the session and toolbar modules.

• 🔴 Toolbar - A component that connects a (concept) toolbar implementation with the browser session module.

• 🔴 Prompts - A component that will handle all the common prompt dialogs from web content.

UI

Generic low-level UI components for building apps.

• 🔵 Autocomplete - A set of components to provide autocomplete functionality.

• 🔵 Colors - The standard set of Photon colors.

• 🔵 Fonts - The standard set of fonts used by Mozilla Android products.

• 🔵 Icons - A collection of often used browser icons.

• 🔵 Progress - An animated progress bar following the Photon Design System.

• ⚪ Tabcounter - A button that shows the current tab count and can animate state changes.

Service

Components and libraries to interact with backend services.

• 🔵 Firefox Accounts (FxA) - A library for integrating with Firefox Accounts.

• 🔴 Firefox Sync - Logins - A library for integrating with Firefox Sync - Logins.

• 🔵 Fretboard - An Android framework for segmenting users in order to run A/B tests and roll out features gradually.

• 🔴 Glean - A client-side telemetry SDK for collecting metrics and sending them to Mozilla's telemetry service (eventually replacing service-telemetry).

• 🔵 Telemetry - A generic library for sending telemetry pings from Android applications to Mozilla's telemetry service.

Support

Supporting components with generic helper code.

• 🔵 Base - Base component containing building blocks for components.

• 🔵 Ktx - A set of Kotlin extensions on top of the Android framework and Kotlin standard library.

• 🔵 Test - A collection of helpers for testing components.

• 🔵 Utils - Generic utility classes to be shared between projects.

Standalone libraries

• ⚪ Crash - A generic crash reporter component that can report crashes to multiple services.

• 🔴 Dataprotect - A component using AndroidKeyStore to protect user data.

• ⚪ Fetch-HttpURLConnection - A concept-fetch implementation using HttpURLConnection.

• ⚪ Fetch-OkHttp - A concept-fetch implementation using OkHttp.

• ⚪ JEXL - Javascript Expression Language: Context-based expression parser and evaluator.

Tooling

• 🔵 Fetch-Tests - A generic test suite for components that implement concept-fetch.

• 🔵 Lint - Custom Lint rules for the components repository.

Sample apps

Sample apps using various components.

• Browser - A simple browser composed from browser components. This sample application is only a very basic browser. For a full-featured reference browser implementation see the reference-browser repository.

• Crash - An app showing the integration of the lib-crash component.

• Firefox Accounts (FxA) - A simple app demoing Firefox Accounts integration.

• Firefox Sync - Logins - A simple app demoing Firefox Sync (Logins) integration.

• Toolbar - An app demoing multiple customized toolbars using the browser-toolbar component.

• DataProtect - An app demoing how to use the Dataprotect component to load and store encrypted data in SharedPreferences.

• Glean - An app demoing how to use the Glean library to collect and send telemetry data.

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/