Panduan Install Aplikasi Kasapro sebagai PWA
Panduan lengkap untuk menginstall aplikasi Kasapro sebagai Progressive Web App (PWA) di berbagai perangkat.
Apa itu PWA?
Progressive Web App (PWA) adalah aplikasi web yang dapat diinstall dan berfungsi seperti aplikasi native di perangkat Anda. Keuntungan PWA:
- ✅ Installable: Dapat diinstall tanpa app store
- ✅ Offline Support: Dapat bekerja tanpa internet (terbatas)
- ✅ Fast Loading: Loading cepat berkat caching
- ✅ Native Feel: Tampil seperti aplikasi native (tanpa address bar browser)
- ✅ Auto Update: Update otomatis tanpa install ulang
- ✅ Home Screen Access: Bisa diakses langsung dari desktop/home screen
Install di Chrome Desktop
- Buka aplikasi Kasapro di browser Chrome
- Cari tombol “Install App” di header halaman (jika tersedia)
- Klik tombol “Install App”
- Di dialog install, klik “Install”
- Aplikasi akan terinstall dan muncul di desktop/start menu
- Buka aplikasi Kasapro di browser Chrome
- Klik icon “Install” di address bar (ikon + atau download)
- Atau buka menu (⋮) → “Install Kasapro…“
- Di dialog install, klik “Install”
- Aplikasi akan terinstall dan muncul di desktop/start menu
Verifikasi Install
- ✅ Aplikasi muncul di desktop/start menu dengan nama “Kasapro”
- ✅ Aplikasi membuka di window terpisah (tanpa address bar)
- ✅ Icon aplikasi sesuai dengan manifest
Install di Chrome Mobile (Android)
Metode 1: Install Prompt
- Buka aplikasi Kasapro di browser Chrome Android
- Setelah beberapa kali menggunakan, akan muncul banner “Add to Home screen”
- Klik “Add” atau “Install”
- Aplikasi akan terinstall dan muncul di home screen
- Buka aplikasi Kasapro di browser Chrome Android
- Buka menu (⋮) → “Add to Home screen” atau “Install app”
- Di dialog, klik “Add” atau “Install”
- Aplikasi akan terinstall dan muncul di home screen
Verifikasi Install
- ✅ Aplikasi muncul di home screen dengan icon “Kasapro”
- ✅ Aplikasi membuka di fullscreen (tanpa browser UI)
- ✅ Aplikasi dapat di-launch dari home screen
Install di Edge Desktop
- Buka aplikasi Kasapro di browser Edge
- Klik icon “App available” di address bar
- Atau buka menu (⋯) → “Apps” → “Install this site as an app”
- Di dialog install, klik “Install”
- Aplikasi akan terinstall dan muncul di start menu
Verifikasi Install
- ✅ Aplikasi muncul di start menu dengan nama “Kasapro”
- ✅ Aplikasi membuka di window terpisah
- ✅ Icon aplikasi sesuai dengan manifest
Install di Safari (iOS)
Catatan: Safari iOS memiliki dukungan PWA terbatas. Install via “Add to Home Screen”.
- Buka aplikasi Kasapro di browser Safari iOS
- Klik icon “Share” (kotak dengan panah ke atas)
- Scroll ke bawah dan pilih “Add to Home Screen”
- Edit nama jika perlu, lalu klik “Add”
- Aplikasi akan muncul di home screen
Verifikasi Install
- ✅ Aplikasi muncul di home screen dengan icon “Kasapro”
- ✅ Aplikasi membuka di fullscreen (tanpa Safari UI)
- ✅ Aplikasi dapat di-launch dari home screen
Troubleshooting
Penyebab: PWA belum memenuhi kriteria installability
Solusi:
- Pastikan menggunakan HTTPS (atau localhost untuk development)
- Pastikan manifest.json valid dan accessible
- Pastikan service worker terdaftar dan aktif
- Pastikan icons tersedia (192x192 dan 512x512)
- Refresh halaman dan coba lagi
Masalah: Install Dialog Tidak Muncul
Penyebab: Browser belum mendeteksi PWA sebagai installable
Solusi:
- Gunakan browser yang support PWA (Chrome, Edge, Safari)
- Pastikan sudah mengunjungi halaman beberapa kali
- Check browser console untuk error messages
- Coba install via browser menu (metode alternatif)
Masalah: Aplikasi Tidak Bisa Dibuka Setelah Install
Penyebab: Service worker atau manifest issue
Solusi:
- Uninstall aplikasi
- Clear browser cache
- Reinstall aplikasi
- Check browser console untuk error messages
Masalah: Icon Tidak Muncul atau Salah
Penyebab: Icon files tidak ditemukan atau format salah
Solusi:
- Pastikan icon files ada di path yang benar
- Pastikan format PNG dan ukuran sesuai
- Check manifest.json untuk path icon yang benar
- Clear browser cache dan reinstall
Masalah: Update Tidak Muncul
Penyebab: Service worker tidak update atau cache issue
Solusi:
- Check notification update di aplikasi
- Klik “Update Sekarang” jika ada
- Atau uninstall dan reinstall aplikasi
- Clear browser cache dan service worker cache
Tips & Best Practices
- Bookmark Aplikasi: Bookmark aplikasi di browser untuk akses cepat
- Allow Notifications: Izinkan notifikasi untuk update alerts
- Keep Updated: Update aplikasi saat ada notifikasi update
- Clear Cache: Clear cache jika aplikasi bermasalah
- Check Console: Check browser console untuk error messages
System Requirements
Minimum Requirements
- Browser: Chrome 90+, Edge 90+, Safari 14+ (iOS), Firefox 90+
- OS: Windows 10+, macOS 10.15+, Android 8+, iOS 14+
- Storage: Minimal 10MB untuk cache
- Internet: Required untuk first load, optional untuk offline mode
Recommended
- Browser: Chrome/Edge terbaru
- OS: Windows 11, macOS 12+, Android 10+, iOS 15+
- Storage: 50MB+ untuk cache dan data
- Internet: Stable connection untuk best experience
Support
Jika mengalami masalah yang tidak teratasi:
- Check Troubleshooting section di atas
- Check browser console untuk error messages
- Clear browser cache dan reinstall
- Hubungi support dengan detail:
- Browser dan versi
- OS dan versi
- Error message (jika ada)
- Screenshot (jika ada)
Butuh bantuan lebih lanjut? Lihat Troubleshooting atau hubungi support.