<meta-data>

بناء الجملة:

<meta-data android:name="string"
           android:resource="resource specification"
           android:value="string" />

المضمَّنة في:

<activity>
<activity-alias>
<application>
<provider>
<receiver>
<service>

description:

زوج من الاسم والقيمة لعنصر من بيانات إضافية عشوائية يمكن تقديمه للمكوِّن الرئيسي. يمكن أن يحتوي عنصر المكوِّن على أي عدد من عناصر <meta-data> الفرعية. يتم جمع القيم منها جميعًا في عنصر Bundle واحد وإتاحتها للمكون كحقل PackageItemInfo.metaData.

حدِّد قيمًا عادية من خلال السمة value. لتعيين رقم تعريف مورد كقيمة، استخدِم السمة resource بدلاً من ذلك. على سبيل المثال، يعيّن الرمز التالي أي قيمة مخزنة في مورد @string/kangaroo لاسم zoo:

<meta-data android:name="zoo" android:value="@string/kangaroo" />

من ناحية أخرى، يؤدي استخدام السمة resource إلى تعيين zoo للمعرّف الرقمي للمورد، وليس القيمة المخزنة في المورد:

<meta-data android:name="zoo" android:resource="@string/kangaroo" />

ننصحك بشدة بتجنّب توفير البيانات ذات الصلة كعدة إدخالات <meta-data> منفصلة. بدلاً من ذلك، إذا كانت لديك بيانات معقّدة لربطها بالمكوِّن، خزِّنها كمورد واستخدِم السمة resource لتحديد معرّفه.

السمات:

android:name

اسم فريد للعنصر. لجعل الاسم فريدًا، استخدِم اصطلاح تسمية على نمط JavaScript، مثل "com.example.project.activity.fred".

android:resource

مرجع لمورد معرف المورد هو القيمة المخصصة للعنصر. يتم استرداد رقم التعريف من Bundle للبيانات الوصفية باستخدام طريقة Bundle.getInt().

android:value

القيمة التي تم تحديدها للعنصر يتم عرض أنواع البيانات التي يمكن تحديدها كقيم وطرق Bundle التي تستخدمها المكوّنات لاسترداد هذه القيم في الجدول التالي:

Type	طريقة الحزمة
سلسلة: استخدِم الشرطات المائلة للخلف المزدوجة (\\) لإلغاء الأحرف، مثل \\n لسطر جديد و\\uxxxxx لحرف Unicode.	getString()
عدد صحيح: على سبيل المثال، 100	getInt()
منطقية: إما true أو false	getBoolean()
اللون: بالشكل #rgb أو #argb أو #rrggbb أو #aarrggbb	getInt()
التعويم: على سبيل المثال، 1.23	getFloat()

تم تقديمه في:

المستوى 1 من واجهة برمجة التطبيقات