Here you’ll find a detailed record of all updates, improvements, bug fixes, and breaking changes introduced in each version. This page is intended to help developers stay informed about the evolution of the MDK and ensure smooth upgrades.
We recommend reviewing the notes before updating to a new version, especially for major releases that may include significant changes.
The format is based on Keep a Changelog (si apre in una nuova scheda), and this project adheres to Semantic Versioning (si apre in una nuova scheda).
[3.7.3] - 2026-11-06
Sezione intitolata “[3.7.3] - 2026-11-06”- Prevented an
IllegalArgumentExceptionon devices without a GPS chip when GPS is configured as optional.
[3.7.2] - 2026-11-04
Sezione intitolata “[3.7.2] - 2026-11-04”- Potential loss of tracking data when stopping localization.
[3.7.1] - 2026-11-02
Sezione intitolata “[3.7.1] - 2026-11-02”- Filter support for
DeferredTrackerandInstantTracker. - Socket timeout to
InstantTracker.
[3.7.0] - 2026-10-20
Sezione intitolata “[3.7.0] - 2026-10-20”- New
BuildingInfo.readyandBuildingInfo.finalizedAtproperties. - New
GiPStech.setDeferredFeaturesandLocationSession.enableDeferredFeature, enabling deferred access to Bluetooth, Wi‑Fi, and GNSS.
Changed
Sezione intitolata “Changed”- Renamed
BuildingInfo.creationInstanttoBuildingInfo.createdAt. - Renamed
FloorInfo.creationInstanttoFloorInfo.createdAt. - Introduced automatic attitude estimator selection, enabled by default.
[3.6.9] - 2026-10-12
Sezione intitolata “[3.6.9] - 2026-10-12”- Attitude estimation not resetting when sensor requirements change.
[3.6.8] - 2026-10-08
Sezione intitolata “[3.6.8] - 2026-10-08”- Functions with default parameters for Swift and Objective-C in
AuxiliaryFileHandle.Group.
Changed
Sezione intitolata “Changed”- Renamed
AuxiliaryFileHandle.ListtoAuxiliaryFileHandle.Group.
[3.6.7] - 2026-10-07
Sezione intitolata “[3.6.7] - 2026-10-07”AuxiliaryFileHandleclass for managing auxiliary files that are not downloaded automatically.Place.getAuxiliaryFileHandlesto retrieve auxiliary file handles for a specific purpose.
[3.6.6] - 2026-10-06
Sezione intitolata “[3.6.6] - 2026-10-06”Region.findBuilding()function for efficiently retrieving a building without iterating over the building list.
- Issue causing time jumps when transitioning from outdoor to indoor environments in specific scenarios.
[3.6.5] - 2026-09-25
Sezione intitolata “[3.6.5] - 2026-09-25”BuildingSelectorclass to notify the location system which building the user is in when it cannot be detected automatically.
Changed
Sezione intitolata “Changed”- Receive
timestampfrom ARDK.
[3.6.4] - 2026-09-17
Sezione intitolata “[3.6.4] - 2026-09-17”Changed
Sezione intitolata “Changed”- Added the
FeatureRequest.Actionenum to identify the requested operation. - Replaced
LocationListener.onFeatureRequestandLocationListener.onFeatureReleasewith a single unified listener method.
[3.6.3] - 2026-09-16
Sezione intitolata “[3.6.3] - 2026-09-16”SpatialManager.downloadProgressflow to track file download progress.
Changed
Sezione intitolata “Changed”- Improved sensor fusion with VisualPositioning.
- Incorrect floor detection with Visual Positioning in buildings with only one floor.
[3.6.2] - 2026-09-14
Sezione intitolata “[3.6.2] - 2026-09-14”FeatureRequestclass.LocationListener.onFeatureRequestandLocationListener.onFeatureReleaseto request/release features provided by other libraries.
OutOfMemoryErrorwhen downloading large files.- Enable or disable sensors when transitioning between indoor and outdoor environments on iOS.
[3.6.1] - 2026-09-07
Sezione intitolata “[3.6.1] - 2026-09-07”- Android library compatibility with AGP 9.4.
[3.6.0] - 2026-09-03
Sezione intitolata “[3.6.0] - 2026-09-03”- Support for AIDK.
Changed
Sezione intitolata “Changed”- Rename GiPStechException to MdkException.
- Update MdkException to inherit from com.gipstech.GiPStechException.
- Target JVM 1.8 for better compatibility.
[3.5.3] - 2026-06-25
Sezione intitolata “[3.5.3] - 2026-06-25”DeferredTracker.appendEventcould generate corrupted chunks.
[3.5.2] - 2026-04-24
Sezione intitolata “[3.5.2] - 2026-04-24”- Beacon scanning not working correctly in background mode on Android.
[3.5.1] - 2026-04-23
Sezione intitolata “[3.5.1] - 2026-04-23”- New auxiliary file purpose
AuxiliaryFile.Purpose.AR.
Changed
Sezione intitolata “Changed”- The
SpatialManager.createEmptyRegion()function can now be executed without prior initialization.
DeferredTracker.Options.minIntervalis now anInt, as it represents a value in milliseconds.
[3.5.0] - 2026-03-25
Sezione intitolata “[3.5.0] - 2026-03-25”- Function
GiPStech.enableBetaContent. - Avoid waiting for a timeout on iOS when no internet connection is available.
Changed
Sezione intitolata “Changed”- Added GiPStech Mobile Common Library (MCL) as an API dependency.
- Replaced the
Coordinatesclass withCoord2Dfrom MCL. - Modified
Floorto inherit fromLocalAffineFrameand removed all functions prefixed withoob.
[3.4.9] - 2026-02-09
Sezione intitolata “[3.4.9] - 2026-02-09”- Set min iOS version to 13.0.
[3.4.8] - 2026-02-06
Sezione intitolata “[3.4.8] - 2026-02-06”- Prevent activation requests when the development key has expired.
[3.4.7] - 2026-01-24
Sezione intitolata “[3.4.7] - 2026-01-24”- Potential deadlock in the
waitcommand on the Testing server.
- New
setFakeLocationFromOScommand to the Testing server. - New
abortcommand to the Testing server.
[3.4.6] - 2026-01-24
Sezione intitolata “[3.4.6] - 2026-01-24”- Fix bug of slow position updates in RF + VIO when VIO is not active.
[3.4.5] - 2026-01-23
Sezione intitolata “[3.4.5] - 2026-01-23”- Ensure proper disposal of library modules if an exception occurs during
GiPStech.init.
[3.4.4] - 2026-01-23
Sezione intitolata “[3.4.4] - 2026-01-23”- Fixed various bugs in Testing server.
[3.4.3] - 2026-01-19
Sezione intitolata “[3.4.3] - 2026-01-19”- Wait for connections in Testing server.
- Serious bug in
Region.isNearOrOutsideBorderthat could cause the method to always returntrueunder certain conditions.
[3.4.2] - 2026-01-13
Sezione intitolata “[3.4.2] - 2026-01-13”GiPStechException.Network.Untrustedcorrectly inheritsGiPStechException.Network.- Discard beacon scan with RSSI equals to 0.
[3.4.1] - 2026-01-13
Sezione intitolata “[3.4.1] - 2026-01-13”java.lang.AbstractMethodErrorcrash affecting older Android versions.
[3.4.0] - 2026-01-09
Sezione intitolata “[3.4.0] - 2026-01-09”- New Testing server to simulate MDK events via a TCP connection.
GiPStech.getResourceStringfor querying resource strings associated to the app.
GiPStechException.Sensor.NotAvailableis now correctly thrown on Android when Positioning is disabled and BluetoothLe is required.
Changed
Sezione intitolata “Changed”- Renamed
GiPStech.getResourceandGiPStech.getResourcesinGiPStech.getResourceBundleandGiPStech.getResourceBundles.
[3.3.14] - 2025-12-24
Sezione intitolata “[3.3.14] - 2025-12-24”GiPStechException.Sensor.NotAuthorizedis now correctly thrown on Android too.
[3.3.13] - 2025-12-22
Sezione intitolata “[3.3.13] - 2025-12-22”- Exception class
GiPStechException.Sensor.NotAuthorized.
- Issues related to iOS sensor access permissions.
[3.3.12] - 2025-12-10
Sezione intitolata “[3.3.12] - 2025-12-10”- Combine system calibrated magnetometer and internal calibration.
- Correctly stop listening to the system calibrated magnetometer.
[3.3.11] - 2025-12-04
Sezione intitolata “[3.3.11] - 2025-12-04”- App resource bundles obtained through
GiPStech.getResources()andGiPStech.getResource().
Changed
Sezione intitolata “Changed”- Renamed
AuxiliaryFile.Purpose.WAYFIinAuxiliaryFile.Purpose.WayFi.
[3.3.10] - 2025-11-28
Sezione intitolata “[3.3.10] - 2025-11-28”- Rare crash while reading the attitude.
- Not closing resource when using
DeferredTracker.
Changed
Sezione intitolata “Changed”- Improved heading accuracy estimation.
[3.3.9] - 2025-11-25
Sezione intitolata “[3.3.9] - 2025-11-25”- Usage of calibrated magnetometer.
- Fallback to sensors heading estimation.
- Heading accuracy with RF + VIO.
[3.3.8] - 2025-11-19
Sezione intitolata “[3.3.8] - 2025-11-19”- Crash when clearance is enabled and no floor is selected.
[3.3.7] - 2025-11-14
Sezione intitolata “[3.3.7] - 2025-11-14”- Conflicts between auxiliary files with the same name but different purpose.
UpgradeRequiredexception.GiPStech.setAppVersionfunction.
[3.3.6] - 2025-11-13
Sezione intitolata “[3.3.6] - 2025-11-13”IllegalStateExceptionthrown if Bluetooth is disabled during localization.
- Clearance correction in RF + VIO.
[3.3.5] - 2025-11-07
Sezione intitolata “[3.3.5] - 2025-11-07”- Quota field to Floor class.
[3.3.4] - 2025-11-05
Sezione intitolata “[3.3.4] - 2025-11-05”- Exception handling in camera pose processing.
- Reading camera pose from sensor file.
[3.3.3] - 2025-11-01
Sezione intitolata “[3.3.3] - 2025-11-01”- Outdoor transition timeout was not triggered when no Bluetooth beacons were received and inertial sensors were not active.
[3.3.2] - 2025-10-27
Sezione intitolata “[3.3.2] - 2025-10-27”- Reset heading and heading_accuracy when selecting the new localization algorithm for RF + VIO.
[3.3.1] - 2025-10-23
Sezione intitolata “[3.3.1] - 2025-10-23”- Bug in universal localization occurring when selecting the new localization algorithm for RF + VIO.
[3.3.0] - 2025-10-22
Sezione intitolata “[3.3.0] - 2025-10-22”- Removed kotlinx-datetime dependency to prevent conflicts with kotlin.datetime.
AuxiliaryFilepackages now correctly extract subdirectories.- Purposes are now properly reset when shutting down.
- Parameters pattern and depth in
Place.findAuxiliaryFiles. - Introduced new LocationSession methods supporting pose input from multiple sources.
- Introduced a new localization algorithm that enhances the fusion of VIO and RF data.
[3.2.0] - 2025-09-30
Sezione intitolata “[3.2.0] - 2025-09-30”- Rename
XCFrameworkto match internal framework name.
Changed
Sezione intitolata “Changed”- Removed function
SpatialManaget.findAuxiliaryFile. - Replaced
kotlinx.datetime.Instantwithkotlin.time.InstantinBuildingInfoandFloorInfo. - Functions requiring a connection now throw
GiPStechException.Network.Unauthorizedif a secure connection cannot be established.
- Support for auxiliary file packages.
- Request throttling to reduce unnecessary calls.
- New functions:
SpatialManager.addAuxPurposeandSpatialManager.removeAuxPurpose. - New function
GiPStech.resetThrottlingto reset throttling timers. - New purpose
AuxiliaryFile.Purpose.VPfor visual positioning.
[3.1.8] - 2025-08-29
Sezione intitolata “[3.1.8] - 2025-08-29”- Renew activation if MDK directory is deleted.
- Stop scanning Bluetooth beacons on some Android device.
[3.1.7] - 2025-08-05
Sezione intitolata “[3.1.7] - 2025-08-05”- iBeacon scanning in Android and iOS.
- Re-enable GPS when switching from indoor to outdoor.
[3.1.6] - 2025-06-16
Sezione intitolata “[3.1.6] - 2025-06-16”- Overloads in
XCFrameworkdo not throw exceptions asNSError.
[3.1.5] - 2025-06-10
Sezione intitolata “[3.1.5] - 2025-06-10”Changed
Sezione intitolata “Changed”- Default value of fallback parameter to true.
- OBB functions to
Floor:obbContains,obbProjectandobbUnproject.
[3.1.4] - 2025-05-29
Sezione intitolata “[3.1.4] - 2025-05-29”- Missing invocation of
onExceptionin response to sensor errors. LocationListener.onExceptionis now correctly triggered when Bluetooth LE, Wi-Fi, or GNSS is disabled during the localization process.- The
AuxiliaryFilepath field now correctly stores the full file path instead of just the file name.
[3.1.3] - 2025-05-26
Sezione intitolata “[3.1.3] - 2025-05-26”- Turn off unnecessary sensors indoors to optimize battery consumption.
- If a sensor is missing during the first invocation of
startLocalization, the remaining sensors will not be available in any subsequent invocations.
Changed
Sezione intitolata “Changed”GiPStech.setMockLocationnow accepts a location object, which will subsequently be returned bySpatialManager.getLocationFromOS.
Building.getMemorySizeandTile.getMemorySize.- Default parameter values to the
Locationclass constructor.
[3.1.2] - 2025-05-12
Sezione intitolata “[3.1.2] - 2025-05-12”GiPStech.setMockLocationandGiPStech.resetMockLocationfor testing purpose.
[3.1.1] - 2025-05-09
Sezione intitolata “[3.1.1] - 2025-05-09”- Credentials are not reset if the developer key changes — which, in any case, should never occur.
- Potential race condition when simultaneously invoking start and stop operations from multiple threads.
- Potential race condition in BLE telemetry.
- Settings not loaded after the first time.
- Sensor readings in iOS.
[3.1.0] - 2025-05-06
Sezione intitolata “[3.1.0] - 2025-05-06”SpatialManager.isNearOrOutsideBordersometimes did not return correct value.- Sometimes data retrieved with
Region.requestAdditionalAreawere not used.
Changed
Sezione intitolata “Changed”- Removed parameters from
SpatialManager.createEmptyRegion.
[3.0.4] - 2025-04-30
Sezione intitolata “[3.0.4] - 2025-04-30”- Sporadic crash during localization when loading building or reading attitude.
- Synchronization of timestamps between GNSS and inertial sensors.
DeferredTrackerfile format.
- Functions for loading cached buildings:
SpatialManager.loadCachedBuildingsNearbyandSpatialManager.loadCachedBuildingsByBounds. - Functions for setting the localization profile:
GiPStech.setProfileandGiPStech.resetProfile. - Exception
GiPStechException.Sensor.FetchFailedwhich occurs when a sensor reading fails to complete successfully. - Fields
payloadandpayloadFormatinBuildingandFloor. Place.findAuxiliaryFilesas abstract forBuildingandRegion.
[3.0.3] - 2025-04-22
Sezione intitolata “[3.0.3] - 2025-04-22”progresscallback was not invoked byforceSynchronizationwhen no files were available.- Move pro-guarded classes out of the root package to avoid naming collisions with other modules.
sendOnlyExistingoption toDeferredTrackerto allow sending only pre-generated chunks without creating new ones.- Property
AuxiliaryFile.nameWithoutExtension.
[3.0.2] - 2025-04-14
Sezione intitolata “[3.0.2] - 2025-04-14”Location.levelis now -1 instead of 255 when outdoor.- Swap coordinates in
Floor.origin,Floor.topLeftandFloor.bottomRight. - Sensor exception on
Place.startLocalizationafterCalibrationManager.abortCalibration.
Changed
Sezione intitolata “Changed”- Rename
LocationSession.getAttitudeinLocationSession.readAttitude.
[3.0.1] - 2025-04-10
Sezione intitolata “[3.0.1] - 2025-04-10”- Localization not halted when
GiPStechException.Sensor.NotAvailableis thrown. - Auxiliary files are not being correctly stored with version information.
CalibrationManager.beginCalibrationnow correcly throwsGiPStechException.Sensor.NotAvailablewhen required sensor is unavailable.GiPStech.initnow correctly throwsGiPStechException.ActivationDenied(instead ofGiPStechException.Sensor.ActivationRequired) if the GiPStech Server does not authorize the application.
- Support for Wi-Fi localization (only Android).
- Parameter
includeIndoor(default true) inSpatialManager.findAuxiliaryFiles. - Parameter
mockLocation(default null) inGiPStech.setSensorFile. - Property
Floor.heading. - Function
Floor.requestImageFile. - Function
FloorInfo.requestImageFile.
[3.0.0] - 2025-03-31
Sezione intitolata “[3.0.0] - 2025-03-31”First public release.