CronetEngine.Builder

public static final int HTTP_CACHE_DISABLED = 0

הגדרה להשבתת מטמון HTTP. יכול להיות שחלק מהנתונים עדיין יישמרו באופן זמני בזיכרון. הועבר אל enableHttpCache.

public static final int HTTP_CACHE_DISK = 3

הגדרה להפעלת מטמון בדיסק, כולל נתוני HTTP. צריך להפעיל את setStoragePath לפני שמעבירים את הקבוע הזה אל enableHttpCache.

public static final int HTTP_CACHE_DISK_NO_HTTP = 2

הגדרה להפעלת מטמון בדיסק, לא כולל נתוני HTTP. צריך להפעיל את setStoragePath לפני שמעבירים את הקבוע הזה אל enableHttpCache.

public static final int HTTP_CACHE_IN_MEMORY = 1

הגדרה להפעלת מטמון HTTP בזיכרון, כולל נתוני HTTP. הועבר אל enableHttpCache.

protected JSONObject mParsedExperimentalOptions

ייצוג ב-JSON של האפשרויות הניסיוניות.

public Builder(Context context)

בונה אובייקט Builder שמקל על יצירת CronetEngine. בהגדרות האישיות שקובעים כברירת מחדל, פרוטוקולים HTTP/2 ו-QUIC מופעלים, אבל מטמון ה-HTTP מושבת.

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

הצמדה של קבוצת מפתחות ציבוריים למארח נתון. כשמצמידים קבוצה של מפתחות ציבוריים, pinsSha256, נדרש תקשורת עם hostName כדי לבצע אימות באמצעות אישור עם מפתח ציבורי מתוך קבוצת המפתחות המוצמדים. אפליקציה יכולה להצמיד את המפתח הציבורי של אישור הבסיס, של כל אחד מאישורי הביניים או של אישור הרשומה הסופית. האימות ייכשל ולא יתבצע חיבור מאובטח אם אף אחד מהמפתחות הציבוריים לא נמצא בשרשרת האישורים של המארח, גם אם המארח מנסה לבצע אימות באמצעות אישור שמותר על ידי מאגר האישורים המהימנים של המכשיר.

אם מפעילים את ה-method הזו כמה פעמים עם אותו שם מארח, ההצמדות שהוגדרו קודם למארח מוחלפות.

מידע נוסף על הצמדת מפתח ציבורי זמין ב-RFC 7469.

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

הוספנו רמז לכך ש-host תומך ב-QUIC. שימו לב: צריך להשתמש ב-enableHttpCache (HTTP_CACHE_DISK) כדי ליהנות מיתרון ההתחברות בין סשנים ללא זמן הקמה (0-RTT).

public CronetEngine build()

בניית CronetEngine באמצעות ההגדרה של ה-builder הזה.

public CronetEngine.Builder enableBrotli(boolean value)

קובעת אם הדחיסה Brotli מופעלת. אם ההגדרה הזו מופעלת, המערכת תפרסם את Brotli בכותרות הבקשה Accept-Encoding. ברירת המחדל היא השבתה.

public CronetEngine.Builder enableHttp2(boolean value)

ההגדרה הזו קובעת אם הפרוטוקול HTTP/2 מופעל. ברירת המחדל היא enabled.

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

הפעלה או השבתה של שמירת נתונים במטמון של HTTP ומידע אחר, כמו פרטי שרת QUIC.

public CronetEngine.Builder enableNetworkQualityEstimator(boolean value)

ההגדרה הזו מפעילה את כלי ההערכה של איכות הרשת, שאוסף ומדווח על מדידות של זמן הלוך ושוב (RTT) ושל קצב העברת הנתונים במורד הזרם בשכבות שונות של מחסנית הרשת. אחרי שמפעילים את כלי ההערכה, אפשר להוסיף מאזינים של RTT ושל קצב העברת נתונים באמצעות addRttListener ו-addThroughputListener, ולהסיר אותם באמצעות removeRttListener ו-removeThroughputListener. הכלי להערכת נפח הזיכרון והמעבד משתמש בזיכרון ובמעבד רק כשהוא מופעל.

public CronetEngine.Builder enablePublicKeyPinningBypassForLocalTrustAnchors(boolean value)

ההגדרה הזו מפעילה או משביתה את העקיפה של הצמדת מפתחות ציבוריים לישויות עוגן אמינות מקומיות. לא מומלץ להשבית את העקיפה של ישויות עוגן אמינות מקומיות, כי היא עלולה למנוע מהאפליקציה לתקשר עם המארחים המוצמדים. לדוגמה, משתמש יכול לשלוח את כלל התנועה דרך שרת proxy עם SSL על ידי שינוי הגדרות לשרת proxy במכשיר והוספת אישור ה-proxy לרשימת ישויות עוגן אמינות מקומיות. אם משביתים את העקיפה, סביר להניח שהאפליקציה לא תוכל לשלוח תעבורה למארחים המוצמדים. מידע נוסף זמין במאמר 'איך הצמדת מפתחות פועלת עם פרוקסי ומסננים מקומיים?' בכתובת https://www.chromium.org/Home/chromium-security/security-faq

