chrome.app.runtime

תיאור

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

סוגים

ActionData

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

מאפיינים

  • actionType

ActionType

Chrome 54+

ניתן להפעיל אפליקציה מתוך מחשבה על פעולה ספציפית, לדוגמה, כדי ליצור הערה חדשה. סוג הפעולה שבעזרתה הופעלה האפליקציה זמין בשדה actionData במופע של LaunchData.

ערך

EmbedRequest

מאפיינים

  • נתונים

    כל אופציונלי

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

  • embedderId

    מחרוזת

  • לאפשר

    void

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

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

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

    • כתובת אתר

      מחרוזת

  • דחייה

    void

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

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

    () => {...}

LaunchData

מאפיינים

  • actionData

    ActionData אופציונלי

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

    מכילה נתונים שמציינים את הActionType שדרכם האפליקציה הזו הופעלה. הערך יהיה null אם האפליקציה לא הופעלה עם כוונת פעולה ספציפית.

  • id [מזהה]

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

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

  • isKioskSession

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

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

  • isPublicSession

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

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

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

  • פריטים

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

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

  • referrerUrl

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

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

  • source

    LaunchSource אופציונלי

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

  • כתובת אתר

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

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

LaunchItem

מאפיינים

  • רשומה

    הערך

    רשומה עבור הפריט.

  • סוג

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

    סוג ה-MIME של הקובץ.

LaunchSource

ספירת מקורות של הפעלות של אפליקציות. יש לסנכרן את הנתונים האלה עם AppLaunchSource ברכיבים/services/app_service/public/mojom/types.mojom, ועם GetLaunchSourceEnum() בתוספים/browser/api/app_runtime/app_runtime_api.cc. הערה: המספרים משמשים בהיסטוגרמה של UMA, לכן אסור לשנות את הסדר של הרשומות או להסיר אותן.

Enum

"untracked"

"new_tab_page"

"reload"

"restart"

"file_handler"

"system_tray"

"keyboard"

"extensions_page"

"management_api"

"kiosk"

"test"

"context_menu"

"arc"

"intent_url"

"app_home_page"

אירועים

onEmbedRequested

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

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

פרמטרים

  • קריאה חוזרת (callback)

    פונקציה

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

    (request: EmbedRequest) => void

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