chrome.app.runtime

الوصف

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

الأنواع

ActionData

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

أماكن إقامة

  • actionType

    "new_note"

ActionType

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

يمكن تشغيل التطبيق مع وضع إجراء معيّن في الاعتبار، على سبيل المثال، لإنشاء ملاحظة جديدة. يتوفّر نوع الإجراء الذي تم تشغيل التطبيق من خلاله داخل الحقل 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

onRestarted

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

يتم تنشيطه عند بدء تشغيل Chrome على التطبيقات التي كانت قيد التشغيل عند آخر مرة تم فيها إيقاف تشغيل Chrome، أو عندما يُطلب من التطبيقات إعادة تشغيلها من حالتها السابقة لأسباب أخرى (على سبيل المثال، عندما يُبطل المستخدم إمكانية الوصول إلى الملفات التي تم الاحتفاظ بها في أحد التطبيقات، سيُعيد وقت التشغيل تشغيل التطبيق). في هذه الحالات، إذا لم تكن التطبيقات تحتوي على معالِج "onRestarted"، سيتم إرسال حدث onLaunched إليها بدلاً من ذلك.

المعلمات

  • رد الاتصال

    الوظيفة

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

    () => void