<متا داده>

نحو:

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

موجود در:

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

توضیحات:

یک جفت نام-مقدار برای یک مورد از داده‌های دلخواه اضافی که می‌تواند به مؤلفه والد ارائه شود. یک عنصر کامپوننت می‌تواند حاوی هر تعداد از عناصر فرعی <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

یک نام منحصر به فرد برای کالا برای منحصر به فرد نگه داشتن نام، از یک قرارداد نامگذاری به سبک جاوا، مانند " com.example.project.activity.fred " استفاده کنید.

android:resource

ارجاع به یک منبع شناسه منبع مقداری است که به آیتم اختصاص داده شده است. شناسه با استفاده از متد Bundle.getInt() از Bundle متا داده بازیابی می شود.

android:value

مقدار اختصاص داده شده به مورد. انواع داده هایی که می توانند به عنوان مقادیر اختصاص داده شوند و روش های Bundle که کامپوننت ها برای بازیابی آن مقادیر استفاده می کنند در جدول زیر فهرست شده اند:

تایپ کنید	روش باندل
رشته: برای فرار از کاراکترها از بک اسلش های دوتایی ( \\ ) استفاده کنید، مانند \\n برای یک خط جدید و \\uxxxxx برای یک کاراکتر یونیکد	getString()
عدد صحیح: برای مثال 100	getInt()
بولی: یا true یا false	getBoolean()
رنگ: به شکل #rgb ، #argb ، #rrggbb ، یا #aarrggbb	getInt()
Float: به عنوان مثال، 1.23	getFloat()

معرفی شده در:

API سطح 1