Pacotes
Kits de início & SDK demos
Copiar página
Crie um app Lia com configuração guiada do terminal, login aprovado pelo navegador e registro automático de app privado. Escolha entre nove integrações de framework.
#Crie um projeto
npm create @lia-labs/app@latestLia Developer Studio o guia por seu projeto, framework, starter, configuração e conta. Use as teclas de seta para escolher seu framework e Iniciador ou SDK playground. Recomendado configurações habilitam simulação do navegador local e instalam dependências com o gerenciador de pacotes que você está usando. Personalizar permite que você altere o app público ID, gerenciador de pacotes, simulação local e preferência de instalação. A configuração valida seu diretório antes de criar arquivos, mostra o progresso da instalação e imprime comandos de recuperação se uma instalação falhar. Pressione Ctrl+C para cancelar. Pastas existentes não vazias nunca são sobrescritas.
Use uma versão do Node LTS compatível: é recomendado o Node 22.12+ ou 24+. Os starters selecionam versões de framework compatíveis com as associações atuais Lia, incluindo Preact 10 e Solid 1.
cd my-lia-app
npm install
npm run devPular npm install se as dependências já estão instaladas. Use os comandos correspondentes ao seu gerenciador de pacotes selecionado.
#Conecte sua conta Lia
Após criar seus arquivos, escolha Conectar & registrar para abrir Lia Developers no seu navegador. Faça login com sua conta Lia, compare o código mostrado no terminal e aprova o pedido. Seu app é criado como uma lista de teste privada no seu painel de desenvolvedor. Escolha Continue construindo localmente, ou passar --local, para se cadastrar depois.
npx @lia-labs/create-app@latest login
npx @lia-labs/create-app@latest whoami
npx @lia-labs/create-app@latest appsJá tem um projeto gerado? Registre-o a partir do diretório do projeto:
npx @lia-labs/create-app@latest register --name "My game" --kind gameVocê também pode criar e registrar em um único comando:
npm create @lia-labs/app@latest my-game -- --framework react --template demo --register --kind gameO registro não exige hospedagem ainda. Até você adicionar um HTTPS URL implantado no painel, abrir a lista mostra um espaço reservado de configuração. Use --url https://your-app.example quando registrando se o hospedagem estiver pronta. Registrar um app ID que você já possui vincula o projeto a essa lista sem editá-la; um ID pertencente a outra pessoa é rejeitado. Gerencie mudanças em URL, arte, testadores e revisão no painel.
O app público ID é salvo em lia.config.json e a configuração do framework gerado. O registro adiciona informações de painel e nome de host a esse arquivo. Credenciais da conta são armazenadas separadamente no seu computador; elas nunca são escritas no projeto ou no código do navegador gerado.
Um código de aprovação do navegador expira após dez minutos. O acesso ao terminal dura até trinta dias e pode listar seus aplicativos, criar listagens privadas de testes e conectar prévias locais aos seus aplicativos de teste privados. Ele não pode publicar aplicativos, ler chaves do servidor ou fazer pagamentos. Use Terminais conectados no painel de controle para revogar um terminal imediatamente, ou sair da linha de comando:
npx @lia-labs/create-app@latest logoutApenas aprova um código que você mesmo começou. Os requisitos existentes de acesso de desenvolvedor ainda se aplicam; o login do terminal não contorna o processo de convite. Se um navegador não puder ser aberto automaticamente, use login --no-browser e abra o link impresso você mesmo. Solicitações recusadas ou expiradas podem ser repetidas com login.
#Visualize seu app local dentro do Lia
Do seu projeto registrado, execute:
npx @lia-labs/create-app@latest devO CLI inicia o servidor de desenvolvimento do seu framework, abre um túnel Cloudflare temporário e o conecta à sua lista de teste privada. Abra o app novamente no Lia sob Apps → Testes. Edições subsequentes usam o recarregamento em tempo real do seu framework, então você pode continuar testando no seu telefone enquanto modifica arquivos locais. Nenhuma conta Cloudflare ou configuração DNS é necessária.
Se o Cloudflare Tunnel não estiver instalado, Lia baixa o assistente oficial para o seu cache de usuário e verifica a soma de verificação da versão antes de executá-lo. Ele não instala um serviço em segundo plano. Escolha outra porta com --port 4201, ou um gerenciador de pacotes com --pm pnpm.
O painel ao vivo mostra seu servidor local, túnel HTTPS e app Lia conectado. Pressione o para abrir o link do aplicativo, d para seu painel, ou q / Ctrl+C to stop. Existing terminal grants need one new browser approval for local preview access.
Seu Page permanente URL não foi alterado. Parar remove a conexão de visualização, e um terminal perdido expira sua conexão em dois minutos. Visualizações locais funcionam apenas com apps de teste privados e não podem substituir um app em produção. Implante um hospedagem permanente HTTPS antes de enviar para revisão.
O túnel temporário URL é público para qualquer pessoa que o tenha, enquanto a lista Lia permanece restrita aos seus testadores existentes. Mantenha segredos de produção e dados privados de clientes fora das visualizações locais no navegador. Túneis rápidos são infraestrutura de desenvolvimento sem garantia de disponibilidade.
#Preferências do Terminal
A interface se adapta a terminais menores. Defina NO_COLOR=1 para cores simples, LIA_NO_MOTION=1 para reduzir a animação de progresso, ou ACCESSIBLE=1 para prompts de texto padrão. CI e saída redirecionada permanecem estáticas. O CLI relata os passos reais de configuração em vez de uma porcentagem simulada.
#Escolha um framework
| Framework | Comando | Lia integração |
|---|---|---|
| Plano TypeScript | npm create @lia-labs/app@latest my-app -- --framework vanilla | Chamadas SDK com tipos definidos e estado observável. |
| 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 | Hooks do Preact e as associações Lia do Preact. |
| Vue | npm create @lia-labs/app@latest my-app -- --framework vue | Composables, refs e limpeza de componentes. |
| Svelte | npm create @lia-labs/app@latest my-app -- --framework svelte | Armazenamentos Svelte e controles com escopo de componente. |
| Sólido | npm create @lia-labs/app@latest my-app -- --framework solid | Accessores, createInit e createMainButton. |
| Angular | npm create @lia-labs/app@latest my-app -- --framework angular | Um aplicativo Angular autônomo com sinais injetados. |
| Componentes web | npm create @lia-labs/app@latest my-app -- --framework elements | <lia-app>, <lia-main-button> e o SDK digitado. |
| Ponte de baixo nível | npm create @lia-labs/app@latest my-app -- --framework bridge | Tipo avançado request, send e exemplos de eventos. |
O Angular usa seu construtor de aplicativos. Outros iniciadores usam o Vite. Todos os iniciadores usam TypeScript; os arquivos de componentes específicos do framework são incluídos para que você possa adaptar a integração diretamente.
#Comece com um demo SDK funcional
Adicionar --template demo para um catálogo de recursos interativos no seu framework:
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 demoDemonstrações do Framework incluem diálogos, haptica, identidade, atualização de sessão, compras de teste, anúncios recompensados / intersticiais / de banner / nativos, compartilhamento, armazenamento, captura de mídia, biométrica, varredura QR, controles de tela, lembretes e pontuações. Cada ação tem código, feedback de carregamento e uma leitura de resposta. Recursos não suportados e cancelamentos de permissão são tratados sem travar. Tokens de sessão e conteúdos de arquivo são omitidos da leitura.
O demonstrativo avançado da ponte se concentra em mensagens com tipos definidos. Os demonstrativos de framework usam suas respectivas associações para identidade do jogador reativa, idioma e controles nativos; eles compartilham exemplos de recursos com tipos, não um iframe envolvendo o demonstrativo JavaScript simples.
Você também pode abrir o Demo SDK dentro Lia sob Apps → Testes. Todo desenvolvedor registrado tem acesso sem uma concessão separada de testador. O tour de boas-vindas do portal e o link do painel levam a ele.
#Simulação no navegador e testes reais
Instalações de desenvolvimento local mockLia() apenas fora Lia. Pagamentos, anúncios e recompensas são simulados; nenhuma sessão ou pagamento real é criado. Builds de produção omitem o mock de desenvolvimento. Angular substitui seu módulo de desenvolvimento; iniciadores Vite usam a bandeira de desenvolvimento da build.
Desative a simulação com --no-mock. Para projetos Vite, você também pode definir VITE_LIA_MOCK=false em um ambiente de desenvolvimento local. Permissões nativas e hardware ainda precisam ser testados dentro Lia.
- Executar
npm run builde hospedar a saída sobre HTTPS (dist/, oudist/browser/para Angular). - Registre-se pelo CLI ou crie o app no portal do desenvolvedor. Defina seu HTTPS URL antes de testar. Um app ID no código sozinho não registra uma lista ou autentica solicitações.
- Você e até cinco testadores adicionais o encontram em Apps → Testes, independentemente de sua categoria de publicação.
- Para o exemplo de compra, crie um ativo
demo-coinstestar o produto no portal. - Coloque um app de teste de lado com Configurações → Arquivar aplicativo. Ele desaparece da lista de aplicativos nativos de todos e pode ser restaurado sem excluir a configuração ou os dados de teste.
A liberação pública requer revisão. O acesso de desenvolvedor aberto está planejado para o Q1 2027; o CLI não contorna os requisitos atuais de convite ou publicação.
#Mantenha decisões valiosas no seu servidor
Nunca confie em callbacks de cliente, pontuações, valores de armazenamento local ou eventos de fechar anúncios para conceder moeda, itens ou recompensas. Mantenha as chaves do servidor e segredos de webhooks fora do código do navegador e todos VITE_* variáveis.
O starter não falsifica a verificação do servidor ou inclui um ponto de extremidade de entrega inseguro. Compras de demonstração e submissões de pontuação são restritas ao modo de teste. Adicione um backend que verifica sessões, verifica cada carga de aplicativo, jogador, produto, modo e status, entrega uma vez e reconhece a entrega. Mantenha contabilidade de teste e produção separadas.
#Gerenciadores de pacotes e automação
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 solidPara scripts ou CI:
npm create @lia-labs/app@latest my-app -- --framework react --template starter --app-id my-app --yes --no-install --localConfiguração não interativa permanece local, a menos que você passe --register; o registro sem notificações requer um login de terminal existente. Use --install para instalar automaticamente. --help lista opções. Se a instalação falhar, os arquivos gerados permanecem disponíveis e o CLI imprime o comando para tentar novamente.
#Adicione um backend seguro
Executar npx @lia-labs/create-app@latest backend para um projeto de servidor separado em TypeScript/JavaScript, Python, PHP ou Go. Escolha Node/Express, FastAPI/Django, PHP HTTP ou Go HTTP. Esses starters incluem sessões de jogador verificadas, webhooks assinados, verificações de cobrança paga e inventários persistentes com recibos únicos. Mantenha segredos do servidor fora do seu frontend. Veja pacotes de backend e guias de integração de framework.
Traduzido automaticamente. O inglês é a fonte de verdade. Leia em inglês