В этом кратком руководстве я покажу вам, как инициализировать базу данных Firestore в VS Code с помощью JavaScript. В этом проекте предполагается, что вы знакомы с командами терминала, GitHub, JavaScript ES6 и Visual Studio Code.

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

Для начала перейдите на https://www.firebase.com и войдите в свою учетную запись Google. Нажмите кнопку Начать на баннере героя. Оттуда нажмите Добавить проект.

Затем Firebase попросит вас создать имя для вашего нового проекта:

Имя вашего проекта будет уникальным идентификатором, который будет использоваться для доступа к вашему проекту во всех Firebase и Google Cloud. Сделайте это оригинально!

На следующей странице для целей этого руководства и настройки вашей первой базы данных вы можете переключить Google Analytics в положение «Выкл.»:

На следующем экране нажмите «Создать проект», и как только Google завершит его инициализацию (это может занять несколько минут), нажмите «Продолжить», чтобы перейти на страницу «Обзор проекта».

В левом верхнем углу обзорной страницы выберите «Сборка», чтобы открыть раскрывающееся меню, а затем «База данных Firestore»:

На следующей странице нажмите кнопку «Создать базу данных», затем «Далее». Это приведет вас к меню местоположения сервера, выберите тот, который вам подходит, из выпадающего меню:

Создание папки проекта на вашем компьютере:

Теперь, когда ваша база данных создана, оставьте эту вкладку открытой в веб-браузере и переключитесь на свой терминал, чтобы начать настройку папки проекта на вашем компьютере:

На следующем шаге мы собираемся настроить наш .gitignore в VS Code, прежде чем мы начнем импортировать наши файлы — вы скоро поймете, почему.

Создайте файл .gitignore и добавьте следующие две строки:

Затем вернитесь к своему терминалу, чтобы завершить настройку папки проекта с необходимыми библиотеками, используя следующие команды:

git init
npm init -y
npm install firebase-admin

Вернитесь в свой веб-браузер и щелкните значок шестеренки рядом с Обзором проекта в левом верхнем углу, затем выберите «Пользователи и разрешения»:

На следующей странице перейдите на вкладку «Учетные записи служб», прокрутите вниз и сгенерируйте новый закрытый ключ (убедитесь, что выбран node.js):

Как только ваш ключ будет загружен, это будет файл JSON с длинным автоматически сгенерированным именем. Перетащите его в папку проекта в VS Code и переименуйте в «credentials.js» в Проводнике:

Теперь вы готовы начать добавлять код!

Инициализация вашей базы данных в VS Code:

Сначала перейдите к файлу package.json и добавьте "type":"module", , как показано ниже:

Затем откройте файл учетных данных.js и оберните весь блок кода в

default export{}

Теперь также было бы неплохо перепроверить, игнорирует ли учетные данные.js ваш .gitignore — в противном случае вы будете публиковать свой закрытый ключ в GitHub всякий раз, когда будете нажимать.

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

import admin from "firebase-admin"; // imports library from npm install
import serviceAccount  from './credentials.js' //import credentials, assign to variable
admin.initializeApp({
  credential: admin.credential.cert(serviceAccount) //create certificate from creds
});
const db = admin.firestore(); //assigns your firestore db to a variable
export const myCollection = db.collection('myCollection') //initializes your first collection!

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