If you’re already using CocoaPods to manage dependencies in your project, you might choose to install The Mapbox iOS SDK in the same way. If you meet any installation issues while installing the Mapbox iOS SDK with CocoaPods, try following these steps:
- Use the last stable version of CocoaPods. Beta versions are not recommended for use with the Mapbox iOS SDK.
pod installgives you an “Unable to find a specification” error, try running
pod repo updatefirst.
- When you run
pod install, CocoaPods generates an
xcworkspacefile that includes its configuration. The
xcworkspacefile has a white background, unlike the
xcodeprojfile with a blue background. Make sure you’re opening this file and not the original Xcode project.
- If you see the error
Mapbox.h not found, this can typically be resolved by building your application despite the error.
- If you’re getting a permission error or having trouble installing CocoaPods itself, consult the CocoaPods troubleshooting documentation.
If you’re still having issues using Mapbox with CocoaPods, please contact support with the complete details of the issue, including error messages.
If you have installed the Mapbox iOS SDK manually, you may see an App Store bug that results in the following error when submitting your application to the App Store:
ERROR ITMS-90087: Unsupported Architectures. The executable for
YourApp.app/Frameworks/Mapbox.frameworkcontains unsupported architectures ‘[x86_64, i386]’
To circumvent this, you’ll need to add the following script in the Build Phases tab of your project:
If your app successfully builds, but you see
401 responses to requests, make
sure that you’ve set your access token correctly.