Как быстро запустить VK Mini Apps на React: гайд для новичков
Vk mini apps. Быстрый старт с React. Как настроить сервер и клиент с vk-bridge.
327 открытий3К показов
Хотите расширить аудиторию своего приложения или игры, интегрировав их прямо в экосистему ВКонтакте? VK Mini Apps — удобный способ создать мини-приложение, которое станет частью социальной сети или даже самостоятельным продуктом внутри нее. Платформа предлагает комфортную среду разработки, обширную документацию и дополнительные бонусы, например, продвижение через каталог.
Я пробовал запускать как приложения, так и игры, и теперь хочу поделиться своим опытом. В этом гайде я расскажу, как быстро разобраться с платформой и библиотекой для VK Mini Apps, чтобы вы могли запустить свой проект без лишних сложностей.
Настраиваем Mini Apps
Для начала регистрируем наше мини-приложение в vk. Разворачиваем с помощью create-react-app или vite, разницы особо не будет.
Далее устанавливаем библиотеки от vk. Нам точно понадобится vk-bridge, а остальные не обязательны, но могут подойти для ui.
Для локальной разработки нам нужно подключить https в package.json без сертификатов.
Далее указываем локальный адрес, где мы будем разрабатывать приложение. В принципе можно делать это и локально вне платформы, если приложению не требуется общение с vk через мост. Но это довольный редкий кейс. Так что в кабинете разработчика в пункте Размещение вставляем наш айпи адрес и порт выше. Такое проворачиваем для всех типов приложения: десктоп, мобильное приложение, мобильный сайт.
Теперь запустим в хроме наш адрес и подтвердим, что мы согласны с угрозой https без сертификата. Далее можем переходить и разрабатывать в самом vk.
Настраиваем Vk bridge
В index.ts инициализируем библиотеку перед рендером приложения.
Теперь мы можем использовать все события из документации. Например, при старте приложения запрашивать информацию о юзере, используя отдельный хук.
Если у вас есть взаимодействие с сервером, то нужно валидировать юзера на сервере с vk параметрами, переданными клиентом, и только потом отдавать jwt token. То есть хранить токены в localStorage запрещено.
На клиенте мы запрашиваем параметры приложения и передаем их на сервер. Так это может выглядеть в саге:
На сервере валидируем ответ с помощью функции от vk и нашего секретного ключа из кабинета разработчика. Если все прошло без ошибок — это валидный юзер. Теперь мы можем дальше обмениваться с помощью уже нашего jwt в заголовке, пока юзер не закроет приложение, и тогда повторим все заново.
Ну вот и вся база для первых шагов с библиотекой. Удачных мини приложений!
327 открытий3К показов




