مرجع الإضافة.yaml

يحتوي ملف مواصفات إضافتك (extension.yaml) على بيانات وصفية، تعلن عن الموارد التي تم إنشاؤها بواسطة الإضافة وواجهات برمجة التطبيقات التي تتطلبها الإضافة، وتحدد أي معلمات يضبطها المستخدم التي تقدمها الإضافة.

تصف الجداول في هذه الصفحة الحقول المتاحة لـ extension.yaml الملف.

المعلومات الأساسية والمعلومات التي تحدّد الهوية

name: your-extension-name
version: 1.0.0         # Semantic versioning (semver)
specVersion: v1beta    # Always "v1beta"
license: Apache-2.0    # Always "Apache-2.0" (required to publish on extensions.dev)
billingRequired: true  # Always "true"

displayName: Your extension name
description: >-
  Description of the extension. (One or two
  sentences.)
icon: icon.png
tags: [tag, anothertag]

sourceUrl: https://github.com/your-org/your-repo   # GitHub repo URL
releaseNotesUrl: https://github.com/your-org/your-repo/blob/main/CHANGELOG.md

author:
  authorName: Your Company
  email: extensions@example.com
  url: https://example.com/
contributors:
  - authorName: Your Name
  - authorName: Another Contributor
    email: colleague@example.net
    url: https://github.com/their-org/
الحقول الأساسية
name
سلسلة
(مطلوب)

معرِّف الإضافة

لا يمكن أن يحتوي إلا على أحرف صغيرة وأرقام وشرطات. 40 حرفًا الحد.

ملاحظة: يتم استخدام هذه القيمة لإنشاء رابط معرف المثيل (الذي يُستخدم بعد ذلك لإنشاء أسماء حساب خدمة الإضافة والموارد الخاصة بهذه الإضافة).

version
سلسلة
(مطلوب)

إصدار الإضافة.

يجب أن يتّبع إصدار semver (مثلاً، 1.2.0).
specVersion
سلسلة
(مطلوب)

إصدار مواصفات إضافات Firebase

القيمة الحالية: v1beta
license
سلسلة
(اختياري)

ترخيص الإضافة

يجب أن تكون إضافتك مرخَّصة باستخدام "Apache-2.0".
billingRequired
منطقية
(اختياري)

ما إذا كانت الخدمات التي تستخدمها الإضافة تتطلب مستوى مدفوعًا حساب فوترة Firebase.

اضبط دائمًا على true.
displayName
سلسلة
(اختياري)

يجب أن يكون الاسم المعروض للإضافة سهل الاستخدام (من 3 إلى 5 كلمات).

عدد الأحرف المسموح به هو 40.
description
سلسلة
(اختياري) 		وصف موجز للمهمة التي تؤديها الإضافة (جملة واحدة تقريبًا)
icon
سلسلة
(اختياري)

الملف لاستخدامه كرمز للإضافة على extensions.dev و وحدة تحكم Firebase.

يجب أن يكون هذا الملف بتنسيق PNG مربعًا بحجم يتراوح بين 512×512 و1024×1024 بكسل. ضَع الملف في الدليل نفسه مثل extension.yaml. CANNOT TRANSLATE لا يمكن تحديد دليل فرعي.

ضع الإرشادات التالية في الاعتبار عند تصميم أيقونة الإضافة:

  • اختَر ألوان الخلفية والأعمال الفنية المناسبة علامتك التجارية.
  • حافِظ على بساطة ألوان الرموز باستخدام لونَين فقط. ألوان متعددة يمكن أن تجعل الأيقونة مربكة بصريًا.
  • وللسبب ذاته، لا تستخدم تدرجات اللون في الأيقونة. التدرجات يصعب تمييزها بالأحجام الصغيرة وجعل الأيقونة للغاية.
  • استخدام صور بسيطة وفريدة لتوضيح مزايا إضافتك الوظيفة.
  • إذا كانت شركتك تنشئ إضافات متعددة، لا تستخدم شعارك الرمز. سيجد المستخدمون صعوبة في التمييز بين الإضافات.
  • اجعل العمل الفني رسمًا وغامقًا. لا تستخدم تعليقات دقيقة أو متقنة. والذي لن يتم عرضه جيدًا بأحجام أصغر.
  • ولا تضمِّن كلمات تشرح ما تفعله الإضافة. النص هو غير مقروء في الأحجام الأصغر.
