Integrate the SDK

_|

Step 1: Add the package

Add magiclane_maps_flutter to your pubspec.yaml:

dependencies:
  flutter:
    sdk: flutter
  magiclane_maps_flutter:

Then install it:

flutter pub get

Step 2: Configure your platform

Android

Verify Android SDK

Ensure ANDROID_SDK_ROOT environment variable is set to your Android SDK path.

Add Maven repository

In android/build.gradle.kts, add this inside the allprojects block:

allprojects {
    repositories {
        google()
        mavenCentral()
        maven {
            url = uri("https://developer.magiclane.com/packages/android")
        }
    }
}

IOS

Install dependencies

flutter clean
flutter pub get

Open your project in Xcode

open ios/Runner.xcodeproj

Set minimum iOS version to 14.0

In Xcode:

1. Select Runner (project navigator on the left)
2. Select Runner target
3. Open Build Settings tab
4. Search for iOS Deployment Target
5. Change to 14.0 or higher

iOS Deployment Target location

Change to version 14.0

info

This SDK uses Swift Package Manager - no CocoaPods setup required.

---

Troubleshooting

Dependencies not installing?

Try reinstalling:

flutter clean
flutter pub get

Check for issues:

flutter doctor

Android build failing?

1. Open the android folder in Android Studio
2. Let Gradle sync
3. Fix any errors shown in the Build panel

Still having issues?

Clear the package cache and reinstall:

flutter pub cache clean
flutter pub get

Issues on Android (release mode only)?

In android/app/build.gradle.kts, add these lines to the release block:

buildTypes {
    release {
        signingConfig = signingConfigs.getByName("debug")
        isMinifyEnabled = false
        isShrinkResources = false
    }
}

This configuration should no longer be neccessary in recent versions of the SDK, but may be required for older versions. Please let us know if you are still experiencing this issue after updating to the latest SDK version.

iOS app crashes on startup (release mode only)?

Check that ios/Runner/Info.plist contains:

<key>CFBundleDevelopmentRegion</key>
<string>$(DEVELOPMENT_LANGUAGE)</string>

This entry is required for the SDK. Flutter projects include it by default.