Перейти к основному содержимому

Подключение к Firebase

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

Создание нового проекта Firebase из FlutterFlow

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

Шаг 1: Настройка вашего проекта

Перейдите в Settings & Integrations > Project Setup > Firebase в FlutterFlow, чтобы начать.

Шаг 2: Выбор региона

Нажмите + Create Project. Появится всплывающее окно, где вы сможете подтвердить имя вашего проекта и выбрать регион Firebase, который лучше всего подходит для ваших пользователей.

Шаг 3: Подключение учетной записи Google

Выберите Create или Sign in with Google, чтобы связать вашу учетную запись Firebase. Если потребуется, вы должны предоставить доступ, запрошенный от 'flutterflow.io', чтобы можно было создать и настроить проект Firebase от вашего имени. Здесь вы можете Select all и нажать Continue.

Предупреждение Firebase

После запуска FlutterFlow выполнит остальную часть создания проекта в фоновом режиме.

Вот краткий обзор процесса:

Как только процесс завершится, в панели Firebase Settings вы увидите следующее представление.

Проект Firebase создан

Включение аутентификации Firebase

Если вы хотите использовать аутентификацию Firebase в вашем приложении или Firebase Content Manager, вы должны включить аутентификацию в консоли Firebase и активировать вход по 'Email/Password'.

Включение хранилища Firebase

Если вы планируете использовать хранилище Firebase в вашем приложении, нажмите Enable Storage on Firebase и включите его в консоли Firebase.

Скачивание файлов конфигурации Firebase

Файлы конфигурации необходимы при подключении к Firebase. Они содержат различные настройки и ключи, которые позволяют вашему проекту взаимодействовать с сервисами Firebase. Чтобы сгенерировать эти файлы, нажмите Auto Generate Config Files, а затем Generate Files.

Ручное подключение существующего проекта Firebase

Если у вас уже есть проект Firebase и вы хотите подключить его к текущему проекту FlutterFlow, перейдите в Settings & Integrations > Project Setup > Firebase и нажмите на Firebase Setup Wizard. Появится всплывающее диалоговое окно. Следуйте этим шагам:

Настройка Firebase

В диалоге прокрутите вниз до Setup Firebase, отметьте этот вариант и нажмите Next Step. Откроется вторая страница диалога. Перед заполнением дополнительной информации вам нужно разрешить FlutterFlow доступ к вашему проекту Firebase. Следующий раздел проведет вас через этот процесс.

Разрешение доступа FlutterFlow к вашему проекту

  1. Перейдите в консоль Firebase вашего существующего проекта, перейдите в меню слева и выберите Project Settings -> Users and Permissions.

  2. Выберите Add Member в правом верхнем углу.

  3. Добавьте firebase@flutterflow.io в качестве "Editor" для вашего проекта и выберите Done. Затем нажмите Add Member. firebase-add-member.png

  4. На той же странице (т.е. Users and Permissions) выберите Advanced Permission Settings (небольшой синий текст под таблицей). Это откроет консоль Google Cloud в новом окне браузера.

Шаги 2, 3 и 4
  1. Найдите строку, содержащую firebase@flutterflow.io, и выберите Edit principal (карандаш в правой части строки).
На странице консоли Google Cloud
  1. Выберите + Add Another Role.

  2. В разделе Select A Role найдите Service Account User (возможно, потребуется прокрутить). Выберите Service Account User.

При выборе Select A Role и поиске Service Account User
  1. Снова выберите + Add Another Role. В разделе Select A Role найдите Cloud Functions Admin. Выберите Cloud Functions Admin.
к сведению

Примечание: Опция добавления Cloud Functions Admin может отображаться только если вы используете план Firebase Blaze. Кроме того, вам может потребоваться сначала включить cloud functions. Разрешения Cloud Functions Admin требуются для нескольких функций FlutterFlow (например, Push Notifications). Добавление Cloud Functions Admin необязательно, но без него вы не сможете использовать функции, требующие Cloud Functions.

Подключение и автоматическая генерация файлов

  1. Из панели Firebase вашего проекта перейдите в меню слева и выберите Project Settings.

  2. В разделе Your Project найдите Project ID, щелкните по нему правой кнопкой мыши и скопируйте.

  3. Вернитесь в FlutterFlow, введите ID вашего проекта Firebase в диалоге и нажмите Connect. После успешного подключения появится зеленая галочка.

  4. В разделе Config Files выберите Generate Config Files, а затем Generate Files.

к сведению

Не закрывайте и не обновляйте страницу во время генерации файлов.

Подключение к Firebase при создании нового проекта FlutterFlow

Если вы знаете, что будете интегрировать Firebase при создании проекта, вы можете сделать следующее:

Шаг 1: Создание нового проекта и включение Firebase

Сначала создайте новый проект и при этом оставьте опцию Setup Firebase включенной, затем нажмите Next Step.

Включение Firebase при создании проекта

Шаг 2: Подключение к Firebase

Если вы хотите, чтобы FlutterFlow создал проект Firebase для вас, нажмите "+ Create Project" и следуйте соответствующим шагам. В качестве альтернативы, если вы хотите вручную подключить существующий проект Firebase, следуйте ручным шагам здесь.

Шаг 3: Включение аутентификации

Включите Enable Authentication, чтобы позволить пользователям входить в ваше приложение с помощью различных методов входа, включая email и пароль, провайдеры социальных сетей и даже номер телефона.

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

Включение аутентификации при создании проекта

Включение Firestore для доступа к базе данных

Если вы планируете использовать Firestore Database в качестве бэкенда, следуйте этим дополнительным шагам, чтобы включить Firestore. Это позволит вам создавать коллекции и добавлять документы непосредственно из FlutterFlow.

Чтобы настроить Firestore Database:

  1. Из панели Firebase вашего проекта перейдите в меню слева. В разделе Build выберите Firestore Database, а затем Create Database (отмечено желтым на скриншоте).
Включение Firestore Database
  1. Далее вам потребуется установить правила безопасности Firebase. Чтобы быстро начать, вы можете выбрать Start in test mode и нажать Next.
Правила безопасности Firebase
к сведению

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

  1. Далее вам потребуется выбрать место, где будет храниться данные Firestore. Из выпадающего списка выберите расположение, а затем нажмите Enable. Дополнительную информацию о расположениях Firebase см. по этой ссылке.
Выбор расположения Firestore

После завершения вы попадете на панель Cloud Firestore и сможете сразу начать создание коллекций и документов!

Добавление индексов

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

Мы создаем индексы за вас. Все, что вам нужно сделать, — развернуть их в вашей базе данных Firestore.

Вот шаги для развертывания индексов.

  • Нажмите на Firestore в Navigation Menu (слева на экране).
  • Переключитесь на вкладку Settings.
  • Прокрутите вниз до раздела Firestore Indexes и нажмите Deploy.
Пожалуйста, обратите внимание

Если вы добавите фильтрацию/сортировку к запросу или измените существующие настройки фильтрации/сортировки, вам следует снова развернуть индексы Firestore.

Включение биллинга

Если вы хотите развернуть Cloud Functions (например, платежи Braintree, Push Notifications) или использовать Firebase Cloud Storage, вам потребуется включить биллинг для вашего проекта Firebase. Следуйте этим шагам, чтобы включить биллинг:

  1. Из панели Firebase вашего проекта перейдите в меню слева. В разделе Build выберите Functions, а затем Upgrade project.

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

Включение биллинга