CronetEngine.Builder

public static final int HTTP_CACHE_DISABLED = 0

設定為停用 HTTP 快取。部分資料可能仍會暫時儲存在記憶體中。已轉交給「enableHttpCache」。

public static final int HTTP_CACHE_DISK = 3

設定啟用磁碟快取，包括 HTTP 資料。將這個常數傳遞至 enableHttpCache 之前，必須先呼叫 setStoragePath。

public static final int HTTP_CACHE_DISK_NO_HTTP = 2

設定為啟用磁碟快取，但不包括 HTTP 資料。將這個常數傳遞至 enableHttpCache 之前，必須先呼叫 setStoragePath。

public static final int HTTP_CACHE_IN_MEMORY = 1

設定啟用記憶體內 HTTP 快取，包括 HTTP 資料。已轉交給「enableHttpCache」。

protected JSONObject mParsedExperimentalOptions

實驗性選項的 JSON 表示法。

public Builder(Context context)

建構 Builder 物件，方便建立 CronetEngine。預設設定會啟用 HTTP/2 和 QUIC，但停用 HTTP 快取。

public CronetEngine.Builder addPublicKeyPins(
    String hostName,
    Set<byte[]> pinsSha256,
    boolean includeSubdomains,
    Date expirationDate
)

為特定主機釘選一組公開金鑰。綁定一組公開金鑰 ( pinsSha256) 後，與 hostName 通訊時，必須使用公開金鑰來自綁定憑證組的憑證進行驗證。應用程式可以固定根憑證、任何中繼憑證或尾端項目憑證的公開金鑰。即使主機嘗試使用裝置信任憑證存放區允許的憑證進行驗證，如果主機的憑證鏈結中沒有任何公開金鑰，驗證就會失敗，且無法建立安全通訊。

如果使用相同主機名稱多次呼叫這個方法，系統會覆寫先前為該主機設定的固定項目。

如要進一步瞭解公開金鑰固定，請參閱 RFC 7469。

public CronetEngine.Builder addQuicHint(String host, int port, int alternatePort)

新增 host 支援 QUIC 的提示。請注意，如要利用工作階段間的 0-RTT 連線建立功能，必須使用 enableHttpCache (HTTP_CACHE_DISK)。

public CronetEngine build()

使用這個建構工具的設定建構 CronetEngine。

public CronetEngine.Builder enableBrotli(boolean value)

設定是否啟用 Brotli 壓縮功能。如果啟用，系統會在 Accept-Encoding 要求標頭中宣傳 Brotli。預設為停用。

public CronetEngine.Builder enableHttp2(boolean value)

設定是否啟用 HTTP/2 通訊協定。預設為啟用。

public CronetEngine.Builder enableHttpCache(int cacheMode, long maxSize)

啟用或停用 HTTP 資料和其他資訊 (例如 QUIC 伺服器資訊) 的快取。

public CronetEngine.Builder enableNetworkQualityEstimator(boolean value)

啟用網路品質估算器，收集並回報網路堆疊各層的封包往返時間 (RTT) 和下游輸送量測量結果。啟用估算器後，即可使用 addRttListener 和 addThroughputListener 新增 RTT 和處理量監聽器，並使用 removeRttListener 和 removeThroughputListener 移除監聽器。只有在啟用估算器時，估算器才會使用記憶體和 CPU。

public CronetEngine.Builder enablePublicKeyPinningBypassForLocalTrustAnchors(boolean value)

啟用或停用本機信任錨點的公開金鑰固定繞過功能。強烈建議不要停用本機信任錨點的繞過功能，因為這可能會禁止應用程式與已釘選的主機通訊。舉例來說，使用者可能想變更裝置 Proxy 設定，並將 Proxy 憑證新增至本機信任錨點清單，藉此透過啟用 SSL 的 Proxy 傳送所有流量。停用繞過功能後，應用程式很可能無法將任何流量傳送至已釘選的主機。詳情請參閱 https://www.chromium.org/Home/chromium-security/security-faq 的「How does key pinning interact with local proxies and filters?」一節

public CronetEngine.Builder enableQuic(boolean value)

設定是否啟用 QUIC 通訊協定。預設為啟用。如果啟用 QUIC，系統會將包含應用程式名稱和 Cronet 版本的 QUIC User Agent Id 傳送至伺服器。

public String getDefaultUserAgent()

建構 User-Agent 字串，包括應用程式名稱和版本、系統建構版本、型號和 ID，以及 Cronet 版本。

@ConnectionMigrationOptions.Experimental
public CronetEngine.Builder setConnectionMigrationOptions(
    ConnectionMigrationOptions connectionMigrationOptions
)

設定連線遷移作業的行為。詳情請參閱 ConnectionMigrationOptions 和 ConnectionMigrationOptions.Builder 個別方法的說明文件。

只有在啟用 enableQuic 時才適用。

@DnsOptions.Experimental
public CronetEngine.Builder setDnsOptions(DnsOptions dnsOptions)

設定主機名稱查詢的行為。詳情請參閱 DnsOptions 和 DnsOptions.Builder 個別方法的說明文件。

只有在啟用 enableQuic 時才適用。

public CronetEngine.Builder setLibraryLoader(CronetEngine.Builder.LibraryLoader loader)

設定用於載入原生程式庫的 LibraryLoader。如未設定，系統會使用 loadLibrary 載入程式庫。

public CronetEngine.Builder setProxyOptions(@NonNull ProxyOptions proxyOptions)

設定 Proxy 行為。這會以不同方式影響連線建立、UrlRequest 和 BidirectionalStream。詳情請參閱 Proxy 的說明文件。

請勿將此與使用者、某些企業設定檔設定，或 (最有可能) 某些網路自動設定 (例如 Web Proxy Auto-Discovery Protocol) 所設定的 Proxy 設定混淆。這通常稱為「系統」Proxy 設定。如果有的話，通常必須遵守系統 Proxy 設定，才能取得本機和/或網際網路連線。CronetEngine 會在內部處理系統 Proxy 設定。

透過這個 API 定義的 Proxy 設定稱為「應用程式」Proxy 設定。應用程式和系統的 Proxy 設定是分開的，而且最重要的是，兩者不同。目前應用程式和系統 Proxy 設定互斥：指定 ProxyOptions 會覆寫系統 Proxy 設定 (如有)。在某些情況下，如果系統有 Proxy 設定，這可能會導致連線問題。在這種情況下，除非 ProxyOptions 已設定最終的null備援，否則使用者可能無法存取網際網路。請參閱ProxyOptions說明文件。

@QuicOptions.Experimental
public CronetEngine.Builder setQuicOptions(QuicOptions quicOptions)

設定使用 QUIC 時的 Cronet 行為。詳情請參閱 QuicOptions 和 QuicOptions.Builder 個別方法的說明文件。

只有在啟用 enableQuic 時才適用。

public CronetEngine.Builder setStoragePath(String value)

設定 HTTP 快取和 Cookie 儲存空間的目錄。目錄必須存在。

注意：請勿同時使用多個 CronetEngine 的相同儲存目錄。儲存空間目錄的存取權不支援多個 CronetEngine 同時存取。

public CronetEngine.Builder setThreadPriority(int priority)

設定 Cronet 內部執行緒的執行緒優先順序。

public CronetEngine.Builder setUserAgent(String userAgent)

覆寫所有要求的使用者代理程式標頭。明確設定的 User-Agent 標頭 (使用 addHeader 設定) 會覆寫使用這個函式設定的值。