chrome.app.runtime

الوصف

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

الأنواع

ActionData

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

أماكن إقامة

  • actionType

    "new_note"

ActionType

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

يمكن تشغيل التطبيق مع وضع إجراء محدد في الاعتبار، على سبيل المثال، لإنشاء ملاحظة جديدة. يتوفّر نوع الإجراء الذي تم تشغيل التطبيق من خلاله داخل الحقل actionData من مثيل LaunchData.

القيمة

"new_note"

EmbedRequest

أماكن إقامة

  • البيانات

    أي اختياري

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

  • embedderId

    سلسلة

  • سماح

    void

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

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

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

    • url

      سلسلة

  • رفض

    void

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

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

    ()=> {...}

LaunchData

أماكن إقامة

  • actionData

    ActionData اختيارية

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

    يحتوي على بيانات تحدد ActionType التي تم تشغيل هذا التطبيق بها. ويكون هذا الحقل خاليًا إذا لم يتم إطلاق التطبيق لغرض إجراء محدّد.

  • id

    سلسلة اختيارية

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

  • isKioskSession

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

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

  • isPublicSession

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

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

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

  • عناصر

    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 لذلك يجب عدم إعادة ترتيب الإدخالات أو إزالتها.

التعداد

"new_tab_page"

"load_and_launch"

"command_line"

"system_tray"

"about_page"

"extensions_page"

"management_api"

"ephemeral_app"

"chrome_internal"

"test"

"installed_notification"

"arc"

"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