> ## Documentation Index
> Fetch the complete documentation index at: https://supastack.dev/llms.txt
> Use this file to discover all available pages before exploring further.
> For the full documentation corpus in one file, fetch: https://supastack.dev/llms-full.txt

# Configurar a aplicação móvel

Define o endereço do backend e o esquema de links profundos usados pela build nativa, e mantém os dois lados da transferência sincronizados.

## 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.


Para continuar a configuração, leia [Testar a aplicação móvel](https://supastack.dev/pt/docs/mobile/testing.md).


## Seguinte

[Testar a aplicação móvel](https://supastack.dev/pt/docs/mobile/testing.md)