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 (opens in a new tab), and this project adheres to Semantic Versioning (opens in a new tab).
[3.7.3] - 2026-11-06
Section titled “[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
Section titled “[3.7.2] - 2026-11-04”- Potential loss of tracking data when stopping localization.
[3.7.1] - 2026-11-02
Section titled “[3.7.1] - 2026-11-02”- Filter support for
DeferredTrackerandInstantTracker. - Socket timeout to
InstantTracker.
[3.7.0] - 2026-10-20
Section titled “[3.7.0] - 2026-10-20”- New
BuildingInfo.readyandBuildingInfo.finalizedAtproperties. - New
GiPStech.setDeferredFeaturesandLocationSession.enableDeferredFeature, enabling deferred access to Bluetooth, Wi‑Fi, and GNSS.
Changed
Section titled “Changed”- Renamed
BuildingInfo.creationInstanttoBuildingInfo.createdAt. - Renamed
FloorInfo.creationInstanttoFloorInfo.createdAt. - Introduced automatic attitude estimator selection, enabled by default.
[3.6.9] - 2026-10-12
Section titled “[3.6.9] - 2026-10-12”- Attitude estimation not resetting when sensor requirements change.
[3.6.8] - 2026-10-08
Section titled “[3.6.8] - 2026-10-08”- Functions with default parameters for Swift and Objective-C in
AuxiliaryFileHandle.Group.
Changed
Section titled “Changed”- Renamed
AuxiliaryFileHandle.ListtoAuxiliaryFileHandle.Group.
[3.6.7] - 2026-10-07
Section titled “[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
Section titled “[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
Section titled “[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
Section titled “Changed”- Receive
timestampfrom ARDK.
[3.6.4] - 2026-09-17
Section titled “[3.6.4] - 2026-09-17”Changed
Section titled “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
Section titled “[3.6.3] - 2026-09-16”SpatialManager.downloadProgressflow to track file download progress.
Changed
Section titled “Changed”- Improved sensor fusion with VisualPositioning.
- Incorrect floor detection with Visual Positioning in buildings with only one floor.
[3.6.2] - 2026-09-14
Section titled “[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
Section titled “[3.6.1] - 2026-09-07”- Android library compatibility with AGP 9.4.
[3.6.0] - 2026-09-03
Section titled “[3.6.0] - 2026-09-03”- Support for AIDK.
Changed
Section titled “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
Section titled “[3.5.3] - 2026-06-25”DeferredTracker.appendEventcould generate corrupted chunks.
[3.5.2] - 2026-04-24
Section titled “[3.5.2] - 2026-04-24”- Beacon scanning not working correctly in background mode on Android.
[3.5.1] - 2026-04-23
Section titled “[3.5.1] - 2026-04-23”- New auxiliary file purpose
AuxiliaryFile.Purpose.AR.
Changed
Section titled “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
Section titled “[3.5.0] - 2026-03-25”- Function
GiPStech.enableBetaContent. - Avoid waiting for a timeout on iOS when no internet connection is available.
Changed
Section titled “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
Section titled “[3.4.9] - 2026-02-09”- Set min iOS version to 13.0.
[3.4.8] - 2026-02-06
Section titled “[3.4.8] - 2026-02-06”- Prevent activation requests when the development key has expired.
[3.4.7] - 2026-01-24
Section titled “[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
Section titled “[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
Section titled “[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
Section titled “[3.4.4] - 2026-01-23”- Fixed various bugs in Testing server.
[3.4.3] - 2026-01-19
Section titled “[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
Section titled “[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
Section titled “[3.4.1] - 2026-01-13”java.lang.AbstractMethodErrorcrash affecting older Android versions.
[3.4.0] - 2026-01-09
Section titled “[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
Section titled “Changed”- Renamed
GiPStech.getResourceandGiPStech.getResourcesinGiPStech.getResourceBundleandGiPStech.getResourceBundles.
[3.3.14] - 2025-12-24
Section titled “[3.3.14] - 2025-12-24”GiPStechException.Sensor.NotAuthorizedis now correctly thrown on Android too.
[3.3.13] - 2025-12-22
Section titled “[3.3.13] - 2025-12-22”- Exception class
GiPStechException.Sensor.NotAuthorized.
- Issues related to iOS sensor access permissions.
[3.3.12] - 2025-12-10
Section titled “[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
Section titled “[3.3.11] - 2025-12-04”- App resource bundles obtained through
GiPStech.getResources()andGiPStech.getResource().
Changed
Section titled “Changed”- Renamed
AuxiliaryFile.Purpose.WAYFIinAuxiliaryFile.Purpose.WayFi.
[3.3.10] - 2025-11-28
Section titled “[3.3.10] - 2025-11-28”- Rare crash while reading the attitude.
- Not closing resource when using
DeferredTracker.
Changed
Section titled “Changed”- Improved heading accuracy estimation.
[3.3.9] - 2025-11-25
Section titled “[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
Section titled “[3.3.8] - 2025-11-19”- Crash when clearance is enabled and no floor is selected.
[3.3.7] - 2025-11-14
Section titled “[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
Section titled “[3.3.6] - 2025-11-13”IllegalStateExceptionthrown if Bluetooth is disabled during localization.
- Clearance correction in RF + VIO.
[3.3.5] - 2025-11-07
Section titled “[3.3.5] - 2025-11-07”- Quota field to Floor class.
[3.3.4] - 2025-11-05
Section titled “[3.3.4] - 2025-11-05”- Exception handling in camera pose processing.
- Reading camera pose from sensor file.
[3.3.3] - 2025-11-01
Section titled “[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
Section titled “[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
Section titled “[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
Section titled “[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
Section titled “[3.2.0] - 2025-09-30”- Rename
XCFrameworkto match internal framework name.
Changed
Section titled “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
Section titled “[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
Section titled “[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
Section titled “[3.1.6] - 2025-06-16”- Overloads in
XCFrameworkdo not throw exceptions asNSError.
[3.1.5] - 2025-06-10
Section titled “[3.1.5] - 2025-06-10”Changed
Section titled “Changed”- Default value of fallback parameter to true.
- OBB functions to
Floor:obbContains,obbProjectandobbUnproject.
[3.1.4] - 2025-05-29
Section titled “[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
Section titled “[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
Section titled “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
Section titled “[3.1.2] - 2025-05-12”GiPStech.setMockLocationandGiPStech.resetMockLocationfor testing purpose.
[3.1.1] - 2025-05-09
Section titled “[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
Section titled “[3.1.0] - 2025-05-06”SpatialManager.isNearOrOutsideBordersometimes did not return correct value.- Sometimes data retrieved with
Region.requestAdditionalAreawere not used.
Changed
Section titled “Changed”- Removed parameters from
SpatialManager.createEmptyRegion.
[3.0.4] - 2025-04-30
Section titled “[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
Section titled “[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
Section titled “[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
Section titled “Changed”- Rename
LocationSession.getAttitudeinLocationSession.readAttitude.
[3.0.1] - 2025-04-10
Section titled “[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
Section titled “[3.0.0] - 2025-03-31”First public release.