Pular para o conteúdo principal

​
Guia de configuração para o aplicativo móvel

Guia completo para configurar o aplicativo móvel do AirysChat para desenvolvimento e contribuição.

​
Instalação e configuração

​
Pré-requisitos

Antes de começar, certifique-se de ter o seguinte instalado:
Para saber mais sobre as instruções mais atualizadas, consulte o guia disponível aqui.

​
Clonar o repositório

git clone git@github.com:airyschat/airyschat-mobile-app.git
cd airyschat-mobile-app

​
Instalar dependências

pnpm install

​
Instalar o Expo CLI

pnpm install -g expo-cli

​
Variáveis de Ambiente

Crie seu arquivo de configuração de ambiente: 
cp .env.example .env
Configure as seguintes variáveis de ambiente:
NomeDescriçãoValor PadrãoObrigatório
EXPO_PUBLIC_AIRYSCHAT_WEBSITE_TOKENToken do widget web para suporte no app-Não
EXPO_PUBLIC_AIRYSCHAT_BASE_URLURL da instalação self-hostedhttps://app.airyschat.comSim
EXPO_PUBLIC_JUNE_SDK_KEYChave SDK de analytics do June-Não
EXPO_PUBLIC_MINIMUM_AIRYSCHAT_VERSIONVersão mínima suportada do AirysChat-Sim
EXPO_PUBLIC_SENTRY_DSNURL DSN do Sentry para relatórios de erro-Não
EXPO_PUBLIC_PROJECT_IDIdentificador do projeto Expo-Sim
EXPO_PUBLIC_APP_SLUGSlug do aplicativo para o Expo-Sim
EXPO_PUBLIC_SENTRY_PROJECT_NAMENome do projeto no Sentry-Não
EXPO_PUBLIC_SENTRY_ORG_NAMENome da organização no Sentry-Não
EXPO_PUBLIC_IOS_GOOGLE_SERVICES_FILECaminho para o arquivo config do iOS-Não
EXPO_PUBLIC_ANDROID_GOOGLE_SERVICES_FILECaminho para o arquivo config do Android-Não
EXPO_APPLE_IDID da conta do Apple Developer-Não
EXPO_APPLE_TEAM_IDID da equipe do Apple Developer-Não
EXPO_STORYBOOK_ENABLEDAtivar/desativar StorybookfalseNão

​
Gerar o código nativo

pnpm generate
Este comando gera diretórios nativos para Android e iOS usando o Prebuild.
Você precisa executar o pre-build se adicionar uma nova dependência nativa ao seu projeto ou alterar a configuração do projeto no arquivo de configuração do app do Expo (app.config.ts).

​
Como executar o aplicativo

Conecte seu dispositivo iPhone/Android e execute o seguinte comando para instalar o aplicativo no seu dispositivo.

​
Desenvolvimento iOS

pnpm run:ios

​
Desenvolvimento Android

pnpm run:android

​
Instalação de Pacotes

Por favor, sempre instale pacotes usando o comando npx expo install package-name ao invés de pnpm install package-name.
Isso é crucial para dependências nativas porque o Expo instalará automaticamente a versão compatível correta, enquanto o pnpm/yarn/npm pode instalar a versão mais recente, que pode não ser compatível. 
# Forma correta de instalar pacotes
npx expo install package-name

# Forma incorreta (pode causar problemas de compatibilidade)
pnpm install package-name

​
Notificações push

Se você estiver usando a edição community do AirysChat com o aplicativo móvel oficial, as notificações push funcionam prontas para uso sem nenhuma configuração adicional. Se você estiver construindo um aplicativo com marca personalizada, consulte o guia de aplicativo móvel personalizado para Firebase, deep linking e configuração de build.

​
Solução de problemas

Problema: O Metro bundler falha ao iniciar ou empacotarSolução:
# Limpar cache e reiniciar
pnpm clear
pnpm start --reset-cache
Problema: Problemas com o simulador ou build do iOSSolução:
  • Certifique-se de que o Xcode esteja instalado corretamente
  • Verifique a compatibilidade de versão do simulador do iOS
  • Limpe os dados derivados (derived data) no Xcode
  • Reinicie o Metro bundler
Problema: Problemas com o emulador ou build do AndroidSolução:
  • Verifique a configuração do Android Studio
  • Verifique as versões do SDK e ferramentas de build
  • Certifique-se de que o emulador está rodando
  • Limpe o cache do Gradle
Problema: Os comandos do Expo falhamSolução:
# Atualizar Expo CLI
npm install -g @expo/cli@latest

# Login no Expo
expo login

# Limpar o cache do Expo
expo r -c

​
Diretrizes de Contribuição

Ao contribuir para o aplicativo móvel:
  1. Siga os padrões de código: Use as configurações do ESLint e Prettier
  2. Escreva testes: Inclua testes unitários para novos recursos
  3. Teste em ambas as plataformas: Garanta a compatibilidade com iOS e Android
  4. Atualize a documentação: Documente novos recursos e mudanças
  5. Verifique o desempenho: Monitore o impacto no desempenho do aplicativo

​
Obtendo Ajuda

Se você encontrar problemas:

​
Recursos Úteis

Seu ambiente de desenvolvimento do aplicativo móvel AirysChat está pronto! 📱