check-internet-android

KO | EN

gitlite — search

#python #hacktoberfest #ai #typescript #go #android #docker #macos #awesome #kubernetes #vue #awesome-list #pytorch #open-source

check-internet-android

(★ 20)

🌐 Light library to check or observe the real internet connection in android apps easily

check-internet-android Latest Version Download

Download Latest Version (.zip)

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

<h1 align="center">Check Internet</h1>

<p align="center">
🌐 <b>CheckInternetAndroid</b> is a light library to check or observe internet connection in Android apps easily. It checks the real internet connection by connecting to the Google's DNS server. If call is successful, then the internet is working, else it is not working.
</p>

# Setup

Add the maven library bucket to the `dependencyResolutionManagement.repositories` block in `settings.gradle.kts` file as follows:
```kotlin
dependencyResolutionManagement {
  ...
  repositories {
    ...
    maven("https://jitpack.io")
  }
}
```

Install the library to the project in desired module's `build.gradle.kts` file. Replace `<current_version>` with the actual version:
```kotlin
implementation("com.github.raheemadamboev:check-internet-android:<current_version>")
```

# Implementation

**Check internet connection (callback API):**
```kotlin
CheckInternet(applicationContext).check { connected ->
  if (connected) { 
      // there is internet                
  } else { 
      // there is no internet                  
  }
}
```

**Check internet connection (suspend API):**
```kotlin
viewModelScope.launch {
  val connected = CheckInternet(applicationContext).check()
  if (connected) { 
      // there is internet                
  } else { 
      // there is no internet                  
  }
}
```

**Observe internet status (StateFlow)**
```kotlin

private val internet: CheckInternet by lazy { CheckInternet(applicationContext) }

override fun onResume() {
  super.onResume()
  internet.startObservingConnection()
}

override fun onPause() {
  super.onPause()
  internet.stopObservingConnection()
}

lifecycleScope.launch {
  internet.status.collectLatest { status ->
    when(status) {
      Initial -> {
        // initial state, internet is not being observed, should call startObservingConnection()
      }

Connected -> {
        // there is internet
      }

NotConnected -> {
        // there is no internet
      }
    }
  }
}
```

# Demo

Checked internet connection via wifi and mobile network. <a href="https://github.com/raheemadamboev/check-internet-android/blob/master/extra/app-debug.apk">Download demo</a>

# Projects using this library

**GoTest** 250 000+ downloads in <a href="https://play.google.com/store/apps/details?id=xyz.teamgravity.gotest">Google Play Store</a>

**Buxgalteriya schyotlar rejasi** 50 000+ downloads in <a href="https://play.google.com/store/apps/details?id=xyz.teamgravity.uzbekistanaccountingcode">Google Play Store</a>

**Irregular Verbs**  25 000+ downloads in <a href="https://play.google.com/store/apps/details?id=xyz.teamgravity.irregularverbs">Google Play Store</a>

# License

```xml
Designed and developed by raheemadamboev (Raheem) 2022.

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.
```

check-internet-android

check-internet-android Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

check-internet-android

check-internet-android Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

Download README