> ## Documentation Index
> Fetch the complete documentation index at: https://docs.replit.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Crie e lance um aplicativo mobile

> Crie um aplicativo iOS nativo com o Agent, teste-o no seu celular com o Expo Go e envie-o pelo TestFlight e pela revisão da App Store.

## O que você fará

Neste tutorial, você irá:

* Criar um aplicativo mobile a partir de um prompt com o Agent
* Pré-visualizá-lo localmente no seu celular com o Expo Go
* Compartilhar uma pré-visualização no Expo Go para testes e feedback
* Promover para o TestFlight para testes beta
* Enviar para a App Store para lançamento público

<Note>
  Execute este tutorial no Editor de projeto em [replit.com](https://replit.com). Se você estiver usando o aplicativo Replit para iOS, abra o projeto em replit.com para trabalhar em aplicativos mobile nativos.
</Note>

<Note>
  A Apple define os requisitos para envios ao TestFlight e à App Store. Você usará o App Store Connect para gerenciar testes e lançamentos.
</Note>

## O que você precisará

* Uma conta no Replit com acesso ao Editor de projeto em [replit.com](https://replit.com)
* Um celular com o Expo Go instalado
* Uma assinatura do Programa de Desenvolvedor da Apple (exigida pela Apple para o TestFlight e a App Store)

## Parte 1: Crie seu aplicativo com o Agent

<Steps>
  <Step title="Crie um aplicativo mobile">
    Na tela inicial do Replit, descreva o que você quer criar e selecione **Aplicativo mobile** como o tipo de app.
  </Step>

  <Step title="Deixe o Agent construir">
    O Agent estrutura seu projeto e cria sua primeira versão. Mantenha o chat aberto para acompanhar o progresso e solicitar mudanças.
  </Step>
</Steps>

## Parte 2: Teste no seu celular com o Expo Go

O Expo Go executa uma pré-visualização nativa do seu aplicativo no seu dispositivo.

<Steps>
  <Step title="Instale o Expo Go">
    Instale o Expo Go no seu iPhone ou dispositivo Android.
  </Step>

  <Step title="Abra o QR code">
    No Editor de projeto, selecione **Pré-visualizar no dispositivo mobile** para exibir um QR code.
  </Step>

  <Step title="Escaneie e pré-visualize">
    Escaneie o QR code com seu celular para abrir uma pré-visualização nativa no Expo Go.
  </Step>
</Steps>

<Frame>
  <img src="https://mintcdn.com/replit/TlSUj3SmUsRG399T/images/native-mobile-apps/mobile-screen.png?fit=max&auto=format&n=TlSUj3SmUsRG399T&q=85&s=d512e8c7bf0a86ecacd92fbef1f52749" alt="Aplicativo mobile em execução na pré-visualização do Editor de projeto do Replit com o painel Pré-visualizar no dispositivo e QR code" width="1440" height="900" data-path="images/native-mobile-apps/mobile-screen.png" />
</Frame>

<Tip>
  Se sua pré-visualização parecer desatualizada, atualize no Expo Go. No seu dispositivo, agite o celular para abrir o menu do desenvolvedor e selecione **Recarregar**.
</Tip>

## Parte 3: Compartilhe uma pré-visualização com o Expo Go

Compartilhar com o Expo Go cria uma pré-visualização de desenvolvimento para testadores que têm o Expo Go instalado. Use-o para coletar feedback antes de enviar uma build pelo processo de revisão da Apple.

<Steps>
  <Step title="Publique pelo Editor de projeto">
    Abra o painel de publicação e selecione **Publicar**. Isso implanta seu aplicativo e back-end na infraestrutura do Replit.
  </Step>

  <Step title="Compartilhe seu aplicativo">
    Depois de publicar a pré-visualização, testadores com o Expo Go podem abri-la usando o link compartilhável. Nesta etapa, não é necessária uma conta de Desenvolvedor da Apple.
  </Step>
</Steps>

<Tip>
  Use as pré-visualizações do Expo Go para compartilhar protótipos rapidamente, coletar feedback inicial e iterar antes de se comprometer com o processo da App Store.
</Tip>

## Parte 4: Promova para o TestFlight

Depois de compartilhar uma pré-visualização no Expo Go, você pode promover seu aplicativo para o TestFlight para testes beta mais formais. O TestFlight requer uma conta de Desenvolvedor da Apple, mas fornece uma experiência de aplicativo nativo sem o Expo Go.

### Pré-requisitos para publicação na Apple

A Apple exige contas e configurações específicas antes de você poder enviar builds. Conclua estas etapas antes de tentar enviar.

#### Entre no Programa de Desenvolvedor da Apple

Você precisa de uma assinatura do Programa de Desenvolvedor da Apple para enviar builds para o TestFlight e para a App Store.

<Callout type="note">
  A Apple exige autenticação de dois fatores na sua Conta Apple.
</Callout>

#### Inscrição individual vs. organizacional

* **Contas individuais**: Publique com seu nome legal como vendedor.
* **Contas de organização**: Publique com o nome da organização como vendedor. A Apple exige um Número D‑U‑N‑S para organizações, o que pode levar algum tempo para obter.

#### Etapas típicas de inscrição

1. Entre em `https://developer.apple.com/programs/enroll/`
2. Complete a verificação de identidade
3. Aceite o contrato de licença do Programa de Desenvolvedor da Apple
4. Pague a taxa anual definida pela Apple
5. Aguarde a aprovação da Apple (o tempo varia de acordo com o tipo de conta)

### Entenda o TestFlight vs. a App Store

O TestFlight é o sistema de testes beta da Apple. A App Store é o mercado público onde qualquer pessoa pode baixar seu aplicativo.

| Aspecto                    | TestFlight                                             | App Store                                    |
| -------------------------- | ------------------------------------------------------ | -------------------------------------------- |
| **Público**                | Testadores convidados (até 10.000 testadores externos) | Público geral                                |
| **Finalidade**             | Testes beta e feedback                                 | Lançamento público                           |
| **Revisão**                | A primeira build de uma versão passa por revisão beta  | Cada envio passa pela Revisão de aplicativos |
| **Tempo de vida da build** | Expira após 90 dias                                    | Permanente até você removê-la                |

<Tip>
  O TestFlight é a maneira mais rápida de detectar falhas, problemas de desempenho e problemas específicos do dispositivo antes do lançamento.
</Tip>

<Steps>
  <Step title="Abra o painel de publicação">
    Com seu aplicativo já compartilhado como pré-visualização do Expo Go, abra o painel de publicação no Editor de projeto.
  </Step>

  <Step title="Selecione publicação na App Store">
    Selecione **Publicar na App Store** para promover seu aplicativo para o TestFlight.
  </Step>

  <Step title="Conecte à Apple e envie">
    Entre com sua conta de Desenvolvedor da Apple quando solicitado. O Replit cria um aplicativo nativo na nuvem e o envia para o TestFlight.
  </Step>
</Steps>

<Note>
  A primeira build de uma versão normalmente requer uma revisão beta do TestFlight. Após a aprovação, geralmente você pode enviar builds adicionais para testadores mais rapidamente.
</Note>

### Habilite testes externos

Para compartilhar sua build do TestFlight com outras pessoas, configure os testes externos no App Store Connect:

1. No App Store Connect, abra seu aplicativo.
2. Vá para **TestFlight** e depois **Testes externos**.
3. Crie um grupo de testes e adicione sua build.
4. Envie para a Revisão de aplicativos beta (exigida pela Apple para testadores externos).
5. Compartilhe o link público do TestFlight após a aprovação.

## Parte 5: Envie para a App Store

Quando sua build estiver pronta para o lançamento, envie-a pelo App Store Connect:

1. No App Store Connect, abra seu aplicativo.
2. Vá para a aba **App Store**.
3. Preencha os metadados necessários (descrição, capturas de tela, categoria, preços e detalhes de privacidade).
4. Selecione sua build do TestFlight para promover.
5. Envie para revisão.

### Complete sua listagem no App Store Connect

O Replit cria sua listagem de aplicativo no App Store Connect, mas você ainda precisa preencher os metadados necessários antes que a Apple aceite um envio. Os seguintes campos são comumente necessários:

* **Nome e subtítulo do aplicativo**
* **Categoria** (primária, secundária opcional)
* **Preços e disponibilidade** (gratuito ou pago e regiões)
* **URL da política de privacidade** (acessível publicamente)
* **Detalhes de privacidade do aplicativo** ("rótulos nutricionais" de coleta de dados)
* **Capturas de tela** (obrigatórias)
* **URL de suporte** (obrigatória)
* **Informações de contato para revisão do aplicativo** (obrigatórias)

<Callout type="note">
  Se seu aplicativo exigir login, adicione credenciais de demonstração para a Revisão de aplicativos no App Store Connect para que a Apple possa testá-lo.
</Callout>

### Requisitos de privacidade

A Apple exige que você:

* Forneça uma **URL de política de privacidade** pública
* Declare suas práticas de dados de **Privacidade do aplicativo** (incluindo SDKs e serviços de terceiros que você usa)

Se você usar serviços de terceiros (análises, pagamentos, relatórios de falhas, anúncios), revise as divulgações de privacidade deles e inclua-as nas suas respostas de Privacidade do aplicativo.

### Capturas de tela

As capturas de tela são obrigatórias e influenciam fortemente a conversão na App Store.

<Tip>
  Use capturas de tela reais do seu aplicativo. Certifique-se de que as capturas de tela correspondam à build atual que você está enviando.
</Tip>

### Motivos comuns de rejeição

| Problema                                        | Como evitar                                                               |
| ----------------------------------------------- | ------------------------------------------------------------------------- |
| Falhas ou bugs óbvios                           | Teste no TestFlight primeiro e corrija os problemas antes do envio        |
| Política de privacidade ausente                 | Adicione uma URL de política de privacidade pública antes do envio        |
| Capturas de tela não correspondem ao aplicativo | Carregue capturas de tela da build atual                                  |
| Os revisores não conseguem acessar o aplicativo | Forneça credenciais de demonstração e instruções nas notas de revisão     |
| Conteúdo incompleto ou de espaço reservado      | Remova fluxos "em breve" e telas incompletas                              |
| Prompts de permissão sem contexto               | Explique por que você precisa de câmera, localização ou outras permissões |

### Prazos esperados

| Etapa                                                     | Duração típica                                                      |
| --------------------------------------------------------- | ------------------------------------------------------------------- |
| Aprovação do Programa de Desenvolvedor da Apple           | Varia (geralmente 1–2 dias para indivíduos; mais para organizações) |
| Processamento de build no App Store Connect               | Geralmente 10–15 minutos                                            |
| Revisão beta do TestFlight (primeira build de uma versão) | Geralmente cerca de um dia                                          |
| Revisão da App Store                                      | Geralmente 1–2 dias                                                 |

### Atualizando seu aplicativo após o lançamento

* **Atualizações de UI e conteúdo**: Publique novamente para lançar atualizações rapidamente.
* **Mudanças nativas** (por exemplo, ícones de aplicativo ou permissões): Envie uma nova build para a App Store.

## Lista de verificação

Use esta lista de verificação para verificar se você está pronto para cada etapa.

**Antes de compartilhar uma pré-visualização do Expo Go:**

* Você consegue executar o aplicativo em um dispositivo real via Expo Go
* Seu aplicativo não tem falhas óbvias ou fluxos quebrados

**Antes de promover para o TestFlight:**

* Seu aplicativo está publicado e em execução no Replit
* Você tem uma assinatura do Programa de Desenvolvedor da Apple
* Você sabe se sua conta Apple é individual ou organizacional

**Antes de enviar para a App Store:**

* Os metadados do App Store Connect estão completos (nome, categoria, regiões e URL de suporte)
* A URL da política de privacidade é pública e precisa
* Os detalhes de Privacidade do aplicativo estão completos (incluindo serviços de terceiros)
* As capturas de tela estão carregadas e correspondem à build enviada
* As informações de contato para Revisão de aplicativos estão definidas
* As credenciais de demonstração são fornecidas (se seu aplicativo exigir login)

## Próximos passos

* Saiba como os aplicativos mobile funcionam no Replit: [Aplicativos Mobile Nativos](/references/artifact-types/building-mobile-apps)
* Saiba como o Agent funciona: [Agent](/references/agent/overview)
* Use o Replit no mobile: [Aplicativo Mobile do Replit](/references/platforms/mobile-app)
* Saiba mais sobre o Expo: [Documentação do Expo](https://docs.expo.dev/)
