This library is compatible with RxJava2 and RxAndroid2.
JavaDoc can be found at: https://pwittchen.github.io/ReactiveAirplaneMode/.
- Usage
- Examples
- Download
- Tests
- Code style
- Static code analysis
- Changelog
- Releasing
- References
- License
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);
Exemplary application is located in app
directory of this repository.
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 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 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 runs Checkstyle, PMD and Lint. It can be executed with command:
./gradlew check
Reports from analysis are generated in library/build/reports/ directory.
See CHANGELOG.md file.
See RELEASING.md file.
- https://stackoverflow.com/questions/4319212/how-can-one-detect-airplane-mode-on-android
- https://stackoverflow.com/questions/5533881/toggle-airplane-mode-in-android
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.