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

7.7 KiB
Raw Permalink Blame History

ทำ 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 (ยังไม่มีในเครื่องนี้)

# 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 ทางที่ทำได้จริง:

  1. แชร์ ZIP — โฟลเดอร์อยู่ข้างใน zip (โครงสร้าง <ชื่อโฟลเดอร์>/<รูป>.jpg)
  2. แชร์หลายรูปพร้อมกัน — 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