CronetEngine.Builder

const val HTTP_CACHE_DISABLED = 0: Int

HTTP önbelleğini devre dışı bırakma ayarı. Bazı veriler geçici olarak bellekte saklanmaya devam edebilir. enableHttpCache adlı hesaba aktarıldı.

const val HTTP_CACHE_DISK = 3: Int

HTTP verileri de dahil olmak üzere disk üzerindeki önbelleği etkinleştirmek için ayar. Bu sabit enableHttpCache öğesine aktarılmadan önce setStoragePath çağrılmalıdır.

const val HTTP_CACHE_DISK_NO_HTTP = 2: Int

HTTP verileri hariç, disk üzerindeki önbelleği etkinleştirmek için ayar. Bu sabit enableHttpCache öğesine aktarılmadan önce setStoragePath çağrılmalıdır.

const val HTTP_CACHE_IN_MEMORY = 1: Int

HTTP verileri de dahil olmak üzere bellek içi HTTP önbelleğini etkinleştirmek için ayar. enableHttpCache adlı hesaba aktarıldı.

Builder(context: Context!)

Builder oluşturmayı kolaylaştıran bir CronetEngine nesnesi oluşturur. Varsayılan yapılandırma, HTTP/2 ve QUIC'i etkinleştirir ancak HTTP önbelleğini devre dışı bırakır.

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

Belirli bir ana makine için bir dizi ortak anahtarı sabitler. Bir dizi ortak anahtarı sabitleyerek ( pinsSha256), hostName ile iletişim kurmak için sabitlenmiş anahtarlar grubundan bir ortak anahtar içeren sertifikayla kimlik doğrulaması yapılması gerekir. Bir uygulama, kök sertifikanın, ara sertifikaların veya son giriş sertifikasının ortak anahtarını sabitleyebilir. Ana makine, cihazın güvenilen sertifika deposu tarafından izin verilen bir sertifikayla kimlik doğrulamaya çalışsa bile, genel anahtarlardan hiçbiri ana makinenin sertifika zincirinde bulunmuyorsa kimlik doğrulama başarısız olur ve güvenli iletişim kurulmaz.

Bu yöntemin aynı ana makine adıyla birden çok kez çağrılması, ana makine için daha önce ayarlanmış sabitlemeleri geçersiz kılar.

Ortak anahtar sabitleme hakkında daha fazla bilgiyi RFC 7469'da bulabilirsiniz.

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

host'nın QUIC'i desteklediğine dair ipucu eklendi. Oturumlar arasında 0-RTT bağlantı oluşturma özelliğinden yararlanmak için enableHttpCache (HTTP_CACHE_DISK) gerektiğini unutmayın.

fun build(): CronetEngine!

Bu oluşturucunun yapılandırmasını kullanarak CronetEngine oluşturun.

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

Brotli sıkıştırmanın etkin olup olmadığını belirler. Etkinleştirilirse Brotli, Accept-Encoding istek üstbilgilerinde reklamı yapılır. Varsayılan olarak devre dışıdır.

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

HTTP/2 protokolünün etkinleştirilip etkinleştirilmeyeceğini ayarlar. Varsayılan olarak etkindir.

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

HTTP verilerinin ve QUIC sunucu bilgileri gibi diğer bilgilerin önbelleğe alınmasını etkinleştirir veya devre dışı bırakır.

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

Ağ yığını katmanlarının çeşitli yerlerinde gidiş dönüş süresi (RTT) ve aşağı yönlü işleme hızı ölçümlerini toplayıp raporlayan ağ kalitesi tahmincisini etkinleştirir. Tahmin aracı etkinleştirildikten sonra, RTT ve işleme hızı dinleyicileri addRttListener ve addThroughputListener ile eklenebilir, removeRttListener ve removeThroughputListener ile kaldırılabilir. Tahmin aracı, yalnızca etkinleştirildiğinde bellek ve CPU kullanır.

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

Yerel güven bağlantıları için ortak anahtar sabitleme atlamasını etkinleştirir veya devre dışı bırakır. Uygulamanın sabitlenmiş ana makinelerle iletişim kurmasını engelleyebileceğinden, yerel güven bağlantıları için atlamanın devre dışı bırakılması kesinlikle önerilmez. Örneğin, bir kullanıcı cihaz proxy ayarlarını değiştirip proxy sertifikasını yerel güven bağlantısı listesine ekleyerek tüm trafiği SSL etkin bir proxy üzerinden göndermek isteyebilir. Baypas devre dışı bırakıldığında uygulamanın, sabitlenmiş ana makinelere trafik göndermesi büyük olasılıkla engellenir. Daha fazla bilgi için https://www.chromium.org/Home/chromium-security/security-faq adresindeki "Anahtar sabitleme, yerel proxy'ler ve filtrelerle nasıl etkileşime girer?" bölümüne bakın.

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

