Установите, настройте и интегрируйте пакет локального эмулятора.

Пакет Firebase Local Emulator Suite можно установить и настроить для различных сред прототипирования и тестирования: от разовых сеансов прототипирования до рабочих процессов непрерывной интеграции в производственном масштабе.

Установите пакет локального эмулятора

Перед установкой Emulator Suite вам потребуется:

• Node.js версии 16.0 или выше.
• Java JDK версии 11 или выше.

Чтобы установить пакет эмулятора:

1. Установите Firebase CLI . Если у вас еще не установлен Firebase CLI, установите его сейчас . Для использования Emulator Suite вам понадобится CLI версии 8.14.0 или выше. Проверить, какая версия у вас установлена, можно с помощью следующей команды:

   firebase --version

2. Если вы еще этого не сделали, инициализируйте текущий рабочий каталог как проект Firebase, следуя инструкциям на экране, чтобы указать, какие продукты использовать:

   firebase init

3. Настройте пакет эмулятора. Эта команда запускает мастер настройки, который позволяет выбрать интересующие эмуляторы, загрузить соответствующие двоичные файлы эмулятора и установить порты эмулятора, если значения по умолчанию не подходят.

   firebase init emulators

После установки эмулятора проверки обновлений не выполняются и дополнительные автоматические загрузки не выполняются, пока вы не обновите версию Firebase CLI.

Настройка пакета эмулятора

При желании вы можете настроить сетевые порты эмуляторов и путь к определениям правил безопасности в файле firebase.json :

• Измените порты эмулятора, запустив firebase init emulators или отредактировав файл firebase.json вручную.
• Измените путь к определениям правил безопасности, отредактировав файл firebase.json вручную.

Если вы не настроите эти параметры, эмуляторы будут прослушивать свои порты по умолчанию, а эмуляторы Cloud Firestore , Realtime Database и Cloud Storage for Firebase будут работать с открытой защитой данных.

Конфигурация порта

Каждый эмулятор привязывается к отдельному порту на вашем компьютере с предпочтительным значением по умолчанию.

Конфигурация идентификатора проекта

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

Обычно рекомендуется устанавливать один идентификатор проекта для всех вызовов эмулятора, чтобы Emulator Suite UI , различные эмуляторы продуктов и все запущенные экземпляры определенного эмулятора могли корректно взаимодействовать во всех случаях.

Local Emulator Suite выдает предупреждения при обнаружении нескольких идентификаторов проектов в среде, хотя вы можете переопределить это поведение, установив для ключа singleProjectMode значение false в файле firebase.json .

Вы можете проверить декларации идентификаторов проектов на предмет несоответствий:

• Проект по умолчанию в командной строке. По умолчанию идентификатор проекта будет взят при запуске из проекта, выбранного с помощью firebase init или firebase use . Чтобы просмотреть список проектов (и посмотреть, какой из них выбран), используйте firebase projects:list .
• Правила модульных тестов. Идентификатор проекта часто указывается при вызовах методов библиотеки Rules Unit Testing initializeTestEnvironment или initializeTestApp .
• Флаг командной строки --project . Передача флага Firebase CLI --project переопределяет проект по умолчанию. Вам необходимо убедиться, что значение флага соответствует идентификатору проекта в модульных тестах и ​​инициализации приложения.

Также проверьте конфигурации идентификаторов проектов для конкретной платформы, которые вы установили при настройке платформ Apple , Android и веб- проектов.

Настройка правил безопасности

Эмуляторы будут использовать конфигурацию правил безопасности из ключей конфигурации database , firestore и storage в firebase.json .

{
  // Existing firebase configuration ...
  "database": {
    "rules": "database.rules.json"
  },
  "firestore": {
    "rules": "firestore.rules"
  },
  "storage": {
    "rules": "storage.rules"
  }

  // ...

  // Optional emulator configuration. Default
  // values are used if absent.
  "emulators": {
    "singleProjectMode": false, // do not warn on detection of multiple project IDs
    "firestore": {
      "port": "8080"
    },
    "ui": {
      "enabled": true,      // Default is `true`
      "port": 4000          // If unspecified, see CLI log for selected port
    },
    "auth": {
      "port": "9099"
    },
    "pubsub": {
      "port": "8085"
    }
  }
}

Указание параметров Java

Эмулятор Realtime Database , эмулятор Cloud Firestore и часть эмулятора Cloud Storage for Firebase основаны на Java, которую можно настроить с помощью флагов JVM через переменную среды JAVA_TOOL_OPTIONS .

Например, если у вас возникли ошибки, связанные с пространством кучи Java, вы можете увеличить максимальный размер кучи Java до 4 ГБ:

