Files
poli0981andClaude Opus 5.5 a22589a334 fix(android): keep the app clear of the status and navigation bars
targetSdk 36 and MainActivity's enableEdgeToEdge() draw the webview under
both system bars. The React 1.x shell padded all four safe-area insets; the
SvelteKit rewrite kept only <main>'s bottom one, so the top bar of every 2.x
app has sat under the clock, which docs/android-support.md says cannot happen.

- styles/theme.css gains pt-safe, pb-safe, pl-safe, pr-safe and p-safe-or-4
  (env(safe-area-inset-*), named after the tailwindcss-safe-area classes).
  The shell root carries pt-safe pl-safe pr-safe, <main> pb-safe, the drawer
  pt-safe pb-safe pl-safe, and /welcome and the /error pages, which have no
  shell, pad themselves.
- The consent gate and the human check use p-safe-or-4 and centre their card
  with m-auto instead of items-center: on a short phone a card taller than
  the screen lost its top, unreachable (measured at 360x520: the 620px
  consent card now scrolls from its top edge).
- Back-to-top and the toasts add the bottom inset; the never-expiring Android
  update toast sat on the gesture bar.
- The status-bar icons follow the SYSTEM theme (enableEdgeToEdge() uses
  SystemBarStyle.auto), but the app defaults to dark, so a phone in light
  mode showed dark icons on a dark page. In the Android app the layout now
  puts a status-bar-strip behind them, keyed on prefers-color-scheme and
  never on the reader's theme. Its two colours are theme.css's --background
  tokens; mobile-layout.test.ts compares them and holds the shell padding.

env() reports these insets only from Android System WebView 136; an older
WebView reads 0 and keeps today's look. The Android docs now say so, and the
themes.xml comments, which still pointed at the React Layout and claimed
light icons, describe what enableEdgeToEdge() actually does.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-03 06:42:01 +07:00

89 lines
4.8 KiB
Markdown
Raw Permalink Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# Android support & system requirements
> Mirrored in Vietnamese at [`i18n/vi/android-support.md`](i18n/vi/android-support.md).
This document explains the **minimum Android version** the F2P Tracker APK
requires, **why**, and **what we test on**. Numbers are sourced so you can check
them yourself.
## Minimum requirement
| | |
| --- | --- |
| **Minimum** | **Android 11 (API level 30)** or newer |
| **Target / compiled against** | Android 16 (API 36) |
| **CPU/ABI** | universal APK — `arm64-v8a`, `armeabi-v7a`, `x86`, `x86_64` |
The APK declares `minSdkVersion 30`. On a device older than Android 11, Android's
package installer **refuses to install** it (`INSTALL_FAILED_OLDER_SDK`) and shows
*"App not installed"* / *"requires a newer version of Android"*. This is enforced
by the OS itself — there is no in-app bypass — so the version floor is also the
install gate. (Set in [`gen/android/app/build.gradle.kts`](../web/src-tauri/gen/android/app/build.gradle.kts) → `minSdk = 30`.)
## Why Android 11+
1. **Security / end-of-life.** Google only ships OS-level security backports for
the latest releases. As of June 2026 that is **Android 14, 15 and 16** only —
Android 13 left the security bulletins around March 2026, Android 12/12L on
31 March 2025, and Android 11 and older are long past it. We set the floor at
**11** rather than 14 as a deliberate balance: it removes the *deeply* dead
tail (Android 7–10) while still covering the large installed base on 11–13.
**Be aware:** Android 11–13 no longer receive OS security patches from Google,
even though they can still install the app.
2. **WebView compatibility.** The app is a thin native shell around the
web UI; everything renders in the **Android System WebView** (Chromium). Old
Android releases tend to carry an outdated WebView, which can choke on the
modern ES2022 / Svelte 5 output of our Vite 8 / Rolldown build. A newer OS
floor raises the guaranteed Chromium baseline and reduces that breakage risk.
(The WebView itself updates independently via the Play Store, so users who
keep it current fare better — but we can't rely on that on EOL devices.)
3. **Edge-to-edge & safe areas.** We compile against `targetSdk 36` (Android 16),
which forces edge-to-edge layout; the UI uses `env(safe-area-inset-*)` to dodge
the status / gesture-nav bars. These behave most reliably on Android 11+.
The WebView only reports those insets from **Android System WebView 136**; on
an older one the top bar sits under the status bar, and updating "Android
System WebView" from the Play Store fixes it.
4. **Tested surface.** We only test from Android 11 upward (see below); we don't
want to ship a floor we can't smoke-test.
## Tested devices
| Type | Device / target | Android version |
| --- | --- | --- |
| Emulator | Android Studio AVD | **Android 11 → 16** (API 30–36) |
| Real phone | **vivo 1907** | **Android 12** (API 31) |
Anything below Android 11 is unsupported and blocked at install time. Anything
above is expected to work but is best-effort beyond the matrix above. Found a
problem? File a [bug report](https://github.com/poli0981/free-steam-games-list/issues/new?template=bug_report.yml)
with device + Android version + screenshot.
## Android version landscape (the data behind the decision)
Worldwide Android version share and security-support status, mid-2026:
| Android | API | Google OS security patches? | Share (StatCounter, May 2026) | Cumulative (this version or newer) |
| --- | --- | --- | --- | --- |
| 16 (Baklava) | 36 | ✅ supported | 23.1% | 22.3% |
| 15 | 35 | ✅ supported | 18.1% | 41.0% |
| 14 | 34 | ✅ supported | 13.0% | 54.5% |
| 13 | 33 | ❌ EOL ~Mar 2026 | 14.3% | 68.9% |
| 12 / 12L | 31 / 32 | ❌ EOL 31 Mar 2025 | 10.0% | 78.8% |
| **11** | **30** | ❌ EOL ~2023 | 7.9% | **86.9%** |
| 10 and older | ≤ 29 | ❌ | remainder | — |
A `minSdk 30` floor therefore reaches roughly **87% of active Android devices**
while dropping only the long-dead tail.
### Sources
- API level ↔ version mapping and cumulative usage — [apilevels.com](https://apilevels.com/) (cumulative figures updated 28 May 2026 from April 2026 data).
- Per-version market share — [StatCounter, Mobile Android Version, Worldwide](https://gs.statcounter.com/android-version-market-share/mobile/worldwide/) (May 2026).
- Security end-of-life dates — [endoflife.date/android](https://endoflife.date/android) and the [Android Security Bulletins](https://source.android.com/docs/security/bulletin) (a release is treated as EOL once it stops appearing in the monthly bulletins).
## Related
- [`../web/src-tauri/TAURI.md`](../web/src-tauri/TAURI.md) — Android build prerequisites + CI.
- [`pc_spec.md`](pc_spec.md) — maintainer hardware + the full test-device list.
- [`DISCLAIMER.md`](DISCLAIMER.md) — data-accuracy caveats.