Skip to content

iOS code integration doc updates #6433

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
mdanylov-sigma wants to merge 2 commits into
base: master
Choose a base branch
from
Open

iOS code integration doc updates #6433

Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
28e8811
iOS code integration doc updates.
mdanylov-sigma Feb 16, 2026
22877c8
Update CocoaPods and Carthage deprecation timelines
mdanylov-sigma Feb 17, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
27 changes: 21 additions & 6 deletions prebid-mobile/pbm-api/ios/code-integration-ios.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -32,6 +32,11 @@ end

Now run `pod install` to add the Prebid SDK to project dependencies.

{: .alert.alert-warning :}
Support for CocoaPods will be discontinued in Q4 2026. As CocoaPods is transitioning to read-only mode, it will no longer be supported for future updates. For more details, please refer to the official [announcement](https://blog.cocoapods.org/CocoaPods-Specs-Repo/).

We strongly recommend that publishers migrate to Swift Package Manager (SPM) to ensure ongoing compatibility and access to future releases. Please follow the [instructions](/prebid-mobile/pbm-api/ios/code-integration-ios.html#swift-package-manager-spm) to transition your integration.

### Carthage

If you are not familiar with the Carthage package builder, please refer to the project [github page](https://github.com/Carthage/Carthage) for more details.
Expand All @@ -41,6 +46,11 @@ If you are not familiar with the Carthage package builder, please refer to the p
3. Run `carthage update`.
4. Drag `PrebidMobile.xcframework` from `Carthage/Build` to `General -> Linked Frameworks and Libraries`

{: .alert.alert-warning :}
Support for Carthage will be discontinued in Q4 2026.

We strongly recommend that publishers migrate to Swift Package Manager (SPM) to ensure ongoing compatibility and access to future releases. Please follow the [instructions](/prebid-mobile/pbm-api/ios/code-integration-ios.html#swift-package-manager-spm) to transition your integration.

### XCFramework

1. Clone the project and run script `scripts/buildPrebidMobile.sh`
Expand All @@ -54,18 +64,23 @@ Starting from version `3.1.0`, PrebidMobile supports the Swift Package Manager (
To [add the Prebid Mobile SDK package dependency](https://developer.apple.com/documentation/xcode/adding-package-dependencies-to-your-app#Add-a-package-dependency) using SPM, follow these steps:

1. In Xcode, install the Prebid Mobile SDK by navigating to File > Add Package Dependencies...
2. In the prompt that appears, search for the Prebid Mobile SDK GitHub repository:
2. In the prompt that appears, use the search field to find the appropriate package based on your integration needs. Search for `Prebid Mobile SDK` to install the core SDK, or `Prebid Mobile SDK Adapters` if you need mediation adapters (GAM, AdMob, MAX).

`Prebid Mobile SDK`

```bash
https://github.com/prebid/prebid-mobile-ios-sdk.git
```

`Prebid Mobile SDK Adapters`

```bash
https://github.com/prebid/prebid-mobile-ios.git
https://github.com/prebid/prebid-mobile-ios-adapters.git
```

3. Select the version of the Prebid Mobile SDK you want to use. For new projects, we recommend using the `Up to Next Major Version`.
4. In the package selection screen, make sure to check the modules you need for your integration and link it to your application target.

{: .alert.alert-info :}
The Swift Package Manager (SPM) integration is currently marked as beta. We are actively working on refining the project structure and modularization to improve clarity, performance, and ease of integration. During this period, some modules or dependencies may be reorganized. We welcome your feedback - if you encounter any issues or have suggestions, please don't hesitate to reach out and help us shape the future of the PrebidMobile SPM support.

### Build framework from source

Build Prebid Mobile from source code. After [cloning the repo](https://github.com/prebid/prebid-mobile-ios), use Terminal or another command line tool, change to the root directory and run:
Expand Down