Configurando badges

Nota

Para configurar badges para os plugins Cordova ou React Native, consulte os guias correspondentes:

• Badges para Cordova
• Badges para React Native

A partir da versão 6.4.0 do SDK do Pushwoosh para iOS, o processo de gerenciamento e configuração de badges por meio de notificações push mudou.

Se você estava usando anteriormente o número de badges para indicar o número de notificações push recebidas em seu aplicativo, você deve migrar para uma versão mais recente do SDK para iOS (6.4.0 ou posterior). As versões mais antigas serão suportadas até o final do segundo trimestre de 2022.

Como configurar badges

Para configurar os badges, siga os passos abaixo:

1. Adicione a Notification Service Extension (File -> New -> Target…)

2. Selecione a “Notification Service Extension”

3. Substitua a classe NotificationService gerada por uma subclasse de PushwooshNotificationServiceExtension. O Pushwoosh lida com a contagem de badges, evento de entrega, download de anexos e o fallback de timeout para você:

Swift

import PushwooshFramework

class NotificationService: PushwooshNotificationServiceExtension {}

Objective-C

#import <PushwooshFramework/PushwooshFramework.h>

@interface NotificationService : PushwooshNotificationServiceExtension
@end

@implementation NotificationService
@end

4. Adicione a capacidade de App Groups a ambos os alvos — o aplicativo principal e a Notification Service Extension — e use o mesmo App Group para cada um.

5. Adicione o ID do App Group ao info.plist do aplicativo principal:

<key>PW_APP_GROUPS_NAME</key>
<string>group.com.example.demoapp_example</string>

A extensão herda esse valor do aplicativo host, então você não precisa repeti-lo no info.plist da extensão — adicione-o lá apenas para substituir o valor do host.

Se você preferir não usar o arquivo info.plist, forneça o App Group no código, sobrescrevendo pushwooshAppGroupsName em sua classe NotificationServiceExtension:

Swift

override func pushwooshAppGroupsName() -> String? {
    "group.com.example.demoapp_example"
}

Objective-C

- (NSString *)pushwooshAppGroupsName {
    return @"group.com.example.demoapp_example";
}

Exemplo

Enviar uma notificação push com badges

Se você deseja enviar uma notificação push com badges a partir do Painel de Controle do Pushwoosh, basta adicionar o valor de badge desejado ao campo de texto badges, como mostrado na imagem abaixo:

Nota

Você pode usar os seguintes formatos de valor para enviar badges corretamente: +1, -1 ou 5. Se você quiser incrementar o valor do badge, use o sinal ”+”, se quiser decrementar os badges, use o sinal ”-”. Você também pode definir o número exato usando, por exemplo, 5 sem sinal.

Compartilhe seu feedback conosco

Seu feedback nos ajuda a criar uma experiência melhor, então adoraríamos ouvir de você se tiver algum problema durante o processo de integração do SDK. Se você enfrentar alguma dificuldade, não hesite em compartilhar suas opiniões conosco através deste formulário.