CronetEngine.Builder

public static final int HTTP_CACHE_DISABLED = 0

Setelan untuk menonaktifkan cache HTTP. Beberapa data mungkin masih disimpan sementara dalam memori. Diteruskan ke enableHttpCache.

public static final int HTTP_CACHE_DISK = 3

Setelan untuk mengaktifkan cache di disk, termasuk data HTTP. setStoragePath harus dipanggil sebelum meneruskan konstanta ini ke enableHttpCache.

public static final int HTTP_CACHE_DISK_NO_HTTP = 2

Setelan untuk mengaktifkan cache di disk, tidak termasuk data HTTP. setStoragePath harus dipanggil sebelum meneruskan konstanta ini ke enableHttpCache.

public static final int HTTP_CACHE_IN_MEMORY = 1

Setelan untuk mengaktifkan cache HTTP dalam memori, termasuk data HTTP. Diteruskan ke enableHttpCache.

protected JSONObject mParsedExperimentalOptions

Representasi JSON dari opsi eksperimental.

public Builder(Context context)

Membangun objek Builder yang memfasilitasi pembuatan CronetEngine. Konfigurasi default mengaktifkan HTTP/2 dan QUIC, tetapi menonaktifkan cache HTTP.

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

Menyematkan serangkaian kunci publik untuk host tertentu. Dengan menyematkan sekumpulan kunci publik, pinsSha256, komunikasi dengan hostName diperlukan untuk melakukan autentikasi dengan sertifikat yang memiliki kunci publik dari kumpulan yang disematkan. Aplikasi dapat menyematkan kunci publik sertifikat root, salah satu sertifikat perantara, atau sertifikat entri akhir. Autentikasi akan gagal dan komunikasi yang aman tidak akan dilakukan jika tidak ada kunci publik dalam rantai sertifikat host, meskipun host mencoba melakukan autentikasi dengan sertifikat yang diizinkan oleh penyimpanan sertifikat tepercaya perangkat.

Memanggil metode ini beberapa kali dengan nama host yang sama akan menggantikan pin yang ditetapkan sebelumnya untuk host.

Informasi selengkapnya tentang penyematan kunci publik dapat ditemukan di RFC 7469.

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

Menambahkan petunjuk bahwa host mendukung QUIC. Perhatikan bahwa enableHttpCache (HTTP_CACHE_DISK) diperlukan untuk memanfaatkan pembentukan koneksi 0-RTT antar-sesi.

public CronetEngine build()

Membangun CronetEngine menggunakan konfigurasi builder ini.

public CronetEngine.Builder enableBrotli(boolean value)

Menetapkan apakah kompresi Brotli diaktifkan. Jika diaktifkan, Brotli akan diiklankan di header permintaan Accept-Encoding. Nilai defaultnya adalah dinonaktifkan.

public CronetEngine.Builder enableHttp2(boolean value)

Menetapkan apakah protokol HTTP/2 diaktifkan. Diaktifkan secara default.

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

Mengaktifkan atau menonaktifkan penyimpanan dalam cache data HTTP dan informasi lain seperti informasi server QUIC.

public CronetEngine.Builder enableNetworkQualityEstimator(boolean value)

Mengaktifkan estimator kualitas jaringan, yang mengumpulkan dan melaporkan pengukuran waktu perjalanan pulang pergi (RTT) dan throughput downstream di berbagai lapisan stack jaringan. Setelah mengaktifkan estimator, pemroses RTT dan throughput dapat ditambahkan dengan addRttListener dan addThroughputListener serta dihapus dengan removeRttListener dan removeThroughputListener. Estimator menggunakan memori dan CPU hanya saat diaktifkan.

public CronetEngine.Builder enablePublicKeyPinningBypassForLocalTrustAnchors(boolean value)

Mengaktifkan atau menonaktifkan pengabaian penyematan kunci publik untuk trust anchor lokal. Sangat tidak disarankan untuk menonaktifkan bypass untuk trust anchor lokal karena dapat melarang aplikasi berkomunikasi dengan host yang disematkan. Misalnya, pengguna mungkin ingin mengirim semua traffic melalui proxy yang mendukung SSL dengan mengubah setelan proxy perangkat dan menambahkan sertifikat proxy ke daftar anchor tepercaya lokal. Menonaktifkan bypass kemungkinan besar akan mencegah aplikasi mengirimkan traffic apa pun ke host yang disematkan. Untuk mengetahui informasi selengkapnya, lihat 'How does key pinning interact with local proxies and filters?' di https://www.chromium.org/Home/chromium-security/security-faq

