summaryrefslogtreecommitdiffstats
path: root/mobile/android/docs/fenix.rst
diff options
context:
space:
mode:
authorDaniel Baumann <daniel.baumann@progress-linux.org>2024-04-07 17:32:43 +0000
committerDaniel Baumann <daniel.baumann@progress-linux.org>2024-04-07 17:32:43 +0000
commit6bf0a5cb5034a7e684dcc3500e841785237ce2dd (patch)
treea68f146d7fa01f0134297619fbe7e33db084e0aa /mobile/android/docs/fenix.rst
parentInitial commit. (diff)
downloadthunderbird-6bf0a5cb5034a7e684dcc3500e841785237ce2dd.tar.xz
thunderbird-6bf0a5cb5034a7e684dcc3500e841785237ce2dd.zip
Adding upstream version 1:115.7.0.upstream/1%115.7.0upstream
Signed-off-by: Daniel Baumann <daniel.baumann@progress-linux.org>
Diffstat (limited to '')
-rw-r--r--mobile/android/docs/fenix.rst51
1 files changed, 51 insertions, 0 deletions
diff --git a/mobile/android/docs/fenix.rst b/mobile/android/docs/fenix.rst
new file mode 100644
index 0000000000..46ed237613
--- /dev/null
+++ b/mobile/android/docs/fenix.rst
@@ -0,0 +1,51 @@
+Building Firefox for Android
+============================
+
+First, you'll want to `set up your machine to build Firefox </setup>`_.
+Follow the instructions there, choosing "GeckoView/Firefox for Android" as
+the bootstrap option.
+
+Once you're set up and have a GeckoView build from the above, please
+continue with the following steps.
+
+1. Clone the repository and initial setup
+-----------------------------------------
+
+.. code-block:: shell
+
+ git clone https://github.com/mozilla-mobile/firefox-android
+ cd firefox-android/fenix
+ echo dependencySubstitutions.geckoviewTopsrcdir=/path/to/mozilla-central > local.properties
+
+replace `/path/to/mozilla-central` with the location of your mozilla-central/mozilla-unified source tree.
+
+2. Build
+--------
+
+.. code-block:: shell
+
+ export JAVA_HOME=$HOME/.mozbuild/jdk/jdk-17.0.6+10
+ export ANDROID_HOME=$HOME/.mozbuild/android-sdk-<os_name>
+ ./gradlew clean app:assembleDebug
+
+`<os_name>` is either `linux`, `macosx` or `windows` depending on the OS you're building from.
+
+
+For more details, check out the `more complete documentation <https://github.com/mozilla-mobile/firefox-android/tree/main/fenix>`_.
+
+3. Run
+------
+
+From the gecko working directory:
+
+.. code-block:: shell
+
+ ./mach android-emulator
+
+
+From the firefox-android working directory:
+
+.. code-block:: shell
+
+ ./gradlew :app:installFenixDebug
+ "$ANDROID_HOME/platform-tools/adb" shell am start -n org.mozilla.fenix.debug/org.mozilla.fenix.debug.App