v0.13.0

.github/workflows/rust.yml

@@ -39,14 +39,14 @@ jobs:
       CARGO_BUILD_TARGET: ${{ matrix.cbt }}
 
     steps:
-      - uses: actions/checkout@v2
+      - uses: actions/checkout@v4
       - name: Install dependencies
         if: ${{ runner.os == 'Linux' }}
         run: |
           sudo apt-get update
-          sudo apt-get install libdbus-1-dev
-      - uses: actions/setup-java@v2
-        if: ${{ matrix.target == 'android' }}
+          sudo apt-get install libdbus-1-dev openjdk-17-jdk
+      - uses: actions/setup-java@v5
+        if: ${{ matrix.target == 'android' || matrix.target == 'linux' }}
         with:
           distribution: 'zulu'
           java-version: '17'
@@ -71,20 +71,29 @@ jobs:
         run: cargo check --all --bins --examples --no-default-features
       - name: Check with all features
         run: cargo check --all --bins --examples --all-features
+      - name: Run JNI host tests
+        if: ${{ matrix.target == 'linux' }}
+        run: ./scripts/run-jni-tests.sh
       - name: Run tests
         if: ${{ matrix.target != 'android' }}
         run: cargo test --all
+      - name: Build Android library and test app
+        if: ${{ matrix.target == 'android' }}
+        run: |
+          ./scripts/build-java.sh
+          cp src/droidplug/java/gradlew tests/android/
+          cp -r src/droidplug/java/gradle tests/android/
+          printf 'sdk.dir=%s\n' "$ANDROID_HOME" > tests/android/local.properties
+          cd tests/android
+          chmod +x gradlew
+          ./gradlew assembleDebug assembleAndroidTest
       - name: Run clippy
-        uses: actions-rs/clippy-check@v1
-        with:
-          name: clippy ${{ matrix.os }}
-          token: ${{ secrets.GITHUB_TOKEN }}
-          args: --all-features
+        run: cargo clippy --all-features -- -D warnings
 
   format:
     runs-on: ubuntu-latest
     steps:
-      - uses: actions/checkout@v2
+      - uses: actions/checkout@v4
       - name: Format Rust code
         run: cargo fmt --all -- --check
 
@@ -100,7 +109,7 @@ jobs:
 #    env:
 #      RUSTC_BOOTSTRAP: 1
 #    steps:
-#      - uses: actions/checkout@v2
+#      - uses: actions/checkout@v4
 #      - name: Install dependencies
 #        if: ${{ runner.os == 'Linux' }}
 #        run: sudo apt-get install libdbus-1-dev

CHANGELOG.md

@@ -1,3 +1,64 @@
+# 0.13.0 (2026-08-29)
+
+## Features
+
+- Add `Central::retrieve_peripherals()` and `RetrievePeripheralsOptions` for
+  retrieving peripherals by identifier or advertised service without scanning.
+  This is supported on Linux, macOS/iOS, and Windows; Android returns
+  `Error::NotSupported`.
+- Add `Central::adapter_address()` for retrieving the local adapter address on
+  Linux and Windows. Apple platforms and ordinary Android applications return
+  `Ok(None)` because their public APIs do not expose this address.
+- Implement `Central::add_peripheral()` on Windows, allowing bonded or already
+  connected devices to be reached by address without waiting for an
+  advertisement.
+- Add `appearance` to `PeripheralProperties`, populated from GAP Appearance
+  advertising data on Windows, Linux, and Android. CoreBluetooth does not expose
+  this advertising field, so it remains `None` on Apple platforms.
+- Add support for receiving advertisements on the Bluetooth LE Coded PHY on
+  Windows where supported.
+
+## Bugfixes
+
+- Fix CoreBluetooth service discovery hanging when descriptor discovery fails.
+- Fix CoreBluetooth `clear_peripherals()` so cleared devices can be rediscovered
+  and emit fresh discovery events.
+- Report the negotiated CoreBluetooth MTU after service discovery instead of
+  always returning the default MTU.
+- Preserve complete local names over shortened names across split or repeated
+  advertisements on Android, macOS/iOS, and Windows.
+- Fix filtered Windows scans dropping scan-response packets that omit service
+  UUIDs, and prevent stale scan-response matches from leaking between scans.
+- Propagate Android JNI callback and initialization failures consistently while
+  preserving Java exception details.
+- Harden Windows characteristic subscription state so repeated subscriptions do
+  not install duplicate handlers and failed CCCD operations remain retryable.
+  (#326)
+- Clarify that `Peripheral::properties()` is a backend-dependent snapshot and
+  may be unavailable, incomplete, or stale. (#339)
+- Prevent CoreBluetooth descriptor discovery and GATT operation failures from
+  hanging pending futures or panicking on missing relationships. (#397, #422)
+- Run compatible CoreBluetooth operations through FIFO queues, preserve
+  write-without-response ordering under backpressure, and complete pending
+  operations safely on disconnect or late callbacks. (#464)
+- Remove stale CoreBluetooth peripheral event senders after dispatch failures so
+  peripherals can be rediscovered cleanly. (#469)
+- Expand Android JNI host-test coverage for futures, streams, and environment
+  setup across worker threads. (#427)
+- Update the event-driven discovery example to describe its async-task usage.
+  (#460)
+
+## Breaking Changes
+
+- **Android minimum SDK**: Android API 24 (Android 7.0) or newer is now required.
+- **`PeripheralProperties` struct literals**: The new `appearance` field must be
+  initialized by callers that construct this public struct directly.
+
+## Dependencies
+
+- Update `jni` from 0.19 to 0.22 and migrate the Android backend to its current
+  API.
+
 # 0.12.0 (2026-03-08)
 
 ## Features