docs(android): add System Requirements (WebView/Android/RAM/storage) (#95)

Add a "System requirements" table to the README Android section (EN + VI):
Android 12+ (API 31), Android System WebView Chromium 111+, supported ABIs,
RAM, storage, and offline/no-network note — with guidance to update WebView
if the UI looks broken. Refresh the now-stale Android testing note in
docs/pc_spec.md (EN + VI) to reflect emulator-based build + smoke testing.

Co-authored-by: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
This commit is contained in:
poli0981andClaude Opus 4.8 authored and GitHub committed 2026-06-16 14:57:37 +07:00
1 parent 5249f92c10
commit 8bbecd14bd
4 files changed
+34 -4

No files matched your search

+11
View File
@@ -109,6 +109,17 @@ Output:
JSONPrism also ships as an Android app you sideload from a `.apk`. Same React UI; native file picker via the dialog plugin. **Requires Android 12 (API 31) or newer** — the OS refuses to install it on older versions.
### System requirements
| Requirement | Detail |
| --- | --- |
| **Android version** | **12 (API 31)** or newer — older versions are blocked at install time (`INSTALL_FAILED_OLDER_SDK`) |
| **System WebView** | **Chromium 111+** (Android System WebView / Chrome). Kept current by the Play Store on most devices; a much older WebView renders the layout incorrectly — update "Android System WebView" and Chrome from the Play Store if the UI looks broken. |
| **CPU / ABI** | arm64-v8a, armeabi-v7a, x86, or x86_64 — the single universal APK runs on all of them (modern phones are arm64-v8a) |
| **RAM** | 2 GB minimum; 4 GB recommended for large or batch (up to 500 files) conversions |
| **Storage** | ~27 MB to download; ~100 MB free recommended (install + temporary working files) |
| **Network** | None — the app runs fully offline and sends nothing off the device |
### Install (users)
1. Download `JSONPrism-<version>-android-universal.apk` from the [Releases](https://github.com/poli0981/jsonPrism/releases) page.
+11
View File
@@ -109,6 +109,17 @@ Output:
JSONPrism còn có bản Android để bạn sideload từ file `.apk`. Cùng React UI; chọn file qua dialog native. **Yêu cầu Android 12 (API 31) trở lên** — máy cũ hơn sẽ bị hệ điều hành chặn cài.
### Yêu cầu hệ thống
| Yêu cầu | Chi tiết |
| --- | --- |
| **Phiên bản Android** | **12 (API 31)** trở lên — máy cũ hơn bị chặn ngay khi cài (`INSTALL_FAILED_OLDER_SDK`) |
| **System WebView** | **Chromium 111+** (Android System WebView / Chrome). Đa số máy được Play Store cập nhật sẵn; WebView quá cũ sẽ render giao diện sai — nếu UI bị vỡ, hãy cập nhật "Android System WebView" và Chrome trong Play Store. |
| **CPU / ABI** | arm64-v8a, armeabi-v7a, x86 hoặc x86_64 — một file APK universal chạy được trên tất cả (máy hiện đại là arm64-v8a) |
| **RAM** | Tối thiểu 2 GB; khuyến nghị 4 GB cho file lớn hoặc xử lý hàng loạt (tối đa 500 file) |
| **Dung lượng** | ~27 MB để tải; nên có ~100 MB trống (cài đặt + file tạm khi làm việc) |
| **Mạng** | Không cần — app chạy hoàn toàn offline, không gửi gì ra ngoài |
### Cài đặt (người dùng)
1. Tải `JSONPrism-<version>-android-universal.apk` từ trang [Releases](https://github.com/poli0981/jsonPrism/releases).
+6 -2
View File
@@ -25,8 +25,12 @@ Dùng để kiểm tra bản web (chủ yếu là deploy lên GitHub Pages) trê
- iPhone 14 Pro — iOS 26.x — Chrome, Brave
- iPhone 13 Pro Max — iOS 26.x — Chrome, Brave
Test Android là cơ hội (không có thiết bị chuyên dụng); bản web vẫn nên
chạy được với các phiên bản WebView phổ thông.
Android: app được build và smoke-test trên emulator (API 31 cho cổng chặn
cài / min-SDK, API 36 với WebView Chromium 134 cho phần render) — chưa có
thiết bị thật chuyên dụng. **Yêu cầu hệ thống cho người dùng cuối** (Android
12+, WebView Chromium 111+, RAM, dung lượng) nằm ở mục "Yêu cầu hệ thống"
trong README; chi tiết build / ký nằm ở
[docs/TAURI-NOTES.md](../../TAURI-NOTES.md).
## Tài liệu liên quan
+6 -2
View File
@@ -26,8 +26,12 @@ form factors:
- iPhone 14 Pro — iOS 26.x — Chrome, Brave
- iPhone 13 Pro Max — iOS 26.x — Chrome, Brave
Android testing is opportunistic (no dedicated device); the web build
should still work given mainstream WebView versions.
Android: the app is built and smoke-tested on emulators (API 31 for the
install / min-SDK gate, API 36 with a Chromium 134 WebView for rendering) —
no dedicated physical device yet. **End-user system requirements** (Android
12+, WebView Chromium 111+, RAM, storage) live in the README "System
requirements" section; build / signing details are in
[docs/TAURI-NOTES.md](TAURI-NOTES.md).
## Related docs