chrome.app.runtime

توضیحات

از chrome.app.runtime API برای مدیریت چرخه عمر برنامه استفاده کنید. زمان اجرا برنامه نصب برنامه را مدیریت می کند، صفحه رویداد را کنترل می کند، و می تواند برنامه را در هر زمانی خاموش کند.

انواع

ActionData

Chrome 54+

خواص

  • نوع عمل

    "یادداشت_جدید"

ActionType

Chrome 54+

یک برنامه را می توان با در نظر گرفتن یک اقدام خاص راه اندازی کرد، به عنوان مثال، برای ایجاد یک یادداشت جدید. نوع عملکردی که برنامه با آن راه اندازی شده است در داخل فیلد actionData از نمونه LaunchData موجود است.

ارزش

"یادداشت_جدید"

EmbedRequest

خواص

  • داده ها

    هر اختیاری

    برنامه‌نویس اختیاری داده‌های مشخص شده را که برنامه جاسازی‌شده می‌تواند هنگام تصمیم‌گیری برای جاسازی استفاده کند.

  • embedderId

    رشته

  • اجازه می دهد

    باطل

    به embedderId اجازه می دهد تا این برنامه را در عنصر <appview> جاسازی کند. url محتوایی را برای جاسازی مشخص می کند.

    تابع allow به نظر می رسد: 

    (url: string) => {...}

    • آدرس اینترنتی

      رشته

  • انکار کند

    باطل

    از embedderId از جاسازی این برنامه در عنصر <appview> جلوگیری می کند.

    تابع deny به صورت زیر است: 

    () => {...}

LaunchData

خواص

  • actionData

    ActionData اختیاری است

    Chrome 54+

    حاوی داده‌هایی است که مشخص می‌کند ActionType با آن راه‌اندازی شده است. اگر برنامه با هدف خاصی راه‌اندازی نشده باشد، این باطل است.

  • شناسه

    رشته اختیاری

    شناسه فایل یا کنترل کننده URL که برنامه با آن فراخوانی می شود. شناسه‌های Handler کلیدهای سطح بالایی در فرهنگ‌های file_handlers و/یا url_handlers در مانیفست هستند.

  • isKioskSession

    بولی اختیاری

    اینکه آیا برنامه در جلسه کیوسک سیستم عامل Chrome راه اندازی می شود یا خیر.

  • isPublicSession است

    بولی اختیاری

    Chrome 47+

    اینکه آیا برنامه در جلسه عمومی سیستم عامل Chrome راه اندازی می شود یا خیر.

  • موارد

    LaunchItem [] اختیاری است

    ورودی های فایل برای رویداد onLaunched که توسط یک کنترل کننده فایل منطبق در کلید مانیفست file_handlers فعال می شود.

  • referrerUrl

    رشته اختیاری

    URL ارجاع دهنده برای رویداد onLaunched که توسط یک کنترل کننده URL منطبق در کلید مانیفست url_handlers فعال شده است.

  • منبع

    LaunchSource اختیاری است

    جایی که برنامه از آنجا راه اندازی می شود.

  • آدرس اینترنتی

    رشته اختیاری

    نشانی وب رویداد onLaunched که توسط یک کنترل کننده URL منطبق در کلید مانیفست url_handlers فعال شده است.

LaunchItem

خواص

  • ورود

    ورود

    ورودی برای مورد

  • نوع

    رشته اختیاری

    نوع MIME فایل

LaunchSource

شمارش منابع راه اندازی اپلیکیشن این باید با AppLaunchSource در components/services/app_service/public/mojom/types.mojom و GetLaunchSourceEnum() در extensions/browser/api/app_runtime/app_runtime_api.cc همگام باشد. توجه داشته باشید که شمارش در هیستوگرام UMA استفاده می شود، بنابراین ورودی ها نباید دوباره مرتب شوند یا حذف شوند.

Enum

"ردیابی نشده"

"app_launcher"

"new_tab_page"

"بارگذاری مجدد"

"راه اندازی مجدد"

"load_and_launch"

"خط_فرمان"

"file_handler"

"url_handler"

"system_tray"

"about_page"

"صفحه کلید"

"extensions_page"

"management_api"

"اپفمرال_برنامه"

"پس زمینه"

"کیوسک"

"chrome_internal"

"تست"

"installed_notification"

"context_menu"

"قوس"

"intent_url"

"app_home_page"

"focus_mode"

"جرقه"

رویدادها

onEmbedRequested

chrome.app.runtime.onEmbedRequested.addListener(
  callback: function,
)

زمانی فعال می شود که یک برنامه جاسازی درخواست جاسازی این برنامه را داشته باشد. این رویداد فقط در کانال توسعه دهنده با پرچم --enable-app-view در دسترس است.

پارامترها

  • پاسخ به تماس

    تابع

    پارامتر callback به نظر می رسد: 

    (request: EmbedRequest) => void

onLaunched

chrome.app.runtime.onLaunched.addListener(
  callback: function,
)

هنگامی که یک برنامه از راه‌انداز راه‌اندازی می‌شود، فعال می‌شود.

پارامترها

  • پاسخ به تماس

    تابع

    پارامتر callback به نظر می رسد: 

    (launchData?: LaunchData) => void

onRestarted

chrome.app.runtime.onRestarted.addListener(
  callback: function,
)

هنگام راه‌اندازی Chrome برای برنامه‌هایی فعال می‌شود که در آخرین خاموش شدن Chrome اجرا می‌شدند، یا زمانی که برنامه‌ها به دلایل دیگر درخواست راه‌اندازی مجدد از حالت قبلی خود را داشتند (مثلاً وقتی کاربر دسترسی به فایل‌های حفظ‌شده یک برنامه را لغو می‌کند، زمان اجرا برنامه را مجدداً راه‌اندازی می‌کند). در این مواقع اگر برنامه‌ها دارای یک کنترل کننده onRestarted نباشند، به جای آن یک رویداد onLaunched ارسال می‌شود.

پارامترها

  • پاسخ به تماس

    تابع

    پارامتر callback به نظر می رسد: 

    () => void