Ble Undeliverable Exception Documentation

[0p3r4t0r]

Is your feature request related to a problem? (please describe)
The ReadMe section for Ble Undeliverable Exception should contain a complete working code sample and some more detailed instructions.

Describe the solution you'd like
To catch the Ble Undeliverable exception in Java you can do the following . . .

1. Add implementation "com.polidea.rxandroidble2:rxandroidble:1.11.1" to the dependencies section of your build.gradle file (source).

2. Then add the following to MainActivity.java

import io.flutter.embedding.android.FlutterActivity;
import androidx.annotation.NonNull;
import io.flutter.embedding.android.FlutterActivity;
import io.flutter.embedding.engine.FlutterEngine;
import com.polidea.rxandroidble2.exceptions.BleException;
import io.reactivex.exceptions.UndeliverableException;
import io.reactivex.plugins.RxJavaPlugins;

public class MainActivity extends FlutterActivity {
    public void configureFlutterEngine(@NonNull FlutterEngine flutterEngine) {
        super.configureFlutterEngine(flutterEngine);
        RxJavaPlugins.setErrorHandler(throwable -> {
            if (throwable instanceof UndeliverableException && throwable.getCause() instanceof BleException) {
                System.out.println('!' * 80);
                System.out.println("Caught UndeliverableException from flutter_reactive_ble.");
                System.out.println('!' * 80);
                return; // ignore BleExceptions as they were surely delivered at least once
            }
            throw new RuntimeException("Unexpected Throwable in RxJavaPlugins error handler", throwable);
        });
    }
}

Additional context
As for me, my experience with android is limited and so it took me a long time to build a complete working version from the code you had in your README. Also, you can find some helpful examples here in the RxAndroidBle library examples folder.

[remonh87]

@0p3r4t0r thanks for reporting. I indeed see that I forgot to add the need for adding the polidea library in this example. Regarding the rest of the code you are working in java and my example was written in Kotlin. Will make that more clear as well. For the rest the issue is not on the RxAndroid library but more on the RXJava side so adding the RXAndroidBLE examples do not add that much value.

[0p3r4t0r]

How about providing some links to the relevant sections of the RxAndroid library? That way you wouldn't clutter your docs and you could probably save your users some Googling.

Something like . . .

• Also see RxAndroidBle for details and check RxAndroidBle: Examples for an example implementation.

[remonh87]

improved the readme and it is now available on master.