Perguntas Frequentes
Bem-vindo à seção de perguntas frequentes do SDK da Group Link One.
Este guia reúne respostas claras e objetivas para as principais dúvidas que podem surgir durante e após a integração do SDK em seu aplicativo.
As orientações abrangem as implementações nativas para Android e iOS, além de todas as integrações multiplataforma documentadas.
Caso não encontre a sua dúvida, entre em contato com a nossa equipe de suporte.
Compatibilidade e impacto no tamanho do aplicativo
Quais plataformas e frameworks de desenvolvimento são suportados?
Android e iOS nativos, além dos frameworks multiplataforma documentados: Flutter, Ionic, React Native, Expo, Kotlin Multiplatform e OutSystems. Cada framework tem o seu próprio guia nas documentações do SDK.
Quais são as versões mínimas de sistema operacional suportadas?
Nas integrações nativas, as versões mínimas são Android 6.0 (API level 23) e iOS 15.0.
Integrações multiplataforma podem exigir versões mínimas maiores, impostas pelo próprio framework e não pelo SDK. Consulte sempre o guia do framework que você utiliza antes de definir a faixa de compatibilidade do seu aplicativo.
Qual o impacto do SDK no tamanho do meu aplicativo?
Valores aproximados de referência:
| Plataforma | Tamanho aproximado |
|---|---|
| Android | ~ 1,2 MB |
| iOS | O pacote de distribuição tem ~ 6 MB, por conter builds para diversas arquiteturas (iOS, MacOS e Simulador); Apenas o build correspondente ao dispositivo de destino é incorporado ao aplicativo publicado, o que equivale a ~ 1 MB |
O impacto final no tamanho percebido pelo usuário final costuma ser menor, porque as lojas de aplicativos otimizam o pacote entregue a cada aparelho. Esses valores variam ligeiramente entre versões.
Permissões
Quais permissões o SDK exige?
A lista exata, com as declarações e as solicitações em tempo de execução de cada plataforma, estão em permissões necessárias no Android e permissões necessárias no iOS.
Já adicionei o SDK — por que o meu aplicativo ainda precisa declarar as permissões?
O sistema operacional concede as permissões ao aplicativo, e não aos componentes que ele incorpora. Por isso a configuração de permissões é uma etapa obrigatória de todos os guias.
Por que a integração Android menciona uma permissão para notificações em tela cheia?
A permissão USE_FULL_SCREEN_INTENT é usada pelo nosso SDK para exibir a notificação em tela cheia no momento em que o aparelho entra em contato com um dispositivo Bluetooth, capacitando o sensor a iniciar uma intenção de tela cheia para processamento do fluxo de trabalho dos sinais.
Quais diálogos de localização aparecem no iOS, e quando?
Três diálogos diferentes podem ser apresentados, e apenas o primeiro está sob o controle do seu aplicativo:
- Solicitação de permissão de localização — exibida quando o seu aplicativo a solicita em tempo de execução. É necessário solicitá-la durante o onboarding, com uma explicação clara da finalidade.
- Solicitação de localização em segundo plano — exibida quando o seu aplicativo a solicita em tempo de execução, após a permissão de localização ter sido concedida, ou lançado automáticamente pelo iOS por iniciativa dele.
- Aviso sobre o uso em segundo plano — exibida pelo sistema operacional (iOS), informando ao usuário quantas vezes o aplicativo utilizou a localização em segundo plano. É exibido a critério do sistema operacional (iOS), o seu aplicativo e o SDK não controlam quando ela aparece.
Explicar o motivo do uso da localização durante o onboarding, tem impacto direto sobre a quantidade de usuários que mantêm a autorização mais ampla, impactando o volume de informações coletadas.
O que acontece se o usuário negar alguma das permissões?
O SDK se adapta às permissões concedidas: continua operando com menor efetividade. Ele não interrompe o seu aplicativo e não exibe mensagens de erro.
O SDK rastreia a localização dos meus usuários continuamente?
Não. A localização é captada em momentos específicos, não de forma contínua, e agrupada em um mapa de células H3, na qual não contém a posição exata dos dispositivos.
Comportamento em produção
O comportamento é idêntico no Android e no iOS?
O SDK oferece as mesmas capacidades nas duas plataformas, porém os dois sistemas operacionais gerenciam Bluetooth e localização de maneiras diferentes.
Bateria e consumo de dados
Qual é o consumo de bateria do SDK?
O SDK é projetado para ter baixo impacto: utiliza o rádio Bluetooth de baixa energia (BLE), solicita a localização apenas em momentos específicos em vez de mantê-la continuamente ativa e permanece ocioso quando não há sinais relevantes por perto.
O impacto medido depende do modelo do aparelho, da versão do sistema operacional e principalmente de quanto tempo ele passa próximo a dispositivos Group Link.
Qual é o consumo de dados móveis do SDK?
Muito baixo. Cada transmissão carrega alguns kilobytes e períodos sem nenhum dispositivo relevante por perto geram praticamente nenhum tráfego.
Atualizações do SDK
Como as novas versões do SDK são disponibilizadas?
As novas versões do SDK são publicadas pelos gerenciadores de pacotes padrão de cada plataforma:
| Plataforma | Gerenciador de pacotes |
|---|---|
| iOS | CocoaPods e SPM |
| Android | JitPack |
| Flutter | pub.dev |
| Ionic, React Native e Expo | npm |
| OutSystems | Forge |
É de extrema importância manter sempre o SDK atualizado, pois as novas versões acompanham melhorias, correções de bugs e novas funcionalidades.
Não encontrou a sua dúvida?
Consulte a documentação do SDK, que cobre instalação, permissões e inicialização passo a passo.
Se a dúvida permanecer, entre em contato com a nossa equipe de suporte.
Última atualização: 16 de setembro de 2026