chrome.app.runtime

الوصف

استخدِم واجهة برمجة التطبيقات chrome.app.runtime لإدارة مراحل نشاط التطبيق. تدير بيئة تشغيل التطبيق عملية تثبيت التطبيق وتتحكّم في صفحة الأحداث ويمكنها إيقاف التطبيق في أي وقت.

الأنواع

EmbedRequest

الخصائص

  • البيانات

    أيّ اختياري

    بيانات اختيارية يحدّدها المطوّر ويمكن للتطبيق المراد تضمينه استخدامها عند اتخاذ قرار التضمين.

  • embedderId

    سلسلة

  • سماح

    void

    يسمح هذا الإذن لـ "embedderId" بتضمين هذا التطبيق في عنصر <appview>. يحدّد العنصر url المحتوى المطلوب تضمينه.

    تبدو الدالة allow على النحو التالي: 

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

    • url

      سلسلة

  • رفض

    void

    يمنع هذا الإذن embedderId من تضمين هذا التطبيق في عنصر <appview>.

    تبدو الدالة deny على النحو التالي: 

    () => {...}

LaunchData

الخصائص

  • id

    string اختياري

    معرّف الملف أو معالج عنوان URL الذي يتم استدعاء التطبيق به. معرّفات المعالِجات هي المفاتيح ذات المستوى الأعلى في قاموسَي file_handlers و/أو url_handlers في البيان.

  • isKioskSession

    قيمة منطقية اختيارية

    ما إذا كان يتم تشغيل التطبيق في جلسة kiosk على نظام التشغيل Chrome.

  • isPublicSession

    قيمة منطقية اختيارية

    الإصدار 47 من Chrome والإصدارات الأحدث

    ما إذا كان يتم تشغيل التطبيق في جلسة عامة على نظام التشغيل Chrome.

  • items

    LaunchItem[] اختياري

    إدخالات الملفات للحدث onLaunched الذي تم تشغيله بواسطة معالج ملفات مطابق في مفتاح بيان file_handlers.

  • referrerUrl

    string اختياري

    عنوان URL للمُحيل لحدث onLaunched الذي تم تفعيله من خلال معالج عنوان URL مطابق في مفتاح بيان url_handlers.

  • المصدر

    LaunchSource اختياري

    المكان الذي يتم تشغيل التطبيق منه

  • url

    string اختياري

    عنوان URL للحدث onLaunched الذي تم تشغيله بواسطة معالج عنوان URL مطابق في مفتاح بيان url_handlers.

LaunchItem

الخصائص

  • إدخال

    إدخال

    إدخال للعنصر.

  • النوع

    string اختياري

    نوع 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.

المعلمات

  • 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 آخر مرة، أو عندما يُطلب من التطبيقات إعادة التشغيل من حالتها السابقة لأسباب أخرى (على سبيل المثال، عندما يلغي المستخدم إمكانية الوصول إلى الملفات المحفوظة في التطبيق، ستتم إعادة تشغيل التطبيق في وقت التشغيل). في هذه الحالات، إذا لم تكن التطبيقات تحتوي على معالج onRestarted، سيتم إرسال حدث onLaunched إليها بدلاً من ذلك.

المعلمات

  • callback

    دالة

    تظهر المَعلمة callback على النحو التالي: 

    () => void