Files
Bkk1234 6f146aef59 feat(android): Capacitor APK build + native save/share bridge
- android/ — Capacitor project (build/, local.properties ignored)
- app/js/native.js — bridge สำหรับ APK: savePhoto/saveZip/shareItems ผ่าน Filesystem+Share
- app/js/csv.js — นำเข้าโฟลเดอร์หลายรายการจาก CSV (site,letter,datetime,name)
- app/js/orient.js — จัดการ orientation ของ preview/กล้อง
- app/manual.html + APK.md — คู่มือใช้งานและวิธี build APK
- app/templates/folders-template.csv — เทมเพลต CSV
- package.json / package-lock.json / capacitor.config.json / scripts/build-apk.sh
- ปรับ ui, camera, exif, archive, db, naming, main, sw + css/README ตามงานข้างบน
2026-11-20 08:50:42 +07:00

117 lines
7.7 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.
# ทำ CamCat เป็นไฟล์ .apk
## ตอบสั้น ๆ
ทำได้ — แต่ "เว็บแอป" คอมไพล์เป็น APK ตรง ๆ ไม่ได้ ต้องห่อด้วย **Capacitor (WebView + native bridge)**
ซึ่งจะได้ APK จริงที่เข้าถึง **กล้อง**, **ไฟล์ในเครื่อง** และ **share sheet ของ Android** ได้เต็มกว่าเดิม
| ทาง | ได้อะไร | ข้อจำกัด |
|---|---|---|
| PWA (ตอนนี้) | ติดตั้งจาก Chrome, กล้อง, ZIP ดาวน์โหลด | ไฟล์ลง Download, แชร์ไฟล์ได้จำกัด, ไม่มีไอคอนแอปจริง |
| TWA (Bubblewrap/PWABuilder) | APK จาก Play Store ได้ | ยังเป็นเว็บล้วน — เข้าถึงไฟล์/แชร์ได้เท่าเดิม |
| **Capacitor WebView** (แนะนำ) | APK + ปลั๊กอิน Filesystem/Share/Camera | ต้อง build ด้วย Android SDK, APK ใหญ่ขึ้น ~4–6 MB |
## สิ่งที่ปรับในโค้ดแล้ว
- `app/js/native.js` — bridge ตรวจว่ากำลังรันใน APK (`Capacitor.isNativePlatform()`)
- `savePhoto()` → เขียนรูปจริงที่ `Documents/CamCat/<ชื่อโฟลเดอร์>/<ไฟล์>.jpg`
- `saveZip()` → เขียน ZIP ที่ `Documents/CamCat-ZIP/`
- `shareItems()` → เปิด share sheet ของ Android ด้วย FileProvider (รูปเดี่ยว/หลายรูป/ZIP)
- บนเว็บทุกฟังก์ชันคืน `null` → ใช้ทางเดิม (ดาวน์โหลด/Web Share) ไม่กระทบ PWA
- ถ่ายรูปใน APK = บันทึกทั้งใน IndexedDB **และ** ลงโฟลเดอร์จริงในเครื่องทันที
- ปุ่ม ZIP (โฟลเดอร์เดียว / ทุกโฟลเดอร์) ใน APK = เขียนลง `Documents/CamCat-ZIP` แทนการดาวน์โหลด
- หน้า diagnostics เพิ่มบรรทัด “โหมดแอป” และ “ที่เก็บไฟล์”
## build
ต้องมี **JDK 17** และ **Android SDK** (ยังไม่มีในเครื่องนี้)
```bash
# 1) JDK 17 (Temurin) → ตั้ง JAVA_HOME
# 2) Android SDK commandline-tools → ตั้ง ANDROID_HOME + sdkmanager --licenses
# ติดตั้ง: platform-tools, platforms;android-34, build-tools;34.0.0
cd <repo>
./scripts/build-apk.sh # npm install → cap add android → cap sync → assembleDebug
# APK: android/app/build/outputs/apk/debug/app-debug.apk
```
ติดตั้งลงเครื่อง: เปิด “ติดตั้งจากแหล่งที่ไม่รู้จัก” แล้วกดไฟล์ APK (หรือ `adb install -r app-debug.apk`)
## สิทธิ์ใน AndroidManifest (Capacitor สร้างให้บางส่วน — เติมเอง)
```xml
<uses-permission android:name="android.permission.CAMERA" />
<uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" />
<uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION" />
```
## กล้องใน WebView
`getUserMedia()` ใน WebView ต้องมีสิทธิ์ CAMERA และ WebChromeClient อนุญาตคำขอ
ถ้าเปิดแอปแล้วภาพกล้องไม่ขึ้น ให้เพิ่มใน `MainActivity` (fallback):
```java
@Override
public void onRequestPermissionsResult(int requestCode, String[] permissions, int[] results) {
super.onRequestPermissionsResult(requestCode, permissions, results);
// Capacitor จะส่งต่อผลให้ WebView เองในเวอร์ชันใหม่
}
```
ถ้ายังไม่ขึ้น ทางเลือกที่เสถียรกว่า: ใช้ `@capacitor/camera` ถ่ายภาพนิ่ง (ได้ JPEG + EXIF เต็ม)
แล้วคงพรีวิวด้วย `getUserMedia` — โค้ดฝั่งเว็บแยกอยู่แล้วที่ `js/camera.js`
## แชร์ “โฟลเดอร์”
Android แชร์ URI ของ **โฟลเดอร์** ผ่าน share sheet ไม่ได้ (intent รับได้เฉพาะไฟล์)
จึงมี 2 ทางที่ทำได้จริง:
1. **แชร์ ZIP** — โฟลเดอร์อยู่ข้างใน zip (โครงสร้าง `<ชื่อโฟลเดอร์>/<รูป>.jpg`)
2. **แชร์หลายรูปพร้อมกัน** — `shareItems([{name, blob}, …])` ส่งหลาย URI ในครั้งเดียว
## เซ็น release (ภายหลัง)
```bash
keytool -genkey -v -keystore camcat.jks -keyalg RSA -keysize 2048 -validity 10000 -alias camcat
# android/key.properties + build.gradle signingConfigs → assembleRelease
```
## APK ที่ build แล้ว (เครื่องนี้)
| รายการ | ค่า |
|---|---|
| ไฟล์ | `dist/CamCat-1.0-debug.apk` (3.8 MB) |
| Package | `com.camcat.app` · label `CamCat` |
| Permissions | CAMERA, ACCESS_FINE_LOCATION, ACCESS_COARSE_LOCATION, WRITE_EXTERNAL_STORAGE (≤API 29) |
| Build | Gradle 8.2.1 + AGP + SDK 34, debug keystore |
| Toolchain ที่ติดตั้ง | `D:\AndroidToolchain\jdk-17.0.13`, `D:\AndroidToolchain\Sdk` |
ติดตั้ง: คัดลอก APK ไปมือถือ → เปิด “ติดตั้งจากแหล่งที่ไม่รู้จัก” → กดติดตั้ง
หรือ `adb install -r dist/CamCat-1.0-debug.apk`
### ที่เก็บไฟล์ใน APK
`native.js` จะลองเขียน `DOCUMENTS` ก่อน (Android ≤10 เห็นใน My Files/Pictures)
ถ้าระบบปฏิเสธ (Android 11+ scoped storage) จะ fallback ไป app-specific external
(`Android/data/com.camcat.app/files/CamCat/...`) — ยังเข้าถึงได้ทาง USB/File Manager
ถ้าต้องการให้ลง `Documents`/`DCIM` จริงบน Android 11+ ต้องเพิ่มปลั๊กอิน MediaStore
(`@capacitor-community/media`) หรือขอ MANAGE_EXTERNAL_STORAGE (ข้อจำกัดของ Play Store)
## v1.1 (ล่าสุด)
- ล็อกแนวตั้ง `android:screenOrientation="portrait"` — ถือแนวนอน UI ไม่หมุน
- เลือกอัตราส่วนภาพ 4:3 / 3:4 ได้ (กรอบพรีวิว + ครอปไฟล์จริง + เก็บใน meta.ratio)
- กันกล้องค้าง: `takePhoto()` timeout 4s, capture timeout 12s, watchdog 20s
- APK: `dist/CamCat-1.1-debug.apk`
## v1.2
- Auto-orient: อ่าน EXIF Orientation → bake พิกเซลให้ตรง → เขียน Orientation = 1 (กันแอปอื่นหมุนซ้ำ)
- ปุ่มหมุนซ้าย/ขวา 90° ในชีตรูป (บันทึกลง DB + เขียน EXIF ใหม่)
- ปุ่ม Volume up/down เป็นชัตเตอร์ (MainActivity → CustomEvent `camcat:shutter`, debounce 0.6s)
- APK: `dist/CamCat-1.2-debug.apk`