chrome.app.runtime

الوصف

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

الأنواع

ActionData

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

أماكن إقامة

  • actionType

ActionType

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

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

القيمة

"new_note"

EmbedRequest

أماكن إقامة

  • البيانات

    أي خيار اختياري

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

  • embedderId

    سلسلة

  • سماح

    غير صالح

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

    تبدو دالة allow كما يلي: 

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

    • url

      سلسلة

  • رفض

    غير صالح

    تمنع هذه السياسة 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 في components/services/app_service/public/mojom/types.mojom وGetLaunchSourceEnum() في extensions/browser/api/app_runtime/app_runtime_api.cc. لاحظ أنه يتم استخدام التعداد في المدرّج التكراري لـ UMA، لذا يجب عدم إعادة ترتيب الإدخالات أو إزالتها.

التعداد

"untracked"

"app_launcher"

"new_tab_page"

"reload"

"load_and_launch"

"command_line"

"file_handler"

"url_handler"

"keyboard"

"ephemeral_app"

"background"

"kiosk"

"test"

"installed_notification"

"sparky"

الفعاليات

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