Permissões
A SDK coleta dados do dispositivo e, de acordo com o funcionamento do sistema operacional iOS, necessita de permissões específicas para cada dado a ser coletado. De maneira a oferecer uma experiência customizada para os usuários da aplicação que possua a SDK embarcado, implementamos um mecanismo que utiliza os parâmetros passados pelo desenvolvedor para solicitar as permissões ao usuário, seguindo a seguinte mecânica:
As permissões que forem enviadas como parâmetro do método requestPermissions
, no formato de String, são solicitadas ao usuário - a menos que já tenham sido solicitadas anteriormente.
O usuário, por meio de uma caixa de diálogo disponibilizada pelo próprio sistema operacional, é questionado sobre as permissões consideradas necessárias pelo framework.
As permissões são então concedidas ou negadas e, no momento que o método collectData
, este coletará apenas os dados cuja permissão foi concedida.
Caso seu aplicativo já tenha solicitado as permissões necessárias, não é necessário chamar novamente o método requestPermissions
, a SDK irá herdar as permissões solicitadas pelo aplicativo.
Permissões utilizadas pela SDK
Na versão atual da SDK, as seguintes permissões são utilizadas caso estejam disponíveis:
- location - Captura de dados de geolocalização do device
Arquivo Info.plist
O primeiro passo para disponibilizar permissões para a SDK é configurar a permissão no arquivo Info.plist da aplicação, utilizando a seguinte linha de código para cada uma das permissões desejadas:
- location - Captura de dados de geolocalização do device:
<key>NSLocationWhenInUseUsageDescription</key>
<string>Adicionar a mensagem que você deseja que apareça para o usuário quando o iOS solicitar a permissão de acesso à geolocalização</string>
Para melhorar a experiência do usuário no momento da solicitação das permissões você deve personalizar a mensagem reproduzida no pop-up de solicitação conforme descrito anteriormente.