From 4cf2bbac5012ac2cdcc2160bed43ed85fe250038 Mon Sep 17 00:00:00 2001 From: Louis Bur Date: Tue, 2 Apr 2024 12:10:57 +0200 Subject: [PATCH 1/9] visionOS initial documentation --- .../swift/visionos.md | 42 +++++++++++++++++++ 1 file changed, 42 insertions(+) create mode 100644 _docs/_developer_guide/platform_integration_guides/swift/visionos.md diff --git a/_docs/_developer_guide/platform_integration_guides/swift/visionos.md b/_docs/_developer_guide/platform_integration_guides/swift/visionos.md new file mode 100644 index 0000000000..a963579e9b --- /dev/null +++ b/_docs/_developer_guide/platform_integration_guides/swift/visionos.md @@ -0,0 +1,42 @@ +--- +nav_title: visionOS +article_title: visionOS +page_order: 7.2 +platform: + - iOS +description: "visionOS support" +--- + +# visionOS + +With the release of the Apple Vision Pro, Apple has introduced a new platform called visionOS. Starting with the Braze Swift SDK [8.0.0](https://github.com/braze-inc/braze-swift-sdk/blob/main/CHANGELOG.md#800), visionOS is supported as a first class platform. + +> Please refer to our [sample apps]({{site.baseurl}}/developer_guide/platform_integration_guides/swift/sample_apps/) for working examples of visionOS integration. + +## Supported Features + +Most of the features available on iOS are supported on visionOS. This includes: +- Analytics (sessions, custom events, purchases, etc.) +- In-App Messaging (data models and UI) +- Content Cards (data models and UI) +- Push Notifications +- Feature Flags +- Location Analytics + +## Partially Supported Features + +The following features are partially supported on visionOS: +- Rich Push Notifications + - Images display as expected + - GIFs and videos display the preview thumbnail, it is not currently possible to play the media + - Audio playback is not supported +- Push Stories + - The _Next_ button to navigate between Push Story pages is not working as intended + - Scrolling and clicking on the Push Story page works as expected + +We expect that future visionOS updates will address these limitations. + +## Unsupported Features + +Currently, Geofences Monitoring is not supported. The geofences related CoreLocation APIs are not made available by Apple on visionOS. + From eb4d41f3624b87b2e1a2167b6326de4fa4c3b1c4 Mon Sep 17 00:00:00 2001 From: Louis Bur Date: Wed, 3 Apr 2024 18:12:00 +0200 Subject: [PATCH 2/9] Apply suggestions from code review Co-authored-by: Jackson Miller <71667842+jacksonemiller@users.noreply.github.com> Co-authored-by: Jeriel Ng --- .../platform_integration_guides/swift/visionos.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/_docs/_developer_guide/platform_integration_guides/swift/visionos.md b/_docs/_developer_guide/platform_integration_guides/swift/visionos.md index a963579e9b..5abe05365a 100644 --- a/_docs/_developer_guide/platform_integration_guides/swift/visionos.md +++ b/_docs/_developer_guide/platform_integration_guides/swift/visionos.md @@ -9,7 +9,7 @@ description: "visionOS support" # visionOS -With the release of the Apple Vision Pro, Apple has introduced a new platform called visionOS. Starting with the Braze Swift SDK [8.0.0](https://github.com/braze-inc/braze-swift-sdk/blob/main/CHANGELOG.md#800), visionOS is supported as a first class platform. +With the release of the Apple Vision Pro, Apple has introduced a new platform called visionOS. Starting with the Braze Swift SDK [8.0.0](https://github.com/braze-inc/braze-swift-sdk/blob/main/CHANGELOG.md#800), visionOS is supported as a first-class platform. > Please refer to our [sample apps]({{site.baseurl}}/developer_guide/platform_integration_guides/swift/sample_apps/) for working examples of visionOS integration. @@ -38,5 +38,5 @@ We expect that future visionOS updates will address these limitations. ## Unsupported Features -Currently, Geofences Monitoring is not supported. The geofences related CoreLocation APIs are not made available by Apple on visionOS. - +- Currently, Geofences Monitoring is not supported. The Core Location APIs for region monitoring are not made available by Apple on visionOS. +- Live Activities are not supported, as ActivityKit is only available on iOS and iPadOS. From 3dd4350e00f0f823bdf2345a09992f80c05bd991 Mon Sep 17 00:00:00 2001 From: Louis Bur Date: Thu, 4 Apr 2024 10:06:09 +0200 Subject: [PATCH 3/9] Update _docs/_developer_guide/platform_integration_guides/swift/visionos.md Co-authored-by: Daniel Hok <4797040+hokstuff@users.noreply.github.com> --- .../platform_integration_guides/swift/visionos.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/_docs/_developer_guide/platform_integration_guides/swift/visionos.md b/_docs/_developer_guide/platform_integration_guides/swift/visionos.md index 5abe05365a..3ade76a5fb 100644 --- a/_docs/_developer_guide/platform_integration_guides/swift/visionos.md +++ b/_docs/_developer_guide/platform_integration_guides/swift/visionos.md @@ -28,7 +28,7 @@ Most of the features available on iOS are supported on visionOS. This includes: The following features are partially supported on visionOS: - Rich Push Notifications - Images display as expected - - GIFs and videos display the preview thumbnail, it is not currently possible to play the media + - GIFs and videos display the preview thumbnail, but it is not currently possible to play the media - Audio playback is not supported - Push Stories - The _Next_ button to navigate between Push Story pages is not working as intended From 6da6dfb4c24d33327cf4a66ac3cc73fc949e5901 Mon Sep 17 00:00:00 2001 From: Louis Bur Date: Thu, 4 Apr 2024 10:06:29 +0200 Subject: [PATCH 4/9] Update _docs/_developer_guide/platform_integration_guides/swift/visionos.md Co-authored-by: Vanessa Landayan --- .../platform_integration_guides/swift/visionos.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/_docs/_developer_guide/platform_integration_guides/swift/visionos.md b/_docs/_developer_guide/platform_integration_guides/swift/visionos.md index 3ade76a5fb..dd9b08cf05 100644 --- a/_docs/_developer_guide/platform_integration_guides/swift/visionos.md +++ b/_docs/_developer_guide/platform_integration_guides/swift/visionos.md @@ -4,7 +4,7 @@ article_title: visionOS page_order: 7.2 platform: - iOS -description: "visionOS support" +description: "This article covers the features supported on visionOS." --- # visionOS From b274fc52f5f23c8143b70984574f0dc809866e84 Mon Sep 17 00:00:00 2001 From: Louis Bur Date: Thu, 4 Apr 2024 10:08:29 +0200 Subject: [PATCH 5/9] Update _docs/_developer_guide/platform_integration_guides/swift/visionos.md Co-authored-by: Daniel Hok <4797040+hokstuff@users.noreply.github.com> --- .../platform_integration_guides/swift/visionos.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/_docs/_developer_guide/platform_integration_guides/swift/visionos.md b/_docs/_developer_guide/platform_integration_guides/swift/visionos.md index dd9b08cf05..af9e521fd4 100644 --- a/_docs/_developer_guide/platform_integration_guides/swift/visionos.md +++ b/_docs/_developer_guide/platform_integration_guides/swift/visionos.md @@ -9,7 +9,7 @@ description: "This article covers the features supported on visionOS." # visionOS -With the release of the Apple Vision Pro, Apple has introduced a new platform called visionOS. Starting with the Braze Swift SDK [8.0.0](https://github.com/braze-inc/braze-swift-sdk/blob/main/CHANGELOG.md#800), visionOS is supported as a first-class platform. +With the release of the Apple Vision Pro, Apple has introduced a new platform called [visionOS](https://developer.apple.com/visionos/). Starting with the Braze Swift SDK [8.0.0](https://github.com/braze-inc/braze-swift-sdk/blob/main/CHANGELOG.md#800), visionOS is supported as a first-class platform. > Please refer to our [sample apps]({{site.baseurl}}/developer_guide/platform_integration_guides/swift/sample_apps/) for working examples of visionOS integration. From 8e46e6b364a27957dca95012a35dbe7b4926dfad Mon Sep 17 00:00:00 2001 From: Louis Bur Date: Thu, 4 Apr 2024 10:09:03 +0200 Subject: [PATCH 6/9] Update _docs/_developer_guide/platform_integration_guides/swift/visionos.md --- .../platform_integration_guides/swift/visionos.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/_docs/_developer_guide/platform_integration_guides/swift/visionos.md b/_docs/_developer_guide/platform_integration_guides/swift/visionos.md index af9e521fd4..17d0b6009a 100644 --- a/_docs/_developer_guide/platform_integration_guides/swift/visionos.md +++ b/_docs/_developer_guide/platform_integration_guides/swift/visionos.md @@ -19,7 +19,7 @@ Most of the features available on iOS are supported on visionOS. This includes: - Analytics (sessions, custom events, purchases, etc.) - In-App Messaging (data models and UI) - Content Cards (data models and UI) -- Push Notifications +- Push Notifications (user-visible, with action buttons and silent notifications) - Feature Flags - Location Analytics From a26e3fb88831141423d6a9e1de81512793064e39 Mon Sep 17 00:00:00 2001 From: isaiah robinson <95643215+internetisaiah@users.noreply.github.com> Date: Mon, 8 Apr 2024 17:55:51 -0700 Subject: [PATCH 7/9] Update visionos.md --- .../swift/visionos.md | 30 +++++++++---------- 1 file changed, 14 insertions(+), 16 deletions(-) diff --git a/_docs/_developer_guide/platform_integration_guides/swift/visionos.md b/_docs/_developer_guide/platform_integration_guides/swift/visionos.md index 17d0b6009a..50dcf88d0b 100644 --- a/_docs/_developer_guide/platform_integration_guides/swift/visionos.md +++ b/_docs/_developer_guide/platform_integration_guides/swift/visionos.md @@ -1,21 +1,20 @@ --- -nav_title: visionOS -article_title: visionOS +nav_title: visionOS support +article_title: visionOS support page_order: 7.2 platform: - iOS description: "This article covers the features supported on visionOS." --- -# visionOS +# visionOS support -With the release of the Apple Vision Pro, Apple has introduced a new platform called [visionOS](https://developer.apple.com/visionos/). Starting with the Braze Swift SDK [8.0.0](https://github.com/braze-inc/braze-swift-sdk/blob/main/CHANGELOG.md#800), visionOS is supported as a first-class platform. +> Starting with [Braze Swift SDK 8.0.0](https://github.com/braze-inc/braze-swift-sdk/blob/main/CHANGELOG.md#800), you can leverage Braze with [visionOS](https://developer.apple.com/visionos/), Apple's spacial-computing platform for the Apple Vision Pro. For a sample visionOS app using Braze, see [Sample Apps]({{site.baseurl}}/developer_guide/platform_integration_guides/swift/sample_apps/). -> Please refer to our [sample apps]({{site.baseurl}}/developer_guide/platform_integration_guides/swift/sample_apps/) for working examples of visionOS integration. +## Fully supported features -## Supported Features +Most features available on iOS are also available on visionOS, including: -Most of the features available on iOS are supported on visionOS. This includes: - Analytics (sessions, custom events, purchases, etc.) - In-App Messaging (data models and UI) - Content Cards (data models and UI) @@ -23,20 +22,19 @@ Most of the features available on iOS are supported on visionOS. This includes: - Feature Flags - Location Analytics -## Partially Supported Features +## Partially supported features -The following features are partially supported on visionOS: -- Rich Push Notifications +Some features are only partially supported on visionOS, but Apple is likely to address these limitations in the future: + +- Rich Push Notifications: - Images display as expected - GIFs and videos display the preview thumbnail, but it is not currently possible to play the media - Audio playback is not supported -- Push Stories +- Push Stories: - The _Next_ button to navigate between Push Story pages is not working as intended - Scrolling and clicking on the Push Story page works as expected -We expect that future visionOS updates will address these limitations. - -## Unsupported Features +## Unsupported features -- Currently, Geofences Monitoring is not supported. The Core Location APIs for region monitoring are not made available by Apple on visionOS. -- Live Activities are not supported, as ActivityKit is only available on iOS and iPadOS. +- Geofences Monitoring is not supported. Apple has not made the Core Location APIs for region monitoring available on visionOS. +- Live Activities are not supported. Currently, ActivityKit is only available on iOS and iPadOS. From b8a163443ed69aeb536fee476524aab8574eef61 Mon Sep 17 00:00:00 2001 From: isaiah robinson <95643215+internetisaiah@users.noreply.github.com> Date: Mon, 8 Apr 2024 18:05:09 -0700 Subject: [PATCH 8/9] Update visionos.md --- .../swift/visionos.md | 16 ++++++++-------- 1 file changed, 8 insertions(+), 8 deletions(-) diff --git a/_docs/_developer_guide/platform_integration_guides/swift/visionos.md b/_docs/_developer_guide/platform_integration_guides/swift/visionos.md index 50dcf88d0b..4f0cb897a8 100644 --- a/_docs/_developer_guide/platform_integration_guides/swift/visionos.md +++ b/_docs/_developer_guide/platform_integration_guides/swift/visionos.md @@ -18,7 +18,7 @@ Most features available on iOS are also available on visionOS, including: - Analytics (sessions, custom events, purchases, etc.) - In-App Messaging (data models and UI) - Content Cards (data models and UI) -- Push Notifications (user-visible, with action buttons and silent notifications) +- Push Notifications (user-visible with action buttons and silent notifications) - Feature Flags - Location Analytics @@ -26,13 +26,13 @@ Most features available on iOS are also available on visionOS, including: Some features are only partially supported on visionOS, but Apple is likely to address these limitations in the future: -- Rich Push Notifications: - - Images display as expected - - GIFs and videos display the preview thumbnail, but it is not currently possible to play the media - - Audio playback is not supported -- Push Stories: - - The _Next_ button to navigate between Push Story pages is not working as intended - - Scrolling and clicking on the Push Story page works as expected +- Rich Push Notifications + - Images are supported. + - GIFs and videos display the preview thumbnail, but cannot be played. + - Audio playback is not supported. +- Push Stories + - Scrolling and selecting the Push Story page is supported. + - Navigating between Push Story pages using **Next** is not supported. ## Unsupported features From c6d4149a64740107e6098eef4f24190dbc50f49e Mon Sep 17 00:00:00 2001 From: isaiah robinson <95643215+internetisaiah@users.noreply.github.com> Date: Mon, 8 Apr 2024 18:09:00 -0700 Subject: [PATCH 9/9] Update visionos.md --- .../platform_integration_guides/swift/visionos.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/_docs/_developer_guide/platform_integration_guides/swift/visionos.md b/_docs/_developer_guide/platform_integration_guides/swift/visionos.md index 4f0cb897a8..c127237fe6 100644 --- a/_docs/_developer_guide/platform_integration_guides/swift/visionos.md +++ b/_docs/_developer_guide/platform_integration_guides/swift/visionos.md @@ -24,7 +24,7 @@ Most features available on iOS are also available on visionOS, including: ## Partially supported features -Some features are only partially supported on visionOS, but Apple is likely to address these limitations in the future: +Some features are only partially supported on visionOS, but Apple is likely to address these in the future: - Rich Push Notifications - Images are supported.