Чтобы переводить контент на ваш предпочитаемый язык, Google использует технологии на основе искусственного интеллекта. Переводы от ИИ могут содержать ошибки.

Как настроить несколько проектов

На этой странице рассказывается, как использовать в приложении несколько проектов Firebase.

Для многих приложений достаточно одного проекта Firebase и настроек по умолчанию, описанных в руководствах Начало работы. Вот несколько примеров, когда может быть полезно использовать несколько проектов Firebase:

Настройка среды разработки для использования разных проектов Firebase в зависимости от типа сборки или целевой платформы.
Доступ к контенту из нескольких проектов Firebase в приложении.

Поддержка разных сред

Например, это может быть полезно, если вы хотите использовать разные проекты Firebase для разработки и рабочей среды.

Для настройки Web SDK и Admin SDK значения передаются непосредственно в их функции инициализации. Для этих SDK вы можете использовать проверку во время выполнения, чтобы выбрать переменные конфигурации разработки или производства.

Платформы Android и Apple (и их оболочки Unity и C++) обычно загружают конфигурацию из файла конфигурации: GoogleService-Info.plist на платформе Apple и google-services.json на Android. Эти файлы считываются в объект параметров (FIROption или FirebaseOptions), на который ссылается объект приложения Firebase (FIRApp или FirebaseApp).

Для этих платформ переключение между средами обычно реализуется как решение во время сборки за счет использования разных файлов конфигурации для каждой среды.

Как поддерживать несколько сред в приложении Apple

По умолчанию FirebaseApp.configure() загружает файл GoogleService-Info.plist, поставляемый вместе с приложением. Если среды разработки и рабочая среда настроены как отдельные цели в Xcode, вы можете:

Скачать оба файла (GoogleService-Info.plist)
Храните эти два файла в разных каталогах.
Добавьте оба файла в проект Xcode.
Свяжите разные файлы с разными целями с помощью панели Target Membership (Целевые объекты):

Панель "Целевая аудитория"

Если сборки являются частью одной цели, лучше всего дать обоим файлам конфигурации уникальные имена (например, GoogleService-Info-Free.plist и GoogleService-Info-Paid.plist). Затем выберите во время выполнения, какой plist-файл загрузить. Это показано в следующем примере:

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

Поддержка нескольких сред в приложении для Android

В проектах для Android файл конфигурации google-services.json преобразуется в строковые ресурсы Android с помощью плагина Gradle google-services. Подробнее о том, какие ресурсы создаются плагином…

Вы можете создать файл конфигурации google-services.json для каждого варианта сборки. Для этого поместите каждый файл конфигурации google-services.json в отдельный каталог, названный в честь каждого варианта, в корневом каталоге модуля приложения. Например, если у вас есть версии development и release, конфигурация может выглядеть так:

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

Подробнее о том, как добавить JSON-файл…

Затем эти ресурсы загружаются с помощью FirebaseInitProvider, который запускается перед кодом приложения и инициализирует API Firebase, используя эти значения.

Поскольку этот поставщик только считывает ресурсы с известными названиями, вы можете добавить строковые ресурсы непосредственно в приложение, а не использовать плагин google-services Gradle. Для этого:

Удалите плагин Gradle google-services из корневого каталога. build.gradle
Удаление файла конфигурации google-services.json из проекта
Добавление строковых ресурсов напрямую
Удаление apply plugin: 'com.google.gms.google-services' из приложения build.gradle

Как использовать несколько проектов в приложении

Иногда вам нужно получить доступ к разным проектам, используя одни и те же API, например к нескольким экземплярам базы данных. В большинстве случаев существует центральный объект приложения Firebase, который управляет конфигурацией для всех API Firebase. Этот объект инициализируется в рамках обычной настройки. Однако если вы хотите получить доступ к нескольким проектам из одного приложения, вам понадобится отдельный объект приложения Firebase для ссылки на каждый из них. Инициализировать эти экземпляры нужно самостоятельно.

В обоих случаях сначала нужно создать объект FirebaseOptions, который будет содержать данные конфигурации для приложения Firebase. Полную документацию по параметрам можно найти в справочной документации по API для следующих классов:

Swift: FirebaseOptions(googleAppID:gcmSenderID:)
Android: FirebaseOptions.Builder
Веб-версия: initializeApp().
C++: firebase::App::Create
Unity: FirebaseApp.Create
Node.js: initializeApp
Java: FirebaseOptions.Builder

Примеры использования этих классов для поддержки нескольких проектов в приложении приведены ниже.

Swift

// 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.clientID = "27992087142-ola6qe637ulk8780vl8mo5vogegkm23n.apps.googleusercontent.com"
secondaryOptions.databaseURL = "https://myproject.firebaseio.com"
secondaryOptions.storageBucket = "myproject.appspot.com"
secondaryOptions.deepLinkURLScheme = "myapp://"
secondaryOptions.storageBucket = "projectid-12345.appspot.com"
secondaryOptions.appGroupID = nilAppDelegate.swift

Kotlin

// 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()MainActivity.kt

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();MainActivity.java

Веб-приложение

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

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>");

Unity

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'
};index.js

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();

После инициализации этого объекта параметров вы можете использовать его для настройки дополнительного экземпляра приложения Firebase. Обратите внимание, что во всех примерах ниже используется строка secondary. Это название используется для получения экземпляра приложения и его отличия от других экземпляров, включая экземпляр по умолчанию (с названием [DEFAULT]). Выберите строку, соответствующую предполагаемому использованию другого проекта Firebase.

В следующих фрагментах кода показано, как подключиться к альтернативному Realtime Database (API для других функций Firebase работают по тому же принципу).

Swift

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

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


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

Kotlin

// Initialize secondary FirebaseApp.
Firebase.initialize(context = this, options, "secondary")

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

Java

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

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

Веб-приложение

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

C++

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

Unity

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();index.js

Java

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

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

Обеспечьте надежность отчетов для Analytics

Google Analytics собирает события на очень раннем этапе запуска приложения, иногда до того, как будет настроен основной экземпляр приложения Firebase. В таких случаях Firebase обращается к ресурсу Android или GoogleService-Info.plist на платформах Apple, чтобы найти правильный идентификатор приложения Google для хранения событий. Поэтому мы рекомендуем по возможности использовать методы настройки по умолчанию.

Если вам нужно настроить среду выполнения, обратите внимание на следующее:

Если вы используете AdMob и запрашиваете объявления при запуске, как рекомендуется, вы можете пропустить некоторые данные Аналитики, связанные с мобильной рекламой, если не используете подход к настройке на основе ресурсов.
В каждом распространяемом варианте приложения должен быть только один идентификатор приложения Google. Например, если вы выпустили версию 1 приложения с определенным значением GOOGLE_APP_ID в конфигурации, а затем загрузили версию 2 с другим идентификатором, это может привести к потере данных аналитики.
Если вы используете разные конфигурации во время выполнения, не добавляйте файл GoogleService-Info.plist в проект на платформах Apple. Это может привести к изменению GOOGLE_APP_ID и потере данных Аналитики.

Как настроить несколько проектов Оптимизируйте свои подборки Сохраняйте и классифицируйте контент в соответствии со своими настройками.

Поддержка разных сред

Как поддерживать несколько сред в приложении Apple

Поддержка нескольких сред в приложении для Android

Как использовать несколько проектов в приложении

Swift

Kotlin

Java

Веб-приложение

C++

Unity

Node.js

Java

Swift

Kotlin

Java

Веб-приложение

C++

Unity

Node.js

Java

Обеспечьте надежность отчетов для Analytics

Как настроить несколько проектов