feat(apple): Add support for iOS

CHANGELOG.md

@@ -2,6 +2,7 @@
 
 ## Unreleased
 
+- feat: Add support for iOS (#334)
 - feat: Open browser when logging in (sourcemaps, sveltekit, nextjs) (#328)
 - fix: Support `--url` arg in NextJs, SvelteKit and Sourcemaps wizards (#331)
 - fix: Update minimum Node version to Node 14 (#332)

bin.ts

@@ -4,6 +4,7 @@ import { run } from './lib/Setup';
 import { runNextjsWizard } from './src/nextjs/nextjs-wizard';
 import { runSourcemapsWizard } from './src/sourcemaps/sourcemaps-wizard';
 import { runSvelteKitWizard } from './src/sveltekit/sveltekit-wizard';
+import { runAppleWizard } from './src/apple/apple-wizard';
 import { withTelemetry } from './src/telemetry';
 import { WizardOptions } from './src/utils/types';
 export * from './lib/Setup';
@@ -90,6 +91,10 @@ switch (argv.i) {
       // eslint-disable-next-line no-console
     ).catch(console.error);
     break;
+  case 'ios':
+    // eslint-disable-next-line no-console
+    runAppleWizard(wizardOptions).catch(console.error);
+    break
   default:
     runOldWizard();
 }

lib/Constants.ts

@@ -6,6 +6,7 @@ export enum Integration {
   nextjs = 'nextjs',
   sveltekit = 'sveltekit',
   sourcemaps = 'sourcemaps',
+  ios = 'ios',
 }
 
 /** Key value should be the same here */
@@ -45,6 +46,8 @@ export function getIntegrationDescription(type: string): string {
       return 'SvelteKit';
     case Integration.sourcemaps:
       return 'Configure Source Maps Upload';
+    case Integration.ios:
+      return 'iOS';
     default:
       return 'React Native';
   }
@@ -64,6 +67,8 @@ export function mapIntegrationToPlatform(type: string): string | undefined {
       return 'javascript-sveltekit';
     case Integration.sourcemaps:
       return undefined;
+    case Integration.ios:
+      return 'iOS';
     default:
       throw new Error(`Unknown integration ${type}`);
   }

lib/Steps/ChooseIntegration.ts

@@ -9,6 +9,7 @@ import { Electron } from './Integrations/Electron';
 import { NextJsShim } from './Integrations/NextJsShim';
 import { ReactNative } from './Integrations/ReactNative';
 import { SourceMapsShim } from './Integrations/SourceMapsShim';
+import { Apple } from './Integrations/Apple';
 import { SvelteKitShim } from './Integrations/SvelteKitShim';
 
 let projectPackage: any = {};
@@ -48,6 +49,9 @@ export class ChooseIntegration extends BaseStep {
       case Integration.sourcemaps:
         integration = new SourceMapsShim(this._argv);
         break;
+      case Integration.ios:
+        integration = new Apple(this._argv);
+        break;
       default:
         integration = new ReactNative(this._argv);
         break;

lib/Steps/Integrations/Apple.ts

@@ -0,0 +1,19 @@
+import { Answers } from 'inquirer';
+import type { Args } from '../../Constants';
+import { BaseIntegration } from './BaseIntegration';
+import { runAppleWizard } from '../../../src/apple/apple-wizard';
+
+export class Apple extends BaseIntegration {
+    public constructor(protected _argv: Args) {
+        super(_argv);
+    }
+
+    public async emit(_answers: Answers): Promise<Answers> {
+        await runAppleWizard({ promoCode: this._argv.promoCode, url: this._argv.url, });
+        return {};
+    }
+
+    public async shouldConfigure(_answers: Answers): Promise<Answers> {
+        return this._shouldConfigure;
+    }
+}

src/apple/apple-wizard.ts

@@ -0,0 +1,94 @@
+/* eslint-disable max-lines */
+/* eslint-disable @typescript-eslint/no-unsafe-member-access */
+/* eslint-disable @typescript-eslint/no-unsafe-assignment */
+/* eslint-disable @typescript-eslint/no-unsafe-call */
+/* eslint-disable @typescript-eslint/no-unused-vars */
+// @ts-ignore - clack is ESM and TS complains about that. It works though
+import clack from '@clack/prompts';
+import chalk from 'chalk';
+import * as fs from 'fs';
+import * as path from 'path';
+import * as templates from './templates';
+import * as xcManager from './xcode-manager';
+import * as codeTools from './code-tools';
+import * as bash from '../utils/bash';
+import { WizardOptions } from '../utils/types';
+
+const xcode = require('xcode');
+/* eslint-enable @typescript-eslint/no-unused-vars */
+
+import {
+  askForProjectSelection,
+  askForSelfHosted,
+  askForWizardLogin,
+  askToInstallSentryCLI,
+  SentryProjectData,
+  printWelcome,
+  abort,
+} from '../utils/clack-utils';
+
+export async function runAppleWizard(
+  options: WizardOptions,
+): Promise<void> {
+  printWelcome({
+    wizardName: 'Sentry Apple Wizard',
+    promoCode: options.promoCode,
+  });
+
+
+  if (!bash.hasSentryCLI()) {
+    if (!(await askToInstallSentryCLI())) {
+      clack.log.warn("Without Sentry-cli, you won't be able to upload debug symbols to Sentry. You can install it later by following the instructions at https://docs.sentry.io/cli/");
+    } else {
+      await bash.installSentryCLI();
+    }
+  }
+
+  const projectDir = process.cwd();
+  const xcodeProjFile = findFilesWithExtension(projectDir, ".xcodeproj")[0];
+
+  if (!xcodeProjFile) {
+    clack.log.error('No xcode project found. Please run this command from the root of your project.');
+    await abort();
+    return;
+  }
+
+  const pbxproj = path.join(projectDir, xcodeProjFile, "project.pbxproj");
+  if (!fs.existsSync(pbxproj)) {
+    clack.log.error(`No pbxproj found at ${pbxproj}`);
+    await abort();
+    return;
+  }
+
+  const { project, apiKey } = await getSentryProjectAndApiKey(options.promoCode, options.url);
+
+  xcManager.updateXcodeProject(pbxproj, project, apiKey, true, true);
+
+  const codeAdded = codeTools.addCodeSnippetToProject(projectDir, project.keys[0].dsn.public);
+  if (!codeAdded) {
+    clack.log.warn('Sentry dependency was added to your project, but could not add Sentry code snippet to it. Please add it manually by following this: https://docs.sentry.io/platforms/apple/guides/ios/#configure');
+    return;
+  }
+
+  clack.log.success('Sentry was successfully added to your project!');
+}
+
+//Prompt for Sentry project and API key
+async function getSentryProjectAndApiKey(promoCode?: string, url?: string): Promise<{ project: SentryProjectData, apiKey: { token: string } }> {
+  const { url: sentryUrl } = await askForSelfHosted(url);
+
+  const { projects, apiKeys } = await askForWizardLogin({
+    promoCode: promoCode,
+    url: sentryUrl,
+    platform: 'javascript-nextjs',
+  });
+
+  const selectedProject = await askForProjectSelection(projects);
+  return { project: selectedProject, apiKey: apiKeys };
+}
+
+//find files with the given extension
+function findFilesWithExtension(dir: string, extension: string): string[] {
+  const files = fs.readdirSync(dir);
+  return files.filter(file => file.endsWith(extension));
+}

src/apple/code-tools.ts

@@ -0,0 +1,77 @@
+import * as fs from 'fs';
+import * as path from 'path';
+import * as templates from './templates';
+
+const swiftAppLaunchRegex = /(func\s+application\s*\(_\sapplication:[^,]+,\s*didFinishLaunchingWithOptions[^,]+:[^)]+\)\s+->\s+Bool\s+{)|(init\s*\([^)]*\)\s*{)/gim;
+const objcAppLaunchRegex = /-\s*\(BOOL\)\s*application:\s*\(UIApplication\s*\*\)\s*application\s+didFinishLaunchingWithOptions:\s*\(NSDictionary\s*\*\)\s*launchOptions\s*{/gim;
+
+
+function isAppDelegateFile(filePath: string): boolean {
+    const appLaunchRegex = filePath.toLowerCase().endsWith(".swift") ? swiftAppLaunchRegex : objcAppLaunchRegex;
+
+    const fileContent = fs.readFileSync(filePath, 'utf8');
+    return (fileContent.includes("UIApplicationDelegate") && appLaunchRegex.test(fileContent)) || /struct[^:]+:\s*App\s*{/.test(fileContent);
+}
+
+function findAppDidFinishLaunchingWithOptions(dir: string): string | null {
+    const files = fs.readdirSync(dir);
+    //iterate over subdirectories later, 
+    //the appdelegate usually is in the top level
+    const dirs: string[] = [];
+
+    for (const file of files) {
+        const filePath = path.join(dir, file);
+        if (file.endsWith(".swift") || file.endsWith(".m") || file.endsWith(".mm")) {
+            if (isAppDelegateFile(filePath)) {
+                return filePath;
+            }
+        } else if (!file.startsWith(".") && !file.endsWith(".xcodeproj") && !file.endsWith(".xcassets") && fs.lstatSync(filePath).isDirectory()) {
+            dirs.push(file);
+        }
+    }
+
+    for (const dr of dirs) {
+        const result = findAppDidFinishLaunchingWithOptions(path.join(dir, dr));
+        if (result) return result;
+    }
+    return null;
+}
+
+export function addCodeSnippetToProject(projPath: string, dsn: string): boolean {
+    const appDelegate = findAppDidFinishLaunchingWithOptions(projPath);
+    if (!appDelegate) {
+        return false;
+    }
+
+    const fileContent = fs.readFileSync(appDelegate, 'utf8');
+    const isSwift = appDelegate.toLowerCase().endsWith(".swift");
+    const appLaunchRegex = isSwift ? swiftAppLaunchRegex : objcAppLaunchRegex;
+    const importStatement = isSwift ? "import Sentry\n" : "@import Sentry;\n";
+    const checkForSentryInit = isSwift ? "SentrySDK.start" : "[SentrySDK start";
+    let codeSnippet = isSwift ? templates.getSwiftSnippet(dsn) : templates.getObjcSnippet(dsn);
+
+    if (fileContent.includes(checkForSentryInit)) {
+        //already initialized
+        return true;
+    }
+
+    let match = appLaunchRegex.exec(fileContent);
+    if (!match) {
+        const swiftUIMatch = /struct[^:]+:\s*App\s*{/.exec(fileContent)
+        if (!swiftUIMatch) {
+            return false;
+        }
+        //Is SwiftUI with no init
+        match = swiftUIMatch;
+        codeSnippet = `    init() {\n${codeSnippet}    }`;
+    }
+
+    const insertIndex = match.index + match[0].length;
+    const newFileContent = (fileContent.indexOf(importStatement) >= 0 ? "" : importStatement) +
+        fileContent.slice(0, insertIndex) + "\n" +
+        codeSnippet +
+        fileContent.slice(insertIndex);
+    fs.writeFileSync(appDelegate, newFileContent, 'utf8');
+
+    return true;
+}

src/apple/templates.ts

@@ -0,0 +1,47 @@
+export function getRunScriptTemplate(
+    orgSlug: string,
+    projectSlug: string,
+    apiKey: string,
+    uploadSource = true,
+): string {
+    // eslint-disable-next-line no-useless-escape
+    return `# This script is responsable to upload debug symbols and source context for Sentry.\\nif which sentry-cli >/dev/null; then\\nexport SENTRY_ORG=${orgSlug}\\nexport SENTRY_PROJECT=${projectSlug}\\nexport SENTRY_AUTH_TOKEN=${apiKey}\\nERROR=$(sentry-cli debug-files upload ${uploadSource ? "--include-sources " : ""}\"$DWARF_DSYM_FOLDER_PATH\" 2>&1 >/dev/null)\\nif [ ! $? -eq 0 ]; then\\necho \"warning: sentry-cli - $ERROR\"\\nfi\\nelse\\necho \"warning: sentry-cli not installed, download from https://github.com/getsentry/sentry-cli/releases\"\\nfi\\n`;
+}
+
+export const scriptInputPath = "\"${DWARF_DSYM_FOLDER_PATH}/${DWARF_DSYM_FILE_NAME}/Contents/Resources/DWARF/${TARGET_NAME}\"";
+
+export function getSwiftSnippet(dsn: string): string {
+    return `           SentrySDK.start { options in
+            options.dsn = "${dsn}"
+            options.enableTracing = true
+            #if DEBUG
+            options.debug = true
+            options.environment = "Development"
+            #else
+            options.environment = "Release"
+            #endif
+            options.attachScreenshot = true
+            options.attachViewHierarchy = true
+            options.enableTimeToFullDisplay = true
+        }
+        //Remove the next line after running the app once.
+        SentrySDK.capture(message: "This app uses Sentry! :)")\n`;
+}
+
+export function getObjcSnippet(dsn: string): string {
+    return `        [SentrySDK startWithConfigureOptions:^(SentryOptions * options) {
+        options.dsn = @"${dsn}";
+        options.enableTracing = YES;
+    #if DEBUG
+        options.debug = YES;
+        options.environment = @"Development";
+    #else
+        options.environment = @"Release";
+    #endif
+        options.attachScreenshot = YES;
+        options.attachViewHierarchy = YES;
+        options.enableTimeToFullDisplay = YES;
+    }];
+    //Remove the next line after running the app once.
+    [SentrySDK captureMessage:@"This app uses Sentry!"]\n`;
+}