Build Aplikasi Hexaflate

Build aplikasi Android dari setup Firebase hingga download APK/AAB.

Setup Firebase (di Firebase Console)

1. Buat Project

Buka Firebase Console
Create project (contoh: hexaflate-servername)
Aktifkan Google Analytics (opsional)

2. Buat Android App di Firebase Console

Project Settings > Add app > Android
Package name: com.hexflate.pulsa (atau sesuai kebutuhan)
Download google-services.json (akan digunakan nanti)

3. Aktifkan Google Authentication

Authentication > Sign-in method
Enable Google
Set support email

4. Setup Service Account (WAJIB)

Project Settings > Service accounts
Generate new private key
Download JSON file
Di portal.hexaflate.com > Firebase Management
Klik ikon Key untuk konfigurasi Service Account
Paste JSON ke Firebase Service Account
Simpan

⚠️ Service Account harus disimpan dulu di Firebase Management sebelum bisa menggunakan fitur lainnya

Bagian 2: Konfigurasi Aplikasi di Portal

Setelah Firebase Service Account tersimpan dan Firebase app sudah dibuat di Firebase Console, konfigurasi aplikasi dilakukan melalui menu Firebase Management di portal.

Generate Keystore & Auto-register Fingerprint

Saat membuat keystore melalui konfigurasi aplikasi:

Login ke portal.hexaflate.com
Masuk ke menu Firebase Management
Pilih aplikasi yang sudah ada (yang dibuat di Firebase Console)
Klik Konfigurasi pada aplikasi
Isi form Password Keystore:
- Password: Password untuk keystore (min. 6 karakter)
- Key Alias: Nama alias untuk key (default: upload)
- Validity: Masa berlaku dalam hari (default: 10000)
Isi form Informasi Identitas:
- Common Name (CN): Nama lengkap
- Organizational Unit (OU): Divisi
- Organization (O): Nama perusahaan
- Locality (L): Kota
- State (ST): Provinsi
- Country Code (C): ID untuk Indonesia
Generate keystore

Proses akan berjalan otomatis:

✓ Membuat keystore
✓ Mengekstrak SHA fingerprint
✓ Mendaftarkan SHA-1 & SHA-256 fingerprint ke Firebase Console secara otomatis
✓ Menyimpan konfigurasi aplikasi

Langkah 2: Tambahkan SHA Fingerprints dari Play Console (Jika Sudah Publish)

Jika aplikasi sudah di Play Store, tambahkan juga SHA dari Google Play Console:

Buka Google Play Console
Pilih aplikasi Anda
Masuk ke Setup > App signing
Copy SHA-1 dan SHA-256 dari App signing key certificate
Di portal, masuk ke Firebase Management
Pilih aplikasi, klik Tambah di bagian SHA Fingerprints
Paste SHA dan klik Tambah Fingerprint

⚠️ PENTING: SHA-256 dari Play Console WAJIB ditambahkan sebelum publish ke Play Store jika mengaktifkan App Check, atau aplikasi tidak akan berfungsi.

Langkah 3: Setup App Check (OPSIONAL)

⚠️ PERINGATAN: App Check akan memblokir semua aplikasi yang tidak memiliki fingerprint terdaftar atau tidak mengaktifkan App Check. Disarankan untuk menonaktifkan App Check selama demo atau debug.

Setup di Firebase Console:

Buka Firebase Console > App Check
Pilih aplikasi Android Anda
Klik Register pada provider Play Integrity
Aktifkan Enforce jika ingin memblokir request dari aplikasi yang tidak terverifikasi

Aktivasi di Portal:

Login ke portal.hexaflate.com
Masuk ke menu Konfigurasi Server
Di bagian App Check, aktifkan toggle APP_CHECK_ENABLED
Klik Simpan

Persyaratan Penting:

Semua SHA fingerprints harus terdaftar (termasuk dari Play Console)
Aplikasi harus di-build ulang setelah mengaktifkan App Check
Testing/Debug apps tidak akan berfungsi jika App Check diaktifkan tanpa fingerprint yang sesuai

Kapan Menggunakan App Check:

✅ Aktifkan: Untuk aplikasi production yang sudah publish di Play Store
❌ Nonaktifkan: Selama development, testing, atau demo
❌ Nonaktifkan: Jika menggunakan APK untuk distribusi langsung

Bagian 3: Konfigurasi Aplikasi

Sebelum build, lakukan konfigurasi aplikasi melalui portal.

Langkah 1: Buka Konfigurasi

Di menu Firebase Management, pilih aplikasi
Klik Konfigurasi atau ikon gear

Langkah 2: Isi Informasi Konfigurasi

Lengkapi semua informasi yang diperlukan:

Section	Isi
Identitas Aplikasi	Nama app, deskripsi, versi, build number
Warna Tema	Light/dark seed color, splash colors
Pengaturan API	Server name, fallback URLs, token Authorization
Informasi Tentang	Judul, deskripsi, legal
White Label	Pilih distro (jika menggunakan white label)
Gambar Aset	Logo, splash screen, notification icon

Langkah 3: Simpan Konfigurasi

Klik Simpan Konfigurasi untuk menyimpan semua pengaturan.

Bagian 4: Build Aplikasi

Tipe Build

Di menu Build Aplikasi, ada 2 tipe build:

Tipe	Keterangan
APK	Split APKs untuk testing atau distribusi langsung
AAB	App Bundle untuk upload ke Google Play Store (recommended)

Langkah 1: Mulai Build

Di portal, masuk ke menu Build Aplikasi
Klik Build Baru
Pilih tipe build (APK atau AAB)
Pilih aplikasi Firebase yang sudah dikonfigurasi
Klik Build

Catatan: Hanya aplikasi yang sudah memiliki keystore dan konfigurasi lengkap yang bisa di-build.

Monitoring Build

Status build akan berubah:

Menunggu --> Sedang Build --> Selesai / Gagal

Waktu build:

Tercepat: 5-10 menit (antrian kosong)
Normal: 10-15 menit
Terlama: hingga 25 menit (antrian penuh)

Jika Build Gagal

Cek kembali konfigurasi aplikasi
Pastikan keystore sudah dibuat
Pastikan semua field konfigurasi terisi
Jika menggunakan App Check: Pastikan semua SHA fingerprints sudah terdaftar
Jika error App Check: Nonaktifkan App Check di Konfigurasi Server untuk testing
Hubungi admin dengan:
- Screenshot error
- Package name aplikasi
- Server name Anda

Bagian 5: Download Hasil Build

Jika build berhasil:

Tombol Download akan muncul di daftar build
Download file yang dibutuhkan:
- APK: Untuk testing atau distribusi langsung
- AAB: Untuk upload ke Google Play Store (recommended)

File sudah di-sign dan siap untuk deploy.

Catatan: File build akan kedaluwarsa setelah 7 hari. Pastikan download sebelum expired.

Checklist Sebelum Build

Referensi

Panduan Setup Backend - Setup backend Hexaflate
Panduan Web Report Deployment - Deploy web report