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:
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ökbuild.gradle
-
google-services.json
dosyasını projenizden silme - Dize kaynaklarını doğrudan ekleme
- Uygulama
apply plugin: 'com.google.gms.google-services'
uygulamanızınbuild.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:
- Swift:
FirebaseOptions(googleAppID:gcmSenderID:)
- Android:
FirebaseOptions.Builder
- Web:
initializeApp()
- C++:
firebase::App::Create
- Birlik:
FirebaseApp.Create
- Node.js:
initializeApp
- Java:
FirebaseOptions.Builder
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()
ağ
// 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)
ağ
// 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:
- 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.
- 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. - Ç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.