CronetEngine.Builder

const val HTTP_CACHE_DISABLED = 0: Int

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

const val HTTP_CACHE_DISK = 3: Int

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

const val HTTP_CACHE_DISK_NO_HTTP = 2: Int

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

const val HTTP_CACHE_IN_MEMORY = 1: Int

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

Builder(context: Context!)

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

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

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.

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

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

fun build(): CronetEngine!

Membangun CronetEngine menggunakan konfigurasi builder ini.

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

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

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

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

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

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

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

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.

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

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

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

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.

fun getDefaultUserAgent(): String!

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

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

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

Hanya relevan jika enableQuic diaktifkan.

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

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

Hanya relevan jika enableQuic diaktifkan.

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

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

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

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
fun setQuicOptions(quicOptions: QuicOptions!): CronetEngine.Builder!

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

Hanya relevan jika enableQuic diaktifkan.

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

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.

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

Menetapkan prioritas thread dari thread internal Cronet.

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

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.

protected val mParsedExperimentalOptions: JSONObject!

Representasi JSON dari opsi eksperimental.