Net/docs/config.md

全局配置应在Application.onCreate中配置

初始配置

两种方式初始配置, 不初始化也能直接使用

=== "Net初始化"

```kotlin
NetConfig.initialize(Api.HOST, this) {
    // 超时配置, 默认是10秒, 设置太长时间会导致用户等待过久
    connectTimeout(30, TimeUnit.SECONDS)
    readTimeout(30, TimeUnit.SECONDS)
    writeTimeout(30, TimeUnit.SECONDS)
    setDebug(BuildConfig.DEBUG)
    setConverter(SerializationConverter())
}
```

=== "OkHttp构造器初始化"

```kotlin
val okHttpClientBuilder = OkHttpClient.Builder()
    .setDebug(BuildConfig.DEBUG)
    .setConverter(SerializationConverter())
    .addInterceptor(LogRecordInterceptor(BuildConfig.DEBUG))
NetConfig.initialize(Api.HOST, this, okHttpClientBuilder)
```

如果请求指定Path会和上面Api.HOST组成Url后发起请求

!!! failure "强制初始化"

如果是多进程项目(例如Xposed)必须初始化, 因为多进程无法自动指定Context

| 可配置选项 | 描述 | |-|-| | setDebug | 开启日志 | | setSSLCertificate | 配置Https证书 | | trustSSLCertificate | 信任所有Https证书 | | setConverter | 转换器, 将请求结果转为任何类型 | | setRequestInterceptor | 请求拦截器, 全局请求头/请求参数 | | setErrorHandler | 全局错误处理 | | setDialogFactory | 全局对话框 |

!!! success "修改配置"

NetConfig存储所有全局配置变量, 可以后续修改, 且大部分支持单例指定配置

重试次数

可以添加RetryInterceptor拦截器即可实现失败以后会重试指定次数

默认情况下设置超时时间即可, OkHttp内部也有重试机制

NetConfig.initialize(Api.HOST, this) {
    // ... 其他配置
    addInterceptor(RetryInterceptor(3)) // 如果全部失败会重试三次
}

!!! warning "长时间阻碍用户交互"

 OkHttp内部也有重试机制, 如果还添加重试拦截器可能导致请求时间过长, 长时间阻碍用户交互

多域名

Net可随时变更请求域名, 以下介绍三种方式

=== "修改Host"

```kotlin
NetConfig.host = Api.HOST_VIDEO
```

=== "指定全路径"

建议使用单例类管理请求Url
```kotlin
object Api {
    const val HOST_IMG = "http://127.0.0.1"
    const val BANNER = "$HOST_IMG/banner"
    const val HOME = "/home"
}
scopeNetLife {
    val banner = Get<BannerModel>(Api.BANNER).await()
    val home = Get<HomeModel>(Api.HOME).await()
}
```

=== "使用拦截器"

请求指定`tag`, 拦截器中根据tag修改Url, 建议tag为包含域名的枚举或单例
```kotlin
scopeNetLife {
    val data = Get<String>(Api.PATH, GAME).await() // User即为tag
}
// 拦截器如何修改请搜索
```

网络安全配置

Net自动启用网络配置文件, 默认支持Http请求, 可自定义

<network-security-config>
    <base-config cleartextTrafficPermitted="true" />
</network-security-config>

!!! failure "无法打包Apk"

当开发者自定义使用非同名`network_security_config`时网络配置文件时会无法打包Apk

请添加`tools:replace`
```kotlin title="AndroidManifest.xml" hl_lines="3"
<application
    tools:replace="android:networkSecurityConfig">
```