mirror of
https://github.com/fork-maintainers/iceraven-browser
synced 2024-11-09 19:10:42 +00:00
76 lines
3.7 KiB
Markdown
76 lines
3.7 KiB
Markdown
# Firefox Preview
|
|
|
|
Firefox Preview (internal code name: "Fenix") is an all-new browser for Android, based on [GeckoView](https://mozilla.github.io/geckoview/) and [Mozilla Android Components](https://mozac.org/).
|
|
|
|
## Getting Involved
|
|
|
|
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.
|
|
|
|
Before you attempt to make a contribution please read the [Community Participation Guidelines](https://www.mozilla.org/en-US/about/governance/policies/participation/).
|
|
|
|
* [Guide to Contributing](https://github.com/mozilla-mobile/shared-docs/blob/master/android/CONTRIBUTING.md) (**New contributors start here!**)
|
|
|
|
* [View current Issues](https://github.com/mozilla-mobile/fenix/issues), [view current Pull Requests](https://github.com/mozilla-mobile/fenix/pulls), or [file a security issue][sec issue].
|
|
|
|
* IRC: [#fenix (irc.mozilla.org)](https://wiki.mozilla.org/IRC) | [view logs](https://mozilla.logbot.info/fenix/)
|
|
(**We're available Monday-Friday, GMT and PST working hours**).
|
|
|
|
* [View the Wiki](https://github.com/mozilla-mobile/fenix/wiki).
|
|
|
|
* Localization happens on [Pontoon](https://pontoon.mozilla.org/projects/android-l10n/). 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](https://github.com/mozilla-mobile/fenix/issues?q=is%3Aopen+is%3Aissue+label%3A%22good+first+issue%22). 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
|
|
|
|
|
|
1. Clone or Download the repository:
|
|
|
|
```shell
|
|
git clone https://github.com/mozilla-mobile/fenix
|
|
```
|
|
|
|
2. Import the project into Android Studio **or** build on the command line:
|
|
|
|
```shell
|
|
./gradlew clean app:assembleArmDebug
|
|
```
|
|
|
|
3. Make sure to select the correct build variant in Android Studio:
|
|
**armDebug** for ARM
|
|
**x86Debug** for X86
|
|
|
|
## 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:
|
|
```sh
|
|
ln -s ../../config/pre-push-recommended.sh .git/hooks/pre-push
|
|
```
|
|
or for Windows run this command using the Command Prompt with administrative privileges:
|
|
```sh
|
|
mklink .git\hooks\pre-push ..\..\config\pre-push-recommended.sh
|
|
```
|
|
or using PowerShell:
|
|
```sh
|
|
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):
|
|
```sh
|
|
git push <remote> --no-verify
|
|
```
|
|
|
|
## 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/
|
|
|
|
[sec issue]: https://bugzilla.mozilla.org/enter_bug.cgi?assigned_to=nobody%40mozilla.org&bug_ignored=0&bug_severity=normal&bug_status=NEW&cf_fx_iteration=---&cf_fx_points=---&component=Security%3A%20Android&contenttypemethod=list&contenttypeselection=text%2Fplain&defined_groups=1&flag_type-4=X&flag_type-607=X&flag_type-791=X&flag_type-800=X&flag_type-803=X&flag_type-936=X&flag_type-937=X&form_name=enter_bug&groups=mobile-core-security&maketemplate=Remember%20values%20as%20bookmarkable%20template&op_sys=Unspecified&priority=--&product=Fenix&rep_platform=Unspecified&target_milestone=---&version=unspecified
|