PWA Configurations

Platform TechMaju menyediakan konfigurasi default untuk konversi PWA dan aplikasi seluler. Namun, disarankan untuk menerapkan kustomisasi khusus untuk instance Anda.

Konfigurasi PWA

Doctype Konfigurasi PWA memungkinkan kustomisasi lanjutan untuk pengaturan PWA pada instance Anda.

Custom: Checkbox yang, ketika diaktifkan, memungkinkan Anda untuk mengkustomisasi manifest.json dan asset_links.json situs Anda.

Catatan: Setelah Custom diaktifkan, tidak dapat dinonaktifkan.
Manifest: Sebuah field JSON tempat Anda dapat melihat dan memodifikasi file manifest.json. Nilai default disediakan dan dapat disesuaikan ketika Custom diaktifkan.
Asset Links: Sebuah field JSON tempat konfigurasi asset_links.json disimpan. Seperti Manifest, memiliki nilai default yang dapat dimodifikasi ketika Custom diaktifkan.

Apa itu `manifest.json`?

File manifest.json adalah file konfigurasi utama untuk PWA. File ini mendefinisikan metadata yang diperlukan untuk menginstal aplikasi web Anda di perangkat dan memastikan bahwa aplikasi tersebut berperilaku seperti aplikasi native. File ini mencakup detail seperti nama aplikasi, ikon, warna tema, dan pengaturan lainnya yang meningkatkan pengalaman PWA.

Jika dikonfigurasi dengan benar, manifest.json membantu:

Menyediakan tampilan dan fungsi seperti aplikasi ketika diinstal.
Mengontrol bagaimana aplikasi terbuka (misalnya, mode layar penuh atau sebagai jendela mandiri).
Menentukan ikon dan elemen branding lainnya untuk berbagai resolusi layar.

Apa itu `asset_links.json`?

File asset_links.json adalah file konfigurasi penting yang digunakan dalam konversi PWA seluler. File ini membantu mengasosiasikan PWA Anda dengan aplikasi native, menciptakan pengalaman yang mulus bagi pengguna dengan menghilangkan bilah browser di bagian atas layar, yang sebaliknya akan terlihat kurang menarik dan mengurangi kesan aplikasi native.

Untuk mengonfigurasi asset_links.json:

Ambil detail paket aplikasi Anda dari Android Store.
Dapatkan fingerprint SHA untuk kunci penandatanganan aplikasi Anda. Ini biasanya dapat ditemukan di Android Developer Console Anda atau dengan menggunakan perintah keytool secara lokal.
Tambahkan fingerprint SHA ke field Asset Links jika diperlukan.

Pengaturan Situs Web

Pengaturan Situs Web Default ditambahkan ke platform seperti yang terlihat di bawah ini.

Untuk kustomisasi, Anda dapat mengganti nilai href link yang relevan dengan gambar ikon yang setara yang ingin Anda tampilkan untuk instance Anda.

Catatan: Semua link harus bersifat publik agar dapat ditemukan.

Ketika Custom diaktifkan di Konfigurasi PWA, URL manifest.json akan berubah.

Catatan: Jika HTML head pada Pengaturan Situs Web dimodifikasi secara manual, tidak dijamin logika otomatis akan bekerja seperti yang diharapkan. Disarankan pengguna memverifikasi HTML head secara manual untuk memastikan kebenarannya.

Menggunakan Plugin Frappe Builder

Jika plugin Frappe Builder diinstal, langkah tambahan diperlukan untuk memastikan manifest ditambahkan dengan benar ke header.

Perbarui field Builder Settings Script dengan kode berikut:

// Buat elemen link baru
var linkElement = document.createElement("link");

// Atur atribut rel dan href
linkElement.rel = "manifest";
linkElement.href = "/assets/techmaju_core/manifest.json";

// Tambahkan elemen link ke head dokumen
document.head.appendChild(linkElement);

Script ini memastikan bahwa manifest PWA secara dinamis dimasukkan ke dalam head dokumen.