Birden çok proje yapılandırın

Bu sayfada, uygulamanızda birden fazla Firebase projesinin nasıl kullanılacağı açıklanmaktadır.

Çoğu uygulamanın yalnızca tek bir Firebase projesine ve Başlarken kılavuzlarında açıklanan varsayılan kuruluma ihtiyacı vardır. Birden fazla Firebase projesi kullanmanın ne zaman yararlı olabileceğine ilişkin örnekler şunları içerir:

  • Geliştirme ortamınızı, yapı türüne veya hedefe göre farklı Firebase projelerini kullanacak şekilde ayarlama.
  • Uygulamanızda birden fazla Firebase projesinden içeriğe erişme.

Farklı ortamları destekleyin

Yaygın bir kullanım örneği, geliştirme ve üretim ortamlarınız için ayrı Firebase projelerini desteklemektir.

Web ve Yönetici SDK'ları, değerleri doğrudan başlatma işlevlerine geçirerek yapılandırılır. Bu SDK için, geliştirme veya üretim yapılandırma değişkenlerini seçmek için bir çalışma zamanı denetimi kullanabilirsiniz.

Android ve Apple platformları (ve Unity ve C++ sarmalayıcıları) normalde yapılandırmayı bir yapılandırma dosyasından yükler: Apple platformunda GoogleService-Info.plist ve Android'de google-services.json . Bu dosyalar, Firebase uygulama nesnesi ( FIRApp veya FirebaseApp ) tarafından başvurulan bir seçenekler nesnesine ( FIROption veya FirebaseOptions ) okunur.

Bu platformlar için ortamlar arasında geçiş, genellikle her ortam için farklı yapılandırma dosyalarının kullanılması yoluyla bir oluşturma zamanı kararı olarak uygulanır.

Apple uygulamanızda birden çok ortamı destekleyin

Varsayılan olarak, FirebaseApp.configure FirebaseApp.configure() , uygulama ile birlikte verilen GoogleService-Info.plist dosyasını yükler. Geliştirme ve üretim ortamlarınız Xcode'da ayrı hedefler olarak yapılandırılmışsa şunları yapabilirsiniz:

  • Her iki GoogleService-Info.plist dosyasını da indirin
  • İki dosyayı farklı dizinlerde saklayın
  • Her ikisini de Xcode projenize ekleyin
  • Hedef Üyelik panelini kullanarak farklı dosyaları farklı hedeflerle ilişkilendirin:

Hedef Üyelik paneli

Derlemeler tek bir hedefin parçasıysa, en iyi seçenek her iki yapılandırma dosyasına da benzersiz adlar vermektir (ör GoogleService-Info-Free.plist ve GoogleService-Info-Paid.plist ). Ardından, hangi plist'in yükleneceğini çalışma zamanında seçin. Bu, aşağıdaki örnekte gösterilmiştir:

// Load a named file.
let filePath = Bundle.main.path(forResource: "MyGoogleService", ofType: "plist")
guard let fileopts = FirebaseOptions(contentsOfFile: filePath!)
  else { assert(false, "Couldn't load config file") }
FirebaseApp.configure(options: fileopts)

Android uygulamanızda birden çok ortamı destekleyin

Android'de google-service.json dosyası, Google Services gradle eklentisi tarafından Android dize kaynaklarına işlenir. JSON dosyasının İşlenmesi ile ilgili Google Hizmetleri Eklentisi belgelerinde hangi kaynakların oluşturulduğunu görebilirsiniz.

google- google-services.json dosyalarını uygulama modülü kökü altında her bir değişken için adlandırılmış özel dizinlere yerleştirerek farklı yapı türevleri için birden fazla google-services.json dosyasına sahip olabilirsiniz. Örneğin, "geliştirme" ve "yayınlama" yapı çeşitleriniz varsa, yapılandırmanız şu şekilde organize edilebilir:

app/
    google-services.json
    src/development/google-services.json
    src/release/google-services.json
    ...

Daha fazla bilgi edinmek için JSON dosyasını ekleme ile ilgili Google Hizmetleri Eklentisi belgelerine bakın.

Bu kaynaklar daha sonra uygulama kodunuzdan önce çalışan ve bu değerleri kullanarak Firebase API'lerini başlatan FirebaseInitProvider tarafından yüklenir.

Bu sağlayıcı yalnızca bilinen adlara sahip kaynakları okuduğundan, başka bir seçenek de dize kaynaklarını Google Services gradle eklentisini kullanmak yerine doğrudan uygulamanıza eklemektir. Bunu şu şekilde yapabilirsiniz:

  • google-services eklentisini kök build.gradle
  • google-services.json dosyasını projenizden silme
  • Dize kaynaklarını doğrudan ekleme
  • Uygulama apply plugin: 'com.google.gms.google-services' uygulamanızın build.gradle

