Firebase Arka Ucu (Veritabanı + Hesaplar)

1Bu, uygulamanıza ne kazandırır#

Normalde oluşturulan uygulamanız verileri yalnızca çalıştığı telefonda saklar. Firebase'i açmak uygulamaya ücretsiz bir bulut veritabanı verir; böylece aynı veri her cihazdan görülebilir ve (isterseniz) insanlar e-posta + şifre ile kaydolabilir.

KENDİ ALTYAPINIZI GETİRİN modelidir - uygulama SİZİN ücretsiz Firebase projenizle konuşur. AppMint hiçbir şey barındırmaz ve sizden ekstra ücret almaz. Bir yapılandırmayı bir kez yapıştırırsınız; tüm kodu yapay zeka yazar.

Hiçbir şey yazmanız veya tasarlamanız GEREKMEZ - tablo yok, şema yok, SQL yok. Firebase + AppMint, bunu uygulama açıklamanızdan çözer.

2Firebase projesini oluşturun (5 dk, ücretsiz)#

Bilgisayarda en kolayı:

1. console.firebase.google.com adresini açın ve herhangi bir Google hesabıyla giriş yapın.
2. 'Add project'e dokunun → herhangi bir ad verin → 'Continue'ya tıklamaya devam edin → Google Analytics'i atlayın → 'Create project'. Yaklaşık 30 sn bekleyin.
3. Sol menüde: Databases & Storage → Firestore → 'Create database'.

• Kullanıcılarınıza yakın bir konum seçin (bunu sonradan değiştiremezsiniz).
• 'Start in production mode' seçeneğini seçin - 'test mode' DEĞİL. Test modu 30 gün sonra otomatik olarak sona erer ve uygulamanız sessizce çalışmayı bırakır.

1. Sol menüde: Security → Authentication → 'Get started' → 'Sign-in method' sekmesi:

• 'Email/Password'u etkinleştirin (ilk anahtarı AÇIN, kaydedin).
• AYRICA 'Anonymous'u etkinleştirin (aşağı kaydırın, AÇIN, kaydedin) - misafir/liderlik tablosu uygulamaları için gereklidir.

Hepsi bu. Tasarlanacak bir şema yok.

Firebase Console'u Açın →

3Web yapılandırmanızı kopyalayın#

Hâlâ Firebase Console'da:

1. ⚙️ dişli simgesine (sol üst) dokunun → 'Project settings'.
2. 'Your apps' bölümüne kaydırın → </> (web) simgesine dokunun.
3. Uygulamaya herhangi bir takma ad verin → 'Register app'e dokunun ('Firebase Hosting'i atlayın).
4. Bir kod parçacığı göreceksiniz. YALNIZCA firebaseConfig nesnesini kopyalayın - açılış { işaretinden kapanış } işaretine kadar her şeyi.

Web API anahtarının herkese açık olması amaçlanmıştır - verileriniz anahtarı gizleyerek değil, 6. adımdaki güvenlik kurallarıyla korunur.

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

4AppMint'e yapıştırın (bir kez)#

AI Studio'yu açın → Settings → 'BACKEND - FIREBASE (OPTIONAL)' bölümüne kaydırın:

1. Kopyaladığınız firebaseConfig'i büyük metin kutusuna yapıştırın.
2. 'Enable Firebase backend' anahtarını AÇIN.
3. 'Save Firebase config'e dokunun. 'Saved Firebase project: <your-project-id>' mesajını görmelisiniz.

Cihazınızda şifreli olarak saklanır ve oluşturduğunuz her uygulama için yeniden kullanılır - bunu yalnızca bir kez yaparsınız.

5Uygulamanızı tarif edin - gerisini yapay zeka yapar#

Ne istediğinizi sade bir dille söyleyin. Yapay zeka, istediğinize göre giriş ekranları ekleyip eklemeyeceğine karar verir:

• 'Her kullanıcının kendi notlarını kaydettiği bir not uygulaması' → yapay zeka kayıt/giriş + özel notlar oluşturur.
• 'Hesapsız, dokunmatik bir oyun için küresel liderlik tablosu' → yapay zeka sessiz misafir girişi, herkese açık skorlar kullanır, giriş arayüzü eklemez.
• 'Herkesin yazabileceği ortak bir ilan panosu' → yapay zeka misafir girişi kullanır, giriş arayüzü eklemez.

