CronetEngine.Builder

const val HTTP_CACHE_DISABLED = 0: Int

ضبط الإعداد لإيقاف ذاكرة التخزين المؤقت لبروتوكول HTTP قد يتم تخزين بعض البيانات مؤقتًا في الذاكرة. تم تمريرها إلى enableHttpCache.

const val HTTP_CACHE_DISK = 3: Int

إعداد لتفعيل ذاكرة التخزين المؤقت على القرص، بما في ذلك بيانات HTTP يجب استدعاء setStoragePath قبل تمرير هذا الثابت إلى enableHttpCache.

const val HTTP_CACHE_DISK_NO_HTTP = 2: Int

ضبط الإعداد لتفعيل ذاكرة التخزين المؤقت على القرص، باستثناء بيانات HTTP يجب استدعاء setStoragePath قبل تمرير هذا الثابت إلى enableHttpCache.

const val HTTP_CACHE_IN_MEMORY = 1: Int

إعداد لتفعيل ذاكرة التخزين المؤقت لبروتوكول HTTP في الذاكرة، بما في ذلك بيانات HTTP تم تمريرها إلى enableHttpCache.

Builder(context: Context!)

تنشئ هذه الدالة عنصر Builder يسهّل إنشاء CronetEngine. تفعِّل الإعدادات التلقائية البروتوكولَين HTTP/2 وQUIC، ولكنّها توقِف ذاكرة التخزين المؤقت لبروتوكول HTTP.

fun addPublicKeyPins(
    hostName: String!,
    pinsSha256: (Mutable)Set<ByteArray!>!,
    includeSubdomains: Boolean,
    expirationDate: Date!
): CronetEngine.Builder!

تثبِّت هذه السمة مجموعة من المفاتيح العامة لمضيف معيّن. من خلال تثبيت مجموعة من المفاتيح العامة، pinsSha256 يجب أن يتم التواصل مع hostName للمصادقة باستخدام شهادة تتضمّن مفتاحًا عامًا من المجموعة المثبّتة. يمكن للتطبيق تثبيت المفتاح العام لشهادة الجذر أو أي من الشهادات الوسيطة أو شهادة الإدخال النهائي. ستتعذّر المصادقة ولن يتم إنشاء اتصال آمن إذا لم يكن أي من المفاتيح العامة متوفّرًا في سلسلة شهادات المضيف، حتى إذا حاول المضيف المصادقة باستخدام شهادة مسموح بها من خلال مخزن الشهادات الموثوق به على الجهاز.

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

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

fun addQuicHint(host: String!, port: Int, alternatePort: Int): CronetEngine.Builder!

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

fun build(): CronetEngine!

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

fun enableBrotli(value: Boolean): CronetEngine.Builder!

تحدِّد هذه السياسة ما إذا كان ضغط Brotli مفعَّلاً. في حال تفعيل هذه الميزة، سيتم الإعلان عن Brotli في عناوين طلبات Accept-Encoding. يكون الإعداد التلقائي هو "إيقاف".

fun enableHttp2(value: Boolean): CronetEngine.Builder!

تحدّد هذه السياسة ما إذا كان بروتوكول HTTP/2 مفعَّلاً. يكون الإعداد التلقائي مفعّلاً.

fun enableHttpCache(cacheMode: Int, maxSize: Long): CronetEngine.Builder!

تفعيل أو إيقاف التخزين المؤقت لبيانات HTTP ومعلومات أخرى، مثل معلومات خادم QUIC

fun enableNetworkQualityEstimator(value: Boolean): CronetEngine.Builder!

تفعيل أداة تقدير جودة الشبكة التي تجمع قياسات وقت الاستجابة الكاملة (RTT) ومعدّل نقل البيانات من الخادم إلى العميل في طبقات مختلفة من حزمة الشبكة وتعرضها بعد تفعيل أداة التقدير، يمكن إضافة مستمعي وقت الاستجابة ذهابًا وإيابًا ومعدّل نقل البيانات باستخدام addRttListener وaddThroughputListener وإزالتهم باستخدام removeRttListener وremoveThroughputListener. لا يستخدم المقدِّر الذاكرة ووحدة المعالجة المركزية إلا عند تفعيله.

fun enablePublicKeyPinningBypassForLocalTrustAnchors(value: Boolean): CronetEngine.Builder!

تفعيل أو إيقاف تجاوز تثبيت المفتاح العام لكيانات الثقة المحلية ننصح بشدة بعدم إيقاف عملية التجاوز لمثبتات الثقة المحلية لأنّ ذلك قد يمنع التطبيق من التواصل مع المضيفين المثبّتين. على سبيل المثال، قد يريد المستخدم إرسال كل الزيارات من خلال خادم وكيل متوافق مع بروتوكول SSL عن طريق تغيير إعدادات خادم الوكيل على الجهاز وإضافة شهادة خادم الوكيل إلى قائمة مرجع الثقة المحلي. سيؤدي إيقاف التجاوز على الأرجح إلى منع التطبيق من إرسال أي زيارات إلى المضيفين المثبّتين. لمزيد من المعلومات، يُرجى الاطّلاع على "كيف يتفاعل تثبيت المفتاح مع الخوادم الوكيلة والفلاتر المحلية؟" على الرابط https://www.chromium.org/Home/chromium-security/security-faq

fun enableQuic(value: Boolean): CronetEngine.Builder!

تحدِّد هذه السياسة ما إذا كان بروتوكول QUIC مفعَّلاً. يكون الإعداد التلقائي مفعّلاً. في حال تفعيل QUIC، يتم إرسال رقم تعريف وكيل مستخدم QUIC الذي يحتوي على اسم التطبيق وإصدار Cronet إلى الخادم.

fun getDefaultUserAgent(): String!

تنشئ هذه السمة سلسلة User-Agent تتضمّن اسم التطبيق وإصداره وإصدار النظام ورقم التعريف والطراز وإصدار Cronet.

@ConnectionMigrationOptions.Experimental
fun setConnectionMigrationOptions(
    connectionMigrationOptions: ConnectionMigrationOptions!
): CronetEngine.Builder!

تضبط هذه السمة سلوك عملية نقل الاتصال. لمزيد من التفاصيل، يُرجى الاطّلاع على مستندات ConnectionMigrationOptions والطُرق الفردية في ConnectionMigrationOptions.Builder.

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

@DnsOptions.Experimental
fun setDnsOptions(dnsOptions: DnsOptions!): CronetEngine.Builder!

تضبط هذه السمة سلوك البحث عن اسم المضيف. لمزيد من التفاصيل، يُرجى الاطّلاع على مستندات DnsOptions والطُرق الفردية في DnsOptions.Builder.

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

fun setLibraryLoader(loader: CronetEngine.Builder.LibraryLoader!): CronetEngine.Builder!

تضبط هذه السمة LibraryLoader ليتم استخدامها لتحميل المكتبة المجمّعة من رموز برمجية أصلية. في حال عدم ضبطها، سيتم تحميل المكتبة باستخدام loadLibrary.

fun setProxyOptions(proxyOptions: ProxyOptions): CronetEngine.Builder!

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

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

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

@QuicOptions.Experimental
fun setQuicOptions(quicOptions: QuicOptions!): CronetEngine.Builder!

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

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

fun setStoragePath(value: String!): CronetEngine.Builder!

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

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

fun setThreadPriority(priority: Int): CronetEngine.Builder!

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

fun setUserAgent(userAgent: String!): CronetEngine.Builder!

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

protected val mParsedExperimentalOptions: JSONObject!

تمثيل JSON للخيارات التجريبية