Backend Firebase (Database + Akun)

1Yang didapat aplikasi Anda#

Biasanya aplikasi yang dibuat hanya menyimpan data di ponsel tempat ia berjalan. Mengaktifkan Firebase memberi aplikasi database cloud gratis, sehingga data yang sama terlihat dari perangkat mana pun dan (jika mau) orang bisa mendaftar dengan email + kata sandi.

Ini BRING-YOUR-OWN - aplikasi berbicara dengan proyek Firebase gratis MILIK ANDA. AppMint tidak menghosting apa pun dan tidak menagih biaya tambahan. Anda menempel satu konfigurasi sekali; AI menulis semua kodenya.

Anda TIDAK perlu menulis atau merancang apa pun - tanpa tabel, tanpa skema, tanpa SQL. Firebase + AppMint mencari tahu sendiri dari deskripsi aplikasi Anda.

2Buat proyek Firebase (5 menit, gratis)#

Paling mudah di komputer:

1. Buka console.firebase.google.com dan masuk dengan akun Google apa pun.
2. Ketuk 'Add project' → beri nama apa saja → terus klik 'Continue' → lewati Google Analytics → 'Create project'. Tunggu ~30 detik.
3. Di menu kiri: Databases & Storage → Firestore → 'Create database'.

• Pilih lokasi yang dekat dengan pengguna Anda (tidak bisa diubah nanti).
• Pilih 'Start in production mode' - BUKAN 'test mode'. Test mode kedaluwarsa otomatis setelah 30 hari dan aplikasi Anda akan berhenti berfungsi tanpa pemberitahuan.

1. Di menu kiri: Security → Authentication → 'Get started' → tab 'Sign-in method':

• Aktifkan 'Email/Password' (nyalakan sakelar pertama, simpan).
• AKTIFKAN JUGA 'Anonymous' (gulir ke bawah, nyalakan, simpan) - dibutuhkan untuk aplikasi tamu/papan peringkat.

Itu saja. Tidak ada skema yang perlu dirancang.

Buka Firebase Console →

3Salin konfigurasi web Anda#

Masih di Firebase Console:

1. Ketuk ikon ⚙ï¸ roda gigi (kiri atas) → 'Project settings'.
2. Gulir ke 'Your apps' → ketuk ikon </> (web).
3. Beri aplikasi nama panggilan apa saja → ketuk 'Register app' (lewati 'Firebase Hosting').
4. Anda akan melihat cuplikan kode. Salin HANYA objek firebaseConfig - semuanya dari { pembuka sampai } penutup.

Kunci API web memang dimaksudkan publik - data Anda dilindungi oleh aturan keamanan di langkah 6, bukan dengan menyembunyikan kunci.

const firebaseConfig = {
  apiKey: "AIza...",
  authDomain: "my-app.firebaseapp.com",
  projectId: "my-app",
  storageBucket: "my-app.appspot.com",
  messagingSenderId: "123456789",
  appId: "1:123:web:abc"
};   ← copy the { ... } part

4Tempel ke AppMint (sekali saja)#

Buka AI Studio → Settings → gulir ke 'BACKEND - FIREBASE (OPTIONAL)':

1. Tempel firebaseConfig yang Anda salin ke kotak teks besar.
2. Nyalakan sakelar 'Enable Firebase backend'.
3. Ketuk 'Save Firebase config'. Anda akan melihat 'Saved Firebase project: <your-project-id>'.

Disimpan terenkripsi di perangkat Anda dan dipakai ulang untuk setiap aplikasi yang Anda buat - cukup dilakukan sekali.

5Jelaskan aplikasi Anda - AI mengerjakan sisanya#

Cukup katakan apa yang Anda mau, dalam bahasa sehari-hari. AI menentukan apakah perlu menambah layar login atau tidak, berdasarkan permintaan Anda:

