MapboxCommon.iOS
24.5.0
See the version list below for details.
dotnet add package MapboxCommon.iOS --version 24.5.0
NuGet\Install-Package MapboxCommon.iOS -Version 24.5.0
<PackageReference Include="MapboxCommon.iOS" Version="24.5.0" />
paket add MapboxCommon.iOS --version 24.5.0
#r "nuget: MapboxCommon.iOS, 24.5.0"
// Install MapboxCommon.iOS as a Cake Addin #addin nuget:?package=MapboxCommon.iOS&version=24.5.0 // Install MapboxCommon.iOS as a Cake Tool #tool nuget:?package=MapboxCommon.iOS&version=24.5.0
Mapbox for Xamarin.iOS
A Xamarin.iOS binding library for Mapbox library.
About
This project is maintained by tuyen-vuduc.<br> At the momment, I don't have free time to contribute to the project, but if there is a paid request, I am happy to talk to.
Installation
Install-Package MapboxMapObjC.iOS
Usage
- 1/ How to use: Please follow the official guide here.
- 2/ Create
Mapbox.iOSQs.props
file fromMapbox.iOSQs.props.template
// It will look like this
- Mapbox.iOSQS
|- Mapbox.iOSQs.csproj
|- Mapbox.iOSQs.props
- 3/ Replace
YOUR_MAPBOX_DOWNLOADS_TOKEN
with your real token from Mapbox
<MAPBOX_DOWNLOADS_TOKEN>YOUR_MAPBOX_DOWNLOADS_TOKEN</MAPBOX_DOWNLOADS_TOKEN>
- 4/ Replace your Mapbox access token in
ViewController.cs
var myResourceOptions = new MBMResourceOptions(
"YOUR_MAPBOX_TOKEN", // TODO Put your token here
null, null, null, null);
or you can update Info.plist
file
<key>MBXAccessToken</key>
<string>YOUR_MAPBOX_TOKEN</string>
How to upgrade
It takes time to do the binding library and/or upgrade it. Microsoft intends to make it a lot simpler in the future, but not now.
Here are steps if you want to make changes and/or upgrade to the libraries
- 1/ Download latest artifacts from Mapbox as per its installation guide
- 2/ Run
chmod +x ./gen.sh
- 3/ Run
./gen.sh
- 4/ Compile and correct any errors shown up
- 5/ Update
AssemblyInfo.cs
files with the right version number - 6/ Update
*.nuspec
files to have the right version number - 7/ Run
sh build.sh
to create nuget packages - 8/ Commit and create a PR
NOTES
- Check symbols in the lib
nm -m 'artifacts/MapboxMaps.xcframework/ios-arm64/MapboxMaps.framework/MapboxMaps' | grep '_TtC10MapboxMaps22AnyTouchGestureHandler'
IMPROTANT
Mapbox SDK for iOS now is written in Swift and not very compatible with Objective-C, hence it won't be that friendly when doing the binding. I have to create an additional framework to make the bridge between Swift & C# in Objective-C, it's really a time consuming task. It'll require support from the developers like you in the community.
Further
Check out the document site for further details.
Maintainer
This project is maintained by tuyen-vuduc in his spare time and/or when requested.<br>
If you find this project is helpful, please give it a star, become a sponsor of the project and/or buy him a coffee.
License
Mapbox binding library for iOS itself is released under the 3-Clause BSD license. See LICENSE for details.
This license doesn't override and/or replace the licence from Mapbox.
Product | Versions Compatible and additional computed target framework versions. |
---|---|
.NET | net8.0-ios17.2 is compatible. |
-
net8.0-ios17.2
- Xamarin.Build.Download (>= 0.11.4)
NuGet packages (2)
Showing the top 2 NuGet packages that depend on MapboxCommon.iOS:
Package | Downloads |
---|---|
MapboxCoreMaps.iOS
.NET iOS bindings for Mapbox SDK - MapboxCoreMaps |
|
MapboxMaps.iOS
C# bindings for Mapbox iOS SDK - MapboxMaps |
GitHub repositories
This package is not used by any popular GitHub repositories.
Version | Downloads | Last updated |
---|---|---|
24.5.0.1 | 74 | 8/3/2024 |
24.5.0 | 125 | 7/11/2024 |
24.4.0.1 | 90 | 7/4/2024 |
24.4.0 | 110 | 6/27/2024 |
24.3.1.2 | 118 | 5/24/2024 |
24.3.1.1 | 98 | 5/21/2024 |
24.3.1 | 105 | 5/5/2024 |
24.2.0 | 123 | 4/4/2024 |
24.1.0.1 | 154 | 2/28/2024 |
24.1.0 | 128 | 2/21/2024 |
24.0.0 | 105 | 2/17/2024 |
23.3.2.1 | 510 | 7/20/2023 |
23.3.2 | 258 | 7/15/2023 |