import ExternalLink from 'sentry/components/links/externalLink'; import Link from 'sentry/components/links/link'; import List from 'sentry/components/list/'; import ListItem from 'sentry/components/list/listItem'; import {StepType} from 'sentry/components/onboarding/gettingStartedDoc/step'; import type { Docs, DocsParams, OnboardingConfig, } from 'sentry/components/onboarding/gettingStartedDoc/types'; import {appleFeedbackOnboarding} from 'sentry/gettingStartedDocs/apple/apple-macos'; import {t, tct} from 'sentry/locale'; type Params = DocsParams; const getInstallSnippet = () => `brew install getsentry/tools/sentry-wizard && sentry-wizard -i ios`; const getExperimentalFeaturesSnippetSwift = () => ` import Sentry SentrySDK.start { options in // ... // Enable all experimental features options.attachViewHierarchy = true options.enableMetricKit = true options.enableTimeToFullDisplayTracing = true options.swiftAsyncStacktraces = true options.enableAppLaunchProfiling = true }`; const getExperimentalFeaturesSnippetObjC = () => ` @import Sentry; [SentrySDK startWithConfigureOptions:^(SentryOptions *options) { // ... // Enable all experimental features options.attachViewHierarchy = YES; options.enableMetricKit = YES; options.enableTimeToFullDisplayTracing = YES; options.swiftAsyncStacktraces = YES; options.enableAppLaunchProfiling = YES; }];`; const getConfigureMetricsSnippetSwift = (params: Params) => ` import Sentry SentrySDK.start { options in options.dsn = "${params.dsn}" options.enableMetrics = true }`; const getConfigureMetricsSnippetObjC = (params: Params) => ` @import Sentry; [SentrySDK startWithConfigureOptions:^(SentryOptions * options) { options.Dsn = @"${params.dsn}"; options.enableMetrics = YES; }];`; const getVerifyMetricsSnippetSwift = () => ` import Sentry SentrySDK.metrics .increment(key: "button_login_click", value: 1.0, tags: ["screen": "login"] )`; const getVerifyMetricsSnippetObjC = () => ` @import Sentry; [SentrySDK.metrics incrementWithKey :@"button_login_click" value: 1.0 unit: SentryMeasurementUnit.none tags: @{ @"screen" : @"login" } ];`; const onboarding: OnboardingConfig = { install: () => [ { type: StepType.INSTALL, description: (

{tct( 'Add Sentry automatically to your app with the [wizardLink:Sentry wizard] (call this inside your project directory).', { wizardLink: ( ), } )}

), configurations: [ { language: 'bash', code: getInstallSnippet(), }, ], }, ], configure: () => [ { type: StepType.CONFIGURE, description: t('The Sentry wizard will automatically patch your application:'), configurations: [ { description: ( {t('Install the Sentry SDK via Swift Package Manager or Cocoapods')} {tct( 'Update your [appDelegate: AppDelegate] or SwiftUI App Initializer with the default Sentry configuration and an example error', { appDelegate: , } )} {tct( 'Add a new [phase: Upload Debug Symbols] phase to your [xcodebuild: xcodebuild] build script', { phase: , xcodebuild: , } )} {tct( 'Create [sentryclirc: .sentryclirc] with an auth token to upload debug symbols (this file is automatically added to [gitignore: .gitignore])', { sentryclirc: , gitignore: , } )} {t( "When you're using Fastlane, it will add a Sentry lane for uploading debug symbols" )} ), additionalInfo: tct( 'Alternatively, you can also [manualSetupLink:set up the SDK manually].', { manualSetupLink: ( ), stepsBelow: , } ), }, ], }, ], verify: () => [ { type: StepType.VERIFY, description: t( 'The Sentry wizard automatically adds a code snippet that captures a message to your project. Simply run your app and you should see this message in your Sentry project.' ), }, { title: t('Experimental Features'), description: tct( 'Want to play with some new features? Try out our experimental features for [vh: View Hierarchy], [ttfd: Time to Full Display (TTFD)], [metricKit: MetricKit], [prewarmedAppStart: Prewarmed App Start Tracing], and [asyncStacktraces: Swift Async Stacktraces]. Experimental features are still a work-in-progress and may have bugs. We recognize the irony. [break] Let us know if you have feedback through [gh: GitHub issues].', { vh: ( ), ttfd: ( ), metricKit: ( ), prewarmedAppStart: ( ), asyncStacktraces: ( ), gh: , break:
, } ), configurations: [ { code: [ { label: 'Swift', value: 'swift', language: 'swift', code: getExperimentalFeaturesSnippetSwift(), }, { label: 'Objective-C', value: 'c', language: 'c', code: getExperimentalFeaturesSnippetObjC(), }, ], }, ], }, ], nextSteps: () => [ { id: 'cocoapods-carthage', name: t('CocoaPods/Carthage'), description: t( 'Learn about integrating Sentry into your project using CocoaPods or Carthage.' ), link: 'https://docs.sentry.io/platforms/apple/install/', }, { id: 'debug-symbols', name: t('Debug Symbols'), description: t('Symbolicate and get readable stacktraces in your Sentry errors.'), link: 'https://docs.sentry.io/platforms/apple/dsym/', }, { id: 'swiftui', name: t('SwiftUI'), description: t('Learn about our first class integration with SwiftUI.'), link: 'https://docs.sentry.io/platforms/apple/performance/instrumentation/swiftui-instrumentation/', }, { id: 'profiling', name: t('Profiling'), description: t( 'Collect and analyze performance profiles from real user devices in production.' ), link: 'https://docs.sentry.io/platforms/apple/profiling/', }, ], }; const metricsOnboarding: OnboardingConfig = { install: (params: DocsParams) => [ { type: StepType.INSTALL, description: tct( 'You need Sentry Cocoa SDK version [codeVersion:8.23.0] or higher. Learn more about installation methods in our [docsLink:full documentation].', { codeVersion: , docsLink: , } ), configurations: [ { language: 'yml', partialLoading: params.sourcePackageRegistries?.isLoading, code: getInstallSnippet(), }, ], }, ], configure: (params: DocsParams) => [ { type: StepType.CONFIGURE, description: t( 'To enable capturing metrics, you need to enable the metrics feature.' ), configurations: [ { code: [ { label: 'Swift', value: 'swift', language: 'swift', code: getConfigureMetricsSnippetSwift(params), }, { label: 'Objective-C', value: 'c', language: 'c', code: getConfigureMetricsSnippetObjC(params), }, ], }, ], }, ], verify: () => [ { type: StepType.VERIFY, description: tct( "Then you'll be able to add metrics as [codeCounters:counters], [codeSets:sets], [codeDistribution:distributions], and [codeGauge:gauges]. These are available under the [codeNamespace:SentrySDK.metrics()] namespace. Try out this example:", { codeCounters: , codeSets: , codeDistribution: , codeGauge: , codeNamespace: , } ), configurations: [ { configurations: [ { code: [ { label: 'Swift', value: 'swift', language: 'swift', code: getVerifyMetricsSnippetSwift(), }, { label: 'Objective-C', value: 'c', language: 'c', code: getVerifyMetricsSnippetObjC(), }, ], }, ], }, { description: t( 'With a bit of delay you can see the data appear in the Sentry UI.' ), }, { description: tct( 'Learn more about metrics and how to configure them, by reading the [docsLink:docs].', { docsLink: ( ), } ), }, ], }, ], }; const docs: Docs = { onboarding, feedbackOnboardingCrashApi: appleFeedbackOnboarding, crashReportOnboarding: appleFeedbackOnboarding, customMetricsOnboarding: metricsOnboarding, }; export default docs;