feat(apple): SwiftUI documentation (#6046)

 SwiftUI documentation

Co-authored-by: Philipp Hofmann <[email protected]>
Co-authored-by: Liza Mock <[email protected]>

Author: 3 people

src/platform-includes/getting-started-config/apple.mdx

@@ -81,6 +81,10 @@ SentrySDK.start { options in
 }];
 ```
 
+## Use Sentry with SwiftUI
+
+If you want to find out the performance of your Views in a SwiftUI project, [try the SentrySwiftUI library](/platforms/apple/performance/instrumentation/swiftui-instrumentation).
+
 ## Provide Debug Information {#debug-symbols}
 
 Before capturing crashes, you need to provide debug information to Sentry. Debug information is provided by <PlatformLink to="/dsym">uploading dSYM files</PlatformLink>.

src/platforms/apple/common/performance/instrumentation/nested-view-transaction.png

@@ -0,0 +1,69 @@
+---
+title: SwiftUI Instrumentation
+sidebar_order: 12
+description: "Learn how to monitor the performance of your SwiftUI views."
+---
+
+<Include name="beta-note.mdx" />
+
+You can monitor the performance of your views in a SwiftUI project with the SentrySwiftUI library, which you can install via <PlatformLink to="/install/swift-package-manager/">SPM (Swift package manager)</PlatformLink>.
+
+> If you plan to add _SentrySwiftUI_, you don`t need to also add _Sentry_ library since the former dependents on the latter.
+
+In order to start monitoring the performance of your views, you need to wrap it with `SentryTracedView`, like this:
+```swift {tabTitle:Swift}
+
+import SentrySwiftUI
+
+var body: some View {
+    SentryTracedView("<Name of your view>"){
+        List {
+            // Your SwiftUI code ...
+        }
+    }
+}
+```
+
+You may omit the transaction name, Sentry will use the root view type as name, in the previous example the transaction name would be `List`.
+
+Alternatively, you can use a modifier like this:
+
+```swift {tabTitle:Swift}
+
+import SentrySwiftUI
+
+var body: some View {
+    List {
+        // Your SwiftUI code ...
+    }.sentryTrace("<Name of your view>")
+}
+```
+
+It is possible to use nested `SentryTracedView` to have a more granular transaction.
+
+
+```swift {tabTitle:Swift}
+
+import SentrySwiftUI
+
+var body: some View {
+    SentryTracedView("My Awesome Screen"){
+        HStack {
+            SentryTracedView("Menu") {
+                List{
+                    // Your SwiftUI code ...
+                }
+            }
+            SentryTracedView("Content") {
+                VStack{
+                    // Your SwiftUI code ...
+                }
+            }
+        }
+    }
+}
+```
+
+This is the result
+
+![Transaction with nested traced views](nested-view-transaction.png)

src/platforms/apple/common/performance/instrumentation/swiftui-instrumentation.mdx

@@ -108,3 +108,7 @@ SentrySDK.start { options in
     options.enableMetricKit = true
 }
 ```
+
+## Performance Monitoring for SwiftUI
+
+If you want to find out the performance of your Views in a SwiftUI project, [try the SentrySwiftUI library](/platforms/apple/performance/instrumentation/swiftui-instrumentation).