# ทำ 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 ./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 ``` ## กล้องใน 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`