Integrate the SDK

_{Last updated: January 27, 2026 | 2 minutes read}

The Magic Lane Maps SDK for iOS is distributed as a Swift Package hosted on GitHub, making it easy to integrate directly into your Xcode projects using Swift Package Manager (SPM).

Adding the SDK to Your Project

To integrate the Magic Lane Maps SDK into your iOS application:

1. Open your project in Xcode

2. Add the package dependency

   • Navigate to File > Swift Packages > Add Package Dependency

3. Enter the package URL

   • Paste the repository URL: https://github.com/magiclane/magiclane-maps-sdk-ios

4. Select your version

   • Choose your desired version, branch, or commit
   • We recommend using the latest stable release

5. Complete the integration

   • Click Add Package and Xcode will resolve dependencies
   • Select the SDK products you need for your target

Once added, the SDK will be automatically managed by Xcode, and you can start importing and using the Magic Lane Maps SDK in your Swift code.

Note: If you're migrating from the old package URL (https://issuetracker.magiclane.com/magiclane/maps-sdk-ios-swift-package), remove the old dependency first via File > Swift Packages > Remove Package before adding the new GitHub-hosted version.