tags
قائمة السلاسل
(اختياري) 		علامات لمساعدة المستخدمين على اكتشاف إضافتك يتم ربط العلامات التالية بالفئات في "مركز الإضافات": marketing, messaging, payments, search, shipping, social, utilities, ai
sourceUrl
سلسلة
(اختياري) 		عنوان URL العام الذي يمكن الوصول من خلاله إلى دليل الإضافات.
releaseNotesUrl
سلسلة
(اختياري) 		عنوان URL متاح للجميع يمكن من خلاله الوصول إلى ملاحظات الإصدار الخاصة بالإضافة.
author
عنصر مؤلف واحد
(اختياري)

تمثّل هذه السمة المؤلف الرئيسي وجهة التواصل المتعلقة بالإضافة.

author:
  authorName: Your Company
  email: extensions@example.com
  url: https://example.com/
حقول المؤلف
authorName
سلسلة
(مطلوب)

تمثّل هذه السمة اسم المؤلف.

يمكن أن تكون شخصًا أو شركة أو مؤسسة أو غير ذلك.
email
سلسلة
(اختياري) 		تمثّل هذه السمة عنوان البريد الإلكتروني للمؤلف.
url
سلسلة
(اختياري) 		عنوان URL عام يمكن من خلاله الوصول إلى معلومات حول المؤلف.
contributors
قائمة بكائنات المؤلف
(اختياري)

أي مؤلفين مساهمين إضافيين في الإضافة.

contributors:
  - authorName: Your Name
  - authorName: Another Contributor
    email: colleague@example.net
    url: https://github.com/their-org/
حقول المؤلف
authorName
سلسلة
(مطلوب)

تمثّل هذه السمة اسم المؤلف.

يمكن أن تكون شخصًا أو شركة أو مؤسسة أو غير ذلك.
email
سلسلة
(اختياري) 		تمثّل هذه السمة عنوان البريد الإلكتروني للمؤلف.
url
سلسلة
(اختياري) 		عنوان URL عام يمكن من خلاله الوصول إلى معلومات حول المؤلف.

Firebase وGoogle Cloud APIs

تحدّد هذه الحقول Firebase وGoogle APIs التي تستخدمها الإضافة. عندما يكون المستخدمون تثبيت الإضافة، يمكنهم اختيار تمكين واجهات برمجة التطبيقات هذه تلقائيًا في لمشروعهم.

apis:
  - apiName: apiname.googleapis.com
    reason: Explanation of why the extension uses this API
  - apiName: anotherapiname.googleapis.com
    reason: Explanation of why the extension uses this API
حقول واجهة برمجة التطبيقات
apiName
سلسلة
(مطلوب)

اسم واجهة برمجة تطبيقات Google

يجب أن يتوافق مع الحقل اسم الخدمة كما هو مذكور في كل صفحة النظرة العامة حول واجهة برمجة التطبيقات (مثال) في العمود مكتبة Google Cloud API

reason
سلسلة
(مطلوب) 		وصف موجز يوضِّح سبب احتياج الإضافة إلى استخدام واجهة برمجة التطبيقات هذه

أدوار "إدارة الهوية وإمكانية الوصول"

تحدّد هذه الحقول أدوار Cloud IAM التي تطلبها الإضافة. الخدمة تم منح هذه الأدوار للحساب المُدار للإضافة.

يمكنك تحديد سمة واحدة فقط الأدوار المتوافقة.

