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ê precisa migrar para uma versão mais recente do SDK do iOS (6.4.0 ou posterior). As versões mais antigas serão suportadas até o final do segundo trimestre de 2022.

O que determina o valor do badge

O badge sempre vem do próprio push. Nenhuma funcionalidade do Pushwoosh o define ou limpa por conta própria. Enviar "ios_badges" na solicitação /createMessage (ou o campo badges no Control Panel) define tanto aps.badge (o valor absoluto) quanto aps.pw_badge (o delta relativo) no payload do iOS. O Android carrega o valor equivalente em pw_badges e precisa do módulo com.pushwoosh:pushwoosh-badge para aplicá-lo em launchers suportados. Salvar um push na Message Inbox nunca define ou altera o badge. Os dois são efeitos independentes do mesmo push.

Cuidado

O valor relativo do badge +1/-1 é aplicado apenas pela Notification Service Extension, e somente quando ela está instalada e configurada com um App Group correspondente, conforme descrito abaixo. Sem essa configuração, o SO aplica o valor absoluto aps.badge do payload como está. Não há auto-incremento.

Como configurar badges

Para configurar 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 hospedeiro, então você não precisa repeti-lo no info.plist da extensão — adicione-o lá apenas para substituir o valor do hospedeiro.

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 Pushwoosh Control Panel, 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.