123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133 |
- 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 {getUploadSourceMapsStep} from 'sentry/components/onboarding/gettingStartedDoc/utils';
- import {PlatformKey} from 'sentry/data/platformCategories';
- import {t, tct} from 'sentry/locale';
- import type {Organization} from 'sentry/types';
- type StepProps = {
- newOrg: boolean;
- organization: Organization;
- platformKey: PlatformKey;
- projectId: string;
- sentryInitContent: string;
- };
- export const steps = ({
- sentryInitContent,
- ...props
- }: Partial<StepProps> = {}): LayoutProps['steps'] => [
- {
- type: StepType.INSTALL,
- description: t('Add the Sentry Electron SDK package as a dependency:'),
- configurations: [
- {
- language: 'bash',
- code: `
- # Using yarn
- yarn add @sentry/electron
- # Using npm
- npm install --save @sentry/electron
- `,
- },
- ],
- },
- {
- type: StepType.CONFIGURE,
- description: (
- <p>
- {tct(
- `You need to call [codeInit:Sentry.init] in the [codeMain:main] process and in every [codeRenderer:renderer] process you spawn.
- For more details about configuring the Electron SDK [docsLink:click here].`,
- {
- codeInit: <code />,
- codeMain: <code />,
- codeRenderer: <code />,
- docsLink: (
- <ExternalLink href="https://docs.sentry.io/platforms/javascript/guides/electron/" />
- ),
- }
- )}
- </p>
- ),
- configurations: [
- {
- language: 'javascript',
- code: `
- import * as Sentry from "@sentry/electron";
- Sentry.init({
- ${sentryInitContent}
- });
- `,
- },
- ],
- },
- getUploadSourceMapsStep({
- guideLink: 'https://docs.sentry.io/platforms/javascript/guides/electron/sourcemaps/',
- ...props,
- }),
- {
- type: StepType.VERIFY,
- description: t(
- `One way to verify your setup is by intentionally causing an error that breaks your application.`
- ),
- configurations: [
- {
- description: t(
- `Calling an undefined function will throw a JavaScript exception:`
- ),
- language: 'javascript',
- code: `
- myUndefinedFunction();
- `,
- },
- {
- description: t(
- `With Electron you can test native crash reporting by triggering a crash:`
- ),
- language: 'javascript',
- code: `
- process.crash();
- `,
- },
- ],
- additionalInfo: t(
- 'You may want to try inserting these code snippets into both your main and any renderer processes to verify Sentry is operational in both.'
- ),
- },
- ];
- // Configuration End
- export function GettingStartedWithElectron({
- dsn,
- organization,
- platformKey,
- projectId,
- newOrg,
- ...props
- }: ModuleProps) {
- const sentryInitContent: string[] = [`dsn: "${dsn}",`];
- return (
- <Layout
- steps={steps({
- sentryInitContent: sentryInitContent.join('\n'),
- organization,
- platformKey,
- projectId,
- newOrg,
- })}
- nextSteps={[]}
- newOrg={newOrg}
- platformKey={platformKey}
- {...props}
- />
- );
- }
- export default GettingStartedWithElectron;
|