Uygulamanızda birden çok proje kullanın

Bazen aynı API'leri kullanarak farklı projelere erişmeniz gerekir - örneğin, birden çok veritabanı örneğine erişim. Çoğu durumda, tüm Firebase API'lerinin yapılandırmasını yöneten merkezi bir Firebase uygulama nesnesi vardır. Bu nesne, normal kurulumunuzun bir parçası olarak başlatılır. Ancak, tek bir uygulamadan birden çok projeye erişmek istediğinizde, her birine ayrı ayrı başvuruda bulunmak için ayrı bir Firebase uygulama nesnesine ihtiyacınız olacaktır. Bu diğer örnekleri başlatmak size kalmış.

Her iki durumda da, Firebase uygulamasının yapılandırma verilerini tutmak için önce bir Firebase options nesnesi oluşturmanız gerekir. Seçeneklere ilişkin tam belgeler, aşağıdaki sınıflara ilişkin API başvuru belgelerinde bulunabilir:

Bir uygulamada birden çok projeyi desteklemek için bu sınıfların kullanımı aşağıdaki örneklerde gösterilmiştir:

Süratli

// Configure with manual options. Note that projectID and apiKey, though not
// required by the initializer, are mandatory.
let secondaryOptions = FirebaseOptions(googleAppID: "1:27992087142:ios:2a4732a34787067a",
                                       gcmSenderID: "27992087142")
secondaryOptions.apiKey = "AIzaSyBicqfAZPvMgC7NZkjayUEsrepxuXzZDsk"
secondaryOptions.projectID = "projectid-12345"

// The other options are not mandatory, but may be required
// for specific Firebase products.
secondaryOptions.bundleID = "com.google.firebase.devrel.FiroptionConfiguration"
secondaryOptions.trackingID = "UA-12345678-1"
secondaryOptions.clientID = "27992087142-ola6qe637ulk8780vl8mo5vogegkm23n.apps.googleusercontent.com"
secondaryOptions.databaseURL = "https://myproject.firebaseio.com"
secondaryOptions.storageBucket = "myproject.appspot.com"
secondaryOptions.androidClientID = "12345.apps.googleusercontent.com"
secondaryOptions.deepLinkURLScheme = "myapp://"
secondaryOptions.storageBucket = "projectid-12345.appspot.com"
secondaryOptions.appGroupID = nil

Java

// Manually configure Firebase Options. The following fields are REQUIRED:
//   - Project ID
//   - App ID
//   - API Key
FirebaseOptions options = new FirebaseOptions.Builder()
        .setProjectId("my-firebase-project")
        .setApplicationId("1:27992087142:android:ce3b6448250083d1")
        .setApiKey("AIzaSyADUe90ULnQDuGShD9W23RDP0xmeDc6Mvw")
        // setDatabaseURL(...)
        // setStorageBucket(...)
        .build();

Kotlin+KTX

// Manually configure Firebase Options. The following fields are REQUIRED:
//   - Project ID
//   - App ID
//   - API Key
val options = FirebaseOptions.Builder()
        .setProjectId("my-firebase-project")
        .setApplicationId("1:27992087142:android:ce3b6448250083d1")
        .setApiKey("AIzaSyADUe90ULnQDuGShD9W23RDP0xmeDc6Mvw")
        // .setDatabaseUrl(...)
        // .setStorageBucket(...)
        .build()

// The following fields are REQUIRED:
//  - Project ID
//  - App ID
//  - API Key
const secondaryAppConfig = {
    projectId: "<PROJECT_ID>",
    appId: "<APP_ID>",
    apiKey: "<API_KEY>",
    // databaseURL: "...",
    // storageBucket: "...",
};

C++

firebase::AppOptions secondary_app_options;

// API key, app ID, and project ID are always required.
secondary_app_options.set_api_key("<API_KEY>");
secondary_app_options.set_app_id("<GOOGLE_APP_ID>");
secondary_app_options.set_project_id("<PROJECT_ID>");

// The following options are specific to individual Firebase products
// and may not always be required.
secondary_app_options.set_database_url("<DATABASE_URL>");
secondary_app_options.set_messaging_sender_id("<SENDER_ID>");
secondary_app_options.set_storage_bucket("<STORAGE_BUCKET>");

Birlik

Firebase.AppOptions secondaryAppOptions = new Firebase.AppOptions {
  ApiKey = "<API_KEY>",
  AppId = "<GOOGLE_APP_ID>",
  ProjectId = "<PROJECT_ID>"
};

Node.js

const secondaryServiceAccount = require('./path/to/serviceAccountKey.json');

// All required options are specified by the service account,
// add service-specific configuration like databaseURL as needed.
const secondaryAppConfig = {
    credential: cert(secondaryServiceAccount),
    // databaseURL: 'https://<DATABASE_NAME>.firebaseio.com'
};

