CHANGELOG.md

Development

• Fix problem on service shutdown that leaked threads and left scanning on (#804, David G. Young)

2.15.4 / 2018-12-11

• Fix crash on BluetoothCrashResolver (#790, Michael Porter)

2.15.3 / 2018-12-11

• Samsung screen-off scans on Android 8.1+ fixed. (#798, David G. Young)
• Fix bug preventing callbacks after unbind/bind when using ScanJobs. (#765, David G. Young)
• Prevent NPE on access CycledLEScanner after OOM on Android 8+. (#766, David G. Young)
• Make switching back and forth between a foreground service and scan jobs more reliable (#767, David G. Young)
• Disable BluetoothCrashResolver on Android 5+ as a it is not helpful can can create log noise. (#768, David G. Young)
• Prevent NPE on start scan. (#780, Adrián Nieto Rodríguez)
• Fix thread leak leading to OOM Exceptions when using ScanJobs (#785, David G. Young)

2.15.2 / 2018-10-17

• Prevent infrequent out of memory crashes on Android 8+ (#750 Pappas Christodoulos, David G. Young)
• Prevent duplicate ranging/monitoring callbacks casued by bind/unbind with a service (#748, Adrián Nieto Rodríguez, #745, David G. Young)
• Allow starting foreground service at boot (#746, David G. Young)
• Re-enable broken BeaconSimulator (#751, David G. Young)

2.15.1 / 2018-09-01

• Prevent crash caused by internal Android exception when stopping scanning (#724, David G. Young)
• Fix Android 8 crashing apps on background monitoring/ranging data delivery (#720, David G. Young)
• Fix intermittent NPE on ranging beacons (#716, Federico Bertoli, David G. Young)
• Stop running scheduled jobs to do scans after last consumer unbound. (#702, David G. Young)

2.15 / 2018-07-04

Enhancements:

• Optional foreground beacon scanning service for faster background detections on Android 8+ (#663, David G. Young)

Bug Fixes:

• Fixes inability to detect on some 5.x Samsung Devices without scan filters. (#693, David G. Young)
• Fix inverted logic for "disable ScanJob" warning (#700, Marcel Schnelle)
• Fix crash on scanning an Eddystone-URL packet with a negative-length URL. (#703, David G. Young)

2.14 / 2018-05-17

Enhancements:

• Add warnings about disabling scheduled scan jobs on Android 8+ (#674, David G. Young)
• Add warning about setting short scan periods on Android 8 (#677, David G. Young)
• BeaconTransmitter advertisements may be configured as connectable (#683, Michael Harper)

Bug Fixes:

• Fix crashes of BluetoothMedic caused by Bluetooth being turned off (#675, David G. Young)
• Fix flawed in BeaconManager.isBound method on Android 8 (#655, David G. Young)

2.13.1 / 2018-03-05

Full Changelog

Bug Fixes:

• Fix incorrect immediateScanJobId meta-data name in manifest causing crash (#653, David G. Young)

2.13 / 2018-03-05

Full Changelog

Enhancements:

• Add BluetoothMedic to fix crashing bluetooth stacks. (#644, David G. Young)
• Allow configuring job ids (#645, David G. Young)

Bug Fixes:

• Allow scans with screen off on Android 8.1 (#637, David G. Young)

2.12.4 / 2017-12-16

Full Changelog

Bug Fixes:

• Fix performance problems when using identifiers 3-15 bytes caused by Identifier#toHexString(). (#615, David G. Young)
• Restore missing runningAverageRssi values (#621, David G. Young)
• Fix NPE on ExtraBeaconDataTracker (#626, David G. Young)
• Fix regression with RunningAverageRssiFilter.setSampleExpirationMilliseconds being overwritten when committing ranged beacon measurements. (#629, Aaron Kromer)
• Fix missing running average RSSI in callbacks when apps do not use the scheduled scan job feature. (#630, Aaron Kromer)
• Fix copying of multi-frame beacon flag in Beacon(Beacon) constructor (#630, Aaron Kromer)
• Fix the AltBeaon(Beacon) copy constructor which omitted some data fields (#630, Aaron Kromer)

2.12.3 / 2017-10-14

Full Changelog

Bug Fixes:

• Fix NullPointerException in ProcessUtils. (#598, David G. Young)
• Fix ConcurrentModificationException crashing app on Android 8 when monitored regions are changed at the same time the app shifts from active scanning to passive scanning. (#578, David G. Young)
• Fix ConcurrentModifictionExceptions starting ScanJobs. (#584, #588, David G. Young)
• Fix NullPointerException when BluetoothLeScanner cannot be obtained. (#583, David G. Young)

2.12.2 / 2017-08-31

Full Changelog

Bug Fixes:

• Fix stack overflow caused by scan period of zero seconds, caused by 2.12 upgrade of existing apps. (#572, David G. Young)
• Suppress error log on ScanState deserialization if file does not exist yet. (#570, David G. Young)
• Turn off scanning after unbind, which was previously left on forever in some cases. (#569, David G. Young)

2.12.1 / 2017-08-16

Full Changelog

Bug Fixes:

• Fix crash on Android 8.0 background scan when bluetooth is off. (#562 Juliane Lehmann)
• Fix "Scanning too frequently" error with non-zero betweenScanPeriod and scanPeriod+betweenScanPeriod < 6000, and full-power scanning staying on for foreground scans with a non-zero betweenScanPeriod (#555, David G. Young)

2.12 / 2017-08-07

Full Changelog

Enhancements:

• Add Android O support with ScanJob using JobScheduler to do scans instead of BeaconService, set as default for Android O. (#484, David G. Young)

Bug Fixes:

• Correct accessor method for Beacon#getRunningAverageRssi() (#536, Pietro De Caro)

2.11 / 2017-06-28

Full Changelog

Enhancements:

• Add ability to circumvent prohibition against scans running for > 30 minutes on Android N. (#529, David G. Young)
• Add support for running the beacon scanning service in a separate process and working with application setups that have more than one process. (#479, David G. Young)

Bug Fixes:

• Fix Google Play submission errors by no longer using uses-permission-sdk-23 in Manifest (#527, David G. Young)
• Fix inability to use RunningAverageRssiFilter.setSampleExpirationMilliseconds(...) (#523, David G. Young)
• Fix failure to restart scanning in some cases after bluetooth has been off but then is turned back on. (#519, David G. Young)
• Fix failure to stop scanning when unbinding from service or when the between scan period is nonzero. (#507, David G. Young)
• Fix possible NullPointerException with BackgroundPowerSaver on devices prior to Android 4.3 Jelly Bean MR 2 (API 18) (#516, Aaron Kromer)
• Fix rare edge case causing NoSuchElementException when using the legacy BeaconManager#getMonitoringNotifier and BeaconManager#getRangingNotifier where the notifier sets were modified external to BeaconManager by another thread (#516, Aaron Kromer)

2.10 / 2017-04-21

Full Changelog

Enhancements:

• Don't restart BLE scanning periodically if the library confrims device can detect duplicate advertisements in a single scan, leading to more reliable detections with short scan cycles (#491, David G. Young)

Bug Fixes:

• Deprecate misspelled methods removeMonitoreNotifier and setRegionStatePeristenceEnabled in favor of correctly spelled alternatives. (#461, Marco Salis)
• Fix bug causing brief scan dropouts after starting a scan after a long period of inactivity (i.e. startup and background-foreground transitions) due to Android N scan limits (#489, Aaron Kromer)
• Ensure thread safety for singleton creation of BeaconManager, DetectionTracker, MonitoringStatus, and Stats. (#494, Aaron Kromer)

2.9.2 / 2016-11-22

Full Changelog

Bug Fixes:

• Provide access to monitored regions after restoring state (#456, David G. Young)
• Don't start or stop scans if bluetooth state is off to prevent crashes on HTC devices (#452, David G. Young)
• Protect against SecurityException crashes caused by Samsung Knox (#444, David G. Young)
• No Monitoring information after killing an application built with the minify mode (#432, ost-ct)
• Start and stop BLE scans from a background thread to prevent blocking the UI (#430, Marco Salis)
• Prevent flapping (rapid exit then enter) of restored monitored regions (#426, Elias Lecomte)
• Don't implicitly require bluetooth in manifest (Commit b3ac622e2b, David G. Young)

2.9.1 / 2016-08-26

Full Changelog

Bug Fixes:

• Fixes spurious entry/exit events on Android N caused by OS imposed limits of 5 scans every 30 seconds. (#419, David G. Young)

2.9 / 2016-07-25

Full Changelog

Enhancements:

• Multiple ranging and monitoring notifiers are supported via BeaconManger#addRangeNotifier(RangeNotifier notifier) and BeaconManger#addMonitorNotifier(MonitorNotifier notifier) (#392, ost-ct)
• App bootstrap regions by be dynamically changed with newRegionBootstrap#removeRegion(Region region) and RegionBootstrap#addRegion(Region region) methods. (#369, Aristide)
• Improved region state behavior by adding BeaconManager#requestStateForRegion(Region) and BeaconManager#setRegionStatePeristenceEnabled(boolean) (#405, David G. Young)
• Added a guaranteed callback to MonitorNotifier#didDetermineStateForRegion(int state, Region region) when starting monitoring. At app startup, this returns the previously known persisted state. (#405, David G. Young)
• Custom distance calculation for Moto X 2nd gen XT1092 (#386, Clément Garcia)
• More flexible support for combining multi-frame beacons with Beacon#getExtraDataFields() (#387, mfatiga)

Bug Fixes:

• Eddystone frame detection on Google's Android BeaconTools and Chrome fixed by adding missing service UUID PDU. (#401, David G. Young)
• Beacon data fields of over four bytes are now be parsed correctly. (#373, Junsung Lim)
• Region persistence app freezes resolved by limiting persisted regions to 50 (#405, David G. Young)
• Fixed inability to starting monitoring for a different Region definition with the same uniqueId (#405, David G. Young)
• Fixes Eddystone-URL layout to support the full 17 bytes for URLs (uses 18 bytes total: 1 byte for schema and 17 bytes for URL) (#377, Mario Pucci)
• Fix potential context leak in BeaconManager (#381, Ovidiu Latcu)

2.8.1 / 2016-04-18

Full Changelog

Bug Fixes:

• As of the 2.8 release, scanning would never start on Android 4.x devices unless the application manually added ACCESS_COARSE_LOCATION or ACCESS_FINE_LOCATION permissions to the AndroidManifest.xml. This fix makes it so this is not required for 4.x devices, as was the case prior to 2.8. (#365, David G. Young)

2.8 / 2016-03-28

Full Changelog

Enhancements:

• Retains monitored regions across service restarts, preventing apps from getting multiple region entry callbacks each time the service restarts. (#315, Mateusz Sarzyński)
• Add string identifier to BeaconParser which can be referenced by decoded Beacon object, allowing easy determination of beacon type. (#333, David G. Young)
• Switch to using ELAPSED_REALTIME clocks, so scanning doesn't stop on devices without a battery-backed RTC (#339, Luca Niccoli)
• Add ability to access raw EDDYSTONE_TLM data for sending info to Google services. (#328, David G. Young)
• New distance formula for Moto X Pro (#330, David G. Young)
• Adjust the BackgroundPowerSaver so it accepts any context (#355, Kristof Snyers)
• Add support for pre-Eddystone UriBeacon layout (#358, David G. Young)

Bug Fixes:

• Multiple consumers of the BeaconService will now each get a onBeaconServiceConnected() callback. (#340, Mateusz Sarzyński)
• Don't scan for bluetooth devices if permission has not been granted in Android 6. This prevents large number of exceptions in the log. (#327, Alex Urzhumtcev)
• Fix crash on beacon parsing comparison overrun (#324, David G. Young)

2.7.1 / 2015-11-17

Full Changelog

Bug Fixes:

• Stopping and starting monitoring disables scans (#317, David G. Young)

2.7 / 2015-11-12

Full Changelog

Enhancements:

• Adds hardware accelerated detection of Eddystone frames in the background on Android 5+ (#314, David G. Young)
• Provides ability to forward BLE scan callbacks for non-beacon advertisements (#267, Paul Peavyhouse)

Bug Fixes:

• Fix rescheduling of alarms in the distant future so they don't inadvertently go off right away (#312, Mateusz Sarzyński)
• Only request ACCESS_COARSE_LOCATION permission on Android M (#296, Henning Dodenhof)

2.6.1 / 2015-09-30

Full Changelog

Bug Fixes:

• Allow Regions to match beacons with fewer identifiers if the extra region identifiers are null. This allows matching Eddystone-UID and Eddystone-URL beacon with the default Region with three null identifiers. This started failing in version 2.6. (#295, David G. Young)
• Declare the ACCESS_COARSE_LOCATION permission in the manifest since it is required for Android 6.0. This is helpful to keep beacon detection working on Android 6.0 for apps that don't explicitly declare this in their own manifest. (#295, David G. Young)

2.6 / 2015-09-29

Full Changelog

Enhancements:

• Make region exit period configuration with a default of ten seconds (#283, Alex Urzhumtcev)
• When scanning in Background on Android 5+, do a full scan without filters during the main scan period (default for 10 seconds once every 5 minutes) in case scan filters are unavailable (#293, David G. Young)
• Common open-source BeaconParser layouts are defined as constants on BeaconParser (Commit 0101970010, David G. Young)
• Bluetooth address is now a field on Region, offering the option of monitoring and ranging for all beacon transmissions from a known device's MAC Address (#254, David G. Young)
• Target SDK bumped to 23 for Android 6.0 (#293, David G. Young)

Bug Fixes:

• Fix potential ConcurrentModificationException with distance calculation (#245, Dawid Drozd)
• Fix potential NullPointerException in Beacon#hashCode (#249, Sam Yang)
• Switch BeaconParsers list to be a CopyOnWriteArrayList to avoid UnsupportedOperationException changing list after starting scanning. (#290, Matthew Michihara)
• Fix crash when region has more identifiers than beacon (#252, David G. Young)
• Fix bugs with compressing Eddystone-URL to bytes and back (#263, Michael Harper)