Cihaz çevrimdışıysa veya yapılandırma eksikse, uygulama otomatik olarak yalnızca telefon depolamasına geçer; böylece asla çökmez.

6Güvenlik kurallarını uygulayın (ZORUNLU)#

Bu adım olmadan uygulama okumaya veya yazmaya çalıştığında 'permission denied' hataları alır. Kuralları yapay zeka SİZİN İÇİN yazar; siz sadece yapıştırırsınız.

1. Uygulamanızı oluşturduktan sonra Kod görünümünü açın (veya indirilen projeyi açın) ve 'firestore.rules' adlı dosyayı bulun. Dokunun ve TÜM metni kopyalayın.
2. Firebase Console'da: Databases & Storage → Firestore → 'Rules' sekmesi → 'Edit rules'a dokunun → mevcut olanı silin → yapay zekanın kurallarını yapıştırın → 'Publish'e dokunun.

Bunu uygulama başına bir kez yapın. Kurallar uygulamanıza göre hazırlanır - kullanıcıların yalnızca kendi verilerini yazmasına izin verirken liderlik tabloları herkese açık okunabilir kalır.

7Çalıştığını doğrulayın#

APK'yı yükledikten sonra hızlı kontrol:

1. Uygulamayı telefonunuzda açın ve veri kaydetmesi gereken bir işlem yapın (not oluşturun, skor gönderin vb.).
2. Firebase Console'a dönün: Databases & Storage → Firestore → 'Data' sekmesi → girdiğiniz verilerle yeni bir koleksiyon (örn. 'notes' veya 'scores') görmelisiniz.
3. Security → Authentication → 'Users' sekmesi → uygulamanız giriş kullanıyorsa hesabınız burada görünmelidir.

Hiçbir şey görünmezse: sonraki adımdaki en yaygın 3 nedeni kontrol edin.

8Bir şey çalışmazsa#

En yaygın hatalar:

