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) للاستفادة من ميزة إنشاء الاتصال بدون تأخير بين الجلسات.

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) إلى تجاهل القيمة التي تم ضبطها باستخدام هذه الدالة.