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