CronetEngine.Builder

const val HTTP_CACHE_DISABLED = 0: Int

用于停用 HTTP 缓存的设置。某些数据可能仍会暂时存储在内存中。已传递给 enableHttpCache。

const val HTTP_CACHE_DISK = 3: Int

用于启用磁盘缓存（包括 HTTP 数据）的设置。必须先调用 setStoragePath，然后才能将此常量传递给 enableHttpCache。

const val HTTP_CACHE_DISK_NO_HTTP = 2: Int

用于启用磁盘缓存的设置，不包括 HTTP 数据。必须先调用 setStoragePath，然后才能将此常量传递给 enableHttpCache。

const val HTTP_CACHE_IN_MEMORY = 1: Int

用于启用内存中 HTTP 缓存（包括 HTTP 数据）的设置。已传递给 enableHttpCache。

Builder(context: Context!)

构建一个 Builder 对象，以便于创建 CronetEngine。默认配置会启用 HTTP/2 和 QUIC，但停用 HTTP 缓存。

fun addPublicKeyPins(
    hostName: String!,
    pinsSha256: (Mutable)Set<ByteArray!>!,
    includeSubdomains: Boolean,
    expirationDate: Date!
): CronetEngine.Builder!

为指定主机固定一组公钥。通过固定一组公钥 pinsSha256，与 hostName 的通信需要使用公钥来自固定组的证书进行身份验证。应用可以固定根证书、任何中间证书或最终实体证书的公钥。如果主机证书链中不存在任何公钥，即使主机尝试使用设备的可信证书存储区允许的证书进行身份验证，身份验证也会失败，并且无法建立安全通信。

使用相同的主机名多次调用此方法会替换之前为该主机设置的 pin。

如需详细了解公钥固定，请参阅 RFC 7469。

fun addQuicHint(host: String!, port: Int, alternatePort: Int): CronetEngine.Builder!

添加了 host 支持 QUIC 的提示。请注意，需要 enableHttpCache (HTTP_CACHE_DISK) 才能利用会话之间的 0-RTT 连接建立。

fun build(): CronetEngine!

使用此构建器的配置构建 CronetEngine。

fun enableBrotli(value: Boolean): CronetEngine.Builder!

设置是否启用 Brotli 压缩。如果启用，系统将在 Accept-Encoding 请求标头中宣传 Brotli。默认值为 disabled。

fun enableHttp2(value: Boolean): CronetEngine.Builder!

设置是否启用 HTTP/2 协议。默认值为 enabled。

fun enableHttpCache(cacheMode: Int, maxSize: Long): CronetEngine.Builder!

启用或停用 HTTP 数据和其他信息（例如 QUIC 服务器信息）的缓存。

fun enableNetworkQualityEstimator(value: Boolean): CronetEngine.Builder!

启用网络质量估算器，该估算器会收集并报告网络堆栈各个层级的往返时间 (RTT) 和下游吞吐量测量结果。启用估算器后，可以使用 addRttListener 和 addThroughputListener 添加 RTT 和吞吐量监听器，并使用 removeRttListener 和 removeThroughputListener 移除监听器。估算器仅在启用时使用内存和 CPU。

fun enablePublicKeyPinningBypassForLocalTrustAnchors(value: Boolean): CronetEngine.Builder!

为本地信任锚启用或停用公钥锁定绕过。强烈建议不要停用本地信任锚点的绕过功能，因为这可能会禁止应用与固定的主机进行通信。例如，用户可能希望通过更改设备代理设置并将代理证书添加到本地信任锚点列表中，来通过启用 SSL 的代理发送所有流量。停用绕过功能后，应用很可能无法向固定的主机发送任何流量。如需了解详情，请访问 https://www.chromium.org/Home/chromium-security/security-faq，查看“密钥固定如何与本地代理和过滤器互动？”

fun enableQuic(value: Boolean): CronetEngine.Builder!

设置是否启用 QUIC 协议。默认值为 enabled。如果启用了 QUIC，则包含应用名称和 Cronet 版本的 QUIC User Agent ID 会发送到服务器。

fun getDefaultUserAgent(): String!

构建 User-Agent 字符串，包括应用名称和版本、系统 build 版本、型号和 ID 以及 Cronet 版本。

@ConnectionMigrationOptions.Experimental
fun setConnectionMigrationOptions(
    connectionMigrationOptions: ConnectionMigrationOptions!
): CronetEngine.Builder!

配置连接迁移的行为。如需了解详情，请参阅 ConnectionMigrationOptions 的文档和 ConnectionMigrationOptions.Builder 的各个方法。

仅在 enableQuic 已启用的情况下相关。

@DnsOptions.Experimental
fun setDnsOptions(dnsOptions: DnsOptions!): CronetEngine.Builder!

配置主机名查找的行为。如需了解详情，请参阅 DnsOptions 的文档和 DnsOptions.Builder 的各个方法。

仅在 enableQuic 已启用的情况下相关。

fun setLibraryLoader(loader: CronetEngine.Builder.LibraryLoader!): CronetEngine.Builder!

设置用于加载原生库的 LibraryLoader。如果未设置，系统将使用 loadLibrary 加载库。

fun setProxyOptions(proxyOptions: ProxyOptions): CronetEngine.Builder!

配置代理行为。这会以不同的方式影响连接建立、UrlRequest 和 BidirectionalStream。如需了解详情，请参阅 Proxy 的文档。

请勿将此情况与以下情况混淆：用户设置的代理配置；某些企业资料配置；或（最有可能）某些网络自动配置（例如 Web 代理自动发现协议）。这通常称为“系统”代理配置。如果存在，尊重系统代理配置通常是获得本地和/或互联网连接的必要条件。CronetEngine 已在内部处理系统代理配置。

通过此 API 定义的代理配置称为“应用”代理配置。应用代理配置和系统代理配置是分开的，最重要的是，两者有所不同。目前，应用和系统代理配置是互斥的：如果指定了 ProxyOptions，则会覆盖系统代理配置（如果存在）。在存在系统代理配置的某些情况下，这可能会导致连接问题。在这种情况下，除非 ProxyOptions 已配置为最终的 null 回退，否则用户可能最终无法访问互联网。请参阅 ProxyOptions 文档。

@QuicOptions.Experimental
fun setQuicOptions(quicOptions: QuicOptions!): CronetEngine.Builder!

配置使用 QUIC 时 Cronet 的行为。如需了解详情，请参阅 QuicOptions 的文档和 QuicOptions.Builder 的各个方法。

仅在 enableQuic 已启用的情况下相关。

fun setStoragePath(value: String!): CronetEngine.Builder!

设置 HTTP 缓存和 Cookie 存储的目录。相应目录必须存在。

注意：请勿同时使用多个 CronetEngine 将数据存储到同一存储目录。对存储目录的访问不支持多个 CronetEngine 的并发访问。

fun setThreadPriority(priority: Int): CronetEngine.Builder!

设置 Cronet 内部线程的线程优先级。

fun setUserAgent(userAgent: String!): CronetEngine.Builder!

替换所有请求的 User-Agent 标头。明确设置的 User-Agent 标头（使用 addHeader 设置）会替换使用此函数设置的值。

protected val mParsedExperimentalOptions: JSONObject!

实验性选项的 JSON 表示形式。