public CronetEngine.Builder enableQuic(boolean value)

המדיניות הזו קובעת אם פרוטוקול QUIC מופעל. ברירת המחדל היא enabled. אם QUIC מופעל, מזהה סוכן המשתמש של QUIC שמכיל את שם האפליקציה ואת גרסת Cronet נשלח לשרת.

public String getDefaultUserAgent()

יוצר מחרוזת User-Agent שכוללת את שם האפליקציה והגרסה שלה, את גרסת ה-build של המערכת, את המודל והמזהה ואת גרסת Cronet.

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

הגדרת אופן הפעולה של העברת חיבורים. פרטים נוספים זמינים במסמכי התיעוד של ConnectionMigrationOptions ובמאמרים על השיטות השונות של ConnectionMigrationOptions.Builder.

ההגדרה רלוונטית רק אם האפשרות enableQuic מופעלת.

@DnsOptions.Experimental
public CronetEngine.Builder setDnsOptions(DnsOptions dnsOptions)

ההגדרה קובעת את אופן הפעולה של חיפוש שם המארח. פרטים נוספים זמינים במסמכי התיעוד של DnsOptions ובמאמרים על השיטות השונות של DnsOptions.Builder.

ההגדרה רלוונטית רק אם האפשרות enableQuic מופעלת.

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

מגדירה LibraryLoader שישמש לטעינת ספריית Native. אם לא מגדירים את המדיניות, הספרייה תיטען באמצעות loadLibrary.

public CronetEngine.Builder setProxyOptions(@NonNull ProxyOptions proxyOptions)

ההגדרה קובעת את התנהגות ה-proxy. ההגדרה הזו משפיעה בדרכים שונות על הקמת חיבורים, על UrlRequest ועל BidirectionalStream. פרטים נוספים מופיעים במסמכי התיעוד של Proxy.

לא להתבלבל עם הגדרות proxy שהוגדרו על ידי: המשתמש, הגדרות פרופיל ארגוניות או (ברוב המקרים) הגדרות רשת אוטומטיות (למשל, Web Proxy Auto-Discovery Protocol). ההגדרה הזו נקראת בדרך כלל הגדרת proxy של המערכת. אם הוא קיים, בדרך כלל נדרש לכבד את הגדרת ה-proxy של המערכת כדי לקבל קישוריות מקומית ו/או קישוריות לאינטרנט. ‫CronetEngine כבר מטפל בהגדרת שרת ה-proxy של המערכת באופן פנימי.

הגדרות proxy שמוגדרות באמצעות ה-API הזה נקראות הגדרות proxy של האפליקציה. ההגדרות של שרת ה-Proxy באפליקציה ושל שרת ה-Proxy במערכת הן נפרדות, והכי חשוב, הן שונות. נכון לעכשיו, הגדרות ה-Proxy של האפליקציה והמערכת הן בלעדיות: אם מציינים את ProxyOptions, הוא מבטל את הגדרת ה-Proxy של המערכת, אם היא קיימת. זה עלול לגרום לבעיות בקישוריות בתרחישים מסוימים שבהם קיימת הגדרת proxy של המערכת. בתרחישים כאלה, יכול להיות שלמשתמשים לא תהיה גישה לאינטרנט, אלא אם ProxyOptions הוגדר עם גיבוי סופי, null. אפשר לעיין בProxyOptionsמאמרי העזרה.

@QuicOptions.Experimental
public CronetEngine.Builder setQuicOptions(QuicOptions quicOptions)

הגדרה של אופן הפעולה של Cronet כשמשתמשים ב-QUIC. פרטים נוספים זמינים במסמכי התיעוד של QuicOptions ובמאמרים על השיטות השונות של QuicOptions.Builder.

ההגדרה רלוונטית רק אם האפשרות enableQuic מופעלת.

public CronetEngine.Builder setStoragePath(String value)

מגדירה את הספרייה לאחסון מטמון HTTP וקובצי Cookie. הספרייה חייבת להתקיים.

הערה: אל תשתמשו באותה תיקיית אחסון עם יותר מ- CronetEngine אחד בכל פעם. הגישה לספריית האחסון לא תומכת בגישה בו-זמנית של כמה CronetEngine.

public CronetEngine.Builder setThreadPriority(int priority)

ההגדרה קובעת את העדיפות של השרשור הפנימי של Cronet.

public CronetEngine.Builder setUserAgent(String userAgent)

מחליף את כותרת סוכן המשתמש לכל הבקשות. כותרת User-Agent שהוגדרה באופן מפורש (הוגדרה באמצעות addHeader) תבטל ערך שהוגדר באמצעות הפונקציה הזו.