chrome.app.runtime

תיאור

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

סוגים

ActionData

Chrome בגרסה 54 ומעלה

תכונות

  • actionType

    "new_note"

ActionType

Chrome בגרסה 54 ומעלה

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

ערך

"new_note"

EmbedRequest

תכונות

  • נתונים

    כל אופציונלי

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

  • embedderId

    string

  • לאפשר

    void

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

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

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

    • כתובת אתר

      string

  • דחייה

    void

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

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

    ()=> {...}

LaunchData

תכונות

  • actionData

    ActionData אופציונלי

    Chrome בגרסה 54 ומעלה

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

  • id

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

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

  • isKioskSession

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

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

  • isPublicSession

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

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

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

  • items

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

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

  • referrerUrl

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

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

  • source

    LaunchSource – אופציונלי

    מקור האפליקציה.

  • כתובת אתר

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

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

LaunchItem

תכונות

  • רשומה

    הערך

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

  • סוג

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

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

LaunchSource

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

טיפוסים בני מנייה (enum)

"new_tab_page"

"load_and_launch"

"command_line"

"url_handler"

"system_tray"

"about_page"

"extensions_page"

"management_api"

"chrome_internal"

"context_menu"

"intent_url"

"focus_mode"

אירועים

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