export JAVA_TOOL_OPTIONS="-Xmx4g"
firebase emulators:start

Несколько флагов можно указать в кавычках, разделенных пробелами, например JAVA_TOOL_OPTIONS="-Xms2g -Xmx4g" . Флаги влияют только на компоненты эмуляторов на основе Java и не влияют на другие части интерфейса командной строки Firebase , такие как Emulator Suite UI .

Запуск эмуляторов

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

Метод firebase emulators:exec обычно более подходит для рабочих процессов непрерывной интеграции.

Экспорт и импорт данных эмулятора

Вы можете экспортировать данные из эмуляторов Authentication , Cloud Firestore , Realtime Database и Cloud Storage for Firebase чтобы использовать их в качестве совместно используемого общего базового набора данных. Эти наборы данных можно импортировать с помощью флага --import , как описано выше.

Интеграция с вашей CI-системой

Запуск контейнерных образов Emulator Suite

Установка и настройка Emulator Suite с контейнерами в типичной конфигурации CI не вызывает затруднений.

Следует отметить несколько проблем:

• Файлы JAR устанавливаются и кэшируются в ~/.cache/firebase/emulators/ .

  • Возможно, вы захотите добавить этот путь в конфигурацию кэша CI, чтобы избежать повторных загрузок.

• Если в вашем репозитории нет файла firebase.json , вам необходимо добавить аргумент командной строки к emulators:start или emulators:exec чтобы указать, какие эмуляторы следует запустить. Например,
  --only functions,firestore .

Создайте токен аутентификации (только для эмулятора хостинга)

Если ваши рабочие процессы непрерывной интеграции основаны на Firebase Hosting , вам нужно будет войти в систему, используя токен, чтобы запустить firebase emulators:exec . Другие эмуляторы не требуют входа в систему.

Чтобы сгенерировать токен, запустите firebase login:ci в своей локальной среде; это не следует выполнять из системы CI. Следуйте инструкциям для аутентификации. Вам нужно выполнить этот шаг только один раз для каждого проекта, поскольку токен будет действителен для всех сборок. Токен следует рассматривать как пароль; убедитесь, что это хранится в секрете.

Если ваша среда CI позволяет вам указывать переменные среды, которые можно использовать в сценариях сборки, просто создайте переменную среды с именем FIREBASE_TOKEN , значением которой будет строка токена доступа. Интерфейс командной строки Firebase автоматически получит переменную среды FIREBASE_TOKEN , и эмуляторы запустятся правильно.

В крайнем случае, вы можете просто включить токен в свой сценарий сборки, но убедитесь, что посторонние лица не имеют доступа. Для этого жестко запрограммированного подхода вы можете добавить --token "YOUR_TOKEN_STRING_HERE" к команде firebase emulators:exec .

Используйте REST API Emulator Hub.

Список запущенных эмуляторов

Чтобы получить список запущенных в данный момент эмуляторов, отправьте запрос GET в конечную точку /emulators концентратора эмуляторов.

curl localhost:4400/emulators

Результатом будет объект JSON со списком всех запущенных эмуляторов и их конфигурацией хоста/порта, например:

{
  "hub":{
    "name": "hub",
    "host": "localhost",
    "port": 4400
  },
  "functions": {
    "name": "functions",
    "host": "localhost",
    "port": 5001
  }
  "firestore": {
    "name": "firestore",
    "host": "localhost",
    "port": 8080
  }
}

Включить/отключить триггеры фоновых функций

В некоторых ситуациях вам потребуется временно отключить триггеры локальных функций и расширений. Например, вы можете захотеть удалить все данные в эмуляторе Cloud Firestore без запуска каких-либо функций onDelete , которые выполняются в эмуляторах Cloud Functions или Extensions .

Чтобы временно отключить триггеры локальных функций, отправьте запрос PUT в конечную точку /functions/disableBackgroundTriggers концентратора эмулятора.

curl -X PUT localhost:4400/functions/disableBackgroundTriggers

Результатом будет объект JSON с подробным описанием текущего состояния.

{
  "enabled": false
}

Чтобы включить триггеры локальных функций после их отключения, отправьте запрос PUT в конечную точку /functions/enableBackgroundTriggers концентратора эмулятора.

curl -X PUT localhost:4400/functions/enableBackgroundTriggers

Результатом будет объект JSON с подробным описанием текущего состояния.

{
  "enabled": true
}

Интеграция SDK эмулятора

В таблицах в этом разделе указано, какие эмуляторы поддерживаются пакетами SDK клиента и администратора. Будущее означает, что поддержка эмулятора запланирована, но пока недоступна.

Доступность клиентского SDK

Доступность административного SDK