Habilitar suporte para geofences e iBeacons
Os serviços de localização permitem adicionar regiões de geofence ou iBeacon relacionadas ao seu app na plataforma Xtremepush. Isso permite que você analise o público do seu aplicativo, visitas aos seus locais e acione notificações quando eles entram/saem/permanecem em seus locais.
Habilitar serviços de localização
Na integração padrão do SDK do iOS, os Serviços de Localização estão desligados.
Eles podem ser ativados usando esse setLocationEnabled método.
func application(_ application: UIApplication, didFinishLaunchingWithOptions launchOptions: [UIApplicationLaunchOptionsKey: Any]?) -> Bool {
// ...
XPush.setLocationEnabled(true)
// ...
XPush.applicationDidFinishLaunching(options: launchOptions)
return true
}- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions
{
// ...
[XPush setLocationEnabled:YES];
// ...
[XPush applicationDidFinishLaunchingWithOptions:launchOptions];
return YES;
}Você também precisa adicionar as seguintes chaves de descrição de uso e o texto associado para a localização do seu Info.plist arquivo. Ele será mostrado ao usuário no diálogo de permissões de localização.
NSLocationAlwaysUsageDescriptionNSLocationAlwaysAndWhenInUseUsageDescriptionNSLocationWhenInUseUsageDescription
Sem isso, seu aplicativo não solicitará permissão de localização. Você deve explicar explicitamente por que seu app precisa da permissão Always para qualquer uso que você o utilize, por exemplo, notificando sobre experiências especiais no estádio no dia do jogo, adicionando pontos de recompensa quando você visita nossa loja, etc.
.png?sv=2026-02-06&spr=https&st=2026-10-03T08%3A12%3A18Z&se=2026-10-03T08%3A25%3A18Z&sr=c&sp=r&sig=KFCXgGxPMwSgziI3I6q8FXuIW%2FGj2ZFzxwwOZV92yk8%3D)
Lembrete de uso periódico em segundo plano do iOS 13
A partir do iOS 13 (setembro de 2019), o sistema operacional exibe periodicamente um prompt para lembrar o usuário sobre aplicativos usando a localização em segundo plano (ou seja, aqueles que receberam a permissão Sempre ). O usuário deve confirmar permissão contínua para acessar o local.
O prompt inclui um mapa mostrando onde seu app acionou geofences e onde ele verificou a localização para garantir que as geofences próximas estavam configuradas corretamente. A descrição do uso da sua localização é repetida aqui, então você deve verificar se a descrição descreve corretamente como você usa os dados de localização, ou corre o risco de perder a confiança do usuário e, com ela, seus privilégios de acesso à localização em segundo plano.
.png?sv=2026-02-06&spr=https&st=2026-10-03T08%3A12%3A18Z&se=2026-10-03T08%3A25%3A18Z&sr=c&sp=r&sig=KFCXgGxPMwSgziI3I6q8FXuIW%2FGj2ZFzxwwOZV92yk8%3D)
Alterações no iOS 13 na concessão de permissão de localização
A partir do iOS 13 (setembro de 2019), os aplicativos que solicitam a permissão Sempre mostram uma opção Permitir Uma Vez para o usuário no primeiro prompt de localização do aplicativo.
Se o usuário escolher Permitir uma vez, o aplicativo recebe permissão de localização apenas para uma única sessão em primeiro plano. Quando o usuário sai do aplicativo ou bloqueia o dispositivo, a permissão expira automaticamente e o aviso é exibido novamente no próximo uso dos serviços de localização.
Se o usuário concordar com Enquanto Está Usando o App , no futuro, quando seu app normalmente receberia um evento de localização em segundo plano (por exemplo, um evento de região de entrar beacon), o usuário terá uma opção para atualizar a permissão para Sempre. Se isso acontecer, seu aplicativo receberá o evento em segundo plano.
.png?sv=2026-02-06&spr=https&st=2026-10-03T08%3A12%3A18Z&se=2026-10-03T08%3A25%3A18Z&sr=c&sp=r&sig=KFCXgGxPMwSgziI3I6q8FXuIW%2FGj2ZFzxwwOZV92yk8%3D)
Ative o Bluetooth para iBeacons
Desde a versão 4.1.0 do Xtremepush SDK, você deve habilitar explicitamente o suporte para iBeacons. Isso é para evitar que seus usuários sejam solicitados (desde o iOS 13 em setembro de 2019) a permitir o acesso a serviços Bluetooth, a menos que você precise especificamente.
.png?sv=2026-02-06&spr=https&st=2026-10-03T08%3A12%3A18Z&se=2026-10-03T08%3A25%3A18Z&sr=c&sp=r&sig=KFCXgGxPMwSgziI3I6q8FXuIW%2FGj2ZFzxwwOZV92yk8%3D)
Para habilitar o suporte a iBeacons e pedir aos seus usuários que permitam o acesso ao Bluetooth:
Siga os passos acima para habilitar os Serviços de Localização
Adicione a seguinte chamada de método imediatamente após a chamada ao
setLocationEnabled:
XPush.setBeaconsEnabled(true)[XPush setBeaconsEnabled:YES];Adicione a
NSBluetoothAlwaysUsageDescriptionchave e a descrição de uso associada ao seuInfo.plistarquivo para explicar o uso do Bluetooth aos seus usuários.Em contraste com o existente
NSBluetoothPeripheralUsageDescriptionnecessário para integrar o SDK do iOS, essa nova descrição será exibida como parte do pedido de permissão Bluetooth e também no app Configurações nas telas de Privacidade Bluetooth.