الوصف
ويمكنك استخدام واجهة برمجة التطبيقات chrome.app.runtime
لإدارة مراحل نشاط التطبيق. يدير وقت تشغيل التطبيق عملية تثبيت التطبيق ويتحكّم في صفحة الحدث ويمكنه إيقاف التطبيق في أي وقت.
الأنواع
ActionData
أماكن إقامة
-
actionType
"new_note"
ActionType
يمكن تشغيل التطبيق مع وضع إجراء معيّن في الاعتبار، على سبيل المثال، لإنشاء ملاحظة جديدة. يتوفّر نوع الإجراء الذي تم تشغيل التطبيق من خلاله داخل الحقل actionData
من مثيل LaunchData.
القيمة
"new_note"
EmbedRequest
أماكن إقامة
-
البيانات
أي خيار اختياري
البيانات الاختيارية المحددة بواسطة المطوّر التي يمكن أن يستخدمها التطبيق المراد تضمينه عند اتخاذ قرار التضمين.
-
embedderId
سلسلة
-
سماح
void
يسمح هذا الإذن لـ
embedderId
بتضمين هذا التطبيق في عنصر <appview>. وتحدّد السمةurl
المحتوى الذي تريد تضمينه.تظهر الدالة
allow
بالشكل التالي:(url: string) => {...}
-
url
سلسلة
-
-
منع
void
تمنع هذه السياسة
embedderId
من تضمين هذا التطبيق في عنصر <appview>.تظهر الدالة
deny
بالشكل التالي:() => {...}
LaunchData
أماكن إقامة
-
actionData
ActionData اختيارية
الإصدار 54 من Chrome أو الإصدارات الأحدثيحتوي على بيانات تحدد
ActionType
الذي تم تشغيل هذا التطبيق من خلاله. ويكون هذا الحقل فارغًا إذا لم يتم تشغيل التطبيق لغرض معيّن. -
id
سلسلة اختيارية
رقم تعريف الملف أو معالج عناوين URL الذي يتم استدعاء التطبيق به. معرّفات المعالِجات هي مفاتيح المستوى الأعلى في القواميس
file_handlers
و/أوurl_handlers
في البيان. -
isKioskSession
قيمة منطقية اختيارية
ما إذا كان يجري تشغيل التطبيق في جلسة Kiosk لنظام التشغيل Chrome
-
isPublicSession
قيمة منطقية اختيارية
الإصدار 47 من Chrome أو الإصدارات الأحدثتحدّد هذه القيمة ما إذا كان سيتم تشغيل التطبيق في جلسة عامة على نظام التشغيل Chrome.
-
items
LaunchItem[] اختياري
إدخالات الملف الخاصة بالحدث
onLaunched
التي تم تشغيلها من خلال معالج ملفات مطابق في مفتاح البيانfile_handlers
-
referrerUrl
سلسلة اختيارية
عنوان URL المُحيل لحدث
onLaunched
الذي تم تشغيله من خلال معالج عنوان URL مطابق في مفتاح البيانurl_handlers
-
المصدر
LaunchSource اختياري
الأجهزة التي تم تشغيل التطبيق منها
-
url
سلسلة اختيارية
عنوان 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، لذا يجب عدم إعادة ترتيب الإدخالات أو إزالتها.
التعداد
"untracked"
"new_tab_page"
"load_and_launch"
"command_line"
"file_handler"
"url_handler"
"system_tray"
"about_page"
"extensions_page"
"management_api"
"ephemeral_app"
"chrome_internal"
"intent_url"
"app_home_page"
"focus_mode"
فعاليات
onEmbedRequested
chrome.app.runtime.onEmbedRequested.addListener(
callback: function,
)
يتم إطلاقه عندما يطلب أحد تطبيقات التضمين تضمين هذا التطبيق. لا يتوفّر هذا الحدث إلا على قناة المطوّر التي تحمل العلامة "-enable-app-view".
المعلمات
-
رد الاتصال
الوظيفة
تظهر المَعلمة
callback
على النحو التالي:(request: EmbedRequest) => void
-
طلب
-
onLaunched
chrome.app.runtime.onLaunched.addListener(
callback: function,
)
يتم إطلاقه عند تشغيل تطبيق من مشغّل التطبيقات.
المعلمات
-
رد الاتصال
الوظيفة
تظهر المَعلمة
callback
على النحو التالي:(launchData?: LaunchData) => void
-
launchData
LaunchData اختياري
-
onRestarted
chrome.app.runtime.onRestarted.addListener(
callback: function,
)
يتم تنشيطه عند بدء تشغيل Chrome على التطبيقات التي كانت قيد التشغيل عند آخر مرة تم فيها إيقاف تشغيل Chrome، أو عندما يُطلب من التطبيقات إعادة تشغيلها من حالتها السابقة لأسباب أخرى (على سبيل المثال، عندما يُبطل المستخدم إمكانية الوصول إلى الملفات التي تم الاحتفاظ بها في أحد التطبيقات، سيُعيد وقت التشغيل تشغيل التطبيق). في هذه الحالات، إذا لم تكن التطبيقات تحتوي على معالِج "onRestarted
"، سيتم إرسال حدث onLaunched
إليها بدلاً من ذلك.
المعلمات
-
رد الاتصال
الوظيفة
تظهر المَعلمة
callback
على النحو التالي:() => void