CronetEngine.Builder

public static final int HTTP_CACHE_DISABLED = 0

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

public static final int HTTP_CACHE_DISK = 3

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.

public static final int HTTP_CACHE_DISK_NO_HTTP = 2

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.

public static final int HTTP_CACHE_IN_MEMORY = 1

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

protected JSONObject mParsedExperimentalOptions

Reprezentacja JSON opcji eksperymentalnych.

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

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

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.

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

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.

public CronetEngine build()

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

public CronetEngine.Builder enableBrotli(boolean value)

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.

public CronetEngine.Builder enableHttp2(boolean value)

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

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

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

public CronetEngine.Builder enableNetworkQualityEstimator(boolean value)

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.

public CronetEngine.Builder enablePublicKeyPinningBypassForLocalTrustAnchors(boolean value)

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.

public CronetEngine.Builder enableQuic(boolean value)

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.

public String getDefaultUserAgent()

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

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

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

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.

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

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

public CronetEngine.Builder setProxyOptions(@NonNull ProxyOptions proxyOptions)

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

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.

public CronetEngine.Builder setStoragePath(String value)

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.

public CronetEngine.Builder setThreadPriority(int priority)

Ustawia priorytet wątku wewnętrznego Croneta.

public CronetEngine.Builder setUserAgent(String userAgent)

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.