Packages
Everything Massif Maps publishes, and where to get it. The SDK packages share one version, the
v<version> of the GitHub release; the styles
and the NativeScript plugin have their own.
Map SDK
| Platform | Package | Get it |
|---|---|---|
| Android | com.github.massif-maps:MassifMaps-android-aar — variants full (default), core, lite, objectapi | JitPack, or the .aar on the release — install |
| iOS | massif-maps/MassifMaps-ios-swift — products MassifMaps (full), MassifMapsCore, MassifMapsLite | Swift Package Manager, or the xcframework zip on the release — install |
| Web | @massif-maps/web | npm, or MassifMaps-web-<version>.zip on the release — web guide |
| NativeScript | @nativescript-community/ui-massifmaps | npm — install |
| UWP | — | build from source (BUILDING.md) |
core is the standard build profile; lite drops SQLite and everything built on it and is about 40% smaller;
objectapi is core plus the object API, which the other Android variants no longer carry. What each
variant contains, and how to choose: Variants.
Routing without the map
| Platform | Package | Get it |
|---|---|---|
| Android | com.github.massif-maps:MassifMaps-android-aar:<version>:routing@aar | JitPack, or the .aar on the release |
| iOS | ValhallaRouting, a product of the MassifMaps-ios-swift package | Swift Package Manager |
Valhalla routing for an app that has no map, or a map without routing: the full map variant
already routes offline. On Android it installs beside any map variant (its own classes and
libvalhalla_routing.so). On iOS pair it with MassifMapsCore or MassifMapsLite, never
MassifMaps: both define the same MSF routing classes. See the routing guide.
JavaScript and TypeScript
| Package | What it is |
|---|---|
@massif-maps/web | the SDK compiled to WebAssembly, with the typed API |
@massif-maps/typings | the generated typings and runtime tables of the surface API, one copy for the web and NativeScript bindings; its version is the SDK's |
@massif-maps/api | the typed surface API on its own, shared by the web and NativeScript bindings |
@massif-maps/style-tools | massif-style: CartoCSS compilation, MapBox style conversion, legends, own version — style CLI |
@massif-maps/styles | the Massif styles for MapLibre and the SDK, own version — Massif styles |
Release assets
Also attached to each v<version> GitHub release:
css2xml_<os>.zip— the CartoCSS compiler as a native binary, Linux and macOS;massif-api-bindings.zip,massif-api.json,massif.d.ts— the facade API schema and its generated bindings, for an integration that generates its own;
The style compiler that @massif-maps/style-tools loads, massif-style.wasm and massif-style.mjs,
is attached to each style-tools-v<version> release instead.
Pre-releases
A release candidate (6.1.0-rc.1) is a GitHub prerelease, and its npm packages carry the next
dist-tag: npm install @massif-maps/web@next. JitPack and Swift Package Manager take the version
explicitly. A plain install never picks a pre-release.