public CronetEngine.Builder enableQuic(boolean value)

Menetapkan apakah protokol QUIC diaktifkan. Diaktifkan secara default. Jika QUIC diaktifkan, maka ID Agen Pengguna QUIC yang berisi nama aplikasi dan versi Cronet akan dikirim ke server.

public String getDefaultUserAgent()

Membangun string User-Agent yang mencakup nama dan versi aplikasi, versi build sistem, model dan ID, serta versi Cronet.

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

Mengonfigurasi perilaku migrasi koneksi. Untuk mengetahui detail selengkapnya, lihat dokumentasi ConnectionMigrationOptions dan masing-masing metode ConnectionMigrationOptions.Builder.

Hanya relevan jika enableQuic diaktifkan.

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

Mengonfigurasi perilaku pencarian nama host. Untuk mengetahui detail selengkapnya, lihat dokumentasi DnsOptions dan masing-masing metode DnsOptions.Builder.

Hanya relevan jika enableQuic diaktifkan.

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

Menetapkan LibraryLoader yang akan digunakan untuk memuat library native. Jika tidak disetel, library akan dimuat menggunakan loadLibrary.

public CronetEngine.Builder setProxyOptions(@NonNull ProxyOptions proxyOptions)

Mengonfigurasi perilaku proxy. Hal ini memengaruhi, dengan cara yang berbeda: pembentukan koneksi, UrlRequest, dan BidirectionalStream. Untuk mengetahui detail selengkapnya, lihat dokumentasi Proxy.

Hal ini tidak boleh disamakan dengan konfigurasi proxy yang telah disiapkan oleh: pengguna; atau beberapa konfigurasi profil perusahaan, atau (kemungkinan besar) beberapa konfigurasi otomatis jaringan (misalnya, Web Proxy Auto-Discovery Protocol). Hal ini biasanya disebut sebagai konfigurasi proxy "sistem". Jika ada, mematuhi konfigurasi proxy sistem sering kali menjadi persyaratan untuk mendapatkan konektivitas lokal dan/atau internet. CronetEngine sudah menangani konfigurasi proxy sistem secara internal.

Konfigurasi proxy yang ditentukan melalui API ini disebut sebagai konfigurasi proxy "aplikasi". Konfigurasi proxy aplikasi dan sistem terpisah dan, yang paling penting, berbeda. Saat ini, konfigurasi proxy aplikasi dan sistem bersifat eksklusif: menentukan ProxyOptions akan menggantikan konfigurasi proxy sistem, jika ada. Hal ini dapat menyebabkan masalah konektivitas dalam beberapa skenario saat konfigurasi proxy sistem ada. Dalam skenario seperti itu, pengguna mungkin tidak memiliki akses internet, kecuali jika ProxyOptions telah dikonfigurasi dengan penggantian null akhir. Lihat dokumentasi ProxyOptions.

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

Mengonfigurasi perilaku Cronet saat menggunakan QUIC. Untuk mengetahui detail selengkapnya, lihat dokumentasi QuicOptions dan masing-masing metode QuicOptions.Builder.

Hanya relevan jika enableQuic diaktifkan.

public CronetEngine.Builder setStoragePath(String value)

Menetapkan direktori untuk Penyimpanan Cookie dan Cache HTTP. Direktori harus ada.

CATATAN: Jangan gunakan direktori penyimpanan yang sama dengan lebih dari satu CronetEngine sekaligus. Akses ke direktori penyimpanan tidak mendukung akses serentak oleh beberapa CronetEngine.

public CronetEngine.Builder setThreadPriority(int priority)

Menetapkan prioritas thread dari thread internal Cronet.

public CronetEngine.Builder setUserAgent(String userAgent)

Mengganti header Agen Pengguna untuk semua permintaan. Header Agen Pengguna yang ditetapkan secara eksplisit (ditetapkan menggunakan addHeader) akan menggantikan nilai yang ditetapkan menggunakan fungsi ini.