# liangjingkanji/Net

[永久维护] Android 基于协程/OkHttp网络请求工具

Repository: https://github.com/liangjingkanji/Net
Canonical: https://ross.abutalabs.com/products/liangjingkanji-net
Homepage: http://liangjingkanji.github.io/Net/
Language: Kotlin
License: MIT
License Family: permissive
Topics: okhttp
Last push: 2024-12-20T16:27:09+00:00

## Health v2 (maintenance only)
Score: 34/100 (v2, computed 2026-09-02T17:46:02.011165+00:00)
- activity 0, release rhythm 40, longevity 100
- inputs: {"age_days": 2544, "days_push": 621, "days_rel": 640, "gap_med": 0.0, "n_releases_24m": 5}
- flags: none
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 2035, forks 240 (observed 2026-08-28T04:06:07.986823+00:00)

## What it is
Net is a coroutine-based Android networking library built on top of OkHttp, offering a non-intrusive API that supports all OkHttp features while allowing easy OkHttp version upgrades. It provides high-level conveniences such as automatic lifecycle-aware request cancellation, global error handling, pagination, loading dialogs, and customizable response converters.

## Use cases
- make HTTP requests in Android apps with Kotlin coroutines
- handle concurrent or sequential network requests in a single scope
- automatically cancel requests when an Android lifecycle is destroyed
- show loading dialogs and empty-state pages during network calls
- implement pull-to-refresh and automatic pagination loading
- download files or APKs with progress handling
- persist cookies and configure HTTPS quickly
- customize JSON or protocol response converters for typed results

## When to choose
- you are building an Android app in Kotlin and want a coroutine-friendly OkHttp wrapper
- you need built-in lifecycle-aware cancellation and global error handling to reduce crashes
- you want automatic pagination, refresh, loading dialog, and empty-page handling out of the box
- you need to upgrade OkHttp versions freely while keeping a stable high-level API

## When to avoid
- your project is not Android/Kotlin based
- you prefer raw OkHttp or Retrofit with minimal abstraction
- you need a cross-platform (non-Android) networking solution
- you require RxJava-based patterns (only the legacy 1.x branch supports that)

## Facets
- artifact type: library
- maturity: active
- function: http-client, concurrency, error-handling, caching, logging, serialization
- domain: mobile-development, web-development, developer-tools
- platform: jvm
- tags: okhttp-wrapper, coroutines, networking, android-networking, kotlin-coroutines, request-scheduling, lifecycle-aware, pagination, chinese-documentation, android, mobile

## Member repositories
- liangjingkanji/Net (main) score 34

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:06:07.986823+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-30T02:59:21.889746+00:00, confidence not recorded.
  - readme: https://github.com/liangjingkanji/Net (fetched 2026-08-28T04:06:07.986823+00:00, sha 0bbf77f03f00)
  - homepage: http://liangjingkanji.github.io/Net/ (fetched 2026-08-29T10:38:54.755844+00:00, sha 8863ec2e5c28)
- Data as of 2026-08-30T08:39:29.467469+00:00.