mobile/android/docs/fenix.rst

   1 Building Firefox for Android
   2 ============================
   3
   4 First, you'll want to `set up your machine to build Firefox </setup>`_.
   5 Follow the instructions there, choosing "GeckoView/Firefox for Android" as
   6 the bootstrap option.
   7
   8 Once you're set up and have a GeckoView build from the above, please
   9 continue with the following steps.
  10
  11 1. Clone the repository and initial setup
  12 -----------------------------------------
  13
  14 .. code-block:: shell
  15
  16     git clone https://github.com/mozilla-mobile/firefox-android
  17     cd firefox-android/fenix
  18     echo dependencySubstitutions.geckoviewTopsrcdir=/path/to/mozilla-central > local.properties
  19
  20 replace `/path/to/mozilla-central` with the location of your mozilla-central/mozilla-unified source tree.
  21
  22 2. Build
  23 --------
  24
  25 .. code-block:: shell
  26
  27     export JAVA_HOME=$HOME/.mozbuild/jdk/jdk-17.0.6+10
  28     export ANDROID_HOME=$HOME/.mozbuild/android-sdk-<os_name>
  29     ./gradlew clean app:assembleDebug
  30
  31 `<os_name>` is either `linux`, `macosx` or `windows` depending on the OS you're building from.
  32
  33
  34 For more details, check out the `more complete documentation <https://github.com/mozilla-mobile/firefox-android/tree/main/fenix>`_.
  35
  36 3. Run
  37 ------
  38
  39 From the gecko working directory:
  40
  41 .. code-block:: shell
  42
  43     ./mach android-emulator
  44
  45
  46 From the firefox-android working directory:
  47
  48 .. code-block:: shell
  49
  50    ./gradlew :app:installFenixDebug
  51    "$ANDROID_HOME/platform-tools/adb" shell am start -n org.mozilla.fenix.debug/org.mozilla.fenix.debug.App