• 'permission-denied' veya veri kaydedilmiyor → 6. adımı (kuralları Publish etmek) unuttunuz.
• Kayıt/girişte 'auth/operation-not-allowed' → 2. adımda Email/Password'u etkinleştirmediniz.
• Misafir/liderlik tablosu uygulamaları için 'auth/operation-not-allowed' → 2. adımda Anonymous'u etkinleştirmediniz.
• Google girişi için 'auth/operation-not-allowed' → Google'ı etkinleştirmediniz VE SHA-256 parmak izinizi yapıştırmadınız (aşağıdaki 'Add Google Sign-In' adımına bakın).
• Yapıştırılan yapılandırma reddedildi ('Couldn't find a { ... } config object') → yalnızca içini değil, süslü parantezler dahil TÜM { ... } bloğunu yapıştırın.

Oluşturulan uygulamalarda desteklenen giriş yöntemleri: Email/Password, Anonymous (misafir), Google Sign-In (yerel Credential Manager aracılığıyla) ve Phone/SMS (reCAPTCHA aracılığıyla). Facebook ile giriş DESTEKLENİR: sihirbazın Entegre Et adımına Facebook App ID ve Client Token'ınızı girin (giriş bir tarayıcı sekmesinde açılır). Apple/Twitter ile giriş hâlâ DESTEKLENMEZ - Google'ın Android WebView içinde engellediği OAuth açılır pencereleri gerektirirler.

9Google ile Giriş Ekleyin (isteğe bağlı)#

Oluşturulan uygulamalar, Android'in yerel Credential Manager'ı aracılığıyla Google ile Giriş'i kullanabilir - WebView içinde çalışır (OAuth açılır pencerelerinin aksine). Uygulama başına tek seferlik kurulum:

1. Firebase Console → Security → Authentication → 'Sign-in method' sekmesi → 'Google'ı etkinleştirin. Kaydedin.
2. Firebase Console → ⚙ Project settings → 'Your apps' → henüz kayıtlı bir Android uygulamanız yoksa 'Add app'e dokunun → Android → paket adınızı girin (AppMint'te kullanacağınız ad).
3. AppMint'te APK'nızı bir kez derleyin. İndirilen '<appname>_signkey_info.txt' dosyasını açın - en üstte SHA-1 ve SHA-256 parmak izlerini göreceksiniz.
4. Firebase Console'a geri dönün → ⚙ Project settings → Your apps → Android app → 'Add fingerprint' → SHA-1'i yapıştırın, ardından SHA-256 için tekrar 'Add fingerprint'. 'Save'e dokunun. Google Sign-In SHA-1'i kontrol eder: yalnızca SHA-256 ile 'No credentials available' hatasıyla başarısız olur. (Bunu uygulama başına yalnızca BİR KEZ yaparsınız - sonraki her derlemede aynı imza anahtarı kullanılır.)
5. Google Play'de mi yayınlıyorsunuz? Play uygulamanızı kendi anahtarıyla yeniden imzalar, bu yüzden Play'den yapılan bir yüklemenin parmak izi FARKLIDIR. Play Console → uygulamanız → Test ve yayın → Uygulama bütünlüğü → 'App signing key certificate' altındaki SHA-1 ve SHA-256'yı kopyalayın ve ikisini de aynı Firebase Android uygulamasına ekleyin. Bunu atlarsanız giriş APK'dan çalışır ama Play'den yükleyen herkes için başarısız olur.
6. Firebase Console → ⚙ Project settings → General → 'Your apps' bölümüne kaydırın → Web SDK bölümünü bulun → 'Web client ID'yi kopyalayın (.apps.googleusercontent.com ile biter).
7. AppMint Ayarları'nı açın → 'GOOGLE SIGN-IN - OAUTH WEB CLIENT ID' alanına yapıştırın. Kaydedin.
8. Uygulamanızı yeniden derleyin. Google ile Giriş artık çalışır.

10Telefon / SMS ile Giriş Ekleyin (isteğe bağlı)#

Telefon Kimlik Doğrulaması Firebase Web SDK + reCAPTCHA kullanır (WebView içinde çalışır). Kullanıcı telefon numarasını yazar, 'Ben robot değilim' kontrolüne dokunur, bir SMS kodu alır ve girer.

Kurulum:

1. Firebase Console → Security → Authentication → 'Sign-in method' sekmesi → 'Phone'u etkinleştirin. Kaydedin.
2. SHA gerekmez (Play Integrity değil, reCAPTCHA doğrulaması kullanıyoruz).
3. Uygulama açıklamanızda yapay zekadan telefonla giriş isteyin (örn. 'Kullanıcılar telefon numaralarıyla giriş yapar').

⚠️ Faturalandırma: Gerçek doğrulama SMS'i göndermek artık Blaze (kullandıkça öde) planı gerektirir - ücretsiz Spark planı artık ücretsiz SMS kotası içermiyor. Firebase Console → ⚙ Project settings → Usage and billing bölümünden yükseltin. Blaze'de Firebase Authentication günde 3.000 doğrulama SMS'ine izin verir; SMS fiyatları ülkeye göre değişir.

💡 Faturalandırma veya gerçek SMS OLMADAN test etmek için: Authentication → Settings → 'Phone numbers for testing' sabit bir test numarası + kodu eklemenize izin verir (SMS gönderilmez).

Firebase Auth kotaları ve fiyatlandırma →

11Maliyet - ne beklemeli#

Firebase'in ücretsiz 'Spark' planı çoğu hobi uygulamasını karşılar. Günlük ücretsiz kota:

• 50.000 belge okuma
• 20.000 yazma
• 20.000 silme
• Toplam 1 GiB depolama
• Ayda 10 GiB giden ağ trafiği

Karşılaştırma için: 100 aktif kullanıcılı küçük bir not uygulaması günde ~5.000 okuma yapar. Viral bir oyun liderlik tablosu bir saatte 50 bin okumayı aşabilir.

⚠️ Bütçe uyarısı ayarlayın: Google Cloud Console → Billing → Budgets & alerts → 'Alert me at $1' olarak ayarlayın. Güvende kalırsınız ve kullanım para tutmaya başladığı anda Firebase size e-posta gönderir.

Bütçe uyarısı ayarlayın →