56b21426eb
* For #5574 - Part 1: Port TabAction.SaveTabGroup to TabSessionInteractor and SessionControlController. (#6651) - Introduces the TabSessionInteractor, SessionControlInteractor and SessionControlController classes. - Removes the TabAction.SaveTabGroup. * For #5574 - Part 2: Port TabAction.PrivateBrowsingLearnMore to TabSessionInteractor and SessionControlController (#6651) * For #5574 - Part 3: Port TabAction.ShareTabs to TabSessionInteractor and SessionControlController (#6651) * For #5574 - Part 4: Remove unused TabAction.Share and TabItemMenu (#6651) In #2205, the tab overflow button was removed which would have shown the TabItemMenu when clicked. So, we can remove TabItemMenu since it is not used and as a result, we can also remove TabAction.Share since there are no consumers. * For #5574 - Part 5: Port TabAction.PlayMedia and TabAction.PauseMedia to TabSessionInteractor and SessionControlController (#6651) * For #5574 - Part 6: Port TabAction.Select to TabSessionInteractor and SessionControlController (#6651) * For #5574 - Part 7: Port Onboarding.Finish to OnboardingInteractor and SessionControlController (#6651) * For #5574 - Part 8: Port TabAction.Close and TabAction.CloseAll to TabSessionInteractor and SessionControlController (#6651) - Removes TabAction * For #5574 - Part 9: Port CollectionAction.Delete to CollectionInteractor and SessionControlController (#6651) * For #5574 - Part 10: Port CollectionAction.ShareTabs to CollectionInteractor and SessionControlController (#6651) * For #5574 - Part 11: Port CollectionAction.AddTab and CollectionAction.Rename to CollectionInteractor and SessionControlController (#6651) * For #5574 - Part 12: Port CollectionAction.RemoveTab to CollectionInteractor and SessionControlController (#6651) * For #5574 - Part 13: Port CollectionAction.OpenTab to CollectionInteractor and SessionControlController (#6651) * For #5574 - Part 14: Port CollectionAction.CloseTabs to CollectionInteractor and SessionControlController (#6651) * For #5574 - Part 15: Introduce a HomeFragmentStore (#6651) - We will hook up the HomeFragmentStore in later parts. - Removes List<Tab>.toSessionBundle(context: Context) since it is unused. * For #5574 - Part 16: Port CollectionAction.Collapse and CollectionAction.Expand to CollectionInteractor and SessionControlController (#6651) - We assume the store is hooked up to the SessionControlController in this part, but this work will be done in a later part. - Removes CollectionAction. * For #5574 - Part 20: Remove the architecture module. (#6651) * For #5574 - Part 17: Remove duplicate subscribeToTabCollections in BrowserFragment.kt (#6651) There is a duplicate call of subscribeToTabCollections() in both HomeFragment and BrowserFragment. In this patch, we remove the call in BrowserFragment to avoid passing the HomeFragmentStore to BrowserFragment in order to dispatch the CollectionsChange event. * For #5574 - Part 18: Delete SessionControlComponent and fix TabCollection and Tab imports (#6651) * For #5574 - Part 19: Use the new HomeFragmentStore in the HomeFragment (#6651) - Renames SessionControlUIView to SessionControlView * For #5574 - Part 21: Fix white screen on home fragment (#6651) * For #5574 - Part 22: Fix formatting in SessionControlInteractor and replace See with @see in SessionControlController (#6651) * For #5574 - Part 23: Move to metrics.track call to the beginning of handleCollectionRemoveTab (#6651) This ensures that the metrics.track will be called immediately before the tab is removed from the collection. * For #5574 - Part 24: Use the sessionManager getter in SessionControlController (#6651) * For #5574 - Part 25: Use mapNotNull in List<Tab>.toSessionBundle (#6651) * For #5574 - Part 26: Simplify closeTab and closeAllTabs functions by assigning a deletionJob constant (#6651) * For #5574 - Part 27: Replace listOf() with emptyList() in removeAllTabsWithUndo (#6651) * For #5574 - Part 28: Replace the Context parameter with the HomeActivity in SessionControlController (#6651) * For #5574 - Part 29: Add test for HomeFragmentStore, DefaultSessionControlController and SessionControlInteractor (#6651) * For #5574 - Removes running CI against the architecture debug build varient |
||
---|---|---|
.github | ||
app | ||
automation | ||
buildSrc | ||
certificates | ||
config | ||
docs | ||
fastlane | ||
gradle/wrapper | ||
taskcluster | ||
.adjust_token | ||
.cron.yml | ||
.editorconfig | ||
.gitattributes | ||
.gitignore | ||
.taskcluster.yml | ||
CODE_OF_CONDUCT.md | ||
Gemfile | ||
Jenkinsfile | ||
LICENSE | ||
README.md | ||
bors.toml | ||
build.gradle | ||
codecov.yml | ||
debug.keystore | ||
gradle.properties | ||
gradlew | ||
gradlew.bat | ||
l10n.toml | ||
settings.gradle |
README.md
Firefox Preview
Firefox Preview (internal code name: "Fenix") is an all-new browser for Android, based on GeckoView and Mozilla Android Components.
** 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! **
I want to open a Pull Request!
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:
- Every PR must have exactly one issue associated with it.
- Write a clear explanation of what the code is doing when opening the pull request, and optionally add comments to the PR.
- Make sure there are tests - or ask for help on how the code should be tested in the Issue!
- Keep PRs small and to the point. For extra code-health changes, either file a separate issue, or make it a separate PR that can be easily reviewed.
- Use micro-commits. This makes it easier and faster to review.
- Add a screenshot for UX changes (this is part of the PR checklist)
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.
Getting Involved
Before you attempt to make a contribution please read the Community Participation Guidelines.
-
Guide to Contributing (New contributors start here!)
-
Browse our current Issues, or file a security issue.
-
Slack: #fenix on mozilla-android.slack.com | Join here (We're available Monday-Friday, GMT and PST working hours).
-
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!
Build Instructions
Note: Both Android SDK and NDK are required.
- Clone or Download the repository:
git clone https://github.com/mozilla-mobile/fenix
- Import the project into Android Studio or build on the command line:
./gradlew clean app:assembleGeckoBetaDebug
Use app:assembleGeckoNightlyDebug to build with the Gecko Nightly version instead.
- Make sure to select the correct build variant in Android Studio. See the next section.
Guide to Build Variants
We have a lot of build variants. Each variant is composed of two flavors. One flavor is the version of Gecko to use and the other describes which app id and settings to use. Here is a description of what each means:
- geckoBeta (recommended) uses the Beta variant of the Gecko rendering engine, which corresponds to the next version of Gecko which will go to production
- geckoNightly uses the Nightly variant of the Gecko rendering engine, which is the version which will arrive after beta and is less stable
- debug uses debug symbols and debug signing, adds tools like LeakCanary for troubleshooting, and does not strip unused or wasteful code
- fenixNightly is a release build with nightly signing which uses the org.mozilla.fenix.nightly app id for nightly releases to Google Play
- fenixBeta is a release build with beta signing which uses the org.mozilla.fenix.beta app id for beta releases to Google Play
- fenixProduction is a release build with release signing which uses the org.mozilla.fenix app id for production releases to Google Play
- fennecProduction is an experimental build with release signing which uses the org.mozilla.firefox app id and supports upgrading the older Firefox. WARNING Pre-production versions of this may result in data loss.
- forPerformanceTest is a release build with the debuggable flag set and test activities enabled for running Raptor performance tests
Pre-push hooks
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 config/pre-push-recommended.sh
.
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.
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
local.properties helpers
There are multiple helper flags available via local.properties
that will help speed up local development workflow
when working across multiple layers of the dependency stack - specifically, with android-components, geckoview or application-services.
android-components auto-publication workflow
Specify a relative path to your local android-components
checkout via autoPublish.android-components.dir
.
If enabled, during a Fenix build android-components will be compiled and locally published if it has been modified, and published versions of android-components modules will be automatically used instead of whatever is declared in Dependencies.kt.
application-services composite builds
Specify a relative path to your local application-services
checkout via substitutions.application-services.dir
.
If enabled, a multi-project gradle build will be configured, and any application-services dependency will be substituted
for the local version. Any changes to application-services
will be automatically included in Fenix builds.
GeckoView
Specify a relative path to your local mozilla-central
checkout via dependencySubstitutions.geckoviewTopsrcdir
,
and optional a path to m-c object directory via dependencySubstitutions.geckoviewTopobjdir
.
If these are configured, local builds of GeckoView will be used instead of what's configured in Dependencies.kt. For more details, see https://mozilla.github.io/geckoview/contributor/geckoview-quick-start#include-geckoview-as-a-dependency
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/