QUIC protokolünün etkinleştirilip etkinleştirilmeyeceğini belirler. Varsayılan olarak etkindir. QUIC etkinse uygulama adını ve Cronet sürümünü içeren QUIC kullanıcı aracısı kimliği sunucuya gönderilir.

fun getDefaultUserAgent(): String!

Uygulama adı ve sürümü, sistem derleme sürümü, model ve kimlik ile Cronet sürümünü içeren bir User-Agent dizesi oluşturur.

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

Bağlantı taşıma davranışını yapılandırır. Daha fazla bilgi için ConnectionMigrationOptions ve ConnectionMigrationOptions.Builder'nin ayrı ayrı yöntemleriyle ilgili dokümanlara bakın.

Yalnızca enableQuic etkinleştirilmişse geçerlidir.

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

Ana makine adı aramasının davranışını yapılandırır. Daha fazla bilgi için DnsOptions ve DnsOptions.Builder'nin ayrı ayrı yöntemleriyle ilgili dokümanlara bakın.

Yalnızca enableQuic etkinleştirilmişse geçerlidir.

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

Yerel kitaplığı yüklemek için kullanılacak bir LibraryLoader ayarlar. Ayarlanmazsa kitaplık loadLibrary kullanılarak yüklenir.

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

Proxy davranışını yapılandırır. Bu durum, bağlantı oluşturma, UrlRequest ve BidirectionalStream'ı farklı şekillerde etkiler. Daha fazla ayrıntı için Proxy dokümanlarına bakın.

Bu, kullanıcı, bazı kurumsal profil yapılandırmaları veya (büyük olasılıkla) bazı ağ otomatik yapılandırmaları (ör. Web Proxy Otomatik Bulma Protokolü) tarafından ayarlanan proxy yapılandırmasıyla karıştırılmamalıdır. Bu yapılandırmaya genellikle "sistem" proxy yapılandırması denir. Sistem proxy yapılandırmasına uymak, yerel ve/veya internet bağlantısı elde etmek için genellikle gereklidir. CronetEngine, sistem proxy yapılandırmasını dahili olarak zaten işler.

Bu API aracılığıyla tanımlanan proxy yapılandırmalarına "uygulama" proxy yapılandırması denir. Uygulama ve sistem proxy yapılandırması ayrıdır ve en önemlisi farklıdır. Şu anda uygulama ve sistem proxy yapılandırmaları birbirini dışlar: ProxyOptions belirtildiğinde, varsa sistem proxy yapılandırması geçersiz kılınır. Bu durum, sistem proxy yapılandırmasının bulunduğu bazı senaryolarda bağlantı sorunlarına neden olabilir. Bu gibi senaryolarda, ProxyOptions son bir null yedeklemeyle yapılandırılmadığı sürece kullanıcılar internet erişimi olmadan kalabilir. ProxyOptions belgelerine bakın.

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

QUIC kullanılırken Cronet'in davranışını yapılandırır. Daha fazla bilgi için QuicOptions ve QuicOptions.Builder'nin ayrı ayrı yöntemleriyle ilgili dokümanlara bakın.

Yalnızca enableQuic etkinleştirilmişse geçerlidir.

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

HTTP önbelleği ve çerez depolama alanı için dizini ayarlar. Dizin mevcut olmalıdır.

NOT: Aynı depolama dizinini aynı anda birden fazla CronetEngine ile kullanmayın. Depolama dizinine erişim, birden fazla CronetEngine tarafından eşzamanlı erişimi desteklemez.

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

Cronet'in dahili iş parçacığının iş parçacığı önceliğini ayarlar.

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

Tüm istekler için kullanıcı aracısı üstbilgisini geçersiz kılar. Açıkça ayarlanmış bir User-Agent başlığı (addHeader kullanılarak ayarlanır) bu işlev kullanılarak ayarlanan bir değeri geçersiz kılar.

protected val mParsedExperimentalOptions: JSONObject!

Deneysel seçeneklerin JSON gösterimi.