Руководство по миграции Parse Server 6

В этом документе освещаются только конкретные изменения, требующие более подробного объяснения. Для получения полного списка изменений в Parse Server 6 обратитесь к списку изменений.

Несовместимый протокол git с Node 14

Parse Server 6 использует версию 2 файла блокировки пакета менеджера пакетов Node (npm). Хотя версия 2 должна быть обратно совместима с версией 1, вы всё равно можете столкнуться с ошибками из-за несовместимых протоколов git, которые не могут быть правильно интерпретированы npm, поставляемым с Node 14.

Если у вас возникают проблемы с установкой Parse Server на Node 14 из-за ссылок на зависимости в файле блокировки пакета с использованием протокола ssh, настройте git для использования протокола https:

sudo git config --system url."https://github".insteadOf "ssh://git@github"

Также можно вручную заменить URL-адреса зависимостей в файле блокировки пакетов.

⚠️ Также можно удалить файл блокировки пакетов и создать его заново с помощью Node 14. Имейте в виду, что при этом вы больше не используете официальную версию Parse Server. Вы можете использовать зависимости, которые не были протестированы как часть процесса выпуска Parse Server.

Оператор импорта

Синтаксис импорта и инициализации был упрощён с более интуитивным именованием и структурой.

Parse Server 5:

// Возвращает экземпляр Parse Server
const ParseServer = require('parse-server');

// Возвращает промежуточное ПО Parse Server express
const { ParseServer } = require('parse-server');

Parse Server 6:

// Оба возвращают экземпляр Parse Server
const ParseServer = require('parse-server');
const { ParseServer } = require('parse-server');

Чтобы получить промежуточное ПО в Parse Server 6, настройте экземпляр Parse Server, запустите Parse Server и используйте его свойство app. Подробнее см. в разделе «Асинхронная инициализация».

Асинхронная инициализация

Ранее можно было подключить Parse Server до того, как он полностью запустился и был готов принимать запросы. Это могло привести к неопределённому поведению, например, объекты Parse могли быть сохранены до регистрации облачного кода. Чтобы предотвратить это, Parse Server 6 необходимо запускать асинхронно перед подключением.

Parse Server 5:

// 1. Импортировать Parse Server
const { ParseServer } = require('parse-server');

// 2. Создать экземпляр Parse Server как промежуточное ПО express
const server = new ParseServer(config);

// 3. Подключить промежуточное ПО
app.use("/parse", server);

Parse Server 6:

// 1. Импортировать Parse Server
const ParseServer = require('parse-server');

// 2. Создать экземпляр Parse Server
const server = new ParseServer(config);

// 3. Запустить Parse Server асинхронно
await server.start();

// 4. Подключить промежуточное ПО
app.use("/parse", server.app);