ref(getting-started-docs): Migrate native doc to sentry main repo (#52860)

static/app/components/onboarding/gettingStartedDoc/sdkDocumentation.tsx

@@ -22,6 +22,7 @@ export const migratedDocs = [
   'react-native',
   'java-spring-boot',
   'php-laravel',
+  'native',
   'go',
   'rust',
 ];

static/app/gettingStartedDocs/native/native.spec.tsx

@@ -0,0 +1,20 @@
+import {render, screen} from 'sentry-test/reactTestingLibrary';
+
+import {StepTitle} from 'sentry/components/onboarding/gettingStartedDoc/step';
+
+import {GettingStartedWithNative, steps} from './native';
+
+describe('GettingStartedWithNative', function () {
+  it('all products are selected', function () {
+    const {container} = render(<GettingStartedWithNative dsn="test-dsn" />);
+
+    // Steps
+    for (const step of steps()) {
+      expect(
+        screen.getByRole('heading', {name: step.title ?? StepTitle[step.type]})
+      ).toBeInTheDocument();
+    }
+
+    expect(container).toSnapshot();
+  });
+});

static/app/gettingStartedDocs/native/native.tsx

@@ -0,0 +1,108 @@
+import {Fragment} from 'react';
+
+import ExternalLink from 'sentry/components/links/externalLink';
+import {Layout, LayoutProps} from 'sentry/components/onboarding/gettingStartedDoc/layout';
+import {ModuleProps} from 'sentry/components/onboarding/gettingStartedDoc/sdkDocumentation';
+import {StepType} from 'sentry/components/onboarding/gettingStartedDoc/step';
+import {t, tct} from 'sentry/locale';
+
+// Configuration Start
+export const steps = ({
+  dsn,
+}: {
+  dsn?: string;
+} = {}): LayoutProps['steps'] => [
+  {
+    type: StepType.INSTALL,
+    description: (
+      <p>
+        {tct(
+          'Install the SDK by downloading the [releasesLink:latest release]. Next, follow the instructions in the [nativeSDKDocumentationLink:Native SDK Documentation] to build and link the SDK library.',
+          {
+            releasesLink: (
+              <ExternalLink href="https://github.com/getsentry/sentry-native/releases" />
+            ),
+            nativeSDKDocumentationLink: (
+              <ExternalLink href="https://docs.sentry.io/platforms/native/" />
+            ),
+          }
+        )}
+      </p>
+    ),
+  },
+  {
+    type: StepType.CONFIGURE,
+    description: t(
+      'Import and initialize the Sentry SDK early in your application setup:'
+    ),
+    configurations: [
+      {
+        language: 'c',
+        code: `
+#include <sentry.h>
+
+int main(void) {
+  sentry_options_t *options = sentry_options_new();
+  sentry_options_set_dsn(options, "${dsn}");
+  // This is also the default-path. For further information and recommendations:
+  // https://docs.sentry.io/platforms/native/configuration/options/#database-path
+  sentry_options_set_database_path(options, ".sentry-native");
+  sentry_options_set_release(options, "my-project-name@2.3.12");
+  sentry_options_set_debug(options, 1);
+  sentry_init(options);
+
+  /* ... */
+
+  // make sure everything flushes
+  sentry_close();
+}
+        `,
+      },
+    ],
+    additionalInfo: (
+      <p>
+        {tct(
+          'Alternatively, the DSN can be passed as [code:SENTRY_DSN] environment variable during runtime. This can be especially useful for server applications.',
+          {
+            code: <code />,
+          }
+        )}
+      </p>
+    ),
+  },
+  {
+    type: StepType.VERIFY,
+    description: t(
+      'The quickest way to verify Sentry in your Native application is by capturing a message:'
+    ),
+    configurations: [
+      {
+        language: 'c',
+        code: `
+sentry_capture_event(sentry_value_new_message_event(
+  /*   level */ SENTRY_LEVEL_INFO,
+  /*  logger */ "custom",
+  /* message */ "It works!"
+));
+        `,
+      },
+    ],
+    additionalInfo: (
+      <Fragment>
+        {t(
+          "If you're new to Sentry, use the email alert to access your account and complete a product tour."
+        )}
+        {t(
+          "If you're an existing user and have disabled alerts, you won't receive this email."
+        )}
+      </Fragment>
+    ),
+  },
+];
+// Configuration End
+
+export function GettingStartedWithNative({dsn, ...props}: ModuleProps) {
+  return <Layout steps={steps({dsn})} {...props} />;
+}
+
+export default GettingStartedWithNative;