LiaDesenvolvedores

Pacotes

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@latest

Lia 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 dev

Pular 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 apps

Já tem um projeto gerado? Registre-o a partir do diretório do projeto:

npx @lia-labs/create-app@latest register --name "My game" --kind game

Você também pode criar e registrar em um único comando:

npm create @lia-labs/app@latest my-game -- --framework react --template demo --register --kind game

O 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 logout

Apenas 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 dev

O 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

FrameworkComandoLia integração
Plano TypeScriptnpm create @lia-labs/app@latest my-app -- --framework vanillaChamadas SDK com tipos definidos e estado observável.
Reactnpm create @lia-labs/app@latest my-app -- --framework reactuseInit, usePlayer, useLanguage, useMainButton.
Preactnpm create @lia-labs/app@latest my-app -- --framework preactHooks do Preact e as associações Lia do Preact.
Vuenpm create @lia-labs/app@latest my-app -- --framework vueComposables, refs e limpeza de componentes.
Sveltenpm create @lia-labs/app@latest my-app -- --framework svelteArmazenamentos Svelte e controles com escopo de componente.
Sólidonpm create @lia-labs/app@latest my-app -- --framework solidAccessores, createInit e createMainButton.
Angularnpm create @lia-labs/app@latest my-app -- --framework angularUm aplicativo Angular autônomo com sinais injetados.
Componentes webnpm create @lia-labs/app@latest my-app -- --framework elements<lia-app>, <lia-main-button> e o SDK digitado.
Ponte de baixo nívelnpm create @lia-labs/app@latest my-app -- --framework bridgeTipo 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 demo

Demonstraçõ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.

  1. Executar npm run build e hospedar a saída sobre HTTPS (dist/, ou dist/browser/ para Angular).
  2. 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.
  3. Você e até cinco testadores adicionais o encontram em Apps → Testes, independentemente de sua categoria de publicação.
  4. Para o exemplo de compra, crie um ativo demo-coins testar o produto no portal.
  5. 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 solid

Para scripts ou CI:

npm create @lia-labs/app@latest my-app -- --framework react --template starter --app-id my-app --yes --no-install --local

Configuraçã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

Digite para pesquisar todas as páginas, métodos e endpoints.