- 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 ตามงานข้างบน
117 lines
7.7 KiB
Markdown
117 lines
7.7 KiB
Markdown
# ทำ 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`
|