- 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 ตามงานข้างบน
7.7 KiB
ทำ 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/<ชื่อโฟลเดอร์>/<ไฟล์>.jpgsaveZip()→ เขียน 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 (ยังไม่มีในเครื่องนี้)
# 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 สร้างให้บางส่วน — เติมเอง)
<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):
@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 ทางที่ทำได้จริง:
- แชร์ ZIP — โฟลเดอร์อยู่ข้างใน zip (โครงสร้าง
<ชื่อโฟลเดอร์>/<รูป>.jpg) - แชร์หลายรูปพร้อมกัน —
shareItems([{name, blob}, …])ส่งหลาย URI ในครั้งเดียว
เซ็น release (ภายหลัง)
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