Configurar a aplicação móvel

Instalação e configuração

Coloca os valores destinados ao dispositivo em apps/mobile/.env.local; o Expo lê esse ficheiro, não o .env na raiz do repositório. EXPO_PUBLIC_API_URL é a origem do backend web que o telefone alcança — o mesmo valor que testaste no navegador do telefone. EXPO_PUBLIC_APP_SCHEME é o esquema URI nativo da aplicação; usa um valor de DNS inverso como com.example.app.

app.json define o nome do produto, o slug, a versão, o identificador de bundle e os plugins. app.config.ts deriva o esquema de links profundos e as origens de produção de EXPO_PUBLIC_APP_SCHEME, pelo que uma mudança de esquema exige uma nova build nativa, não apenas reiniciar o Metro. No servidor, adiciona cada origem que a aplicação usa a MOBILE_ALLOWED_ORIGINS; a transferência falha de forma segura quando os dois lados não coincidem.

Todos os valores EXPO_PUBLIC_* são incluídos no bundle da aplicação. Mantém as chaves dos fornecedores no servidor e usa valores públicos apenas para endereços e esquemas.

EXPO_PUBLIC_API_URL=http://192.168.1.25:3000
EXPO_PUBLIC_APP_SCHEME=com.example.app

Fluxo de implementação

Reinicia o Expo depois de alterar .env.local. Executa os testes e a verificação de tipos do pacote e confirma o esquema resolvido com uma build de desenvolvimento: abre um link de callback de autenticação e verifica que volta à aplicação em vez do navegador. O Expo Go não consegue validar esquemas personalizados da tua build nativa.

Verificação e resolução de problemas

Reinicia o Expo depois de alterar .env.local e abre a pré-visualização no dispositivo de destino. Muda o tema, reinicia a aplicação e confirma que a escolha persiste; depois aciona um link profundo e verifica que a aplicação o encaminha em vez do navegador.