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

Comece a usar o SDK da 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 da 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 Swift em todos os módulos. A documentação agora está incorporada 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. Os novos recursos incluem suporte total 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 da 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 na 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 na Pushwoosh.

Envie uma notificação push

Volte para o Painel de Controle da 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 da 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