chrome.app.runtime

תיאור

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

סוגים

EmbedRequest

מאפיינים

  • נתונים

    כל אופציונלי

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

  • embedderId

    מחרוזת

  • לאפשר

    void

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

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

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

    • כתובת אתר

      מחרוזת

  • דחייה

    void

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

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

    () => {...}

LaunchData

מאפיינים

  • id [מזהה]

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

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

  • isKioskSession

    boolean אופציונלי

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

  • isPublicSession

    boolean אופציונלי

    Chrome מגרסה 47 ואילך

    האם האפליקציה מופעלת בפעילות ציבורית ב-Chrome OS.

  • פריטים

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

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

  • referrerUrl

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

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

  • source

    LaunchSource אופציונלי

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

  • כתובת אתר

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

    כתובת ה-URL של האירוע 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

"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 נסגר בפעם האחרונה, או כשאפליקציות התבקשו להפעיל מחדש מהמצב הקודם שלהן מסיבות אחרות (למשל, כשהמשתמש מבטל את הגישה לקבצים שנשמרו באפליקציה, סביבת זמן הריצה תפעיל מחדש את האפליקציה). במקרים כאלה, אם לא תהיה לאפליקציות טיפולית onRestarted, יישלח להן אירוע onLaunched במקום זאת.

פרמטרים

  • callback

    פונקציה

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

    () => void