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:

Nome	Descrição	Valor Padrão	Obrigatório
EXPO_PUBLIC_AIRYSCHAT_WEBSITE_TOKEN	Token do widget web para suporte no app	-	Não
EXPO_PUBLIC_AIRYSCHAT_BASE_URL	URL da instalação self-hosted	https://app.airyschat.com	Sim
EXPO_PUBLIC_JUNE_SDK_KEY	Chave SDK de analytics do June	-	Não
EXPO_PUBLIC_MINIMUM_AIRYSCHAT_VERSION	Versão mínima suportada do AirysChat	-	Sim
EXPO_PUBLIC_SENTRY_DSN	URL DSN do Sentry para relatórios de erro	-	Não
EXPO_PUBLIC_PROJECT_ID	Identificador do projeto Expo	-	Sim
EXPO_PUBLIC_APP_SLUG	Slug do aplicativo para o Expo	-	Sim
EXPO_PUBLIC_SENTRY_PROJECT_NAME	Nome do projeto no Sentry	-	Não
EXPO_PUBLIC_SENTRY_ORG_NAME	Nome da organização no Sentry	-	Não
EXPO_PUBLIC_IOS_GOOGLE_SERVICES_FILE	Caminho para o arquivo config do iOS	-	Não
EXPO_PUBLIC_ANDROID_GOOGLE_SERVICES_FILE	Caminho para o arquivo config do Android	-	Não
EXPO_APPLE_ID	ID da conta do Apple Developer	-	Não
EXPO_APPLE_TEAM_ID	ID da equipe do Apple Developer	-	Não
EXPO_STORYBOOK_ENABLED	Ativar/desativar Storybook	false	Nã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

Problemas no Metro bundler

Problema: O Metro bundler falha ao iniciar ou empacotarSolução:

# Limpar cache e reiniciar
pnpm clear
pnpm start --reset-cache

Falha no build do iOS

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

Falha no build do Android

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

Problemas no Expo CLI

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:

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

Obtendo Ajuda

Se você encontrar problemas:

Documentação do Expo: Docs Oficiais do Expo
Documentação do React Native: Docs do React Native
Problemas no GitHub: Problemas do App Móvel
Suporte da Comunidade: Discord

Recursos Úteis

Desenvolvimento com Expo: https://docs.expo.dev/
React Native: https://reactnative.dev/
EAS Build: https://docs.expo.dev/build/introduction/
EAS Submit: https://docs.expo.dev/submit/introduction/

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

Getting Started

Environment Setup

Project Setup

Testing

Others

Configuração de Desenvolvimento do Aplicativo Móvel

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

Instalação e configuração

Pré-requisitos

Clonar o repositório

Instalar dependências

Instalar o Expo CLI

Variáveis de Ambiente

Gerar o código nativo

Como executar o aplicativo

Desenvolvimento iOS

Desenvolvimento Android

Instalação de Pacotes

Notificações push

Solução de problemas

Diretrizes de Contribuição

Obtendo Ajuda

Recursos Úteis

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

​Instalação e configuração

​Pré-requisitos

​Clonar o repositório

​Instalar dependências

​Instalar o Expo CLI

​Variáveis de Ambiente

​Gerar o código nativo

​Como executar o aplicativo

​Desenvolvimento iOS

​Desenvolvimento Android

​Instalação de Pacotes

​Notificações push

​Solução de problemas

​Diretrizes de Contribuição

​Obtendo Ajuda

​Recursos Úteis

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

Instalação e configuração

Pré-requisitos

Clonar o repositório

Instalar dependências

Instalar o Expo CLI

Variáveis de Ambiente

Gerar o código nativo

Como executar o aplicativo

Desenvolvimento iOS

Desenvolvimento Android

Instalação de Pacotes

Notificações push

Solução de problemas

Diretrizes de Contribuição

Obtendo Ajuda

Recursos Úteis