CronetEngine.Builder

const val HTTP_CACHE_DISABLED = 0: Int

Ustawienie wyłączające pamięć podręczną HTTP. Niektóre dane mogą być nadal tymczasowo przechowywane w pamięci. Przekazano do enableHttpCache.

const val HTTP_CACHE_DISK = 3: Int

Ustawienie włączające pamięć podręczną na dysku, w tym dane HTTP. Funkcję setStoragePath należy wywołać przed przekazaniem tej stałej do funkcji enableHttpCache.

const val HTTP_CACHE_DISK_NO_HTTP = 2: Int

Ustawienie włączające pamięć podręczną na dysku z wyłączeniem danych HTTP. Funkcję setStoragePath należy wywołać przed przekazaniem tej stałej do funkcji enableHttpCache.

const val HTTP_CACHE_IN_MEMORY = 1: Int

Ustawienie umożliwiające włączenie pamięci podręcznej HTTP w pamięci RAM, w tym danych HTTP. Przekazano do enableHttpCache.

Builder(context: Context!)

Tworzy obiekt Builder, który ułatwia tworzenie obiektu CronetEngine. Konfiguracja domyślna włącza protokoły HTTP/2 i QUIC, ale wyłącza pamięć podręczną HTTP.

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

Przypina zestaw kluczy publicznych dla danego hosta. Przypinając zestaw kluczy publicznych pinsSha256, komunikacja z hostName wymaga uwierzytelnienia za pomocą certyfikatu z kluczem publicznym z przypiętego zestawu. Aplikacja może przypiąć klucz publiczny certyfikatu głównego, dowolnego certyfikatu pośredniego lub certyfikatu końcowego. Uwierzytelnianie nie powiedzie się i nie zostanie nawiązana bezpieczna komunikacja, jeśli w łańcuchu certyfikatów hosta nie będzie żadnego klucza publicznego, nawet jeśli host spróbuje uwierzytelnić się za pomocą certyfikatu dozwolonego przez zaufany magazyn certyfikatów urządzenia.

Wywołanie tej metody kilka razy z tą samą nazwą hosta powoduje zastąpienie wcześniej ustawionych przypięć dla tego hosta.

Więcej informacji o przypinaniu klucza publicznego znajdziesz w dokumencie RFC 7469.

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

Dodaje wskazówkę, że host obsługuje QUIC. Pamiętaj, że enableHttpCache (HTTP_CACHE_DISK) jest potrzebne, aby korzystać z nawiązywania połączenia 0-RTT między sesjami.

fun build(): CronetEngine!

Utwórz CronetEngine za pomocą konfiguracji tego narzędzia do tworzenia.

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

Określa, czy kompresja Brotli jest włączona. Jeśli ta opcja jest włączona, Brotli będzie reklamowany w nagłówkach żądań Accept-Encoding. Domyślnie jest wyłączona.

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

Określa, czy protokół HTTP/2 jest włączony. Domyślnie jest włączona.

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

Włącza lub wyłącza buforowanie danych HTTP i innych informacji, takich jak informacje o serwerze QUIC.

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

Włącza narzędzie do szacowania jakości sieci, które zbiera i raportuje pomiary czasu podróży w obie strony (RTT) oraz przepustowości pobierania na różnych warstwach stosu sieciowego. Po włączeniu estymatora można dodawać słuchaczy RTT i przepustowości za pomocą addRttListener i addThroughputListener oraz usuwać ich za pomocą removeRttListener i removeThroughputListener. Estymator korzysta z pamięci i procesora tylko wtedy, gdy jest włączony.

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

Włącza lub wyłącza pomijanie przypinania klucza publicznego w przypadku lokalnych kotwic zaufania. Wyłączenie obejścia w przypadku lokalnych kotwic zaufania jest wysoce odradzane, ponieważ może uniemożliwić aplikacji komunikację z przypiętymi hostami. Użytkownik może na przykład chcieć przesyłać cały ruch przez serwer proxy z włączonym protokołem SSL, zmieniając ustawienia serwera proxy urządzenia i dodając certyfikat serwera proxy do listy lokalnych punktów zaufania. Wyłączenie obejścia najprawdopodobniej uniemożliwi aplikacji wysyłanie ruchu do przypiętych hostów. Więcej informacji znajdziesz w sekcji „How does key pinning interact with local proxies and filters?” (Jak działa przypinanie kluczy w przypadku lokalnych serwerów proxy i filtrów?) na stronie https://www.chromium.org/Home/chromium-security/security-faq.

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

