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

Пакет 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, базы данных реального времени и облачного хранилища для Firebase будут работать с открытой защитой данных.

Команда Описание
эмуляторы инициализации Запустите мастер инициализации эмулятора. Определите эмуляторы, которые необходимо установить, и при необходимости укажите настройки порта эмулятора. init emulators не являются разрушительными; принятие значений по умолчанию сохранит текущую конфигурацию эмулятора.

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

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

Эмулятор Порт по умолчанию
Аутентификация 9099
Пользовательский интерфейс пакета эмулятора 4000
Облачные функции 5001
Эвентарк 9299
База данных реального времени 9000
Облачный пожарный магазин 8080
Облачное хранилище для Firebase 9199
Хостинг Firebase 5000
Паб/Саб 8085

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

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

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

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

Эмулятор базы данных реального времени, эмулятор 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.

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

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

Команда Описание
эмуляторы:старт Запустите эмуляторы продуктов Firebase, настроенных в firebase.json . Процессы эмулятора будут продолжать работать до тех пор, пока они не будут явно остановлены. Вызов emulators:start загрузит эмуляторы в ~/.cache/firebase/emulators/, если они еще не установлены.
Флаг Описание
--only Необязательный. Ограничьте запуск эмуляторов. Укажите список имен эмуляторов, разделенных запятыми, указав одно или несколько из «auth», «database», «firestore», «functions», «hosting» или «pubsub».
--inspect-functions debug_port Необязательный. Используйте с эмулятором Cloud Functions, чтобы включить отладку функций с помощью точки останова на указанном порту (или порте по умолчанию 9229, если аргумент опущен). Обратите внимание, что при указании этого флага эмулятор Cloud Functions переключается в специальный сериализованный режим выполнения, в котором функции выполняются в одном процессе в последовательном порядке (FIFO); это упрощает отладку функций, хотя поведение отличается от многопроцессного параллельного выполнения функций в облаке.
--export-on-exit= Необязательный. Используйте с эмулятором аутентификации, Cloud Firestore, базы данных реального времени или облачного хранилища для Firebase. Укажите эмуляторам экспортировать данные в каталог при завершении работы, как описано для команды emulators:export . Каталог экспорта можно указать с помощью этого флага: firebase emulators:start --export-on-exit=./saved-data . Если используется --import , путь экспорта по умолчанию тот же; например: firebase emulators:start --import=./data-path --export-on-exit . Наконец, если хотите, передайте разные пути к каталогам флагам --import и --export-on-exit .
--import= import_directory Необязательный. Используйте с эмулятором аутентификации, Cloud Firestore, базы данных реального времени или облачного хранилища для Firebase. Импортируйте данные, сохраненные с помощью параметра запуска --export-on-exit или команды emulators:export , в работающий экземпляр эмулятора аутентификации, Cloud Firestore, базы данных реального времени или облачного хранилища для Firebase. Любые данные, находящиеся в настоящее время в памяти эмулятора, будут перезаписаны.
эмуляторы: scriptpath exec Запустите скрипт по scriptpath после запуска эмуляторов продуктов Firebase, настроенных в firebase.json . Процессы эмулятора автоматически остановятся после завершения работы сценария.
Флаг Описание
--only Необязательный. Ограничьте запуск эмуляторов. Укажите список имен эмуляторов, разделенных запятыми, указав одно или несколько из «firestore», «базы данных», «функций», «хостинга» или «pubsub».
--inspect-functions debug_port Необязательный. Используйте с эмулятором Cloud Functions, чтобы включить отладку функций с помощью точки останова на указанном порту (или порте по умолчанию 9229, если аргумент опущен). Обратите внимание, что при указании этого флага эмулятор Cloud Functions переключается в специальный сериализованный режим выполнения, в котором функции выполняются в одном процессе в последовательном порядке (FIFO); это упрощает отладку функций, хотя поведение отличается от многопроцессного параллельного выполнения функций в облаке.
--export-on-exit= Необязательный. Используйте с эмулятором аутентификации, Cloud Firestore, базы данных реального времени или облачного хранилища для Firebase. Укажите эмуляторам экспортировать данные в каталог при завершении работы, как описано для команды emulators:export . Каталог экспорта можно указать с помощью этого флага: firebase emulators:start --export-on-exit=./saved-data . Если используется --import , путь экспорта по умолчанию тот же; например: firebase emulators:start --import=./data-path --export-on-exit . Наконец, если хотите, передайте разные пути к каталогам флагам --import и --export-on-exit .
--import= import_directory Необязательный. Используйте с эмулятором аутентификации, Cloud Firestore, базы данных реального времени или облачного хранилища для Firebase. Импортируйте данные, сохраненные с помощью параметра запуска --export-on-exit или команды emulators:export , в работающий экземпляр эмулятора аутентификации, Cloud Firestore, базы данных реального времени или облачного хранилища для Firebase. Любые данные, находящиеся в настоящее время в памяти эмулятора, будут перезаписаны.
--ui Необязательный. Запустите пользовательский интерфейс эмулятора во время выполнения.

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

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

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

эмуляторы: экспорт export_directory

Аутентификация, Cloud Firestore, база данных реального времени или облачное хранилище для эмулятора Firebase . Экспортируйте данные из работающего экземпляра эмулятора Cloud Firestore, базы данных реального времени или облачного хранилища для Firebase. Указанный export_directory будет создан, если он еще не существует. Если указанный каталог существует, вам будет предложено подтвердить, что предыдущие данные экспорта должны быть перезаписаны. Вы можете пропустить это приглашение, используя флаг --force . Каталог экспорта содержит файл манифеста данных firebase-export-metadata.json .

Вы можете указать эмуляторам автоматически экспортировать данные при их завершении, используя флаги --export-on-exit описанные выше.

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

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

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

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

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

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

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

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

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

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

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

Используйте REST API эмулятора 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

Андроид платформы Apple Интернет Пользовательский интерфейс Firebase
Андроид
Пользовательский интерфейс Firebase
iOS
Пользовательский интерфейс Firebase
Интернет
База данных реального времени 19.4.0 7.2.0 8.0.0 6.4.0 Будущее Н/Д
Облачный пожарный магазин 21.6.0 7.2.0 8.0.0 6.4.0 Будущее Н/Д
Аутентификация 20.0.0 7.0.0 8.0.0 7.0.0 Будущее 4.7.2
Облачное хранилище для Firebase 20.0.0 8.0.0 8.4.0 7.0.0 11.0.0 Н/Д
Облачные функции 19.1.0 7.2.0 8.0.0 Н/Д Н/Д Н/Д
Хостинг Н/Д Н/Д Н/Д Н/Д Н/Д Н/Д
Расширения Н/Д Н/Д Н/Д Н/Д Н/Д Н/Д

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

Узел Джава Питон Идти
База данных реального времени 8.6.0 6.10.0 2.18.0 Будущее
Облачный пожарный магазин 8.0.0 6.10.0 3.0.0 1.0.0
Аутентификация 9.3.0 7.2.0 5.0.0 4.2.0
Облачное хранилище для Firebase 9.8.0 Будущее Будущее Будущее
Облачные функции Н/Д Н/Д Н/Д Н/Д
Хостинг Н/Д Н/Д Н/Д Н/Д
Расширения Н/Д Н/Д Н/Д Н/Д