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 מופעל. ברירת המחדל היא מופעל.

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

public CronetEngine.Builder enableQuic(boolean value)

ההגדרה קובעת אם פרוטוקול QUIC מופעל. ברירת המחדל היא מופעל. אם 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 של המערכת. אם יש פרוקסי, לעיתים קרובות נדרש לכבד את הגדרת הפרוקסי של המערכת כדי לקבל קישוריות מקומית ו/או לאינטרנט. ‫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)

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

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

public CronetEngine.Builder setThreadPriority(int priority)

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

public CronetEngine.Builder setUserAgent(String userAgent)

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