yangjie/bluetooth_low_energy
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

Add state migration step #45 (#75)

Browse Source
This commit is contained in:
渐渐被你吸引
2024-06-04 11:55:34 +08:00
committed by GitHub
parent 108b6a804f
commit 87dfbc8ec6
1 changed files with 32 additions and 15 deletions
Download Patch File Download Diff File Expand all files Collapse all files

47
bluetooth_low_energy/doc/migrations/migration-v6.md
View File

@ -1,6 +1,5 @@
# Migrate form 5.x to 6.x # Migrate form 5.x to 6.x
## Capitalization Rules ## Capitalization Rules
* `GattCharacteristicNotifiedEventArgs` -> `GATTCharacteristicNotifiedEventArgs` * `GattCharacteristicNotifiedEventArgs` -> `GATTCharacteristicNotifiedEventArgs`
@ -45,16 +44,25 @@ final stateChangedSubscription = centralManager.stateChanged.listen((eventArgs)
}); });
``` ```
4. The type of `manufacturerSpecificData` in `Advertisement` changed from `ManufacturerSpecificData` to `List<ManufacturerSpecificData>`. 4. Get state of the `CentralManager`.
``` Dart ``` Dart
// 5.x // 5.x
final manufacturerSpecificData = advertisement.manufacturerSpecificData; // ManufacturerSpecificData // final state = await CentralManager.instance.getState();
// 6.x
final state = centralManager.state;
```
5. The type of `manufacturerSpecificData` in `Advertisement` changed from `ManufacturerSpecificData` to `List<ManufacturerSpecificData>`.
``` Dart
// 5.x
// final manufacturerSpecificData = advertisement.manufacturerSpecificData; // ManufacturerSpecificData
// 6.0 // 6.0
final manufacturerSpecificData = advertisement.manufacturerSpecificData; // List<ManufacturerSpecificData> final manufacturerSpecificData = advertisement.manufacturerSpecificData; // List<ManufacturerSpecificData>
``` ```
5. Request MTU manually on Android. 6. Request MTU manually on Android.
``` Dart ``` Dart
// The mtu is no longer requested automatically on Android // The mtu is no longer requested automatically on Android
@ -69,7 +77,7 @@ if (Platform.isAndroid) {
} }
``` ```
6. Fragment the value manually when write characteristics. 7. Fragment the value manually when write characteristics.
``` Dart ``` Dart
// The value is no longer fragmented automatically after // The value is no longer fragmented automatically after
@ -128,7 +136,16 @@ final stateChangedSubscription = peripheralManager.stateChanged.listen((eventArg
}); });
``` ```
4. Use the factory methods to create GATTService and GATTDescriptor. 4. Get state of the `PeripheralManager`.
``` Dart
// 5.x
// final state = await PeripheralManager.instance.getState();
// 6.x
final state = peripheralManager.state;
```
5. Use the factory methods to create GATTService and GATTDescriptor.
``` Dart ``` Dart
// 5.x // 5.x
@ -196,16 +213,16 @@ final service = GATTService(
); );
``` ```
5. The type of `manufacturerSpecificData` in `Advertisement` changed from `ManufacturerSpecificData` to `List<ManufacturerSpecificData>`. 6. The type of `manufacturerSpecificData` in `Advertisement` changed from `ManufacturerSpecificData` to `List<ManufacturerSpecificData>`.
``` Dart ``` Dart
// 5.x // 5.x
final advertisement = Advertisement( // final advertisement = Advertisement(
manufacturerSpecificData: ManufacturerSpecificData( // manufacturerSpecificData: ManufacturerSpecificData(
id: 0x2e19, // id: 0x2e19,
data: Uint8List.fromList([0x01, 0x02, 0x03]), // data: Uint8List.fromList([0x01, 0x02, 0x03]),
), // ),
); // );
// 6.x // 6.x
final advertisement = Advertisement( final advertisement = Advertisement(
manufacturerSpecificData: [ manufacturerSpecificData: [
@ -217,7 +234,7 @@ final advertisement = Advertisement(
); );
``` ```
6. Respond read and write requests manually. 7. Respond read and write requests manually.
``` Dart ``` Dart
// The read and write requests are no longer responded automatically // The read and write requests are no longer responded automatically
@ -254,7 +271,7 @@ final characteristicWriteRequestedSubscription = peripheralManager.characteristi
}); });
``` ```
7. Fragment the value manually when notify characteristics. 8. Fragment the value manually when notify characteristics.
``` Dart ``` Dart
// The value is no longer fragmented automatically after // The value is no longer fragmented automatically after