如何在 Android 中处理网络？

Question

如何在 Android 中处理网络？

Accepted Answer

Android 应用经常通过网络与 **APIs** 通信。标准方法使用 **Retrofit**（REST 客户端）和 **OkHttp** 等库，配合 coroutines 实现异步，以及 JSON 解析 — 在主线程外干净正确地处理网络调用。

## Retrofit — 标准 REST 客户端

```kotlin
// define the API as an interface; Retrofit implements it
interface ApiService {
  @GET("users/{id}")
  suspend fun getUser(@Path("id") id: Int): User    // suspend → coroutine async

@POST("users")
  suspend fun createUser(@Body user: User): User
}

// build Retrofit and use it
val api = Retrofit.Builder()
  .baseUrl("https://api.example.com/")
  .addConverterFactory(GsonConverterFactory.create())   // JSON parsing
  .build()
  .create(ApiService::class.java)

// call it from a coroutine (off the main thread)
viewModelScope.launch {
  val user = api.getUser(42)      // async, clean, returns a parsed User object
}
```

Retrofit 将 REST API 转换为简洁的 Kotlin 接口；使用 coroutines 时，调用是异步的且看起来是顺序的；converter 处理 JSON↔对象的解析。

## 关键概念和最佳实践

```text
✓ Run network calls OFF the main thread (coroutines + Dispatchers.IO) — never block UI
✓ OkHttp (under Retrofit) → interceptors (auth headers, logging), timeouts, caching
✓ JSON parsing → Gson / Moshi / kotlinx.serialization (response ↔ data classes)
✓ HANDLE ERRORS — network failures, non-2xx responses, timeouts → graceful UI feedback
✓ Repository pattern → abstract networking behind a clean interface (testable, organized)
✓ Show loading/error/success STATES (with ViewModel + observable state)
✓ INTERNET permission in the manifest
```

## 为什么这很重要

理解 Android 中的网络处理至关重要，因为**大多数应用都与后端通信** — 通过网络获取和发送数据是普遍需求，因此这是必须了解的实用知识。

应用持续进行 API 调用（加载数据、提交表单、身份验证），Android 有标准成熟的方法。**Retrofit**（标准 REST 客户端）是核心：它将 REST API 转换为简洁的 Kotlin **接口**，结合 **coroutines**（使调用异步且看起来顺序化）和 **converter**（处理 JSON 到对象的解析），提供了一种干净高效的网络调用方式 — 理解它对现代 Android 网络处理至关重要。

理解**关键概念和最佳实践**很重要：在**主线程外**运行网络调用（通过 coroutines 和 Dispatchers.IO，永远不要阻塞 UI — 这是基本要求，因为阻塞会导致 ANR）、使用 **OkHttp** 功能（用于身份验证头和日志的拦截器、超时、缓存）、**JSON 解析**为数据类（通过 Gson、Moshi 或 kotlinx.serialization）、**优雅处理错误**（网络故障、非 2xx 响应、超时 — 提供 UI 反馈，因为网络调用经常失败）、使用**仓库模式**（在简洁可测试的接口后面抽象网络处理）、显示**加载/错误/成功状态**，以及声明 **internet 权限**。

这些体现了构建健壮、架构良好的网络处理，而不是脆弱的临时方案。

由于大多数 Android 应用与 API 通信（普遍需求），且正确执行它（Retrofit + coroutines、在主线程外、具有适当的 JSON 解析、错误处理和架构）对于功能强大、健壮的应用至关重要，并且理解标准工具和实践对此核心能力是必要的，因此理解 Android 中的网络处理是必须掌握、频繁应用的实用知识 — 这是几乎每个与后端通信的真实 Android 应用都需要的基础技能，是构建能够可靠地获取和显示真实数据的应用的核心。