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) و توان عملیاتی پایین‌دست را در لایه‌های مختلف پشته شبکه جمع‌آوری و گزارش می‌کند. پس از فعال کردن تخمین‌گر، می‌توان شنونده‌های RTT و توان عملیاتی را با addRttListener و addThroughputListener اضافه و با removeRttListener و removeThroughputListener حذف کرد. تخمین‌گر فقط در صورت فعال بودن از حافظه و CPU استفاده می‌کند.

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 از قبل پیکربندی پروکسی سیستم را به صورت داخلی مدیریت می‌کند.

پیکربندی پروکسی تعریف‌شده از طریق این API، پیکربندی پروکسی "برنامه" نامیده می‌شود. پیکربندی پروکسی برنامه و سیستم از هم جدا هستند و مهم‌تر از همه، با هم متفاوتند. در حال حاضر، پیکربندی‌های پروکسی برنامه و سیستم کاملاً منحصر به فرد هستند: تعیین 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 Cache و Cookie Storage تنظیم می‌کند. این دایرکتوری باید وجود داشته باشد.

نکته: از یک دایرکتوری ذخیره‌سازی با بیش از یک CronetEngine به طور همزمان استفاده نکنید. دسترسی به دایرکتوری ذخیره‌سازی از دسترسی همزمان توسط چندین CronetEngine پشتیبانی نمی‌کند.

public CronetEngine.Builder setThreadPriority(int priority)

اولویت نخ داخلی Cronet را تنظیم می‌کند.

public CronetEngine.Builder setUserAgent(String userAgent)

هدر User-Agent را برای همه درخواست‌ها لغو می‌کند. یک هدر User-Agent که به طور صریح تنظیم شده باشد (با استفاده از addHeader تنظیم می‌شود) با استفاده از این تابع، مقداری را که تنظیم شده است، لغو می‌کند.