Nội dung mô tả
Sử dụng API chrome.app.runtime
để quản lý vòng đời của ứng dụng. Môi trường thời gian chạy của ứng dụng quản lý việc cài đặt ứng dụng, kiểm soát trang sự kiện và có thể tắt ứng dụng bất cứ lúc nào.
Loại
ActionData
Thuộc tính
-
actionType
"new_note"
ActionType
Người dùng có thể khởi chạy ứng dụng dựa trên một hành động cụ thể, chẳng hạn như để tạo ghi chú mới. Loại thao tác khởi chạy ứng dụng có sẵn bên trong trường actionData
của thực thể LaunchData.
Giá trị
"new_note"
EmbedRequest
Thuộc tính
-
data
không bắt buộc bất kỳ
Nhà phát triển tuỳ chọn chỉ định dữ liệu mà ứng dụng cần nhúng có thể sử dụng khi đưa ra quyết định nhúng.
-
embedderId
string
-
allow
void
Cho phép
embedderId
nhúng ứng dụng này trong phần tử <appview>.url
chỉ định nội dung cần nhúng.Hàm
allow
sẽ có dạng như sau:(url: string)=> {...}
-
url
string
-
-
từ chối
void
Ngăn
embedderId
nhúng ứng dụng này trong phần tử <appview>.Hàm
deny
sẽ có dạng như sau:()=> {...}
LaunchData
Thuộc tính
-
actionData
ActionData không bắt buộc
Chrome 54 trở lênChứa dữ liệu chỉ định
ActionType
mà bạn dùng để chạy ứng dụng này. Giá trị này rỗng nếu ứng dụng không được khởi chạy với một ý định hành động cụ thể. -
id
chuỗi không bắt buộc
Mã của tệp hoặc trình xử lý URL mà ứng dụng đang được gọi cùng. Mã nhận dạng trình xử lý là các khoá cấp cao nhất trong từ điển
file_handlers
và/hoặcurl_handlers
trong tệp kê khai. -
isKioskSession
boolean không bắt buộc
Liệu ứng dụng có đang được chạy trong phiên kiosk của Chrome OS hay không.
-
isPublicSession
boolean không bắt buộc
Chrome 47 trở lênLiệu ứng dụng có đang được chạy trong phiên công khai của Chrome OS hay không.
-
items
LaunchItem[] không bắt buộc
Các mục nhập tệp cho sự kiện
onLaunched
được kích hoạt bởi một trình xử lý tệp trùng khớp trong khoá tệp kê khaifile_handlers
. -
referrerUrl
chuỗi không bắt buộc
URL liên kết giới thiệu cho sự kiện
onLaunched
được kích hoạt bởi một trình xử lý URL trùng khớp trong khoá tệp kê khaiurl_handlers
. -
nguồn
LaunchSource không bắt buộc
Nguồn khởi chạy ứng dụng.
-
url
chuỗi không bắt buộc
URL cho sự kiện
onLaunched
được kích hoạt bởi một trình xử lý URL trùng khớp trong khoá tệp kê khaiurl_handlers
.
LaunchItem
Thuộc tính
-
mục nhập
Vé vào cửa
Mục nhập cho mục.
-
loại
chuỗi không bắt buộc
Loại MIME của tệp.
LaunchSource
Liệt kê các nguồn khởi chạy ứng dụng. Tệp này phải được đồng bộ hoá với AppLaunchSource trong các thành phần/services/app_service/public/mojom/types.mojom và GetLaunchSourceEnum() trong extensions/browser/api/app_runtime/app_runtime_api.cc. Xin lưu ý rằng cách liệt kê được dùng trong biểu đồ UMA, vì vậy, bạn không nên sắp xếp lại hoặc xoá các mục nhập.
Liệt kê
"app_launcher"
"new_tab_page"
"load_and_launch"
"command_line"
"file_handler"
"url_handler"
"system_tray"
"about_page"
"extensions_page"
"management_api"
"kiosk"
"chrome_internal"
"context_menu"
"arc"
"intent_url"
"app_home_page"
Sự kiện
onEmbedRequested
chrome.app.runtime.onEmbedRequested.addListener(
callback: function,
)
Được kích hoạt khi một ứng dụng nhúng yêu cầu nhúng ứng dụng này. Sự kiện này chỉ có trên kênh nhà phát triển có cờ --enable-app-view.
Thông số
-
số gọi lại
hàm
Tham số
callback
sẽ có dạng như sau:(request: EmbedRequest)=>void
-
request
-
onLaunched
chrome.app.runtime.onLaunched.addListener(
callback: function,
)
Được kích hoạt khi một ứng dụng được khởi chạy từ trình chạy.
Thông số
-
số gọi lại
hàm
Tham số
callback
sẽ có dạng như sau:(launchData?: LaunchData)=>void
-
launchData
LaunchData không bắt buộc
-
onRestarted
chrome.app.runtime.onRestarted.addListener(
callback: function,
)
Được kích hoạt lúc Chrome khởi động cho các ứng dụng đang chạy khi Chrome tắt lần cuối hoặc khi các ứng dụng được yêu cầu khởi động lại từ trạng thái trước đó vì lý do khác (ví dụ: khi người dùng thu hồi quyền truy cập vào các tệp được giữ lại của ứng dụng, thời gian chạy sẽ khởi động lại ứng dụng). Trong những trường hợp này, nếu không có trình xử lý onRestarted
, ứng dụng sẽ được gửi một sự kiện onLaunched
.
Thông số
-
số gọi lại
hàm
Tham số
callback
sẽ có dạng như sau:()=>void