Início rápido do SDK para iOS 7.0+

Comece a usar o SDK Pushwoosh para iOS com este exemplo rápido e simples.

O que há de novo no SDK para iOS 7.0+

A partir da versão 7.0, o SDK Pushwoosh para iOS foi redesenhado com uma arquitetura totalmente modular. O SDK agora está dividido em módulos separados: PushwooshFramework, PushwooshCore, PushwooshBridge e PushwooshLiveActivities são necessários para a integração básica, enquanto PushwooshForegroundPush, PushwooshVoIP e PushwooshTVOS podem ser adicionados opcionalmente com base nas suas necessidades.

Essa abordagem modular permite que você inclua apenas os recursos que seu aplicativo realmente usa, reduzindo o tamanho final do binário e melhorando os tempos de compilação. Cada módulo pode ser atualizado de forma independente, facilitando a adoção de novos recursos sem afetar o restante da sua integração.

Esta versão introduz suporte nativo ao Swift Package Manager para um gerenciamento de dependências mais fácil, juntamente com uma interoperabilidade aprimorada com o Swift em todos os módulos. A documentação agora está embutida diretamente nos frameworks binários, para que você possa acessar a referência da API e exemplos de código diretamente no Xcode através do Quick Help e da janela de Documentação do Desenvolvedor. Novos recursos incluem suporte completo para Live Activities do iOS 16+ com integração da Dynamic Island, notificações push em primeiro plano personalizáveis com banners animados e feedback tátil, capacidades de VoIP aprimoradas e um módulo tvOS dedicado para aplicativos da Apple TV.

Pré-requisitos

Para integrar o SDK Pushwoosh para iOS em seu aplicativo, você precisará do seguinte:

Requisitos

• Uma conta Pushwoosh
• Um projeto Pushwoosh configurado na sua conta.
• Uma plataforma iOS configurada para enviar notificações push. Recomendamos usar a configuração de Autenticação Baseada em Token como a abordagem mais simples.
• Durante a configuração, defina o Gateway como Sandbox para enviar pushes para um simulador.
• O seu Pushwoosh Application Code e o Token de API de Dispositivo Pushwoosh do Painel de Controle Pushwoosh para o seu aplicativo.

Baixe o projeto de exemplo

Clone o projeto de exemplo do GitHub:

git clone https://github.com/Pushwoosh/pushwoosh-ios-sample.git

Configure o projeto

1. Abra o projeto no Xcode.

2. Adicione https://github.com/Pushwoosh/Pushwoosh-XCFramework como Swift Package Dependency.

3. Defina o bundle identifier para o target principal (PushwooshSampleApp) para corresponder ao seu projeto Pushwoosh (por exemplo, com.pushwoosh.PushwooshSampleApp).

4. Use o mesmo bundle identifier para o target NotificationService, anexando .NotificationService (por exemplo, com.pushwoosh.PushwooshSampleApp.NotificationService).

5. Em Info.plist, defina:

   • a chave Pushwoosh_APPID para o Código de Aplicação Pushwoosh
   • a chave Pushwoosh_API_TOKEN para o Token da API de Dispositivo Pushwoosh

Importante: Certifique-se de dar ao token acesso ao aplicativo correto no seu Painel de Controle Pushwoosh. Saiba mais

Execute o projeto

1. Compile e execute o projeto.
2. O aplicativo terá duas abas: “Actions” e “Settings”. Navegue para a aba Settings.
3. Toque no botão Register for Pushes.
4. Conceda permissão para notificações push. O dispositivo será registrado no Pushwoosh.

Você deverá ver uma entrada de log como esta:

Pushwoosh: Initializing application runtime
[PW] BUNDLE ID: __YOUR_BUNDLE_ID__
[PW] APP CODE: __YOUR_APP_CODE__
[PW] PUSHWOOSH SDK VERSION: 7.0.0
[PW] HWID: __YOUR_HWID__
[PW] PUSH TOKEN: (null)
[PW] [I] -[PWNotificationManagerCompatiOS10] NotificationCenter authorization granted: 1
[PW] [I] -[PWPushNotificationsManagerCommon] Registered for push notifications: __YOUR_PUSH_TOKEN__

Seu dispositivo agora está registrado no Pushwoosh.

Envie uma notificação push

Volte para o Painel de Controle do Pushwoosh e envie uma notificação push para o seu dispositivo registrado.

Migrando do SDK 6.x

Se você está atualizando da versão 6.x do SDK, a principal mudança é como você acessa a instância do Pushwoosh. Na versão 7.0+, use Pushwoosh.configure em vez de Pushwoosh.sharedInstance():

Antes (6.x):

Pushwoosh.sharedInstance().registerForPushNotifications()
Pushwoosh.sharedInstance().delegate = self

Depois (7.0+):

Pushwoosh.configure.registerForPushNotifications()
Pushwoosh.configure.delegate = self

Todas as outras APIs permanecem as mesmas, então a atualização do seu código requer apenas a substituição de sharedInstance() por configure em todo o seu projeto.

Próximos passos

Para saber mais, consulte o guia de integração básica