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 للمصادقة باستخدام شهادة تتضمّن مفتاحًا عامًا من مجموعة المفاتيح المثبّتة. يمكن للتطبيق تثبيت المفتاح العام لشهادة الجذر أو أي من الشهادات الوسيطة أو شهادة الكيان النهائي. ستتعذّر المصادقة ولن يتم إنشاء اتصال آمن إذا لم يكن أي من المفاتيح العامة متوفّرًا في سلسلة شهادات المضيف، حتى إذا حاول المضيف المصادقة باستخدام شهادة مسموح بها من خلال مخزن الشهادات الموثوق به على الجهاز.

سيؤدي استدعاء هذه الطريقة عدة مرات باستخدام اسم المضيف نفسه إلى إلغاء الدبابيس التي تم ضبطها سابقًا للمضيف.

يمكنك الاطّلاع على مزيد من المعلومات حول تثبيت المفتاح العام في RFC 7469.

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

إضافة تلميح بأنّ host يتيح استخدام QUIC. يُرجى العِلم أنّ enableHttpCache (HTTP_CACHE_DISK) ضروري للاستفادة من إمكانية إنشاء اتصال 0-RTT بين الجلسات.

public CronetEngine build()

إنشاء CronetEngine باستخدام إعدادات أداة الإنشاء هذه

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) ومعدّل نقل البيانات في اتجاه واحد عند مختلف طبقات حزمة الشبكة وتعرضها بعد تفعيل أداة تقدير معدل نقل البيانات، يمكن إضافة متتبعي مراسلة نصية في الوقت الفعلي وسرعة معالجة البيانات باستخدام addRttListener وaddThroughputListener وإزالتهم باستخدام removeRttListener وremoveThroughputListener. لا يستخدم المقدِّر الذاكرة ووحدة المعالجة المركزية إلا عند تفعيله.

public CronetEngine.Builder enablePublicKeyPinningBypassForLocalTrustAnchors(boolean value)

تفعيل أو إيقاف تجاوز تثبيت المفتاح العام لمراسي الثقة المحلية ننصح بشدة بعدم إيقاف التجاوز لمراسي الثقة المحلية لأنّ ذلك قد يمنع التطبيق من التواصل مع المضيفين المثبّتين. على سبيل المثال، قد يريد المستخدم إرسال كل عدد الزيارات من خلال خادم وكيل مفعّل لبروتوكول 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 تتضمّن اسم التطبيق وإصداره وإصدار النظام ورقم التعريف والطراز وإصدار 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 ليتم استخدامها لتحميل المكتبة المجمّعة من الرموز البرمجية الأصلية. في حال عدم ضبطها، سيتم تحميل المكتبة باستخدام loadLibrary.

public CronetEngine.Builder setProxyOptions(@NonNull ProxyOptions proxyOptions)

يضبط هذا الخيار سلوك الخادم الوكيل. يؤثّر ذلك بطرق مختلفة في إنشاء عمليات الربط وUrlRequest وBidirectionalStream. لمزيد من التفاصيل، يُرجى الرجوع إلى مستندات Proxy.

يجب عدم الخلط بين ذلك وبين إعدادات الخادم الوكيل التي تم ضبطها من قِبل المستخدم أو بعض إعدادات ملف العمل أو (على الأرجح) بعض الإعدادات التلقائية للشبكة (مثل بروتوكول الاكتشاف التلقائي للخادم الوكيل على الويب). يُشار إلى ذلك عادةً باسم إعدادات الخادم الوكيل "للنظام". في حال توفُّر إعدادات خادم وكيل، غالبًا ما يكون الالتزام بها شرطًا للحصول على اتصال بالشبكة المحلية و/أو الإنترنت. تتعامل CronetEngine مع إعدادات الخادم الوكيل للنظام داخليًا.

يُشار إلى إعدادات الخادم الوكيل المحدّدة من خلال واجهة برمجة التطبيقات هذه باسم إعدادات الخادم الوكيل "للتطبيق". يختلف إعداد الخادم الوكيل للتطبيق عن إعداد الخادم الوكيل للنظام، والأهم من ذلك أنّهما مختلفان. في الوقت الحالي، تتنافى إعدادات الخادم الوكيل للتطبيق والنظام مع بعضها البعض: يؤدي تحديد ProxyOptions إلى إلغاء إعدادات الخادم الوكيل للنظام، إذا كانت متوفّرة. قد يؤدي ذلك إلى حدوث مشاكل في الاتصال في بعض السيناريوهات التي يتوفّر فيها إعداد خادم وكيل للنظام. في مثل هذه السيناريوهات، قد لا يتمكّن المستخدمون من الوصول إلى الإنترنت، ما لم يتم ضبط ProxyOptions باستخدام null نهائي كخيار احتياطي. يُرجى الرجوع إلى مستندات ProxyOptions.

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

تضبط هذه السمة سلوك Cronet عند استخدام QUIC. لمزيد من التفاصيل، راجِع مستندات QuicOptions والطُرق الفردية في QuicOptions.Builder.

لا يكون هذا الخيار ذا صلة إلا إذا كان الخيار enableQuic مفعَّلاً.

public CronetEngine.Builder setStoragePath(String value)

تضبط هذه السياسة الدليل الخاص بالتخزين المؤقت عبر HTTP وتخزين ملفات تعريف الارتباط. يجب أن يكون الدليل متوفّرًا.

ملاحظة: لا تستخدِم دليل التخزين نفسه مع أكثر من CronetEngine في الوقت نفسه. لا يتيح الوصول إلى دليل التخزين إمكانية الوصول المتزامن من خلال عدة CronetEngine.

public CronetEngine.Builder setThreadPriority(int priority)

تضبط هذه السمة أولوية سلسلة المحادثات الداخلية في Cronet.

public CronetEngine.Builder setUserAgent(String userAgent)

تتجاوز هذه السمة عنوان User-Agent لجميع الطلبات. سيؤدي عنوان User-Agent الذي تم ضبطه بشكلٍ صريح (باستخدام addHeader) إلى تجاهل القيمة التي تم ضبطها باستخدام هذه الدالة.