Skip to content
Select language:English

Release notes

Updated 8 min read

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).

  • Prevented an IllegalArgumentException on devices without a GPS chip when GPS is configured as optional.
  • Potential loss of tracking data when stopping localization.
  • Filter support for DeferredTracker and InstantTracker.
  • Socket timeout to InstantTracker.
  • New BuildingInfo.ready and BuildingInfo.finalizedAt properties.
  • New GiPStech.setDeferredFeatures and LocationSession.enableDeferredFeature, enabling deferred access to Bluetooth, Wi‑Fi, and GNSS.
  • Renamed BuildingInfo.creationInstant to BuildingInfo.createdAt.
  • Renamed FloorInfo.creationInstant to FloorInfo.createdAt.
  • Introduced automatic attitude estimator selection, enabled by default.
  • Attitude estimation not resetting when sensor requirements change.
  • Functions with default parameters for Swift and Objective-C in AuxiliaryFileHandle.Group.
  • Renamed AuxiliaryFileHandle.List to AuxiliaryFileHandle.Group.
  • AuxiliaryFileHandle class for managing auxiliary files that are not downloaded automatically.
  • Place.getAuxiliaryFileHandles to retrieve auxiliary file handles for a specific purpose.
  • 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.
  • BuildingSelector class to notify the location system which building the user is in when it cannot be detected automatically.
  • Receive timestamp from ARDK.
  • Added the FeatureRequest.Action enum to identify the requested operation.
  • Replaced LocationListener.onFeatureRequest and LocationListener.onFeatureRelease with a single unified listener method.
  • SpatialManager.downloadProgress flow to track file download progress.
  • Improved sensor fusion with VisualPositioning.
  • Incorrect floor detection with Visual Positioning in buildings with only one floor.
  • FeatureRequest class.
  • LocationListener.onFeatureRequest and LocationListener.onFeatureRelease to request/release features provided by other libraries.
  • OutOfMemoryError when downloading large files.
  • Enable or disable sensors when transitioning between indoor and outdoor environments on iOS.
  • Android library compatibility with AGP 9.4.
  • Support for AIDK.
  • Rename GiPStechException to MdkException.
  • Update MdkException to inherit from com.gipstech.GiPStechException.
  • Target JVM 1.8 for better compatibility.
  • DeferredTracker.appendEvent could generate corrupted chunks.
  • Beacon scanning not working correctly in background mode on Android.
  • New auxiliary file purpose AuxiliaryFile.Purpose.AR.
  • The SpatialManager.createEmptyRegion() function can now be executed without prior initialization.
  • DeferredTracker.Options.minInterval is now an Int, as it represents a value in milliseconds.
  • Function GiPStech.enableBetaContent.
  • Avoid waiting for a timeout on iOS when no internet connection is available.
  • Added GiPStech Mobile Common Library (MCL) as an API dependency.
  • Replaced the Coordinates class with Coord2D from MCL.
  • Modified Floor to inherit from LocalAffineFrame and removed all functions prefixed with oob.
  • Set min iOS version to 13.0.
  • Prevent activation requests when the development key has expired.
  • Potential deadlock in the wait command on the Testing server.
  • New setFakeLocationFromOS command to the Testing server.
  • New abort command to the Testing server.
  • Fix bug of slow position updates in RF + VIO when VIO is not active.
  • Ensure proper disposal of library modules if an exception occurs during GiPStech.init.
  • Fixed various bugs in Testing server.
  • Wait for connections in Testing server.
  • Serious bug in Region.isNearOrOutsideBorder that could cause the method to always return true under certain conditions.
  • GiPStechException.Network.Untrusted correctly inherits GiPStechException.Network.
  • Discard beacon scan with RSSI equals to 0.
  • java.lang.AbstractMethodError crash affecting older Android versions.
  • New Testing server to simulate MDK events via a TCP connection.
  • GiPStech.getResourceString for querying resource strings associated to the app.
  • GiPStechException.Sensor.NotAvailable is now correctly thrown on Android when Positioning is disabled and BluetoothLe is required.
  • Renamed GiPStech.getResource and GiPStech.getResources in GiPStech.getResourceBundle and GiPStech.getResourceBundles.
  • GiPStechException.Sensor.NotAuthorized is now correctly thrown on Android too.
  • Exception class GiPStechException.Sensor.NotAuthorized.
  • Issues related to iOS sensor access permissions.
  • Combine system calibrated magnetometer and internal calibration.
  • Correctly stop listening to the system calibrated magnetometer.
  • App resource bundles obtained through GiPStech.getResources() and GiPStech.getResource().
  • Renamed AuxiliaryFile.Purpose.WAYFI in AuxiliaryFile.Purpose.WayFi.
  • Rare crash while reading the attitude.
  • Not closing resource when using DeferredTracker.
  • Improved heading accuracy estimation.
  • Usage of calibrated magnetometer.
  • Fallback to sensors heading estimation.
  • Heading accuracy with RF + VIO.
  • Crash when clearance is enabled and no floor is selected.
  • Conflicts between auxiliary files with the same name but different purpose.
  • UpgradeRequired exception.
  • GiPStech.setAppVersion function.
  • IllegalStateException thrown if Bluetooth is disabled during localization.
  • Clearance correction in RF + VIO.
  • Quota field to Floor class.
  • Exception handling in camera pose processing.
  • Reading camera pose from sensor file.
  • Outdoor transition timeout was not triggered when no Bluetooth beacons were received and inertial sensors were not active.
  • Reset heading and heading_accuracy when selecting the new localization algorithm for RF + VIO.
  • Bug in universal localization occurring when selecting the new localization algorithm for RF + VIO.
  • Removed kotlinx-datetime dependency to prevent conflicts with kotlin.datetime.
  • AuxiliaryFile packages 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.
  • Rename XCFramework to match internal framework name.
  • Removed function SpatialManaget.findAuxiliaryFile.
  • Replaced kotlinx.datetime.Instant with kotlin.time.Instant in BuildingInfo and FloorInfo.
  • Functions requiring a connection now throw GiPStechException.Network.Unauthorized if a secure connection cannot be established.
  • Support for auxiliary file packages.
  • Request throttling to reduce unnecessary calls.
  • New functions: SpatialManager.addAuxPurpose and SpatialManager.removeAuxPurpose.
  • New function GiPStech.resetThrottling to reset throttling timers.
  • New purpose AuxiliaryFile.Purpose.VP for visual positioning.
  • Renew activation if MDK directory is deleted.
  • Stop scanning Bluetooth beacons on some Android device.
  • iBeacon scanning in Android and iOS.
  • Re-enable GPS when switching from indoor to outdoor.
  • Overloads in XCFramework do not throw exceptions as NSError.
  • Default value of fallback parameter to true.
  • OBB functions to Floor: obbContains, obbProject and obbUnproject.
  • Missing invocation of onException in response to sensor errors.
  • LocationListener.onException is now correctly triggered when Bluetooth LE, Wi-Fi, or GNSS is disabled during the localization process.
  • The AuxiliaryFile path field now correctly stores the full file path instead of just the file name.
  • 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.
  • GiPStech.setMockLocation now accepts a location object, which will subsequently be returned by SpatialManager.getLocationFromOS.
  • Building.getMemorySize and Tile.getMemorySize.
  • Default parameter values to the Location class constructor.
  • GiPStech.setMockLocation and GiPStech.resetMockLocation for testing purpose.
  • 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.
  • SpatialManager.isNearOrOutsideBorder sometimes did not return correct value.
  • Sometimes data retrieved with Region.requestAdditionalArea were not used.
  • Removed parameters from SpatialManager.createEmptyRegion.
  • Sporadic crash during localization when loading building or reading attitude.
  • Synchronization of timestamps between GNSS and inertial sensors.
  • DeferredTracker file format.
  • Functions for loading cached buildings: SpatialManager.loadCachedBuildingsNearby and SpatialManager.loadCachedBuildingsByBounds.
  • Functions for setting the localization profile: GiPStech.setProfile and GiPStech.resetProfile.
  • Exception GiPStechException.Sensor.FetchFailed which occurs when a sensor reading fails to complete successfully.
  • Fields payload and payloadFormat in Building and Floor.
  • Place.findAuxiliaryFiles as abstract for Building and Region.
  • progress callback was not invoked by forceSynchronization when no files were available.
  • Move pro-guarded classes out of the root package to avoid naming collisions with other modules.
  • sendOnlyExisting option to DeferredTracker to allow sending only pre-generated chunks without creating new ones.
  • Property AuxiliaryFile.nameWithoutExtension.
  • Location.level is now -1 instead of 255 when outdoor.
  • Swap coordinates in Floor.origin, Floor.topLeft and Floor.bottomRight.
  • Sensor exception on Place.startLocalization after CalibrationManager.abortCalibration.
  • Rename LocationSession.getAttitude in LocationSession.readAttitude.
  • Localization not halted when GiPStechException.Sensor.NotAvailable is thrown.
  • Auxiliary files are not being correctly stored with version information.
  • CalibrationManager.beginCalibration now correcly throws GiPStechException.Sensor.NotAvailable when required sensor is unavailable.
  • GiPStech.init now correctly throws GiPStechException.ActivationDenied (instead of GiPStechException.Sensor.ActivationRequired) if the GiPStech Server does not authorize the application.
  • Support for Wi-Fi localization (only Android).
  • Parameter includeIndoor (default true) in SpatialManager.findAuxiliaryFiles.
  • Parameter mockLocation (default null) in GiPStech.setSensorFile.
  • Property Floor.heading.
  • Function Floor.requestImageFile.
  • Function FloorInfo.requestImageFile.

First public release.