diff --git a/docs/platforms/apple/common/install/index.mdx b/docs/platforms/apple/common/install/index.mdx index 9a9d3429e9a979..e5f3e0c6dd4931 100644 --- a/docs/platforms/apple/common/install/index.mdx +++ b/docs/platforms/apple/common/install/index.mdx @@ -4,4 +4,13 @@ sidebar_order: 1 description: "All the installation methods for the Apple platform." --- +We recommend installing the SDK through our [Sentry Wizard](https://github.com/getsentry/sentry-wizard) by running the following command inside your project directory: + +```bash +brew install getsentry/tools/sentry-wizard && sentry-wizard -i ios +``` + +This will patch your project and configure the SDK. You'll only need to patch the project once, then you'll be able to add the patched files to your version control system. +If you prefer, you can choose one of the alternative methods below. + diff --git a/docs/platforms/apple/common/install/manual-install.mdx b/docs/platforms/apple/common/install/manual-install.mdx new file mode 100644 index 00000000000000..d2278cc5eac068 --- /dev/null +++ b/docs/platforms/apple/common/install/manual-install.mdx @@ -0,0 +1,19 @@ +--- +title: Manual Install +description: "Integrate Sentry into your Xcode project by using our pre-compiled frameworks." +--- + +To integrate Sentry into your Xcode project, follow these steps: + +1. Download the latest version of the SDK from the Sentry Cocoa [Releases page](https://github.com/getsentry/sentry-cocoa/releases). +2. Each release contains the following four framework options: + - Sentry-Dynamic.xcframework.zip: Dynamic framework + - Sentry.xcframework.zip: Static framework + - SentrySwiftUI.xcframework.zip: Static Framework with SwiftUI support + - Sentry-WithoutUIKitOrAppKit.xcframework.zip: Static framework without UIKit or AppKit linking and related features +3. Import the chosen framework into your Xcode project target. + +### Usage Guidelines: + + • Use `Sentry-Dynamic`, `Sentry`, or `Sentry-WithoutUIKitOrAppKit` independently. Only one of these should be included in your project at a time. + • If you're using `SentrySwiftUI`, it must be combined with `Sentry-Dynamic`. \ No newline at end of file