chrome.app.runtime

شرح

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

انواع

EmbedRequest

مشخصات

  • داده

    هر اختیاری

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

  • embedderId

    رشته

  • مجاز کردن

    باطل کردن

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

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

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

    • نشانی وب

      رشته

  • رد کردن

    باطل کردن

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

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

    () => {...}

LaunchData

مشخصات

  • id

    رشته اختیاری

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

  • isKioskSession

    بولی اختیاری

    اینکه برنامه در جلسه کیوسک Chrome OS راه‌اندازی شده است یا نه.

  • isPublicSession

    بولی اختیاری

    Chrome نسخه ۴۷ و بالاتر

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

  • موارد

    LaunchItem[] اختیاری

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

  • referrerUrl

    رشته اختیاری

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

  • منبع

    LaunchSource اختیاری

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

  • نشانی وب

    رشته اختیاری

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

LaunchItem

مشخصات

  • ورودی

    بلیت ورودی

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

  • نوع

    رشته اختیاری

    نوع رسانه فایل.

LaunchSource

Enumeration of app launch sources. This should be kept in sync with AppLaunchSource in components/services/app_service/public/mojom/types.mojom, and GetLaunchSourceEnum() in extensions/browser/api/app_runtime/app_runtime_api.cc. توجه داشته باشید که از شمارش در هیستوگرام UMA استفاده می‌شود، بنابراین ورودی‌ها نباید دوباره مرتب شوند یا برداشته شوند.

شمارشی

«ردیابی‌نشده»

"app_launcher"

"new_tab_page"

"reload"

"restart"

"load_and_launch"

"command_line"

"file_handler"

"url_handler"

"system_tray"

"about_page"

"keyboard"

"extensions_page"

"management_api"

"ephemeral_app"

«پس‌زمینه»

"kiosk"

"chrome_internal"

"test"

"installed_notification"

"context_menu"

«arc»

"intent_url"

"app_home_page"

"focus_mode"

«sparky»

رویدادها

onEmbedRequested

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

Fired when an embedding app requests to embed this app. This event is only available on dev channel with the flag --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