From 3a141d2fc487aa623aefb1e6038cb2f8c98ee585 Mon Sep 17 00:00:00 2001 From: "David G. Young" Date: Wed, 25 Apr 2018 10:59:04 -0400 Subject: [PATCH 1/2] add warning about disabling scan jobs on Android 8+ --- src/main/java/org/altbeacon/beacon/BeaconManager.java | 9 +++++++++ 1 file changed, 9 insertions(+) diff --git a/src/main/java/org/altbeacon/beacon/BeaconManager.java b/src/main/java/org/altbeacon/beacon/BeaconManager.java index 42aec264c..bfb4e238b 100644 --- a/src/main/java/org/altbeacon/beacon/BeaconManager.java +++ b/src/main/java/org/altbeacon/beacon/BeaconManager.java @@ -548,6 +548,10 @@ public void setBackgroundMode(boolean backgroundMode) { * otherwise beacon scans may be run only once every 15 minutes in the background, and no low * power scans may be performed between scanning cycles. * + * Setting this value to false will disable ScanJobs when the app is run on Android 8+, which + * can prohibit delivery of callbacks when the app is in the background unless the scanning + * process is running in a foreground service. + * * This method may only be called if bind() has not yet been called, otherwise an * `IllegalStateException` is thown. * @@ -564,8 +568,13 @@ public void setEnableScheduledScanJobs(boolean enabled) { " availble prior to Android 5.0"); return; } + if (enabled && android.os.Build.VERSION.SDK_INT >= Build.VERSION_CODES.O) { + LogManager.w(TAG, "Disabling ScanJobs on Android 8+ may disable delivery of "+ + "beacon callbacks in the background unless a foreground service is active."); + } mScheduledScanJobsEnabled = enabled; } + public boolean getScheduledScanJobsEnabled() { return mScheduledScanJobsEnabled; } From 25f7205247d848f63376e3022a06fbfd93b1e1f7 Mon Sep 17 00:00:00 2001 From: "David G. Young" Date: Wed, 16 May 2018 17:14:01 -0400 Subject: [PATCH 2/2] update changelog --- CHANGELOG.md | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/CHANGELOG.md b/CHANGELOG.md index 499b690dc..4cf189c64 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -1,8 +1,9 @@ ### Development Enhancements: + - Add warnings about disabling scheduled scan jobs on Android 8+ (#674, David G. Young) - BeaconTransmitter advertisements may be configured as connectable (#683, Michael Harper) - + ### 2.13.1 / 2018-03-05 [Full Changelog](https://github.com/AltBeacon/android-beacon-library/compare/2.13.1...2.13)