• 'Aplikasi catatan tempat tiap pengguna menyimpan catatannya sendiri' → AI membuat daftar/masuk + catatan pribadi.
• 'Papan peringkat global untuk game ketuk, tanpa akun' → AI memakai login tamu otomatis, skor publik, tanpa UI login.
• 'Papan pengumuman bersama yang bisa diposting semua orang' → AI memakai login tamu, tanpa UI login.

Jika perangkat offline atau konfigurasi tidak ada, aplikasi otomatis beralih ke penyimpanan hanya di ponsel sehingga tidak pernah error.

6Terapkan aturan keamanan (WAJIB)#

Tanpa langkah ini, aplikasi akan mendapat error 'permission denied' saat mencoba membaca atau menulis. AI menulis aturannya UNTUK ANDA; Anda tinggal menempelkannya.

1. Setelah membuat aplikasi, buka tampilan Code (atau ekstrak proyek yang diunduh) dan cari file bernama 'firestore.rules'. Ketuk dan salin SEMUA teksnya.
2. Di Firebase Console: Databases & Storage → Firestore → tab 'Rules' → ketuk 'Edit rules' → hapus isinya → tempel aturan dari AI → ketuk 'Publish'.

Lakukan sekali per aplikasi. Aturan ini disesuaikan dengan aplikasi Anda - pengguna hanya bisa menulis data mereka sendiri, sementara papan peringkat tetap bisa dibaca publik.

7Pastikan berfungsi#

Pemeriksaan cepat setelah menginstal APK:

1. Buka aplikasi di ponsel Anda dan lakukan satu aksi yang seharusnya menyimpan data (buat catatan, kirim skor, dll.).
2. Kembali di Firebase Console: Databases & Storage → Firestore → tab 'Data' → Anda akan melihat koleksi baru (mis. 'notes' atau 'scores') berisi data yang baru Anda masukkan.
3. Security → Authentication → tab 'Users' → jika aplikasi Anda memakai login, akun Anda seharusnya muncul di sini.

Jika tidak ada yang muncul: periksa 3 penyebab paling umum di langkah berikutnya.

8Jika ada yang tidak berfungsi#

Kesalahan yang paling umum:

