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:
1 parent
5249f92c10
commit
8bbecd14bd
4 files changed
+34
-4
No files matched your search
@@ -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.
|
||||
|
||||
@@ -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).
|
||||
|
||||
@@ -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
@@ -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
|
||||
|
||||
|
||||
Reference in new issue
Block a user