roles:
  - role: product.role
    reason: Explanation of why the extension needs this level of access
  - role: anotherproduct.role
    resource: projects/${project_id}/resource_type/*
    reason: Explanation of why the extension needs this level of access
حقول الأدوار
role
سلسلة
(مطلوب)

اسم دور "إدارة الهوية وإمكانية الوصول" المطلوب لتشغيل الإضافة

يجب أن تكون واحدة من الأدوار المتوافقة

reason
سلسلة
(مطلوب) 		وصف موجز لسبب احتياج الإضافة إلى إذن الوصول الممنوح هذا الدور
resource
سلسلة
(اختياري)

حصر نطاق الدور على هذا المورد.

وإذا تم حذفها، يتم ضبطها تلقائيًا على "projects/${project_id}". راجع تقليل نطاق الأدوار.

الخدمات الخارجية

تحدّد هذه الحقول الخدمات غير التابعة لـ Firebase والخدمات غير التابعة لـ Google التي تستخدمها الإضافة. (عادةً واجهات برمجة تطبيقات REST). لا يوفّر نظام إضافات Firebase أي طريقة تفعيل أو إجراء التفويض تلقائيًا لهذه الخدمات.

externalServices:
  - name: Example API
    pricingUri: https://developers.example.com/pricing
  - name: Another Example API
    pricingUri: https://developers.example.com/pricing
حقول الخدمات الخارجية
name
سلسلة
(مطلوب) 		اسم الخدمة الخارجية اللازمة لتشغيل الإضافة
pricingUri
سلسلة
(مطلوب) 		معرّف الموارد المنتظم (URI) لمعلومات التسعير الخاصة بالخدمة

المعلّمات القابلة للضبط من قِبل المستخدم

تحدِّد هذه الحقول المَعلمات التي تتيحها الإضافة للمستخدمين. التهيئة.

params:
  - param: PARAM_ID
    label: Short description of the parameter
    description: >-
      What do you want to set PARAM_ID to?
      This is a longer description of the parameter, often phrased as a prompt
      to the user.
  - param: ANOTHER_PARAM_ID
    label: Short description of the parameter
    description: >
      What do you want to set ANOTHER_PARAM_ID to?
      This is a longer description of the parameter.
    example: example-input
    validationRegex: "^[a-zA-Z][a-zA-Z-]*[a-zA-Z]?$"
    validationErrorMessage:
      Must be a hyphen-delimited string of alphabetic characters
    default: default-value
    required: false
    immutable: true
حقول المَعلمات
param
سلسلة
(مطلوب) 		اسم المَعلمة يمكنك استخدام هذا الاسم للإشارة إلى المَعلمة قيمة في التعليمة البرمجية.
label
سلسلة
(مطلوب) 		وصف موجز للمَعلمة يتم عرضها للمستخدم عندما المطلوبة لقيمة المعلمة.
description
سلسلة
(اختياري)

وصف تفصيلي للمَعلمة يتم عرضها للمستخدم عند تتم مطالبته بقيمة المعلمة.

يتيح استخدام Markdown.
example
سلسلة
(اختياري) 		مثال على قيمة المَعلمة
default
سلسلة
(اختياري) 		القيمة التلقائية للمَعلمة إذا ترك المستخدم قيمة المَعلمة فارغ.
validationRegex
سلسلة
(اختياري) 		تعبير عادي للتحقق من صحة ضبط المستخدم للمعلَمة Google RE2 البنية.
validationErrorMessage
سلسلة
(اختياري) 		رسالة خطأ تظهر في حال تعذُّر التحقّق من صحة التعبير العادي.
required
منطقية
(اختياري) 		تحدِّد هذه السياسة ما إذا كان يمكن للمستخدم إرسال سلسلة فارغة عندما المطلوبة لقيمة المعلمة. وتكون القيمة التلقائية هي true.
immutable
منطقية
(اختياري)

تحدد ما إذا كان يمكن للمستخدم تغيير قيمة المعلمة بعد التثبيت (مثلاً في حال إعادة ضبط الإضافة). الإعدادات التلقائية على false

ملاحظة: في حال تحديد "موقع جغرافي" معلَمة عملية النشر دوال الإضافة، قم بتعيين هذا الحقل على true.
type
سلسلة
(اختياري) 		نوع المَعلمة قد يكون لأنواع المعلَمات الخاصة أو متطلبات مختلفة أو عرضًا تقديميًا مختلفًا لواجهة المستخدم. يمكنك الاطّلاع على الأقسام التالية.

المَعلمات القابلة للاختيار والاختيار المتعدّد

تطلب المَعلمات القابلة للاختيار والقابلة للاختيار المتعدّد من المستخدمين الاختيار من قائمة خيارات محددة مسبقًا.

params:
  - param: PARAM_ID
    label: Short description of the parameter
    description: >-
      Do you want to enable the option?
    type: select
    options:
      - label: Yes
        value: true
      - label: No
        value: false
  - param: ANOTHER_PARAM_ID
    label: Short description of the parameter
    description: >-
      Which options do you want to enable?
    type: multiselect
    options:
      - value: red
      - value: green
      - value: blue
حقول المَعلمات المتعددة الخيارات
type
سلسلة

select أو multiselect

تُستخدَم لتحديد أنّ المَعلمة يمكن أن تكون قيمة واحدة (select). أو عدة قيم (multiselect) تم اختيارها من مجموعة من خيارات محددة مسبقًا
options
قائمة من الخيارات
(مطلوب)

الخيارات التي يمكن للمستخدم الاختيار من بينها

حقول الخيارات
value
سلسلة
(مطلوب) 		إحدى القيم التي يمكن للمستخدم اختيارها. هذه هي القيمة التي تحصل عليها عند قراءة قيمة المعلمة في التعليمة البرمجية.
label
سلسلة
(اختياري) 		وصف موجز للخيار القابل للاختيار. إذا تم حذفها، يتم تطبيق الإعدادات التلقائية إلى value.

مَعلمات الموارد القابلة للاختيار

تطلب مَعلمات الموارد القابلة للاختيار من المستخدمين اختيار مورد (قاعدة بيانات). مثلاً، دلو التخزين، وما إلى ذلك) من مشروعهم.

params:
  - param: PARAM_ID
    label: Short description of the parameter
    description: >-
      Which resource do you want to use?
    type: selectresource
    resourceType: product.googleapis.com/ResourceType
حقول مَعلمات الموارد
type
سلسلة

selectresource

تُحدِّد المَعلمة التي تمثِّل مورد المشروع.
resourceType
سلسلة
(مطلوب)

نوع المورد الذي سيطلب من المستخدم اختياره.

قيم صالحة:

  • storage.googleapis.com/Bucket
  • firestore.googleapis.com/Database
  • firebasedatabase.googleapis.com/DatabaseInstance

مع ذلك، تتضمّن حاليًا حزم Cloud Storage فقط واجهة مستخدم للخيارات. (يتم تقديم أنواع الموارد الأخرى كحقول إدخال نص ذا تصميم مرن).

المعلمات السرية

يتم التعامل مع القيم السرية التي يقدّمها المستخدم (مثل مفاتيح واجهة برمجة التطبيقات) بشكل مختلف:

  • يتم تخزين القيم السرية باستخدام Cloud Secret Manager. العملاء المعتمَدون فقط (مثل المثيل المثبَّت لإحدى الإضافات) يمكنه الوصول إلى هذه القيم.
  • عندما يُطلب من المستخدمين تقديم هذه القيم، لا يتم عرض البيانات التي أدخلوها.
params:
  - param: PARAM_ID
    label: Short description of the parameter
    description: >-
      What is the secret value?
    type: secret
حقول المَعلمات السرية
type
سلسلة

secret

لتحديد أن المعلمة هي قيمة سرية

موارد Cloud Function

توضّح هذه الحقول دوال السحابة الإلكترونية المضمَّنة في إحدى الإضافات. المورد بنية نموذج البيان تبدو مختلفة قليلاً بين الجيل الأول والجيل الثاني الدوال، والتي يمكن أن تتوفر معًا في امتداد معيّن.

وظائف السحابة الإلكترونية من الجيل الأول

resources:
  - name: functionName
    type: firebaseextensions.v1beta.function
    description: >-
      Description of what the function does. (One or two
      sentences.)
    properties:
      runtime: runtime-version
      eventTrigger:
        eventType: google.product.event
        resource: projects/_/resource/specifier
حقول الموارد
name
سلسلة
(مطلوب)

اسم سهل الاستخدام للدالة التي تم تصديرها.

في حال عدم تحديد السمة entryPoint (يُرجى الاطّلاع على أدناه)، يجب أن تتطابق هذه القيمة مع اسم الدالة في رمز المصدر للدوال.

سيكون الاسم النهائي للدالة deployed في التنسيق التالي: ext-extension-instance-id-name
type
سلسلة
(مطلوب) 		بالنسبة إلى مورد الدالة من الجيل الأول: firebaseextensions.v1beta.function
description
سلسلة
(مطلوب)

وصف موجز للمهمة التي تؤديها الدالة الإضافة.
properties
(مطلوب)

مواقع الجيل الأول من Cloud Functions أهم الخصائص مدرجة أدناه، ولكن يمكنك العثور على القائمة الكاملة في السحابة الإلكترونية مرجع الدوال

المواقع
location
(اختياري)

الموقع الذي سيتم نشر الدالة فيه. الإعدادات التلقائية على us-central1
entryPoint
(اختياري) 		اسم الدالة التي تم تصديرها داخل رمز مصدر الدوال التي يجب أن تبحث عنها الإضافة. الإعداد الافتراضي لقيمة name أعلاه.
sourceDirectory
(اختياري)

الدليل الذي يحتوي على package.json جذر. يجب أن يكون ملف رمز مصدر الدوال بهذا الدليل. القيمة التلقائية هي functions.

ملاحظة: الحقل main في package.json يحدد الملف الخاص بـ تعمل على رمز المصدر (مثل index.js).
timeout
(اختياري)

الحد الأقصى لوقت تنفيذ الدالة.

  • عناوين URL التلقائية: 60s
  • الحد الأقصى للقيمة: 540s
availableMemoryMb
(اختياري)

مساحة الذاكرة المتاحة للدالة بالميغابايت.

  • عناوين URL التلقائية: 256
  • القيم الصالحة هي: 128، 256، 512 و1024 و2048
runtime
(يُنصح به)

هي بيئة بيئة التشغيل للدالة.
httpsTrigger
أو
eventTrigger
أو
scheduleTrigger
أو
taskQueueTrigger
(يجب تحديد أحد أنواع عوامل تشغيل الدوال) 		راجع كتابة دوال السحابة الإلكترونية لإحدى الإضافات للحصول على معلومات محدَّدة حول كل نوع مشغل.

وظائف السحابة الإلكترونية من الجيل الثاني

resources:
  - name: functionName
    type: firebaseextensions.v1beta.v2function
    description: >-
      Description of what the function does. (One or two
      sentences.)
    properties:
      buildConfig:
        runtime: nodejs16
      serviceConfig:
        availableMemory: 512M
      eventTrigger:
        eventType: google.firebase.firebasealerts.alerts.v1.published
        triggerRegion: global
        eventFilters:
          - attribute: alerttype
            value: crashlytics.newFatalIssue
حقول الموارد
name
سلسلة
(مطلوب)

اسم سهل الاستخدام للدالة التي تم تصديرها.

في حال عدم تحديد السمة entryPoint (يُرجى الاطّلاع على أدناه)، يجب أن تتطابق هذه القيمة مع اسم الدالة في رمز المصدر للدوال.

سيكون الاسم النهائي للدالة deployed في التنسيق التالي: ext-extension-instance-id-name
type
سلسلة
(مطلوب) 		بالنسبة إلى مورد دالة من الجيل الثاني: firebaseextensions.v1beta.v2function
description
سلسلة
(مطلوب)

وصف موجز للمهمة التي تؤديها الدالة الإضافة.
properties
(مطلوب)

مواقع الجيل الثاني من Cloud Functions أهم الخصائص مدرجة أدناه، ولكن يمكنك العثور على القائمة الكاملة في السحابة الإلكترونية مرجع الدوال

المواقع
location
(اختياري)

الموقع الذي سيتم نشر الدالة فيه. الإعدادات التلقائية على us-central1
sourceDirectory
(اختياري)

الدليل الذي يحتوي على package.json جذر. يجب أن يكون ملف رمز مصدر الدوال بهذا الدليل. القيمة التلقائية هي functions.

ملاحظة: الحقل main في package.json يحدد الملف الخاص بـ تعمل على رمز المصدر (مثل index.js).

هناك أيضًا ثلاثة حقول من نوع الكائن لها خصائصها الخاصة:

مواقعbuildConfig
buildConfig.runtime
(يُنصح به)

هي بيئة بيئة التشغيل للدالة.
buildConfig.entryPoint
(اختياري) 		اسم الدالة التي تم تصديرها داخل رمز مصدر الدوال التي يجب أن تبحث عنها الإضافة. الإعداد الافتراضي لقيمة name أعلاه.
خصائص ServiceConfig
serviceConfig.timeoutSeconds
(اختياري)

الحد الأقصى لوقت تنفيذ الدالة.

  • عناوين URL التلقائية: 60
  • الحد الأقصى للقيمة: 540
serviceConfig.availableMemory
(اختياري) 		يشير ذلك المصطلح إلى مقدار الذاكرة المتاحة لإحدى الدوال. الإعدادات التلقائية على 256M الوحدات المسموح بها هي k، M وG وMi Gi إذا لم يتم تقديم أي وحدة، سيتم تفسير القيمة على أنّها وحدات بايت.
خصائص eventTrigger
eventTrigger.eventType
(مطلوب) 		نوع الحدث المطلوب الاستماع إليه. عرض كتابة السحابة الإلكترونية دوال الإضافات لأنواع الأحداث المتاحة لكل منتج.
eventTrigger.eventFilters
(اختياري) 		الفلاتر التي تفرض قيودًا على الأحداث للاستماع إليها على سبيل المثال: يمكنك فقط الاستماع إلى الأحداث التي تتطابق مع مورد معيّن النمط. عرض كتابة السحابة الإلكترونية دوال الإضافات للاطّلاع على معلومات حول فلترة كلٍّ منها لنوع الحدث.
eventTrigger.channel
(اختياري) 		اسم القناة المرتبطة بالعامل المشغِّل في projects/{project}/locations/{location}/channels/{channel} . إذا لم تستخدم هذه الخاصية، فستراعي الدالة الأحداث على القناة الافتراضية للمشروع.
eventTrigger.triggerRegion
(اختياري) 		ولن يتلقّى عامل التشغيل سوى الأحداث التي نشأت في هذه المنطقة. قد تكون نفس منطقة الدالة، أو منطقة مختلفة أو أو متعدد المناطق أو المنطقة العالمية. إذا لم يتم توفيره، يتم ضبطه تلقائيًا على نفس منطقة الدالة.

أحداث مراحل النشاط

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

lifecycleEvents:
  onInstall:
    function: myTaskFunction
    processingMessage: Describes the task being completed
  onUpdate:
    function: myOtherTaskFunction
    processingMessage: Describes the task being completed
  onConfigure:
    function: myOtherTaskFunction
    processingMessage: Describes the task being completed
حقول أحداث مراحل النشاط
onInstall
(اختياري)

تحدِّد هذه السياسة دالة يتم تشغيلها عندما يثبّت المستخدم الإضافة.

مواصفات الدوال
function
سلسلة
(مطلوب)

اسم الدالة التي يتم تشغيلها في قائمة الانتظار والتي ستتعامل مع الحدث.

يجب تعريف هذه الدالة في resources. ويكون taskقائمة المهام.
processingMessage
سلسلة
(مطلوب) 		رسالة لعرضها في "وحدة تحكُّم Firebase" عندما تكون المهمة التقدم.
onUpdate
(اختياري)

تحدِّد هذه السياسة دالة يتم تشغيلها عندما يعدِّل المستخدم دالة الإضافة.

مواصفات الدوال
function
سلسلة
(مطلوب)

اسم الدالة التي يتم تشغيلها في قائمة الانتظار والتي ستتعامل مع الحدث.

يجب تعريف هذه الدالة في resources. ويكون taskقائمة المهام.
processingMessage
سلسلة
(مطلوب) 		رسالة لعرضها في "وحدة تحكُّم Firebase" عندما تكون المهمة التقدم.
onConfigure
(اختياري)

تحدِّد هذه السياسة دالة يتم تشغيلها عندما يُعيد المستخدم ضبط الإضافة.

مواصفات الدوال
function
سلسلة
(مطلوب)

اسم الدالة التي يتم تشغيلها في قائمة الانتظار والتي ستتعامل مع الحدث.

يجب تعريف هذه الدالة في resources. ويكون taskقائمة المهام.
processingMessage
سلسلة
(مطلوب) 		رسالة لعرضها في "وحدة تحكُّم Firebase" عندما تكون المهمة التقدم.

الأحداث المخصّصة (Eventarc)

الأحداث المخصّصة هي أحداث تُصدرها الإضافة للسماح للمستخدمين بإدراجها. منطقه الخاص في إضافتك. اطّلِع على قسم Eventarc في أضِف عناصر الجذب للمستخدمين إلى إحدى الإضافات.

events:
  - type: publisher-id.extension-name.version.event-name
    description: Description of the event
  - type: publisher-id.extension-name.version.another-event-name
    description: Description of the other event
حقول الأحداث المخصّصة
type
سلسلة
(مطلوب) 		معرّف النوع للحدث. إنشاء المعرّف باستخدام أرقام من 3 إلى 4 الحقول المفصولة بالنقاط: الرقم التعريفي للناشر واسم الإضافة واسم الحدث الحقول مطلوبة؛ يوصى بحقل الإصدار. يمكنك اختيار واسم حدث وصفي لكل نوع حدث تنشره.
description
سلسلة
(مطلوب) 		تمثّل هذه السمة وصف الفعالية.