Merge pull request #416 from Polidea/release/2.2.0

Release 2.2.0

Author: mikolak

.travis.yml

@@ -21,11 +21,11 @@ _android_job_template: &android_job_template
   android:
     components:
       - tools
-      - build-tools-28.0.3
       - android-28
+      - android-29
+      - build-tools-28.0.3
+      - build-tools-29.0.5
       - extra-android-m2repository
-    licenses:
-      - 'android-sdk-license-.+'
   env:
     global:
       - GRADLE_OPTS="-Xms128m"

.vscode/launch.json

@@ -0,0 +1,11 @@
+{
+  "version": "0.2.0",
+  "configurations": [
+    {
+      "name": "Example (debug)",
+      "request": "launch",
+      "type": "dart",
+      "flutterMode": "debug"
+    }
+  ]
+}

CHANGELOG.md

@@ -1,3 +1,11 @@
+## 2.2.0
+
+* **NEW** operations on descriptors
+* **BREAKING FOR BLEMULATOR** BLEmulator versions lower than 1.1.0 are not supported from this release
+* Support for AndroidX
+* Support for Swift 5
+* Lower iOS deployment target to 8.0
+
 ## 2.1.0
 
 * **BREAKING** ScanResult.AdvertisementData.ManufacturerData has changed type from Int8List to Uint8List

README.md

@@ -39,7 +39,7 @@ For more informations, see [REFERENCE](https://github.com/Polidea/FlutterBleLib/
 ### Initialising
 ```dart
 BleManager bleManager = BleManager();
-bleManager.createClient(); //ready to go!
+await bleManager.createClient(); //ready to go!
 // your peripheral logic
 bleManager.destroyClient(); //remember to release native resources when you're done!
 ```
@@ -81,6 +81,8 @@ bleManager.startPeripheralScan(
 The snippet above starts peripheral scan and stops it after receiving first result. 
 It filters the scan results to those that advertise a service with specified UUID.
 
+**NOTE:** `isConnectable` and `overflowServiceUuids` fields of `ScanResult` are iOS-only and remain `null` on Android.
+
 ### Connecting to peripheral
 First you must obtain a _ScanResult_ from _BleManager.startPeripheralScan()_.
 ```dart

REFERENCE.md

@@ -34,11 +34,12 @@ Releases native resources. Should be called once there's no further need for BLE
     bool allowDuplicates,
   });
 ```
-Returns a stream of objects containing advertisement data of the peripheral and the peripheral itself.
 `scanMode` and `callbackType` are Android-specific. [More information in Android documentation](https://developer.android.com/reference/android/bluetooth/le/ScanSettings)
 `allowDuplicates` is iOS-specific. [More information in iOS documentation](https://developer.apple.com/documentation/corebluetooth/cbcentralmanagerscanoptionallowduplicateskey)
 `uuids` is used to filter peripherals to only return those containing services with specified UUIDs.
 
+Returns a stream of objects containing advertisement data of the peripheral and the peripheral itself called `ScanResult`. The object has two iOS-only fields: `isConnectable` and `overflowServiceUuids`. 
+
 ```dart
   Future<void> stopDeviceScan();
 ```

android/build.gradle

@@ -1,5 +1,5 @@
 group 'com.polidea.flutter_ble_lib'
-version '1.0'
+version '2.2.0'
 
 buildscript {
     repositories {
@@ -8,7 +8,7 @@ buildscript {
     }
 
     dependencies {
-        classpath 'com.android.tools.build:gradle:3.2.1'
+        classpath 'com.android.tools.build:gradle:3.5.3'
     }
 }
 
@@ -35,6 +35,6 @@ android {
 }
 
 dependencies {
-    implementation 'com.android.support:support-annotations:28.0.0'
-    implementation 'com.github.Polidea:MultiPlatformBleAdapter:0.1.0'
+    implementation 'androidx.annotation:annotation:1.1.0'
+    implementation 'com.github.Polidea:MultiPlatformBleAdapter:0.1.4'
 }

android/gradle.properties

@@ -1,4 +1,4 @@
 org.gradle.jvmargs=-Xmx1536M
 
-android.useAndroidX=false
-android.enableJetifier=false
+android.useAndroidX=true
+android.enableJetifier=true

android/gradle/wrapper/gradle-wrapper.properties

@@ -2,4 +2,4 @@ distributionBase=GRADLE_USER_HOME
 distributionPath=wrapper/dists
 zipStoreBase=GRADLE_USER_HOME
 zipStorePath=wrapper/dists
-distributionUrl=https\://services.gradle.org/distributions/gradle-4.10.2-all.zip
+distributionUrl=https\://services.gradle.org/distributions/gradle-5.6.2-all.zip

android/src/main/java/com/polidea/flutter_ble_lib/CharacteristicsResponse.java

@@ -3,16 +3,18 @@
 import com.polidea.multiplatformbleadapter.Characteristic;
 import com.polidea.multiplatformbleadapter.Service;
 
+import java.util.List;
+
 public class CharacteristicsResponse {
-    private final Characteristic[] characteristics;
+    private final List<Characteristic> characteristics;
     private final Service service;
 
-    public CharacteristicsResponse(Characteristic[] characteristics, Service service) {
+    public CharacteristicsResponse(List<Characteristic> characteristics, Service service) {
         this.characteristics = characteristics;
         this.service = service;
     }
 
-    public Characteristic[] getCharacteristics() {
+    public List<Characteristic> getCharacteristics() {
         return characteristics;
     }
 

android/src/main/java/com/polidea/flutter_ble_lib/FlutterBleLibPlugin.java

@@ -1,7 +1,6 @@
 package com.polidea.flutter_ble_lib;
 
 import android.content.Context;
-import android.support.annotation.NonNull;
 import android.util.Log;
 
 import com.polidea.flutter_ble_lib.constant.ArgumentKey;
@@ -10,6 +9,7 @@
 import com.polidea.flutter_ble_lib.delegate.BluetoothStateDelegate;
 import com.polidea.flutter_ble_lib.delegate.CallDelegate;
 import com.polidea.flutter_ble_lib.delegate.CharacteristicsDelegate;
+import com.polidea.flutter_ble_lib.delegate.DescriptorsDelegate;
 import com.polidea.flutter_ble_lib.delegate.DeviceConnectionDelegate;
 import com.polidea.flutter_ble_lib.delegate.DevicesDelegate;
 import com.polidea.flutter_ble_lib.delegate.LogLevelDelegate;
@@ -31,6 +31,7 @@
 import java.util.LinkedList;
 import java.util.List;
 
+import androidx.annotation.NonNull;
 import io.flutter.plugin.common.EventChannel;
 import io.flutter.plugin.common.MethodCall;
 import io.flutter.plugin.common.MethodChannel;
@@ -86,6 +87,7 @@ private void setupAdapter(Context context) {
         delegates.add(new MtuDelegate(bleAdapter));
         delegates.add(new CharacteristicsDelegate(bleAdapter, characteristicsMonitorStreamHandler));
         delegates.add(new DevicesDelegate(bleAdapter));
+        delegates.add(new DescriptorsDelegate(bleAdapter));
     }
 
     @Override