---
title: "Manual Install"
description: "Integrate Sentry into your Xcode project by using our pre-compiled frameworks."
url: https://docs.sentry.io/platforms/apple/install/manual-install/
---

# Manual Install | Sentry for Apple

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 framework options:

   **Sentry (Swift / standard Objective-C):**

   * `Sentry.xcframework.zip` — Static framework (recommended)
   * `Sentry-Dynamic.xcframework.zip` — Dynamic framework
   * `SentrySwiftUI.xcframework.zip` — Deprecated. SwiftUI tracking is now included in the main `Sentry` framework.
   * `Sentry-WithoutUIKitOrAppKit.xcframework.zip` — Static framework without UIKit or AppKit linking and related features

   **SentryObjC (pure Objective-C interface):**

   * `SentryObjC-Static.xcframework.zip` — Static framework (recommended)
   * `SentryObjC-Dynamic.xcframework.zip` — Dynamic framework

3. Import the chosen framework into your Xcode project target.

### [Usage Guidelines](https://docs.sentry.io/platforms/apple/install/manual-install.md#usage-guidelines)

* Use `Sentry-Dynamic`, `Sentry`, or `Sentry-WithoutUIKitOrAppKit` independently. Only one of these should be included in your project at a time.
* `SentrySwiftUI` is deprecated. If you still use it, it must be combined with `Sentry-Dynamic`.
* Use **SentryObjC** when you need a pure Objective-C interface — no Swift headers, no semantic imports (`@import`), no `-Swift.h`. This is recommended for Objective-C++ projects or projects with Clang modules disabled. Each SentryObjC framework embeds the full Sentry SDK, so do not link both `Sentry` and `SentryObjC` in the same target. See [SentryObjC](https://docs.sentry.io/platforms/apple/install/swift-package-manager.md#sentryobjc) for configuration and initialization details.
* When using **`SentryObjC-Static.xcframework`** in a pure Objective-C target, additional linker flags are needed for the C++ standard library and Swift runtime — see the [SentryObjC-Static build settings](https://docs.sentry.io/platforms/apple/install/swift-package-manager.md#sentryobjc-static) for the full flags.
* When your project has **Clang modules disabled** or uses **Objective-C++** (`.mm` files), you must link system frameworks explicitly (e.g., `-framework UIKit -framework Foundation` in Other Linker Flags) and use `#import` instead of `@import` — see [Clang Modules Disabled / Objective-C++](https://docs.sentry.io/platforms/apple/install/swift-package-manager.md#clang-modules-disabled--objective-c).