Java

FileInputStream serviceAccount = new FileInputStream("path/to/serviceAccountKey.json");

FirebaseOptions secondaryAppConfig = new FirebaseOptions.Builder()
  .setCredential(FirebaseCredentials.fromCertificate(serviceAccount))
  .setDatabaseUrl("https://<DATABASE_NAME>.firebaseio.com/")
  .build();

Bu seçenekler nesnesini başlattıktan sonra, ek bir Firebase uygulama örneği yapılandırmak için kullanabilirsiniz. Aşağıda gösterilen tüm örneklerde ikincil dizeyi kullandığımızı unutmayın. Bu ad, uygulama örneğini almak ve onu varsayılan örnek ( [DEFAULT] adlı) dahil olmak üzere diğer örneklerden ayırt etmek için kullanılır. Diğer Firebase projesinin kullanım amacına uygun bir dize seçmelisiniz.

Aşağıdaki parçacıklar, alternatif bir Gerçek Zamanlı Veritabanına bağlanmayı gösterir (diğer Firebase özellikleri için API'ler aynı modeli izler).

Süratli

// Configure an alternative FIRApp.
FirebaseApp.configure(name: "secondary", options: secondaryOptions)

// Retrieve a previous created named app.
guard let secondary = FirebaseApp.app(name: "secondary")
  else { assert(false, "Could not retrieve secondary app") }


// Retrieve a Real Time Database client configured against a specific app.
let secondaryDb = Database.database(app: secondary)

Java

// Initialize with secondary app
FirebaseApp.initializeApp(this /* Context */, options, "secondary");

// Retrieve secondary FirebaseApp
FirebaseApp secondary = FirebaseApp.getInstance("secondary");

Kotlin+KTX

// Initialize secondary FirebaseApp.
Firebase.initialize(this /* Context */, options, "secondary")

// Retrieve secondary FirebaseApp.
val secondary = Firebase.app("secondary")
// Get the database for the other app.
val secondaryDatabase = Firebase.database(secondary)

// Initialize another app with a different config
const secondaryApp = firebase.initializeApp(secondaryAppConfig, "secondary");
// Access services, such as the Realtime Database
// secondaryApp.database();

C++

firebase::App* secondary_app = firebase::App::Create(secondary_app_options, "Secondary");
firebase::database::Database* secondary_database = firebase::database::Database::GetInstance(secondary_app);

Birlik

var secondaryApp = Firebase.FirebaseApp.Create(secondaryAppOptions, "Secondary"));
var secondaryDatabase = Firebase.Database.FirebaseDatabase.getInstance(secondaryApp);

Node.js

// Initialize another app with a different config
const secondary = initializeApp(secondaryAppConfig, 'secondary');
// Access services, such as the Realtime Database
// const secondaryDatabase = secondary.database();

Java

// Initialize another app with a different config
FirebaseApp secondaryApp = FirebaseApp.initializeApp(secondaryAppConfig, "secondary");

// Retrieve the database.
FirebaseDatabase secondaryDatabase = FirebaseDatabase.getInstance(secondaryApp);

Analytics için güvenilir raporlama sağlayın

Google Analytics, bazı durumlarda birincil Firebase uygulama örneği yapılandırılmadan önce, uygulama başlatma akışında çok erken olayları toplar. Bu durumlarda Firebase, etkinlikleri depolamak için doğru Google uygulama kimliğini aramak için Apple platformlarındaki Android kaynağına veya GoogleService-Info.plist . Bu nedenle, mümkün olan her yerde varsayılan yapılandırma yöntemlerini kullanmanızı öneririz.

Çalışma zamanı yapılandırması gerekiyorsa, lütfen aşağıdaki uyarılara dikkat edin:

  1. AdMob'u kullanıyorsanız ve başlangıçta önerilen şekilde reklamlar istiyorsanız, kaynak tabanlı yapılandırma yaklaşımını kullanmadığınızda mobil reklamlarla ilgili bazı Analytics verilerini kaçırabilirsiniz.
  2. Uygulamanızın her dağıtılmış varyantında yalnızca tek bir Google uygulama kimliği sağlayın. Örneğin, uygulamanızın 1. sürümünü yapılandırmada belirli bir GOOGLE_APP_ID ile gönderirseniz, ardından 2. sürümü farklı bir kimlikle yüklerseniz, bu, analiz verilerinin düşmesine neden olabilir.
  3. Çalışma zamanında farklı konfigürasyon sağlıyorsanız, Apple platformlarında GoogleService-Info.plist'i projenize eklemeyin, çünkü bu, GOOGLE_APP_ID belirgin bir şekilde değişmesine ve Analytics'in kaybolmasına neden olabilir.