/ReactiveAirplaneMode

✈️ Android library listening airplane mode with RxJava Observables

Primary LanguageJavaApache License 2.0Apache-2.0

ReactiveAirplaneMode Build Status codecov Maven Central

✈️ Android library listening airplane mode with RxJava Observables

This library is compatible with RxJava2 and RxAndroid2.

JavaDoc can be found at: https://pwittchen.github.io/ReactiveAirplaneMode/.

Contents

Usage

We can observe airplane mode in the following way:

ReactiveAirplaneMode.create()
    .observe(context)
    .subscribeOn(Schedulers.io())
    .observeOn(AndroidSchedulers.mainThread())
    .subscribe(isOn -> textView.setText(String.format("Airplane mode on: %s", isOn.toString())));

When airplane mode changes, subscriber will be notified with appropriate Boolean value (true if airplane mode is on or false otherwise).

If you're using this code in an Activity, don't forget to dispose Disposable in onPause() method just like in the sample app.

Please note that method above will be called only when the airplane mode changes.

If you want to read airplane mode on start and then observe it, you can use getAndObserve(context) method as follows:

ReactiveAirplaneMode.create()
    .getAndObserve(context)
    .subscribeOn(Schedulers.io())
    .observeOn(AndroidSchedulers.mainThread())
    .subscribe(isOn -> textView.setText(String.format("Airplane mode on: %s", isOn.toString())));

If you want to check airplane mode only once, you can use get(context) method, which returns Single<Boolean> value:

ReactiveAirplaneMode.create()
    .get(context)
    .subscribeOn(Schedulers.io())
    .observeOn(AndroidSchedulers.mainThread())
    .subscribe(isOn -> textView.setText(String.format("Airplane mode on: %s", isOn.toString())));

If you want to check airplane mode only once without using Reactive Streams, just call isAirplaneModeOn(context) method:

boolean isOn = ReactiveAirplaneMode.create().isAirplaneModeOn(context);

Examples

Exemplary application is located in app directory of this repository.

Download

You can depend on the library through Maven:

<dependency>
    <groupId>com.github.pwittchen</groupId>
    <artifactId>reactiveairplanemode</artifactId>
    <version>0.0.1</version>
</dependency>

or through Gradle:

dependencies {
  compile 'com.github.pwittchen:reactiveairplanemode:0.0.1'
}

Tests

Tests are available in library/src/test/java/ directory and can be executed on JVM without any emulator or Android device from Android Studio or CLI with the following command:

./gradlew test

To generate test coverage report, run the following command:

./gradlew test jacocoTestReport

Code style

Code style used in the project is called SquareAndroid from Java Code Styles repository by Square available at: https://github.com/square/java-code-styles.

Static code analysis

Static code analysis runs Checkstyle, PMD and Lint. It can be executed with command:

./gradlew check

Reports from analysis are generated in library/build/reports/ directory.

Changelog

See CHANGELOG.md file.

Releasing

See RELEASING.md file.

References

License

Copyright 2017 Piotr Wittchen

Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at

   http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.