|blallo 69a9aeebae||10 months ago|
|.github||10 months ago|
|app||10 months ago|
|automation||10 months ago|
|buildSrc||10 months ago|
|certificates||2 years ago|
|config||10 months ago|
|docs||10 months ago|
|fastlane||1 year ago|
|gradle/wrapper||10 months ago|
|mozilla-detekt-rules||11 months ago|
|mozilla-lint-rules||10 months ago|
|taskcluster||10 months ago|
|.adjust_token||2 years ago|
|.cron.yml||11 months ago|
|.dockerignore||1 year ago|
|.drone.yml||10 months ago|
|.editorconfig||1 year ago|
|.gitattributes||2 years ago|
|.gitignore||11 months ago|
|.taskcluster.yml||11 months ago|
|CODE_OF_CONDUCT.md||2 years ago|
|Dockerfile||11 months ago|
|Gemfile||1 year ago|
|Jenkinsfile||1 year ago|
|LICENSE||2 years ago|
|README.md||10 months ago|
|build.gradle||10 months ago|
|codecov.yml||1 year ago|
|gradle.properties||11 months ago|
|gradlew||1 year ago|
|gradlew.bat||1 year ago|
|l10n-release.toml||11 months ago|
|l10n.toml||11 months ago|
|settings.gradle||11 months ago|
|sign.sh||10 months ago|
|version.txt||1 year ago|
** Note: The team is currently experiencing heavy triage and review load, so when triaging issues, we will mainly be looking to identify S1 (high severity) issues. See our triage process here. Please be patient if you don’t hear back from us immediately on your issue! **
Please read the Community Participation Guidelines and the Bugzilla Etiquette guidelines before filing an issue. This is our professional working environment as much as it is our bug tracker, and we want to keep our workspace clean and healthy.
Guide to Contributing (New contributors start here!)
Matrix: #fenix:mozilla.org channel (We’re available Monday-Friday, GMT and PST working hours). Related channels:
Check out the project wiki for more information.
Localization happens on Pontoon. Please get in touch with delphine (at) mozilla (dot) com directly for more information.
Beginners! - Watch out for Issues with the “Good First Issue” label. These are easy bugs that have been left for first timers to have a go, get involved and make a positive contribution to the project!
We encourage you to participate in this open source project. We love Pull Requests, Bug Reports, ideas, (security) code reviews or any other kind of positive contribution.
Since we are a small team, however, we do not have the bandwidth to review unsolicited PRs. Please follow our Pull Request guidelines, or we may close the PR.
To make it easier to review, we have these PR requirements:
As a small team, we have to prioritize our work, and reviewing PRs takes time. We receive lots of PRs every day, so if you can keep your PRs small, it helps our small team review and merge code faster, minimizing stale code.
Keep in mind that the team is very overloaded, so PRs sometimes wait for a very long time. However this is not for lack of interest, but because we find ourselves in a constant need to prioritize certain issues/PRs over others. If you think your issue/PR is very important, try to popularize it by getting other users to comment and share their point of view.
Great! We encourage you to participate in this open source project. We love Pull Requests, Bug Reports, ideas, (security) code reviews or any other kind of positive contribution.
To make it easier to triage, we have these issue requirements:
Please keep in mind that even though a feature you have in mind may seem like a small ask, as a small team, we have to prioritize our planned work and every new feature adds complexity and maintenance and may take up design, research, marketing, product, and engineering time. We appreciate everyone’s passion but we will not be able to incorporate every feature request or even fix every bug. That being said, just because we haven’t replied, doesn’t mean we don’t care about the issue, please be patient with our response times as we’re very busy.
git clone https://github.com/mozilla-mobile/fenix
./gradlew clean app:assembleDebug
If this errors out, make sure that you have an
variable pointing to the right path.
For general development, we recommend the debug build variant. Here’s an explanation of each variant:
nightly, beta, and release are unsigned and
debuggable=false by default. If
you want these variants to be:
debuggable=true, see Building debuggable release variants
For accurate performance measurements, read this section!
To analyze performance during local development build a production variant locally (this could either be the Nightly, beta or release). Otherwise, you could also grab a pre-existing APK if you don’t need to test some local changes. Then, use the Firefox profiler to profile what you need!
For more information on how to use the profiler or how to use the build, refer to this how to measure performance with the build
If you want to run performance tests/benchmarks in automation or locally use a production build since it is much closer in behavior compared to what users see in the wild.
Before you can install any release builds, You will need to sign production build variants: see Automatically signing release builds for details.
Some features are disabled by default when Fenix is built locally. This can be problematic at times for checking performance since you might want to know how your code behaves with those features. The known features that are disabled by default are:
To reduce review turn-around time, we’d like all pushes to run tests locally. We’d
recommend you use our provided pre-push hook in
Using this hook will guarantee your hook gets updated as the repository changes.
This hook tries to run as much as possible without taking too much time.
Before you can run the hook, you’ll need to configure Java properly because it relies on command line tools: see our how-to guide.
To add it on Mac/Linux, run this command from the project root:
ln -s ../../config/pre-push-recommended.sh .git/hooks/pre-push
or for Windows run this command using the Command Prompt with administrative privileges:
mklink .git\hooks\pre-push ..\..\config\pre-push-recommended.sh
or using PowerShell:
New-Item -ItemType SymbolicLink -Path .git\hooks\pre-push -Value (Resolve-Path config\pre-push-recommended.sh)
To push without running the pre-push hook (e.g. doc updates):
git push <remote> --no-verify
Note: If while pushing you encounter this error “Could not initialize class org.codehaus.groovy.runtime.InvokerHelper” and are currently on Java14 then downgrading your Java version to Java13 or lower can resolve the issue
Steps to downgrade Java Version on Mac with Brew:
sudo rm -fr /Library/Java/JavaVirtualMachines/<jdk-version>
brew tap homebrew/cask-versions
brew search java
brew install java11
You can speed up local development by setting a few helper flags available in
local.properties. Some flags will make it easy to
work across multiple layers of the dependency stack - specifically, with android-components, geckoview or application-services.
To sign your release builds with your debug key automatically, add the following to
With this line, release build variants will automatically be signed with your debug key (like debug builds), allowing them to be built and installed directly through Android Studio or the command line.
This is helpful when you’re building release variants frequently, for example to test feature flags and or do performance analyses.
Nightly, Beta and Release variants are getting published to Google Play and therefore are not debuggable. To locally create debuggable builds of those variants, add the following to
To set the raptor manifest flag in Nightly, Beta and Release variants, add the following to
If you’re making changes to these projects and want to test them in Fenix, auto-publication workflow is the fastest, most reliable way to do that.
local.properties, specify a relative path to your local
application-services checkouts. E.g.:
Once these flags are set, your Fenix builds will include any local modifications present in these projects.
Specify a relative path to your local
mozilla-central checkout via
and optional a path to m-c object directory via
If these are configured, local builds of GeckoView will be used instead of what’s configured in Dependencies.kt. For more details, see https://firefox-source-docs.mozilla.org/mobile/android/geckoview/contributor/geckoview-quick-start.html#include-geckoview-as-a-dependency
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/