Określa, czy protokół QUIC jest włączony. Domyślnie jest włączona. Jeśli QUIC jest włączony, do serwera jest wysyłany identyfikator agenta użytkownika QUIC zawierający nazwę aplikacji i wersję Croneta.

fun getDefaultUserAgent(): String!

Tworzy ciąg User-Agent zawierający nazwę i wersję aplikacji, wersję kompilacji systemu, model i identyfikator oraz wersję Croneta.

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

Konfiguruje działanie migracji połączenia. Więcej informacji znajdziesz w dokumentacji ConnectionMigrationOptions i poszczególnych metod ConnectionMigrationOptions.Builder.

Ma znaczenie tylko wtedy, gdy włączona jest funkcja enableQuic.

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

Konfiguruje działanie wyszukiwania nazwy hosta. Więcej informacji znajdziesz w dokumentacji DnsOptions i poszczególnych metod DnsOptions.Builder.

Ma znaczenie tylko wtedy, gdy włączona jest funkcja enableQuic.

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

Ustawia LibraryLoader, który będzie używany do ładowania biblioteki natywnej. Jeśli nie zostanie ustawiona, biblioteka zostanie załadowana za pomocą loadLibrary.

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

Konfiguruje działanie serwera proxy. Wpływa to w różny sposób na nawiązywanie połączeń, UrlRequest i BidirectionalStream. Więcej informacji znajdziesz w dokumentacji Proxy.

Nie należy tego mylić z konfiguracją serwera proxy, która została skonfigurowana przez użytkownika, w ramach konfiguracji profilu firmowego lub (najprawdopodobniej) w ramach automatycznej konfiguracji sieci (np. protokołu automatycznego wykrywania serwera proxy). Jest to zwykle nazywane konfiguracją serwera proxy „systemowego”. Jeśli jest obecny, przestrzeganie konfiguracji serwera proxy systemu jest często wymagane do uzyskania łączności lokalnej lub internetowej. CronetEngine wewnętrznie obsługuje już konfigurację serwera proxy systemu.

Konfiguracja serwera proxy zdefiniowana za pomocą tego interfejsu API jest nazywana konfiguracją serwera proxy „aplikacji”. Konfiguracja serwera proxy aplikacji i systemu jest od siebie niezależna i co najważniejsze – różni się. Obecnie konfiguracje serwera proxy aplikacji i systemu wykluczają się wzajemnie: określenie ProxyOptions zastępuje konfigurację serwera proxy systemu, jeśli jest obecna. W niektórych przypadkach, gdy występuje konfiguracja serwera proxy systemu, może to powodować problemy z łącznością. W takich sytuacjach użytkownicy mogą nie mieć dostępu do internetu, chyba że ProxyOptions ma skonfigurowaną ostateczną, null, rezerwę. Zapoznaj się z dokumentacją ProxyOptions.

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

Konfiguruje działanie Croneta podczas korzystania z QUIC. Więcej informacji znajdziesz w dokumentacji QuicOptions i poszczególnych metod QuicOptions.Builder.

Ma znaczenie tylko wtedy, gdy włączona jest funkcja enableQuic.

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

Określa katalog pamięci podręcznej HTTP i przechowywania plików cookie. Katalog musi istnieć.

UWAGA: nie używaj tego samego katalogu pamięci z więcej niż 1  CronetEngine jednocześnie. Dostęp do katalogu pamięci nie obsługuje jednoczesnego dostępu wielu CronetEngine.

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

Ustawia priorytet wątku wewnętrznego Croneta.

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

Zastępuje nagłówek klienta użytkownika we wszystkich żądaniach. Nagłówek User-Agent ustawiony jawnie (za pomocą addHeader) zastąpi wartość ustawioną za pomocą tej funkcji.

protected val mParsedExperimentalOptions: JSONObject!

Reprezentacja JSON opcji eksperymentalnych.