Пакеты
Наборы для старта & SDK демонстрации
Копировать страницу
Создайте приложение Lia с пошаговой настройкой терминала, входом, одобренным браузером, и автоматической регистрацией приватного приложения. Выберите из девяти интеграций фреймворков.
#Создать проект
npm create @lia-labs/app@latestLia Developer Studio проведет вас через ваш проект, фреймворк, стартовый файл, настройку и учетную запись. Используйте клавиши со стрелками, чтобы выбрать ваш фреймворк и Стартап или SDK площадка. Рекомендуется настройки включают локальное моделирование в браузере и установку зависимостей с помощью менеджера пакетов, который вы используете. Настроить позволяет изменить публичное приложение ID, менеджер пакетов, локальную симуляцию и предпочтения установки. Настройка проверяет ваш каталог перед созданием файлов, показывает ход установки и выводит команды восстановления, если установка не удалась. Нажмите Ctrl+C, чтобы отменить. Существующие непустые папки никогда не перезаписываются.
Используйте поддерживаемую версию Node LTS: рекомендуется Node 22.12+ или 24+. Стартовые проекты выбирают версии фреймворков, совместимые с текущими привязками Lia, включая Preact 10 и Solid 1.
cd my-lia-app
npm install
npm run devПропустить npm install если установлены зависимости. Используйте соответствующие команды для вашего выбранного менеджера пакетов.
#Подключите ваш аккаунт Lia
После создания файлов выберите Подключить & зарегистрировать чтобы открыть Lia Developers в браузере. Войдите в свою учетную запись Lia, сравните код, отображаемый в терминале, и одобрите запрос. Ваше приложение создается как частный тестовый список на вашей панели разработчика. Выберите Продолжайте разработку локально, или пропустить --local, чтобы зарегистрироваться позже.
npx @lia-labs/create-app@latest login
npx @lia-labs/create-app@latest whoami
npx @lia-labs/create-app@latest appsУже есть сгенерированный проект? Зарегистрируйте его из каталога проекта:
npx @lia-labs/create-app@latest register --name "My game" --kind gameВы также можете создать и зарегистрировать всё в одной команде:
npm create @lia-labs/app@latest my-game -- --framework react --template demo --register --kind gameРегистрация не требует хостинга. Пока вы не добавите развернутый HTTPS URL в панели управления, открытие списка показывает место для настройки. Используйте --url https://your-app.example при регистрации, если хостинг готов. Регистрация приложения ID, которое вы уже владеете, связывает проект с этим списком без его редактирования; ID, принадлежащий другому человеку, отклоняется. Управляйте изменениями URL, изображением, тестерами и отзывами на панели управления.
Публичное приложение ID сохраняется в lia.config.json и сгенерированной конфигурации фреймворка. Регистрация добавляет информацию о панели мониторинга и имени хоста в этот файл. Учетные данные учетной записи хранятся отдельно на вашем компьютере; они никогда не записываются в проект или в сгенерированный код браузера.
Код подтверждения браузера истекает через десять минут. Доступ через терминал длится до тридцати дней и может отображать ваши приложения, создавать приватные тестовые списки и подключать локальные предварительные просмотры к вашим приватным тестовым приложениям. Он не может публиковать приложения, читать серверные ключи или производить выплаты. Используйте Подключенные терминалы на панели управления, чтобы немедленно отозвать терминал, или выйти из командной строки:
npx @lia-labs/create-app@latest logoutОдобрять можно только код, который вы сами начали. Существующие требования к доступу разработчика по-прежнему действуют; вход в терминал не обходит процесс приглашения. Если браузер не может открыться автоматически, используйте login --no-browser и открыть напечатанную ссылку самостоятельно. Отклоненные или истекшие запросы можно повторить с помощью login.
#Предварительно просмотрите локальное приложение внутри Lia
Из вашего зарегистрированного проекта выполните:
npx @lia-labs/create-app@latest devСервис CLI запускает сервер разработки вашего фреймворка, открывает временный Cloudflare Туннель и подключает его к вашему приватному тестовому списку. Откройте приложение снова в Lia при Приложения → Тестирование. Дальнейшие изменения используют живую перезагрузку вашего фреймворка, поэтому вы можете продолжать тестировать приложения на телефоне, изменяя локальные файлы. Не требуется Cloudflare аккаунт или DNS настройка.
Если Cloudflare Tunnel не установлен, Lia загружает официальный помощник в кэш пользователя и проверяет контрольную сумму выпуска перед запуском. Он не устанавливает фоновую службу. Выберите другой порт с --port 4201, или менеджер пакетов с --pm pnpm.
Панель в режиме реального времени показывает ваш локальный сервер, HTTPS туннель и подключенное приложение Lia. Нажмите o открыть ссылку на приложение, d для своей панели управления, или q / Ctrl+C to stop. Existing terminal grants need one new browser approval for local preview access.
Ваш постоянный Page URL остается неизменным. Остановка удаляет соединение предварительного просмотра, и утерянный терминал истекает через две минуты. Локальные предварительные просмотры работают только с приватными тестовыми приложениями и не могут заменить живое приложение. Разверните постоянное HTTPS хостинг до подачи на проверку.
Временный туннель URL доступен для любого, кто его имеет, в то время как список Lia остается ограниченным для существующих тестировщиков. Не включайте производственные секреты и приватные данные клиентов в локальные предварительные просмотры. Быстрые туннели — это инфраструктура разработки без гарантии доступности.
#Настройки терминала
Интерфейс адаптируется к меньшим терминалам. Установите NO_COLOR=1 для обычных цветов, LIA_NO_MOTION=1 чтобы уменьшить анимацию прогресса, или ACCESSIBLE=1 для стандартных текстовых подсказок. CI и перенаправленный вывод остаются неизменными. CLI сообщает о реальных шагах настройки, а не о моделируемом проценте.
#Выберите фреймворк
| Фреймворк | Команда | Lia интеграция |
|---|---|---|
| Обычный TypeScript | npm create @lia-labs/app@latest my-app -- --framework vanilla | Типизированные вызовы SDK и наблюдаемое состояние. |
| React | npm create @lia-labs/app@latest my-app -- --framework react | useInit, usePlayer, useLanguage, useMainButton. |
| Preact | npm create @lia-labs/app@latest my-app -- --framework preact | Хуки Preact и привязки Lia Preact. |
| Vue | npm create @lia-labs/app@latest my-app -- --framework vue | Композабели, ссылки и очистка компонентов. |
| Svelte | npm create @lia-labs/app@latest my-app -- --framework svelte | Хранилища Svelte и компонентно-ограниченные элементы управления. |
| Твердый | npm create @lia-labs/app@latest my-app -- --framework solid | Аксессоры, createInit и createMainButton. |
| Angular | npm create @lia-labs/app@latest my-app -- --framework angular | Отдельное приложение Angular с встроенными сигналами. |
| Веб-компоненты | npm create @lia-labs/app@latest my-app -- --framework elements | <lia-app>, <lia-main-button> и типизированный SDK. |
| Низкоуровневый мост | npm create @lia-labs/app@latest my-app -- --framework bridge | Расширенные типы request, send и примеры событий. |
Angular использует свой строитель приложений. Другие стартовые проекты используют Vite. Все стартовые проекты используют TypeScript; файлы компонентов, специфичные для фреймворка, включены, чтобы вы могли напрямую адаптировать интеграцию.
#Начните с рабочим SDK демо
Добавить --template demo для интерактивного справочника функций в вашем фреймворке:
npm create @lia-labs/app@latest my-react-demo -- --framework react --template demo
npm create @lia-labs/app@latest my-vue-demo -- --framework vue --template demo
npm create @lia-labs/app@latest my-angular-demo -- --framework angular --template demoДемонстрации фреймворка включают диалоги, тактильную обратную связь, идентификацию, обновление сеанса, тестовые покупки, вознаграждаемую/межстраничную/баннерную/натуральную рекламу, обмен, хранение, захват медиа, биометрию, QR сканирование, управление экраном, напоминания и счета. Каждое действие имеет код, обратную связь о загрузке и вывод ответа. Неподдерживаемые функции и отмены разрешений обрабатываются без сбоев. Сеанс токенов и содержимое файлов опускаются из вывода.
Демонстрация продвинутого моста фокусируется на необработанных типизированных сообщениях. Демонстрации фреймворков используют свои соответствующие привязки для реактивной идентичности игрока, языка и нативных элементов управления; они делят примеры типизированных функций, а не iframe, окружающий обычную демонстрацию JavaScript.
Вы также можете открыть размещенный SDK демо внутри Lia под Приложения → Тестирование. У каждого зарегистрированного разработчика есть доступ без отдельного разрешения тестера. Вступительная экскурсия и панель управления портала ссылаются на нее.
#Симуляция браузера и реальное тестирование
Локальные установки разработки mockLia() только вне Lia. Платежи, реклама и вознаграждения имитируются; не создается реальной сессии или выплаты. Производственные сборки исключают разработчикую имитацию. Angular заменяет свой модуль разработки; стартовые проекты Vite используют флаг разработки сборки.
Отключить симуляцию с помощью --no-mock. Для проектов Vite вы также можете установить VITE_LIA_MOCK=false в локальной среде разработки. Нативные разрешения и аппаратные средства все еще требуют тестирования внутри Lia.
- Запустить
npm run buildи разместить вывод на HTTPS (dist/, илиdist/browser/для Angular). - Зарегистрируйтесь через CLI или создайте приложение в портал разработчика. Установите развернутый HTTPS URL перед тестированием. Приложение ID в коде само по себе не регистрирует список или не аутентифицирует запросы.
- Вы и до пяти дополнительных тестировщиков найдете его под Приложения → Тестирование, независимо от категории публикации.
- Для примера покупки, создайте активный
demo-coinsтестировать продукт в портале. - Положите тестовое приложение в сторону с Настройки → Архивировать приложение. Он исчезает из списка приложений каждого пользователя и может быть восстановлен без удаления конфигурации или тестовых данных.
Публичный релиз требует проверки. Открытый доступ разработчиков запланирован на Q1 2027; CLI не обходит текущие требования к приглашениям или публикации.
#Оставьте важные решения на вашем сервере
Никогда не доверяйте клиентским обратным вызовам, оценкам, значениям локального хранилища или событиям закрытия объявлений для предоставления валюты, предметов или вознаграждений. Держите ключи сервера и секреты вебхуков вне кода браузера и все VITE_* переменные.
Стартовый проект не имитирует проверку сервера и не включает небезопасную конечную точку доставки. Покупки в демо и отправка результатов ограничены режимом тестирования. Добавьте бэкенд, который проверяет сессии, проверяет каждую оплату, приложение, игрока, продукт, режим и статус, доставляет один раз и подтверждает доставку. Сохраняйте тестовые и живые учетные записи отдельно.
#Управление пакетами и автоматизация
pnpm create @lia-labs/app my-app --framework vue --template demo
yarn create @lia-labs/app my-app --framework svelte
bun create @lia-labs/app my-app --framework solidДля скриптов или CI:
npm create @lia-labs/app@latest my-app -- --framework react --template starter --app-id my-app --yes --no-install --localНепереключаемая настройка остается локальной, если вы не передадите --register; регистрация без подтверждений требует существующего входа в терминал. Используйте --install установить автоматически. --help списки вариантов. Если установка не удалась, сгенерированные файлы остаются доступными, и CLI выводит команду для повторной попытки.
#Добавьте безопасный бэкенд
Запустить npx @lia-labs/create-app@latest backend для отдельного серверного проекта в TypeScript/JavaScript, Python, PHP или Go. Выберите Node/Express, FastAPI/Django, PHP HTTP или Go HTTP. Эти стартовые проекты включают проверенные сессии игроков, подписанные вебхуки, проверки оплаты и постоянные инвентари с уникальными чеками. Не храните секреты сервера в вашем клиенте. См. пакетах бэкенда и руководствах по интеграции фреймворка.
Автоматически переведено. Английский — источник истины. Читать на английском