Skip to content

feat(push-notifications)!: remove deprecated alert presentation option on iOS#2531

Merged
OS-ruimoreiramendes merged 5 commits into
nextfrom
feat/RMET-5102/deprecate-alert-next
May 15, 2026
Merged

feat(push-notifications)!: remove deprecated alert presentation option on iOS#2531
OS-ruimoreiramendes merged 5 commits into
nextfrom
feat/RMET-5102/deprecate-alert-next

Conversation

@OS-ruimoreiramendes
Copy link
Copy Markdown
Contributor

@OS-ruimoreiramendes OS-ruimoreiramendes commented May 15, 2026

Description

Removed the deprecated .alert presentation option on iOS.

BREAKING CHANGE: alert presentation option is no longer supported on iOS. Use banner and list instead.

Reference: https://outsystemsrd.atlassian.net/browse/RMET-5102

Change Type

  • Fix
  • Feature
  • Refactor
  • Breaking Change
  • Documentation

Rationale / Problems Fixed

.alert in UNNotificationPresentationOptions was deprecated in iOS 14 and replaced by the more granular .banner and .list. Following the backwards-compatible change introduced in the previous PR, this PR removes .alert support on iOS entirely.

Tests or Reproductions

Tested on a physical iOS device using the Xcode Push Notifications Console with the following presentationOptions combinations:

  • ["banner", "list", "sound"]: banner appears + sound plays + notification in notification center
  • ["banner", "sound"]: banner appears + sound plays
  • ["list", "sound"]: no banner + sound plays + notification in notification center
  • ["alert", "sound"]: on Android shows notification; on iOS is ignored

Platforms Affected

  • Android
  • iOS
  • Web

@OS-pedrogustavobilro
Copy link
Copy Markdown
Contributor

@OS-ruimoreiramendes similarly to my comment on the local notifications next PR and what we discussed yesterday, I think the changes that come from main should be merged straight into next (as in git merge + push, not a PR)

@OS-ruimoreiramendes
Copy link
Copy Markdown
Contributor Author

@OS-ruimoreiramendes similarly to my comment on the local notifications next PR and what we discussed yesterday, I think the changes that come from main should be merged straight into next (as in git merge + push, not a PR)

I can merge main into next directly. For push-notifications I'll still need a separate PR targeting next to remove the alert option on iOS, since that's a breaking change.

@github-actions
Copy link
Copy Markdown

github-actions Bot commented May 15, 2026

Released dev build of push-notifications with dev version: 8.1.1-dev-2531-20260515T160602.0

@OS-ruimoreiramendes OS-ruimoreiramendes changed the title feat(push-notifications)!: remove deprecated alert and add banner and list presentation options on iOS feat(push-notifications)!: remove deprecated alert presentation option on iOS May 15, 2026
Copy link
Copy Markdown
Contributor

@OS-pedrogustavobilro OS-pedrogustavobilro left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I'm leaving a comment that doesn't impact this PR, but may involve changes, whenever you can take a look 🙏

| **`presentationOptions`** | <code>PresentationOption[]</code> | This is an array of strings you can combine. Possible values in the array are: - `badge`: badge count on the app icon is updated (default value) - `sound`: the device will ring/vibrate when the push notification is received - `alert`: **Deprecated on iOS.** Use `banner` and `list` instead. On Android, this value is still used to display the notification. - `banner`: the push notification is displayed as a banner - `list`: the push notification is displayed in the notification center An empty array can be provided if none of the options are desired. badge is only available for iOS. | 1.0.0 |
| Prop | Type | Description | Since |
| ------------------------- | --------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----- |
| **`presentationOptions`** | <code>PresentationOption[]</code> | This is an array of strings you can combine. Possible values in the array are: - `badge`: badge count on the app icon is updated (default value) - `sound`: the device will ring/vibrate when the push notification is received - `alert`: the push notification is displayed in a native dialog. Only available on Android. - `banner`: the push notification is displayed as a banner. On Android, defaults to the same behavior as `alert`. - `list`: the push notification is displayed in the notification center. On Android, defaults to the same behavior as `alert`. An empty array can be provided if none of the options are desired. badge is only available for iOS. | 1.0.0 |
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Just noticed, slipped me from PR to main, think this readme update for "On Android, defaults to the same behavior as alert" is missing. It's on definitions, but perhaps it was missing a npm run build on the PR to main?

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Already fixed it, seems to be good now.

@OS-ruimoreiramendes OS-ruimoreiramendes merged commit 9c95fe2 into next May 15, 2026
9 checks passed
@OS-ruimoreiramendes OS-ruimoreiramendes deleted the feat/RMET-5102/deprecate-alert-next branch May 15, 2026 16:20
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants