chrome.app.runtime

תיאור

משתמשים ב-API של chrome.app.runtime כדי לנהל את מחזור החיים של האפליקציה. סביבת זמן הריצה של האפליקציה מנהלת את התקנת האפליקציה, שולטת בדף האירועים ויכולה לסגור את האפליקציה בכל שלב.

סוגים

EmbedRequest

מאפיינים

  • נתונים

    any optional

    נתונים אופציונליים שהמפתח ציין, שהאפליקציה להטמעה יכולה להשתמש בהם כשהיא מקבלת החלטה לגבי ההטמעה.

  • embedderId

    מחרוזת

  • לאפשר

    void

    מאפשרת לאפליקציה embedderId להטמיע את האפליקציה הזו ברכיב <appview>. ה-url מציין את התוכן שרוצים להטמיע.

    הפונקציה allow נראית כך: 

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

    • url

      מחרוזת

  • דחייה

    void

    מונעת מ-embedderId להטמיע את האפליקציה הזו ברכיב <appview>.

    הפונקציה deny נראית כך: 

    () => {...}

LaunchData

מאפיינים

  • id [מזהה]

    מחרוזת אופציונלי

    המזהה של הקובץ או של ה-URL handler שהאפליקציה מופעלת איתם. מזהי ה-handler הם המפתחות ברמה העליונה במילונים file_handlers ו/או url_handlers במניפסט.

  • isKioskSession

    בוליאני אופציונלי

    אם האפליקציה מופעלת בסשן קיוסק של ChromeOS.

  • isPublicSession

    בוליאני אופציונלי

    ‫Chrome 47 ואילך

    אם האפליקציה מופעלת בסשן ציבורי של ChromeOS.

  • פריטים

    LaunchItem[] אופציונלי

    רשומות הקבצים של האירוע onLaunched שהופעל על ידי גורם מטפל בקבצים תואם במפתח המניפסט file_handlers.

  • referrerUrl

    מחרוזת אופציונלי

    כתובת ה-URL של הגורם המפנה לאירוע onLaunched שהופעל על ידי handler תואם של כתובת URL במפתח המניפסט url_handlers.

  • source

    LaunchSource אופציונלי

    המקום שממנו האפליקציה מופעלת.

  • url

    מחרוזת אופציונלי

    כתובת ה-URL של האירוע onLaunched שהופעל על ידי handler תואם של כתובת 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)

thought "untracked"

"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"

"background"

"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,
)

מופעל כשאפליקציה להטמעה מבקשת להטמיע את האפליקציה הזו. האירוע הזה זמין רק בערוץ הפיתוח עם הדגל ‎--enable-app-view.

פרמטרים

onLaunched

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

מופעל כשמפעילים אפליקציה ממרכז האפליקציות.

פרמטרים

  • callback

    פונקציה

    הפרמטר callback נראה כך: 

    (launchData?: LaunchData) => void

onRestarted

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

מופעל בהפעלת Chrome לאפליקציות שפעלו כש-Chrome נסגר בפעם האחרונה, או כשהאפליקציות התבקשו להפעיל מחדש את המצב הקודם שלהן מסיבות אחרות (למשל, כשהמשתמש מבטל את הגישה לקבצים השמורים של האפליקציה, זמן הריצה יפעיל מחדש את האפליקציה). במצבים כאלה, אם לאפליקציות אין handler של onRestarted, יישלח אליהן אירוע של onLaunched במקום זאת.

פרמטרים

  • callback

    פונקציה

    הפרמטר callback נראה כך: 

    () => void