LiaРазработчики

Пакеты

Создайте приложение Lia с пошаговой настройкой терминала, входом, одобренным браузером, и автоматической регистрацией приватного приложения. Выберите из девяти интеграций фреймворков.

#Создать проект

npm create @lia-labs/app@latest

Lia 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 интеграция
Обычный TypeScriptnpm create @lia-labs/app@latest my-app -- --framework vanillaТипизированные вызовы SDK и наблюдаемое состояние.
Reactnpm create @lia-labs/app@latest my-app -- --framework reactuseInit, usePlayer, useLanguage, useMainButton.
Preactnpm create @lia-labs/app@latest my-app -- --framework preactХуки Preact и привязки Lia Preact.
Vuenpm create @lia-labs/app@latest my-app -- --framework vueКомпозабели, ссылки и очистка компонентов.
Sveltenpm create @lia-labs/app@latest my-app -- --framework svelteХранилища Svelte и компонентно-ограниченные элементы управления.
Твердыйnpm create @lia-labs/app@latest my-app -- --framework solidАксессоры, createInit и createMainButton.
Angularnpm 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.

  1. Запустить npm run build и разместить вывод на HTTPS (dist/, или dist/browser/ для Angular).
  2. Зарегистрируйтесь через CLI или создайте приложение в портал разработчика. Установите развернутый HTTPS URL перед тестированием. Приложение ID в коде само по себе не регистрирует список или не аутентифицирует запросы.
  3. Вы и до пяти дополнительных тестировщиков найдете его под Приложения → Тестирование, независимо от категории публикации.
  4. Для примера покупки, создайте активный demo-coins тестировать продукт в портале.
  5. Положите тестовое приложение в сторону с Настройки → Архивировать приложение. Он исчезает из списка приложений каждого пользователя и может быть восстановлен без удаления конфигурации или тестовых данных.

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

Автоматически переведено. Английский — источник истины. Читать на английском

Введите, чтобы искать по каждой странице, методу и точке окончания.