Voltar

ATUALIZAÇÃO DO APP

Abrir a pasta nova e fazer Sync no Android Studio

Use este guia quando você gerou um ZIP atualizado (mudou ícone, nome, versão, etc.) e precisa abrir a pasta nova no Android Studio sem bagunçar nada.

Antes de começar: você já deve ter (1) baixado o ZIP novo, (2) extraído na pasta Downloads, e (3) rodado o setup.bat dentro dela. Se a pasta android/ ainda não existe, volte e rode o setup primeiro.
1

Fechar o projeto antigo (se estiver aberto)

Se o Android Studio já está aberto com a versão antiga do app, feche aquele projeto primeiro:

  1. No menu superior, clique em File
  2. Escolha Close Project
  3. Vai aparecer a tela de boas-vindas (Welcome to Android Studio)
Pode pular este passo se o Android Studio está fechado ou já está na tela de Welcome.
2

Abrir o menu File → Open...

No Android Studio (com o projeto antigo fechado ou na tela de Welcome):

  1. Clique em File no canto superior esquerdo (destacado em verde abaixo)
  2. No menu que aparecer, clique em Open...

📍 Onde está o menu File:

Android Studio — Calistehouse
FileEditViewNavigateCodeRefactorBuildRunToolsHelp
▶
🐞
🐘
⚙

📋 Menu que aparece:

Menu File aberto
  • Open...CLIQUE AQUI
  • New
  • Open Recent ▸
  • Close Project
  • Settings...
  • Project Structure...
  • Sync Project with Gradle Files⌘⇧I
Se estiver na tela de Welcome (sem nenhum projeto aberto), o botão fica como Open bem no centro da tela — clica nele direto.
3

Selecionar a pasta android/ DENTRO do projeto novo

Vai abrir uma janela de seleção de pasta. Atenção a este detalhe crítico: você precisa selecionar a pasta android que está dentro do projeto novo, NÃO a pasta raiz do projeto.

  1. Navegue até Downloads
  2. Entre na pasta nova: meuapp-v1.0.1-android
  3. Clique uma vez na subpasta android (sem entrar nela)
  4. Clique no botão OK

🎯 Selecione exatamente esta pasta:

Open File or Project
Caminho:
C:\Users\Você\Downloads\meuapp-v1.0.1-android\android
meuapp-v1.0.1-android/
node_modules/
android/SELECIONE ESTA
package.json
setup.bat
Erro comum: selecionar a pasta raiz meuapp-v1.0.1-android em vez de android. Se fizer isso, o Android Studio não reconhece o projeto Gradle e mostra "Unknown project type". Volte e selecione android/.
Resultado esperado: o Android Studio começa a importar o projeto e aparece uma janela "Trust Project" — clique em Trust Project.
4

Disparar o Gradle Sync (clicar no 🐘 elefante)

O Sync geralmente começa sozinho assim que o projeto abre. Se começar sozinho, pule pro passo 5 e só observe. Se não começar, force manualmente:

Opção A — Botão do elefante (mais rápido):

  1. Olhe na barra de ferramentas no topo direito
  2. Procure o ícone do 🐘 elefante (com uma seta circular azul)
  3. Clique nele uma vez

🐘 Onde está o elefante:

Android Studio — Calistehouse
FileEditViewNavigateCodeRefactorBuildRunToolsHelp
▶
🐞
🐘!
⚙

Opção B — Pelo menu (se não achar o elefante):

  1. Menu File
  2. Role até embaixo e clique em Sync Project with Gradle Files
Atalho de teclado: Ctrl+Shift+O (Windows) ou ⌘⇧I (Mac).
5

ESPERAR o sync terminar (parte difícil 😅)

Depois de clicar, vai aparecer uma barra azul no rodapé com o texto "Gradle: Resolving dependencies..." ou similar.

⏳ Durante o sync (aguarde):

Rodapé do Android Studio
Gradle: Resolving dependencies...
aguarde...

✅ Quando terminar com sucesso:

Rodapé do Android Studio
Gradle sync finished

❌ Se der erro:

Rodapé do Android Studio
Gradle sync failed — see Build Output

⏱️ Tempo esperado:

  • Atualização (2ª vez ou mais): 30 segundos a 2 minutos (cache já existe)
  • Primeira vez na máquina: 10 a 40 minutos (baixa ~1GB de dependências)
NÃO clique em mais nada, NÃO cancele, NÃO feche o Android Studio durante o sync. Se aparecer popup amarelo "AGP Upgrade Assistant", IGNORE — não clique no botão azul.
Resultado esperado: barra fica verde com "Gradle sync finished" no rodapé. Agora você pode buildar.
6

Buildar o APK ou AAB

Sync terminou OK? Agora gere o arquivo de instalação:

🅰️ APK pra testar no celular:

  1. Menu Build (destacado abaixo)
  2. Build App Bundle(s) / APK(s)
  3. Build APK(s)
  4. Espera ~2–5 minutos
  5. Notificação verde no canto inferior direito → clica em locate
  6. Pega o arquivo app-debug.apk em android/app/build/outputs/apk/debug/

🔨 Onde está o menu Build:

Android Studio — Calistehouse
FileEditViewNavigateCodeRefactorBuildRunToolsHelp
▶
🐞
🐘
⚙

🅱️ AAB assinado pra Play Store:

  1. Menu Build → Generate Signed App Bundle / APK...
  2. Escolhe Android App Bundle → Next
  3. Use a MESMA chave de assinatura (.jks) da primeira publicação ⚠️
  4. Escolhe variante release → Create
  5. Sobe o .aab no Google Play Console como nova release
🔑 Chave de assinatura: NUNCA use uma chave diferente da primeira publicação. Se perder a original, perde acesso a atualizar o app na Play Store pra sempre.
7

Instalar/distribuir a versão atualizada

📱 APK (instalação direta):

  • Manda o .apk pro celular (WhatsApp, Drive, USB)
  • Instala por cima do antigo — atualiza automaticamente se a chave de assinatura for a mesma
  • Se for chave diferente, o Android pede pra desinstalar o antigo primeiro

🏪 Play Store:

  • Sobe o .aab no Google Play Console → cria release de produção
  • Aprovação leva de algumas horas a 1 dia
  • Usuários recebem update automático em background
Resultado esperado: seu app abre no celular já com as alterações novas (ícone novo, nome novo, etc.).

🎯 Resumo em 1 minuto

  1. Fecha projeto antigo: File → Close Project
  2. Abre o novo: File → Open...
  3. Seleciona a pasta android/ dentro do projeto novo (NÃO a raiz!)
  4. Clica no 🐘 elefante no topo direito (ou espera o sync iniciar sozinho)
  5. Espera "Gradle sync finished" no rodapé
  6. Build → Build APK(s) ou Generate Signed App Bundle
📘 Guia completo (do zero) Voltar pros meus apps