|
1 | | -# Fenix Installer |
| 1 | +<p align="center"> |
| 2 | + <img src="app/src/main/res/mipmap-xxxhdpi/ic_launcher_foreground.webp" alt="TryFox icon" width="220" /> |
| 3 | +</p> |
| 4 | + |
| 5 | +<h1>TryFox</h1> |
2 | 6 |
|
3 | 7 | A simple Android app to search, download, and install Fenix (Firefox for Android), Focus, and other Mozilla Android project APKs from CI builds. |
4 | 8 |
|
| 9 | +## Install TryFox |
| 10 | + |
| 11 | +Install the latest APK from [TryFox Releases](https://github.com/mozilla-mobile/TryFox/releases/latest). |
| 12 | + |
| 13 | +To make TryFox handle Treeherder links on Android: |
| 14 | + |
| 15 | +1. Install TryFox an |
| 16 | +2. Open Android `Settings`. |
| 17 | +3. Go to `Apps` or `Applications`. |
| 18 | +3. Select `TryFox`. |
| 19 | +4. Open `Open by default`. |
| 20 | +5. Tap `Supported web addresses` or `Add link`. |
| 21 | +6. Enable `treeherder.mozilla.org`. |
| 22 | +7. If your device shows an `Open supported links` toggle or menu, set it to `Open in this app`. |
| 23 | + |
| 24 | +After that, opening a Treeherder URL such as `https://treeherder.mozilla.org/jobs?repo=try&revision=<REVISION>` should offer or directly open TryFox, depending on your Android version and current default-browser settings. |
| 25 | + |
5 | 26 | ## Features |
6 | 27 |
|
| 28 | +<video src="doc/tryfox-demo-jan-2026.mp4" controls muted playsinline width="720"> |
| 29 | + Your browser does not support the video tag. |
| 30 | +</video> |
| 31 | + |
7 | 32 | - **Multi-Project Support**: Select from projects: |
8 | 33 | - `try` (default) |
9 | 34 | - `mozilla-central` (displayed as "central") |
@@ -65,6 +90,18 @@ A simple Android app to search, download, and install Fenix (Firefox for Android |
65 | 90 | ./gradlew assembleDebug |
66 | 91 | ``` |
67 | 92 |
|
| 93 | +Run unit tests: |
| 94 | + |
| 95 | +```bash |
| 96 | +./gradlew testDebugUnitTest |
| 97 | +``` |
| 98 | + |
| 99 | +Run Android instrumentation tests with a connected device or running emulator: |
| 100 | + |
| 101 | +```bash |
| 102 | +./gradlew connectedDebugAndroidTest |
| 103 | +``` |
| 104 | + |
68 | 105 | ## Architecture |
69 | 106 |
|
70 | 107 | - **Jetpack Compose** for UI (Material 3 theming). |
|
0 commit comments