Android library listening network events.
min sdk version = 9
It is able to detect ConnectivityStatus when it changes.
public enum ConnectivityStatus {
UNKNOWN("unknown"),
WIFI_CONNECTED("connected to WiFi"),
WIFI_CONNECTED_HAS_INTERNET("connected to WiFi (Internet available)"),
WIFI_CONNECTED_HAS_NO_INTERNET("connected to WiFi (Internet not available)"),
MOBILE_CONNECTED("connected to mobile network"),
OFFLINE("offline");
...
} In addition, it is able to detect situation when strength of the Wifi signal was changed with WifiSignalStrengthChanged event.
Add permissions to AndroidManifest.xml file inside the <manifest> tag.
<uses-permission android:name="android.permission.ACCESS_WIFI_STATE" />
<uses-permission android:name="android.permission.CHANGE_WIFI_STATE" />
<uses-permission android:name="android.permission.CHANGE_NETWORK_STATE" />
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
<uses-permission android:name="android.permission.INTERNET" />In your activity add Bus field from Otto Event Bus library and NetworkEvents field.
private Bus bus;
private NetworkEvents networkEvents;Initialize objects in onCreate(Bundle savedInstanceState) method.
@Override
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
bus = new Bus();
networkEvents = new NetworkEvents(this, bus);
}Register Bus and NetworkEvents in onResume() method and unregister them in onPause() method.
@Override
protected void onResume() {
super.onResume();
bus.register(this);
networkEvents.register();
}
@Override
protected void onPause() {
super.onPause();
bus.unregister(this);
networkEvents.unregister();
}Subscribe for the events
@Subscribe
public void onConnectivityChanged(ConnectivityChanged event) {
// get connectivity status from event.getConnectivityStatus()
// and do whatever you want
}
@Subscribe
public void onWifiSignalStrengthChanged(WifiSignalStrengthChanged event) {
// do whatever you want - e.g. read fresh list of access points
}Look at MainActivity in application located in example directory to see how this library works.
If you want to use this library with Dagger, check example-dagger directory.
You can depend on the library through Maven:
<dependency>
<groupId>com.github.pwittchen</groupId>
<artifactId>networkevents</artifactId>
<version>1.0.3</version>
</dependency>or through Gradle:
dependencies {
compile 'com.github.pwittchen:networkevents:1.0.3'
}Tests are available in network-events-library/src/androidTest/java/ directory.
Copyright 2015 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.