• 'permission-denied' atau data tidak tersimpan → Anda lupa langkah 6 (Publish aturan).
• 'auth/operation-not-allowed' saat daftar/masuk → Anda belum mengaktifkan Email/Password di langkah 2.
• 'auth/operation-not-allowed' untuk aplikasi tamu/papan peringkat → Anda belum mengaktifkan Anonymous di langkah 2.
• 'auth/operation-not-allowed' untuk login Google → Anda belum mengaktifkan Google DAN menempel fingerprint SHA-256 Anda (lihat langkah 'Tambahkan Google Sign-In' di bawah).
• Konfigurasi yang ditempel ditolak ('Couldn't find a { ... } config object') → tempel SELURUH blok { ... } termasuk kurung kurawal, bukan hanya isinya.

Metode login yang didukung di aplikasi buatan: Email/Password, Anonymous (tamu), Google Sign-In (lewat Credential Manager bawaan), dan Phone/SMS (lewat reCAPTCHA). Login Facebook DIDUKUNG: masukkan Facebook App ID dan Client Token Anda di langkah Integrate pada wizard (login terbuka di tab browser). Login Apple/Twitter masih TIDAK didukung - keduanya memerlukan popup OAuth yang diblokir Google di dalam Android WebView.

9Tambahkan Google Sign-In (opsional)#

Aplikasi yang dibuat bisa memakai Google Sign-In lewat Credential Manager bawaan Android - berfungsi di dalam WebView (tidak seperti popup OAuth). Penyiapan sekali per aplikasi:

1. Firebase Console → Security → Authentication → tab 'Sign-in method' → aktifkan 'Google'. Simpan.
2. Firebase Console → ⚙ Project settings → 'Your apps' → jika Anda belum punya aplikasi Android terdaftar, ketuk 'Add app' → Android → masukkan nama paket Anda (yang akan Anda pakai di AppMint).
3. Build APK Anda sekali di AppMint. Buka file '<appname>_signkey_info.txt' yang diunduh - di bagian atas Anda akan melihat fingerprint SHA-1 dan SHA-256.
4. Kembali di Firebase Console → ⚙ Project settings → Your apps → aplikasi Android → 'Add fingerprint' → tempel SHA-1, lalu 'Add fingerprint' lagi untuk SHA-256. Ketuk 'Save'. Google Sign-In memeriksa SHA-1: dengan hanya SHA-256 akan gagal dengan 'No credentials available'. (Ini hanya dilakukan SEKALI per aplikasi - kunci penandatanganan yang sama dipakai untuk setiap build berikutnya.)
5. Menerbitkan di Google Play? Play menandatangani ulang aplikasi Anda dengan kuncinya sendiri, jadi instalasi dari Play punya fingerprint BERBEDA. Play Console → aplikasi Anda → Test and release → App integrity → salin SHA-1 dan SHA-256 di bawah 'App signing key certificate' dan tambahkan keduanya ke aplikasi Android Firebase yang sama. Jika dilewatkan, login berfungsi dari APK tetapi gagal untuk semua orang yang menginstal dari Play.
6. Firebase Console → ⚙ Project settings → General → gulir ke 'Your apps' → cari bagian Web SDK → salin 'Web client ID' (berakhiran .apps.googleusercontent.com).
7. Buka Settings AppMint → tempel ke 'GOOGLE SIGN-IN - OAUTH WEB CLIENT ID'. Simpan.
8. Build ulang aplikasi Anda. Google Sign-In kini berfungsi.

10Tambahkan Login Telepon / SMS (opsional)#

Phone Auth memakai Firebase Web SDK + reCAPTCHA (berfungsi di dalam WebView). Pengguna mengetik nomor ponsel, mengetuk pemeriksaan 'I'm not a robot', menerima kode SMS, lalu memasukkannya.

Penyiapan:

1. Firebase Console → Security → Authentication → tab 'Sign-in method' → aktifkan 'Phone'. Simpan.
2. Tidak perlu SHA (kami memakai verifikasi reCAPTCHA, bukan Play Integrity).
3. Cukup minta AI untuk login lewat ponsel dalam deskripsi aplikasi Anda (mis. 'Pengguna masuk dengan nomor ponsel mereka').

âš ï¸ Penagihan: Mengirim SMS verifikasi sungguhan kini memerlukan paket Blaze (bayar sesuai pemakaian) - paket Spark gratis tidak lagi menyertakan kuota SMS gratis. Upgrade di Firebase Console → ⚙ Project settings → Usage and billing. Di Blaze, Firebase Authentication mengizinkan hingga 3.000 SMS verifikasi per hari; harga SMS berbeda tiap negara.

💡 Untuk menguji TANPA penagihan atau SMS sungguhan: Authentication → Settings → 'Phone numbers for testing' memungkinkan Anda menambah nomor uji + kode tetap (tidak ada SMS yang dikirim).

Kuota & harga Firebase Auth →

11Biaya - apa yang diharapkan#

Paket 'Spark' gratis dari Firebase mencukupi sebagian besar aplikasi hobi. Gratis per hari:

• 50.000 pembacaan dokumen
• 20.000 penulisan
• 20.000 penghapusan
• Total penyimpanan 1 GiB
• 10 GiB / bulan jaringan keluar

Sebagai acuan: aplikasi catatan kecil dengan 100 pengguna aktif melakukan ~5.000 pembacaan/hari. Papan peringkat game yang viral bisa melewati 50 ribu pembacaan dalam satu jam.

âš ï¸ Atur peringatan anggaran: Google Cloud Console → Billing → Budgets & alerts → atur 'Alert me at $1'. Anda tetap aman dan Firebase akan mengirim email begitu pemakaian mulai berbiaya.

Atur peringatan anggaran →