feat(sdk): add kmp platform (#6452)

* add initial kmp platform setup

* add init strategies & improve docs

* add comment to init and remove android description

* review improvements

* add viewhierarchy

* doc review

* short introduction

* change file type to kts for build.gradle

* add experimental note

* review improvements

Author: buenaflor

src/platform-includes/capture-error/kotlin-multiplatform.mdx

@@ -0,0 +1,5 @@
+```kotlin
+import io.sentry.kotlin.multiplatform.Sentry
+
+Sentry.captureException(exception)
+```

src/platform-includes/capture-message/kotlin-multiplatform.mdx

@@ -0,0 +1,5 @@
+```kotlin
+import io.sentry.kotlin.multiplatform.Sentry
+
+Sentry.captureMessage("Something went wrong")
+```

src/platform-includes/configuration/config-intro/kotlin-multiplatform.mdx

@@ -0,0 +1,9 @@
+```kotlin
+import io.sentry.kotlin.multiplatform.Sentry
+
+// Application context is only needed for Android targets
+Sentry.init(context) { options ->
+  options.dsn = "___PUBLIC_DSN___"
+  options.release = "[email protected]+1"
+}
+```

src/platform-includes/configuration/drain-example/kotlin-multiplatform.mdx

@@ -0,0 +1 @@
+The Kotlin Multiplatform SDK uses native SDKs to automatically store Sentry events on the device's disk before shutdown.

src/platform-includes/enriching-events/add-attachment/kotlin-multiplatform.mdx

@@ -0,0 +1,16 @@
+To add an attachment, either add it to the scope or pass it to any of the `capture` methods.
+
+### Passing Attachments to Capture
+
+You can pass attachments to any of the `capture` methods. For example, when capturing an exception:
+
+```kotlin
+import io.sentry.kotlin.multiplatform.Attachment
+import io.sentry.kotlin.multiplatform.Sentry
+
+val fileAttachment = Attachment("your/path/file.log")
+
+Sentry.captureException(IllegalStateException()) { scope ->
+  scope.addAttachment(fileAttachment)
+}
+```

src/platform-includes/enriching-events/attach-screenshots/kotlin-multiplatform.mdx

@@ -0,0 +1,8 @@
+```kotlin
+import io.sentry.kotlin.multiplatform.Sentry
+
+// Application context is only needed for Android targets
+Sentry.init(context) { options ->
+  options.attachScreenshot = true
+}
+```

src/platform-includes/enriching-events/attach-viewhierarchy/kotlin-multiplatform.mdx

@@ -0,0 +1,15 @@
+<Note>
+
+Currently only available on iOS and Android.
+
+</Note>
+
+```kotlin
+import io.sentry.kotlin.multiplatform.sentry
+
+// Application context is only needed for Android targets
+Sentry.init(context) { options ->
+  options.dsn = "___PUBLIC_DSN___"
+  options.attachViewHierarchy = true
+}
+```

src/platform-includes/enriching-events/attachment-init-with-bytes/kotlin-multiplatform.mdx

@@ -0,0 +1,6 @@
+```kotlin
+import io.sentry.kotlin.multiplatform.Sentry
+import io.sentry.kotlin.multiplatform.Attachment
+
+val attachment = Attachment(bytes, "file.log")
+```

src/platform-includes/enriching-events/attachment-init-with-path/kotlin-multiplatform.mdx

@@ -0,0 +1,6 @@
+```kotlin
+import io.sentry.kotlin.multiplatform.Sentry
+import io.sentry.kotlin.multiplatform.Attachment
+
+val attachment = Attachment("your/path/file.log")
+```

src/platform-includes/enriching-events/attachment-max-size/kotlin-multiplatform.mdx

@@ -0,0 +1,8 @@
+```kotlin
+import io.sentry.kotlin.multiplatform.Sentry
+
+// Application context is only needed for Android targets
+Sentry.init(context) { options ->
+  options.maxAttachmentSize = 5 * 1024 * 1024 // 5 MiB
+}
+```