CronetEngine.Builder

public static final int HTTP_CACHE_DISABLED = 0

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

public static final int HTTP_CACHE_DISK = 3

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.

public static final int HTTP_CACHE_DISK_NO_HTTP = 2

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.

public static final int HTTP_CACHE_IN_MEMORY = 1

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

protected JSONObject mParsedExperimentalOptions

Deneysel seçeneklerin JSON gösterimi.

public 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.

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

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.

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

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.

public CronetEngine build()

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

public CronetEngine.Builder enableBrotli(boolean value)

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.

public CronetEngine.Builder enableHttp2(boolean value)

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

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

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

public CronetEngine.Builder enableNetworkQualityEstimator(boolean value)

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.

public CronetEngine.Builder enablePublicKeyPinningBypassForLocalTrustAnchors(boolean value)

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.

public CronetEngine.Builder enableQuic(boolean value)

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.

public String getDefaultUserAgent()

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
public CronetEngine.Builder setConnectionMigrationOptions(
    ConnectionMigrationOptions connectionMigrationOptions
)

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
public CronetEngine.Builder setDnsOptions(DnsOptions dnsOptions)

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.

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

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

public CronetEngine.Builder setProxyOptions(@NonNull ProxyOptions proxyOptions)

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

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.

public CronetEngine.Builder setStoragePath(String value)

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.

public CronetEngine.Builder setThreadPriority(int priority)

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

public CronetEngine.Builder setUserAgent(String userAgent)

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.