سند تعریف سازگاری Android 4.0

ویرایش 4
آخرین به روز رسانی: 21 آوریل 2013

حق نشر © 2012، Google Inc. کلیه حقوق محفوظ است.
compatibility@android.com

فهرست مطالب

1. معرفی
2. منابع
3. نرم افزار
3.1. سازگاری API مدیریت شده
3.2. سازگاری نرم افزار API
3.3. سازگاری Native API
3.4. سازگاری وب
3.5. سازگاری رفتاری API
3.6. فضاهای نام API
3.7. سازگاری با ماشین مجازی
3.8. سازگاری با رابط کاربری
3.9 مدیریت دستگاه
3.10 دسترسی
3.11 تبدیل متن به گفتار
4. سازگاری بسته بندی برنامه
5. سازگاری چند رسانه ای
6. سازگاری با ابزار توسعه دهنده
7. سازگاری سخت افزار
7.1. نمایشگر و گرافیک
7.2. دستگاه های ورودی
7.3. حسگرها
7.4. اتصال داده
7.5. دوربین ها
7.6. حافظه و ذخیره سازی
7.7. یو اس بی
8. سازگاری با عملکرد
9. سازگاری مدل امنیتی
10. تست سازگاری نرم افزار
11. نرم افزار قابل به روز رسانی
12. تماس با ما
ضمیمه A - روش تست بلوتوث

1. معرفی

این سند شرایطی را که باید برای سازگاری دستگاه‌ها با Android 4.0 رعایت شود، برشمرده است.

استفاده از "باید"، "نباید"، "لازم"، "باید"، "نباید"، "باید"، "نباید"، "توصیه شده"، "ممکن است" و "اختیاری" طبق استاندارد IETF است. تعریف شده در RFC2119 [ منابع، 1 ].

همانطور که در این سند استفاده می‌شود، «پیاده‌کننده دستگاه» یا «اجراکننده» شخص یا سازمانی است که راه‌حل سخت‌افزار/نرم‌افزاری را با Android 4.0 توسعه می‌دهد. "پیاده سازی دستگاه" یا "پیاده سازی" راه حل سخت افزاری/نرم افزاری است که به این شکل توسعه یافته است.

برای اینکه پیاده‌سازی‌های دستگاه با Android 4.0 سازگار در نظر گرفته شوند، باید الزامات ارائه‌شده در این تعریف سازگاری، از جمله هر سندی که از طریق مرجع گنجانده شده‌اند، داشته باشند.

در مواردی که این تعریف یا تست‌های نرم‌افزاری توضیح داده شده در بخش 10 بی‌صدا، مبهم یا ناقص است، این مسئولیت اجرای دستگاه است که از سازگاری با پیاده‌سازی‌های موجود اطمینان حاصل کند.

به همین دلیل، پروژه منبع باز اندروید [ منابع، 3 ] هم مرجع و هم پیاده سازی ترجیحی اندروید است. پیاده‌سازان دستگاه به شدت تشویق می‌شوند تا پیاده‌سازی‌های خود را تا حد امکان بر اساس کد منبع «بالادست» موجود در پروژه منبع باز Android قرار دهند. در حالی که برخی از مؤلفه‌ها را می‌توان به طور فرضی با پیاده‌سازی‌های جایگزین جایگزین کرد، این عمل به شدت ممنوع است، زیرا گذراندن آزمون‌های نرم‌افزار به طور قابل‌توجهی دشوارتر می‌شود. این مسئولیت پیاده‌کننده است که از سازگاری کامل رفتاری با پیاده‌سازی استاندارد Android، از جمله و فراتر از مجموعه تست سازگاری اطمینان حاصل کند. در نهایت، توجه داشته باشید که تعویض و اصلاح برخی از اجزا به صراحت توسط این سند ممنوع است.

2. منابع

  1. سطوح مورد نیاز IETF RFC2119: http://www.ietf.org/rfc/rfc2119.txt
  2. مروری بر برنامه سازگاری اندروید: http://source.android.com/docs/compatibility/index.html
  3. پروژه متن باز اندروید: http://source.android.com/
  4. تعاریف و مستندات API: http://developer.android.com/reference/packages.html
  5. مرجع مجوزهای Android: http://developer.android.com/reference/android/Manifest.permission.html
  6. مرجع android.os.Build: http://developer.android.com/reference/android/os/Build.html
  7. رشته های نسخه مجاز Android 4.0: http://source.android.com/docs/compatibility/4.0/versions.html
  8. Renderscript: http://developer.android.com/guide/topics/graphics/renderscript.html
  9. شتاب سخت افزار: http://developer.android.com/guide/topics/graphics/hardware-accel.html
  10. کلاس android.webkit.WebView: http://developer.android.com/reference/android/webkit/WebView.html
  11. HTML5: http://www.whatwg.org/specs/web-apps/current-work/multipage/
  12. قابلیت های آفلاین HTML5: http://dev.w3.org/html5/spec/Overview.html#offline
  13. برچسب ویدیوی HTML5: http://dev.w3.org/html5/spec/Overview.html#video
  14. HTML5/W3C geolocation API: http://www.w3.org/TR/geolocation-API/
  15. API پایگاه داده وب HTML5/W3C: http://www.w3.org/TR/webdatabase/
  16. HTML5/W3C IndexedDB API: http://www.w3.org/TR/IndexedDB/
  17. مشخصات ماشین مجازی Dalvik: در کد منبع Android در dalvik/docs موجود است
  18. AppWidgets: http://developer.android.com/guide/practices/ui_guidelines/widget_design.html
  19. اعلان ها: http://developer.android.com/guide/topics/ui/notifiers/notifications.html
  20. منابع برنامه: http://code.google.com/android/reference/available-resources.html
  21. راهنمای سبک نماد نوار وضعیت: http://developer.android.com/guide/practices/ui_guideline /icon_design.html#statusbarstructure
  22. مدیر جستجو: http://developer.android.com/reference/android/app/SearchManager.html
  23. نان تست: http://developer.android.com/reference/android/widget/Toast.html
  24. تم ها: http://developer.android.com/guide/topics/ui/themes.html
  25. کلاس R.style: http://developer.android.com/reference/android/R.style.html
  26. تصاویر پس زمینه زنده: https://android-developers.googleblog.com/2010/02/live-wallpapers.html
  27. مدیریت دستگاه Android: http://developer.android.com/guide/topics/admin/device-admin.html
  28. کلاس android.app.admin.DevicePolicyManager: http://developer.android.com/reference/android/app/admin/DevicePolicyManager.html
  29. APIهای سرویس دسترس‌پذیری Android: http://developer.android.com/reference/android/accessibilityservice/package-summary.html
  30. APIهای دسترسی Android: http://developer.android.com/reference/android/view/accessibility/package-summary.html
  31. پروژه Eyes Free: http://code.google.com/p/eyes-free
  32. APIهای Text-To-Speech: http://developer.android.com/reference/android/speech/tts/package-summary.html
  33. مستندات ابزار مرجع (برای adb، aapt، ddms): http://developer.android.com/guide/developing/tools/index.html
  34. توضیحات فایل apk اندروید: http://developer.android.com/guide/topics/fundamentals.html
  35. فایل های مانیفست: http://developer.android.com/guide/topics/manifest/manifest-intro.html
  36. ابزار تست میمون: https://developer.android.com/studio/test/other-testing-tools/monkey
  37. Android android.content.pm.PackageManager کلاس و لیست ویژگی های سخت افزار: http://developer.android.com/reference/android/content/pm/PackageManager.html
  38. پشتیبانی از چند صفحه: http://developer.android.com/guide/practices/screens_support.html
  39. android.util.DisplayMetrics: http://developer.android.com/reference/android/util/DisplayMetrics.html
  40. android.content.res.Configuration: http://developer.android.com/reference/android/content/res/Configuration.html
  41. android.hardware.SensorEvent: http://developer.android.com/reference/android/hardware/SensorEvent.html
  42. API بلوتوث: http://developer.android.com/reference/android/bluetooth/package-summary.html
  43. NDEF Push Protocol: http://source.android.com/docs/compatibility/ndef-push-protocol.pdf
  44. MIFARE MF1S503X: http://www.nxp.com/documents/data_sheet/MF1S503x.pdf
  45. MIFARE MF1S703X: http://www.nxp.com/documents/data_sheet/MF1S703x.pdf
  46. MIFARE MF0ICU1: http://www.nxp.com/documents/data_sheet/MF0ICU1.pdf
  47. MIFARE MF0ICU2: http://www.nxp.com/documents/short_data_sheet/MF0ICU2_SDS.pdf
  48. MIFARE AN130511: http://www.nxp.com/documents/application_note/AN130511.pdf
  49. MIFARE AN130411: http://www.nxp.com/documents/application_note/AN130411.pdf
  50. API جهت‌گیری دوربین: http://developer.android.com/reference/android/hardware/Camera.html#setDisplayOrientation(int)
  51. android.hardware.Camera: http://developer.android.com/reference/android/hardware/Camera.html
  52. لوازم جانبی باز اندروید: http://developer.android.com/guide/topics/usb/accessory.html
  53. USB Host API: http://developer.android.com/guide/topics/usb/host.html
  54. مرجع امنیت و مجوزهای Android: http://developer.android.com/guide/topics/security/security.html
  55. برنامه های اندروید: http://code.google.com/p/apps-for-android
  56. کلاس android.app.DownloadManager: http://developer.android.com/reference/android/app/DownloadManager.html
  57. انتقال فایل اندروید: http://www.android.com/filetransfer
  58. قالب‌های رسانه اندروید: http://developer.android.com/guide/appendix/media-formats.html
  59. پروتکل پیش‌نویس پخش جریانی زنده HTTP: http://tools.ietf.org/html/draft-pantos-http-live-streaming-03
  60. Motion Event API: http://developer.android.com/reference/android/view/MotionEvent.html
  61. پیکربندی ورودی لمسی: http://source.android.com/tech/input/touch-devices.html

بسیاری از این منابع به طور مستقیم یا غیرمستقیم از Android 4.0 SDK مشتق شده اند و از نظر عملکردی با اطلاعات موجود در اسناد آن SDK یکسان خواهند بود. در هر موردی که این تعریف سازگاری یا مجموعه تست سازگاری با مستندات SDK مخالف باشد، اسناد SDK معتبر تلقی می‌شوند. هر گونه جزئیات فنی ارائه شده در مراجع ذکر شده در بالا به عنوان بخشی از این تعریف سازگاری در نظر گرفته می شود.

3. نرم افزار

3.1. سازگاری API مدیریت شده

محیط اجرای مدیریت شده (مبتنی بر دالویک) وسیله اصلی برنامه های اندروید است. رابط برنامه نویسی برنامه اندروید (API) مجموعه ای از رابط های پلتفرم اندروید است که در معرض برنامه های کاربردی در حال اجرا در محیط VM مدیریت شده قرار دارند. پیاده‌سازی‌های دستگاه باید پیاده‌سازی‌های کامل، از جمله همه رفتارهای مستند، هر API مستندی را که توسط Android 4.0 SDK در معرض دید قرار می‌گیرد [ منابع، 4 ] ارائه دهد.

پیاده‌سازی‌های دستگاه نباید هیچ‌یک از APIهای مدیریت‌شده را حذف کنند، رابط‌ها یا امضاهای API را تغییر دهند، از رفتار مستند منحرف شوند، یا شامل موارد بدون عملیات باشند، مگر در مواردی که به‌طور خاص توسط این تعریف سازگاری مجاز است.

این تعریف سازگاری اجازه می‌دهد برخی از انواع سخت‌افزاری که Android برای آن‌ها دارای API است توسط پیاده‌سازی دستگاه حذف شوند. در چنین مواردی، APIها باید همچنان وجود داشته باشند و به روشی معقول رفتار کنند. برای شرایط خاص این سناریو به بخش 7 مراجعه کنید.

3.2. سازگاری نرم افزار API

علاوه بر APIهای مدیریت شده از بخش 3.1، Android همچنین شامل یک API "نرم" فقط زمان اجرا قابل توجه است، به شکل مواردی مانند Intent ها، مجوزها، و جنبه های مشابه برنامه های Android که در زمان کامپایل برنامه قابل اجرا نیستند.

3.2.1. مجوزها

پیاده‌کننده‌های دستگاه باید تمام ثابت‌های مجوز را همانطور که در صفحه مرجع مجوز [ منابع، 5 ] مستند شده است، پشتیبانی و اجرا کنند. توجه داشته باشید که بخش 10 الزامات اضافی مربوط به مدل امنیتی اندروید را فهرست می کند.

3.2.3. ساخت پارامترها

APIهای Android شامل تعدادی ثابت در کلاس android.os.Build [ منابع، 6 ] هستند که برای توصیف دستگاه فعلی در نظر گرفته شده است. برای ارائه مقادیر معنادار و منسجم در بین پیاده‌سازی‌های دستگاه، جدول زیر شامل محدودیت‌های اضافی در قالب‌های این مقادیر است که پیاده‌سازی دستگاه باید با آنها مطابقت داشته باشد.

پارامتر نظرات
android.os.Build.VERSION.RELEASE نسخه سیستم اندروید در حال اجرا، در قالب قابل خواندن توسط انسان. این فیلد باید دارای یکی از مقادیر رشته تعریف شده در [ منابع، 7 ] باشد.
android.os.Build.VERSION.SDK نسخه سیستم Android در حال اجرا، در قالبی که برای کد برنامه شخص ثالث قابل دسترسی است. برای Android 4.0.1 - 4.0.2، این فیلد باید مقدار صحیح 14 را داشته باشد. برای Android 4.0.3 یا بالاتر، این فیلد باید دارای مقدار صحیح 15 ​​باشد.
android.os.Build.VERSION.SDK_INT نسخه سیستم Android در حال اجرا، در قالبی که برای کد برنامه شخص ثالث قابل دسترسی است. برای Android 4.0.1 - 4.0.2، این فیلد باید مقدار صحیح 14 را داشته باشد. برای Android 4.0.3 یا بالاتر، این فیلد باید دارای مقدار صحیح 15 ​​باشد.
android.os.Build.VERSION.INCREMENTAL مقداری که توسط پیاده‌کننده دستگاه انتخاب شده است که ساختار خاص سیستم Android در حال اجرا را در قالب قابل خواندن توسط انسان تعیین می‌کند. این مقدار نباید برای ساخت‌های مختلفی که در دسترس کاربران نهایی قرار گرفته‌اند دوباره استفاده شود. یک استفاده معمولی از این فیلد این است که نشان دهد کدام شماره ساخت یا شناسه تغییر منبع-کنترل برای تولید بیلد استفاده شده است. هیچ الزامی برای قالب خاص این فیلد وجود ندارد، به جز اینکه نباید خالی یا رشته خالی ("") باشد.
android.os.Build.BOARD مقداری که توسط پیاده‌کننده دستگاه انتخاب می‌شود و سخت‌افزار داخلی خاص مورد استفاده دستگاه را در قالب قابل خواندن توسط انسان شناسایی می‌کند. یکی از کاربردهای احتمالی این فیلد نشان دادن بازبینی خاص برد تغذیه کننده دستگاه است. مقدار این فیلد باید به صورت ASCII 7 بیتی قابل رمزگذاری باشد و با عبارت منظم "^[a-zA-Z0-9.,_-]+$" مطابقت داشته باشد.
android.os.Build.BRAND مقداری که توسط پیاده‌کننده دستگاه انتخاب می‌شود و نام شرکت، سازمان، فردی و غیره را که دستگاه را تولید کرده است، در قالب قابل خواندن توسط انسان مشخص می‌کند. استفاده احتمالی از این فیلد نشان دادن OEM و/یا حاملی است که دستگاه را فروخته است. مقدار این فیلد باید به صورت ASCII 7 بیتی قابل رمزگذاری باشد و با عبارت منظم "^[a-zA-Z0-9.,_-]+$" مطابقت داشته باشد.
android.os.Build.CPU_ABI نام مجموعه دستورالعمل (نوع CPU + قرارداد ABI) کد بومی. به بخش 3.3: سازگاری Native API مراجعه کنید.
android.os.Build.CPU_ABI2 نام مجموعه دستورات دوم (نوع CPU + قرارداد ABI) کد بومی. به بخش 3.3: سازگاری Native API مراجعه کنید.
android.os.Build.DEVICE مقداری که توسط پیاده‌کننده دستگاه انتخاب می‌شود و پیکربندی یا بازبینی خاص بدنه (که گاهی «طراحی صنعتی» نامیده می‌شود) دستگاه را مشخص می‌کند. مقدار این فیلد باید به صورت ASCII 7 بیتی قابل رمزگذاری باشد و با عبارت منظم "^[a-zA-Z0-9.,_-]+$" مطابقت داشته باشد.
android.os.Build.FINGERPRINT رشته ای که به طور منحصر به فرد این ساخت را مشخص می کند. باید به طور منطقی برای انسان قابل خواندن باشد. باید از این الگو پیروی کند:
$(BRAND)/$(PRODUCT)/$(DEVICE):$(VERSION.RELEASE)/$(ID)/$(VERSION.INCREMENTAL):$(TYPE)/$(TAGS)
مثلا:
acme/mydevice/generic:4.0/IRK77/3359:userdebug/test-keys
اثر انگشت نباید شامل کاراکترهای فضای خالی باشد. اگر سایر فیلدهای موجود در الگوی بالا دارای نویسه‌های فضای خالی هستند، آنها باید در اثر انگشت ساخت با نویسه دیگری مانند نویسه زیرخط ("_") جایگزین شوند. مقدار این فیلد باید به صورت ASCII 7 بیتی قابل رمزگذاری باشد.
android.os.Build.HARDWARE نام سخت افزار (از خط فرمان هسته یا /proc). باید به طور منطقی برای انسان قابل خواندن باشد. مقدار این فیلد باید به صورت ASCII 7 بیتی قابل رمزگذاری باشد و با عبارت منظم "^[a-zA-Z0-9.,_-]+$" مطابقت داشته باشد.
android.os.Build.HOST رشته ای که به طور منحصر به فرد میزبانی را که ساخت بر روی آن ساخته شده است، در قالب قابل خواندن توسط انسان، شناسایی می کند. هیچ الزامی برای قالب خاص این فیلد وجود ندارد، به جز اینکه نباید خالی یا رشته خالی ("") باشد.
android.os.Build.ID شناسه‌ای که توسط پیاده‌کننده دستگاه برای ارجاع به یک نسخه خاص، در قالب قابل خواندن توسط انسان انتخاب شده است. این فیلد می تواند همان android.os.Build.VERSION.INCREMENTAL باشد، اما باید مقداری باشد که به اندازه کافی معنی دار باشد تا کاربران نهایی بتوانند بین ساخت های نرم افزار تمایز قائل شوند. مقدار این فیلد باید به صورت ASCII 7 بیتی قابل رمزگذاری باشد و با عبارت منظم "^[a-zA-Z0-9.,_-]+$" مطابقت داشته باشد.
android.os.Build.MANUFACTURER نام تجاری سازنده اصلی تجهیزات (OEM) محصول. هیچ الزامی برای قالب خاص این فیلد وجود ندارد، به جز اینکه نباید خالی یا رشته خالی ("") باشد.
android.os.Build.MODEL مقداری که توسط پیاده‌کننده دستگاه انتخاب شده و حاوی نام دستگاهی است که کاربر نهایی آن را می‌شناسد. این باید همان نامی باشد که دستگاه تحت آن به بازار عرضه شده و به کاربران نهایی فروخته می شود. هیچ الزامی برای قالب خاص این فیلد وجود ندارد، به جز اینکه نباید خالی یا رشته خالی ("") باشد.
android.os.Build.PRODUCT مقداری که توسط پیاده‌کننده دستگاه انتخاب می‌شود و حاوی نام توسعه یا کد نام محصول (SKU) است. باید برای انسان قابل خواندن باشد، اما لزوماً برای مشاهده توسط کاربران نهایی در نظر گرفته نشده است. مقدار این فیلد باید به صورت ASCII 7 بیتی قابل رمزگذاری باشد و با عبارت منظم "^[a-zA-Z0-9.,_-]+$" مطابقت داشته باشد.
android.os.Build.SERIAL شماره سریال سخت افزاری، در صورت موجود بودن. مقدار این فیلد باید به صورت ASCII 7 بیتی قابل رمزگذاری باشد و با عبارت منظم "^([a-zA-Z0-9]{0,20})$" مطابقت داشته باشد.
android.os.Build.TAGS فهرستی از برچسب‌های جدا شده با کاما که توسط پیاده‌کننده دستگاه انتخاب شده‌اند که ساخت را بیشتر متمایز می‌کند. به عنوان مثال، "unsigned, debug". مقدار این فیلد باید به صورت ASCII 7 بیتی قابل رمزگذاری باشد و با عبارت منظم "^[a-zA-Z0-9.,_-]+$" مطابقت داشته باشد.
android.os.Build.TIME مقداری که نشان‌دهنده مُهر زمانی زمان وقوع ساخت است.
android.os.Build.TYPE مقداری که توسط پیاده‌کننده دستگاه انتخاب شده و پیکربندی زمان اجرا ساخت را مشخص می‌کند. این فیلد باید یکی از مقادیر مربوط به سه پیکربندی معمول زمان اجرا اندروید را داشته باشد: "user"، "userdbug"، یا "eng". مقدار این فیلد باید به صورت ASCII 7 بیتی قابل رمزگذاری باشد و با عبارت منظم "^[a-zA-Z0-9.,_-]+$" مطابقت داشته باشد.
android.os.Build.USER نام یا شناسه کاربری کاربر (یا کاربر خودکار) که ساخت را ایجاد کرده است. هیچ الزامی برای قالب خاص این فیلد وجود ندارد، به جز اینکه نباید خالی یا رشته خالی ("") باشد.

3.2.3. سازگاری قصد

پیاده‌سازی‌های دستگاه باید از سیستم Intent با اتصال شل، همانطور که در بخش‌های زیر توضیح داده شده است، احترام بگذارند. منظور از "honored" این است که پیاده‌کننده دستگاه باید یک فعالیت یا سرویس Android ارائه دهد که فیلتر Intent منطبق را مشخص می‌کند و به هر الگوی Intent مشخص شده متصل می‌شود و رفتار صحیح را اجرا می‌کند.

3.2.3.1. اهداف اصلی برنامه

پروژه upstream اندروید تعدادی برنامه اصلی مانند مخاطبین، تقویم، گالری عکس، پخش کننده موسیقی و غیره را تعریف می کند. پیاده‌کننده‌های دستگاه ممکن است این برنامه‌ها را با نسخه‌های جایگزین جایگزین کنند.

با این حال، هر گونه نسخه جایگزین باید از همان الگوهای Intent ارائه شده توسط پروژه بالادستی استفاده کند. به عنوان مثال، اگر دستگاهی حاوی یک پخش کننده موسیقی جایگزین باشد، همچنان باید الگوی Intent صادر شده توسط برنامه های شخص ثالث را برای انتخاب آهنگ رعایت کند.

برنامه های زیر به عنوان برنامه های اصلی سیستم اندروید در نظر گرفته می شوند:

  • ساعت رومیزی
  • مرورگر
  • تقویم
  • مخاطب
  • آلبوم عکس
  • جستجوی جهانی
  • پرتاب کننده
  • موسیقی
  • تنظیمات

برنامه های اصلی سیستم اندروید شامل اجزای مختلف Activity یا Service هستند که "عمومی" در نظر گرفته می شوند. به این معنی که ویژگی "android:exported" ممکن است وجود نداشته باشد یا مقدار "true" را داشته باشد.

برای هر فعالیت یا سرویسی که در یکی از برنامه‌های اصلی سیستم Android تعریف شده است و از طریق ویژگی android:exported با مقدار "false" به‌عنوان غیرعمومی علامت‌گذاری نشده است، پیاده‌سازی دستگاه باید شامل یک جزء از همان نوع باشد که فیلتر Intent یکسان را اجرا می‌کند. الگوها به عنوان برنامه اصلی سیستم اندروید.

به عبارت دیگر، پیاده سازی دستگاه ممکن است جایگزین برنامه های اصلی سیستم اندروید شود. با این حال، اگر چنین باشد، پیاده‌سازی دستگاه باید از همه الگوهای Intent که توسط هر برنامه اصلی سیستم اندرویدی که جایگزین می‌شود، پشتیبانی کند.

3.2.3.2. نادیده گرفتن قصد

از آنجایی که Android یک پلتفرم توسعه‌پذیر است، پیاده‌سازی دستگاه باید به هر الگوی Intent اشاره‌شده در بخش 3.2.3.2 اجازه دهد که توسط برنامه‌های شخص ثالث لغو شود. اجرای متن باز اندروید بالادستی به طور پیش فرض این امکان را می دهد. پیاده‌کننده‌های دستگاه نباید امتیازات ویژه‌ای را به استفاده برنامه‌های سیستمی از این الگوهای Intent اختصاص دهند یا از اتصال برنامه‌های شخص ثالث به این الگوها و کنترل آن‌ها جلوگیری کنند. این ممنوعیت به طور خاص شامل غیرفعال کردن رابط کاربری "انتخاب کننده" است که به کاربر اجازه می دهد بین برنامه های متعددی که همه یک الگوی Intent را مدیریت می کنند، انتخاب کند، اما محدود به آن نمی شود.

3.2.3.3. Intent Namespaces

پیاده‌سازی‌های دستگاه نباید شامل هیچ مؤلفه Android باشد که با استفاده از ACTION، CATEGORY یا رشته‌های کلیدی دیگر در فضای نام android.* یا com.android.*، از الگوهای Intent یا Broadcast Intent جدید استفاده می‌کند. پیاده‌کننده‌های دستگاه نباید دارای اجزای Android باشند که از الگوهای Intent یا Broadcast Intent با استفاده از ACTION، CATEGORY یا رشته‌های کلیدی دیگر در فضای بسته متعلق به سازمان دیگری استفاده می‌کنند. پیاده‌کننده‌های دستگاه نباید هیچ یک از الگوهای Intent را که توسط برنامه‌های اصلی فهرست‌شده در بخش 3.2.3.1 استفاده می‌شود، تغییر داده یا گسترش دهند. پیاده‌سازی‌های دستگاه ممکن است شامل الگوهای Intent با استفاده از فضاهای نام به وضوح و واضح با سازمان خود باشد.

این ممنوعیت مشابه آن چیزی است که برای کلاس های زبان جاوا در بخش 3.6 مشخص شده است.

3.2.3.4. اهداف پخش

برنامه های شخص ثالث برای پخش Intent های خاص به پلتفرم متکی هستند تا تغییرات در محیط سخت افزاری یا نرم افزاری را به آنها اطلاع دهند. دستگاه های سازگار با Android باید Intent های پخش عمومی را در پاسخ به رویدادهای سیستم مناسب پخش کنند. اهداف پخش در مستندات SDK توضیح داده شده است.

3.3. سازگاری Native API

3.3.1 رابط های باینری برنامه

کدهای مدیریت شده در حال اجرا در Dalvik می توانند به کد بومی ارائه شده در فایل apk برنامه کاربردی به عنوان یک فایل ELF .so که برای معماری سخت افزاری مناسب دستگاه کامپایل شده است فراخوانی کند. از آنجایی که کد بومی به شدت به فناوری پردازنده اصلی وابسته است، Android تعدادی رابط باینری برنامه (ABI) را در Android NDK در فایل docs/CPU-ARCH-ABIS.txt تعریف می‌کند. اگر پیاده‌سازی دستگاه با یک یا چند ABI تعریف‌شده سازگار باشد، باید مطابق زیر با Android NDK سازگاری داشته باشد.

اگر پیاده سازی دستگاه شامل پشتیبانی از Android ABI باشد، این موارد:

  • باید شامل پشتیبانی از کدهای در حال اجرا در محیط مدیریت شده برای فراخوانی کد بومی، با استفاده از معناشناسی استاندارد Java Native Interface (JNI) باشد.
  • باید با منبع سازگار (یعنی سازگار با هدر) و سازگار با دودویی (برای ABI) با هر کتابخانه مورد نیاز در لیست زیر باشد.
  • باید به طور دقیق رابط باینری برنامه (ABI) پشتیبانی شده توسط دستگاه را از طریق android.os.Build.CPU_ABI API گزارش کند.
  • باید فقط آن دسته از ABI های مستند شده در آخرین نسخه Android NDK را در فایل docs/CPU-ARCH-ABIS.txt گزارش کند.
  • باید با استفاده از کد منبع و فایل‌های هدر موجود در پروژه منبع باز اندروید بالادست ساخته شود

APIهای کد اصلی زیر باید برای برنامه‌هایی که شامل کد بومی هستند در دسترس باشند:

  • libc (کتابخانه C)
  • libm (کتابخانه ریاضی)
  • حداقل پشتیبانی از C++
  • رابط JNI
  • liblog (لاگ اندروید)
  • libz (فشرده سازی Zlib)
  • libdl (پیوند دهنده پویا)
  • libGLESv1_CM.so (OpenGL ES 1.0)
  • libGLESv2.so (OpenGL ES 2.0)
  • libEGL.so (مدیریت سطح OpenGL بومی)
  • libjnigraphics.so
  • libOpenSLES.so (پشتیبانی صوتی OpenSL ES 1.0.1)
  • libOpenMAXAL.so (پشتیبانی از OpenMAX AL 1.0.1)
  • libandroid.so (پشتیبانی از فعالیت های Android بومی)
  • پشتیبانی از OpenGL، همانطور که در زیر توضیح داده شده است

توجه داشته باشید که نسخه‌های بعدی Android NDK ممکن است از ABI‌های اضافی پشتیبانی کند. اگر پیاده سازی دستگاه با ABI از پیش تعریف شده موجود سازگار نباشد، اصلاً نباید پشتیبانی از هیچ ABI را گزارش کند.

سازگاری کد بومی چالش برانگیز است. به همین دلیل، باید تکرار شود که پیاده‌کننده‌های دستگاه به شدت تشویق می‌شوند تا از پیاده‌سازی‌های بالادستی کتابخانه‌های فهرست‌شده در بالا برای اطمینان از سازگاری استفاده کنند.

3.4. سازگاری وب

3.4.1. سازگاری WebView

اجرای متن باز Android از موتور رندر WebKit برای پیاده سازی android.webkit.WebView استفاده می کند. از آنجایی که امکان توسعه یک مجموعه آزمایشی جامع برای یک سیستم رندر وب وجود ندارد، پیاده‌کنندگان دستگاه باید از ساخت بالادستی خاص WebKit در پیاده‌سازی WebView استفاده کنند. به طور مشخص:

  • اجرای پیاده‌سازی‌های دستگاه android.webkit.WebView باید بر اساس ساخت WebKit 534.30 از درخت متن باز Android برای Android 4.0 باشد. این ساخت شامل مجموعه خاصی از عملکردها و اصلاحات امنیتی برای WebView است. پیاده‌کننده‌های دستگاه ممکن است سفارشی‌سازی‌هایی را برای پیاده‌سازی WebKit داشته باشند. با این حال، هر گونه سفارشی سازی نباید رفتار WebView، از جمله رفتار رندر را تغییر دهد.
  • رشته عامل کاربر گزارش شده توسط WebView باید در این قالب باشد:
    Mozilla/5.0 (Linux; U; Android $(VERSION); $(LOCALE); $(MODEL) Build/$(BUILD)) AppleWebKit/534.30 (KHTML, like Gecko) Version/4.0 Mobile Safari/534.30
    • مقدار رشته $(VERSION) باید با مقدار android.os.Build.VERSION.RELEASE یکسان باشد.
    • مقدار رشته $(LOCALE) باید از قوانین ISO برای کد کشور و زبان پیروی کند و باید به محلی پیکربندی شده فعلی دستگاه اشاره کند.
    • مقدار رشته $(MODEL) باید با مقدار android.os.Build.MODEL یکسان باشد.
    • مقدار رشته $(BUILD) باید با مقدار android.os.Build.ID یکسان باشد.

مؤلفه WebView باید تا حد امکان از HTML5 پشتیبانی کند [ منابع، 11 ]. حداقل، پیاده سازی دستگاه باید از هر یک از این API های مرتبط با HTML5 در WebView پشتیبانی کند:

به‌علاوه، پیاده‌سازی‌های دستگاه باید از API ذخیره‌سازی وب HTML5/W3C [ منابع، 15 ] پشتیبانی کنند، و باید از HTML5/W3C IndexedDB API [ منابع، 16 ] پشتیبانی کنند. توجه داشته باشید که از آنجایی که نهادهای استاندارد توسعه وب در حال انتقال به سمت ترجیح IndexedDB بر ذخیره‌سازی وب هستند، انتظار می‌رود که IndexedDB به یک جزء ضروری در نسخه آینده اندروید تبدیل شود.

APIهای HTML5، مانند همه APIهای جاوا اسکریپت، باید به طور پیش‌فرض در WebView غیرفعال شوند، مگر اینکه توسعه‌دهنده صریحاً آنها را از طریق APIهای معمول Android فعال کند.

3.4.2. سازگاری مرورگر

پیاده سازی دستگاه باید شامل یک برنامه مرورگر مستقل برای مرور وب کاربر عمومی باشد. ممکن است مرورگر مستقل مبتنی بر فناوری مرورگری غیر از WebKit باشد. با این حال، حتی اگر یک برنامه مرورگر جایگزین استفاده شود، مؤلفه android.webkit.WebView ارائه شده به برنامه های شخص ثالث باید بر اساس WebKit باشد، همانطور که در بخش 3.4.1 توضیح داده شد.

پیاده سازی ها ممکن است یک رشته عامل کاربر سفارشی را در برنامه مرورگر مستقل ارسال کنند.

برنامه مرورگر مستقل (چه بر اساس برنامه بالادستی مرورگر WebKit یا یک جایگزین شخص ثالث) باید تا حد امکان از HTML5 پشتیبانی کند [ منابع، 11 ]. حداقل، پیاده سازی دستگاه باید از هر یک از این API های مرتبط با HTML5 پشتیبانی کند:

به‌علاوه، پیاده‌سازی‌های دستگاه باید از API ذخیره‌سازی وب HTML5/W3C [ منابع، 15 ] پشتیبانی کنند، و باید از HTML5/W3C IndexedDB API [ منابع، 16 ] پشتیبانی کنند. توجه داشته باشید که از آنجایی که نهادهای استاندارد توسعه وب در حال انتقال به سمت ترجیح IndexedDB بر ذخیره‌سازی وب هستند، انتظار می‌رود که IndexedDB به یک جزء ضروری در نسخه آینده اندروید تبدیل شود.

3.5. سازگاری رفتاری API

رفتارهای هر یک از انواع API (مدیریت شده، نرم، بومی و وب) باید با اجرای ترجیحی پروژه منبع باز Android بالادستی مطابقت داشته باشد [ Resources, 3 ]. برخی از زمینه های خاص سازگاری عبارتند از:

  • دستگاه ها نباید رفتار یا معنای یک Intent استاندارد را تغییر دهند
  • دستگاه ها نباید چرخه عمر یا چرخه حیات معنایی نوع خاصی از اجزای سیستم (مانند سرویس، فعالیت، ارائه دهنده محتوا و غیره) را تغییر دهند.
  • دستگاه ها نباید معنای یک مجوز استاندارد را تغییر دهند

لیست فوق جامع نیست. مجموعه تست سازگاری (CTS) بخش های قابل توجهی از پلت فرم را برای سازگاری رفتاری آزمایش می کند، اما نه همه آنها. اطمینان از سازگاری رفتاری با پروژه متن باز اندروید بر عهده مجری است. به همین دلیل، پیاده‌کننده‌های دستگاه باید در صورت امکان از کد منبع موجود از طریق پروژه منبع باز Android استفاده کنند، نه اینکه بخش‌های مهمی از سیستم را دوباره پیاده‌سازی کنند.

3.6. فضاهای نام API

اندروید از قراردادهای فضای نام بسته و کلاس تعریف شده توسط زبان برنامه نویسی جاوا پیروی می کند. برای اطمینان از سازگاری با برنامه‌های شخص ثالث، پیاده‌کننده‌های دستگاه نباید هیچ گونه تغییر ممنوعه (به زیر را ببینید) در این فضاهای نام بسته ایجاد کنند:

  • جاوا.*
  • javax.*
  • آفتاب.*
  • اندروید.*
  • com.android.*

تغییرات ممنوعه عبارتند از:

  • پیاده‌سازی‌های دستگاه نباید با تغییر هر روش یا امضای کلاس، یا با حذف کلاس‌ها یا فیلدهای کلاس، APIهای در معرض عموم در پلتفرم Android را تغییر دهند.
  • پیاده‌کننده‌های دستگاه ممکن است پیاده‌سازی اساسی APIها را تغییر دهند، اما چنین تغییراتی نباید بر رفتار بیان‌شده و امضای زبان جاوا هر یک از API‌های در معرض عموم تأثیر بگذارد.
  • پیاده‌کننده‌های دستگاه نباید هیچ عنصری که به‌صورت عمومی در معرض دید قرار می‌گیرد (مانند کلاس‌ها یا رابط‌ها، یا فیلدها یا روش‌ها به کلاس‌ها یا رابط‌های موجود) به APIهای بالا اضافه کنند.

"عنصر در معرض عموم" هر ساختاری است که با نشانگر "@hide" همانطور که در کد منبع بالادست Android استفاده می شود تزئین نشده باشد. به عبارت دیگر، پیاده‌کننده‌های دستگاه نباید APIهای جدید را افشا کنند یا APIهای موجود را در فضاهای نام ذکر شده در بالا تغییر دهند. پیاده‌کننده‌های دستگاه ممکن است تغییراتی را فقط داخلی انجام دهند، اما این تغییرات نباید تبلیغ شوند یا در معرض دید توسعه‌دهندگان قرار گیرند.

پیاده‌کننده‌های دستگاه ممکن است APIهای سفارشی اضافه کنند، اما چنین API‌هایی نباید در فضای نام متعلق به سازمان دیگری باشند یا به آن ارجاع دهند. برای مثال، پیاده‌کننده‌های دستگاه نباید API را به com.google.* یا فضای نام مشابه اضافه کنند. فقط گوگل می تواند این کار را انجام دهد. به طور مشابه، Google نباید API را به فضای نام شرکت‌های دیگر اضافه کند. علاوه بر این، اگر پیاده‌سازی دستگاه شامل APIهای سفارشی خارج از فضای نام استاندارد Android باشد، آن APIها باید در یک کتابخانه مشترک Android بسته‌بندی شوند تا فقط برنامه‌هایی که به صراحت از آنها استفاده می‌کنند (از طریق مکانیسم <uses-library> ) تحت تأثیر افزایش مصرف حافظه قرار گیرند. از این قبیل APIها

اگر پیاده‌کننده دستگاه پیشنهاد کند یکی از فضاهای نام بسته بالا را بهبود بخشد (مانند افزودن عملکرد مفید جدید به یک API موجود، یا افزودن یک API جدید)، پیاده‌کننده باید از source.android.com بازدید کند و فرآیند ایجاد تغییرات و تغییرات را آغاز کند. کد، با توجه به اطلاعات آن سایت.

توجه داشته باشید که محدودیت‌های بالا با قراردادهای استاندارد برای نام‌گذاری APIها در زبان برنامه‌نویسی جاوا مطابقت دارد. هدف این بخش صرفاً تقویت آن قراردادها و الزام آور ساختن آنها از طریق گنجاندن در این تعریف سازگاری است.

3.7. سازگاری با ماشین مجازی

پیاده سازی دستگاه باید از مشخصات بایت کد کامل Dalvik Executable (DEX) و معناشناسی ماشین مجازی Dalvik [ منابع، 17 ] پشتیبانی کند.

پیاده سازی های دستگاه باید Dalvik را برای تخصیص حافظه مطابق با پلتفرم بالادستی اندروید و همانطور که در جدول زیر مشخص شده است پیکربندی کند. (برای تعاریف اندازه صفحه و تراکم صفحه به بخش 7.1.1 مراجعه کنید.)

توجه داشته باشید که مقادیر حافظه مشخص‌شده در زیر حداقل مقادیر در نظر گرفته می‌شوند و پیاده‌سازی دستگاه ممکن است حافظه بیشتری را به هر برنامه اختصاص دهد.

اندازه صفحه نمایش تراکم صفحه نمایش حافظه برنامه
کوچک / معمولی / بزرگ ldpi / mdpi 16 مگابایت
کوچک / معمولی / بزرگ tvdpi / hdpi 32 مگابایت
کوچک / معمولی / بزرگ xhdpi 64 مگابایت
xlarge mdpi 32 مگابایت
xlarge tvdpi / hdpi 64 مگابایت
xlarge xhdpi 128 مگابایت

3.8. سازگاری با رابط کاربری

3.8.1. ابزارک ها

Android یک نوع مؤلفه و API و چرخه حیات مربوطه را تعریف می‌کند که به برنامه‌ها اجازه می‌دهد «AppWidget» را در معرض دید کاربر نهایی قرار دهند [ Resources, 18 ]. نسخه مرجع منبع باز Android شامل یک برنامه راه‌انداز است که شامل امکانات رابط کاربری است که به کاربر اجازه می‌دهد AppWidgets را از صفحه اصلی اضافه، مشاهده و حذف کند.

پیاده‌سازی دستگاه ممکن است جایگزینی برای راه‌انداز مرجع (یعنی صفحه اصلی) جایگزین کند. راه‌اندازهای جایگزین باید شامل پشتیبانی داخلی برای AppWidgets باشند و امکانات رابط کاربری را برای افزودن، پیکربندی، مشاهده و حذف AppWidgets مستقیماً در Launcher در معرض نمایش بگذارند. راه‌اندازهای جایگزین ممکن است این عناصر رابط کاربری را حذف کنند. با این حال، اگر آنها حذف شوند، پیاده سازی دستگاه باید یک برنامه کاربردی جداگانه قابل دسترسی از Launcher ارائه دهد که به کاربران اجازه می دهد AppWidgets را اضافه، پیکربندی، مشاهده و حذف کنند.

پیاده‌سازی دستگاه باید دارای قابلیت رندر کردن ویجت‌هایی باشد که 4×4 در اندازه شبکه استاندارد هستند. (برای جزئیات، دستورالعمل‌های طراحی ابزارک برنامه را در مستندات Android SDK [ منابع، 18 ] ببینید.

3.8.2. اطلاعیه

Android شامل APIهایی است که به توسعه دهندگان اجازه می دهد تا با استفاده از ویژگی های سخت افزاری و نرم افزاری دستگاه، کاربران را از رویدادهای قابل توجه آگاه کنند [ منابع، 19 ].

برخی از API ها به برنامه ها اجازه می دهند تا با استفاده از سخت افزار ، به طور خاص صدا ، لرزش و نور ، اعلان ها را انجام دهند یا توجه کنند. اجرای دستگاه باید از اعلان هایی که از ویژگی های سخت افزاری استفاده می کنند ، همانطور که در مستندات SDK توضیح داده شده است ، و تا حد امکان با سخت افزار اجرای دستگاه پشتیبانی کند. به عنوان مثال ، اگر اجرای دستگاه شامل ویبراتور باشد ، باید API های لرزش را به درستی پیاده سازی کند. اگر اجرای دستگاه فاقد سخت افزار باشد ، API های مربوطه باید به عنوان No-Ops اجرا شوند. توجه داشته باشید که این رفتار در بخش 7 بیشتر شرح داده شده است.

علاوه بر این ، اجرای باید به درستی تمام منابع (نمادها ، پرونده های صوتی و غیره) را که در API ها ارائه شده است [ منابع ، 20 ] یا در راهنمای سبک نماد وضعیت/سیستم [ منابع ، 21 ] ارائه دهد. مجریان دستگاه ممکن است تجربه کاربری جایگزین را برای اعلان ها نسبت به آنچه که توسط اجرای منبع باز اندروید ارائه شده است ، ارائه دهند. با این حال ، چنین سیستم های اطلاع رسانی جایگزین باید مانند موارد فوق از منابع اعلان موجود پشتیبانی کنند.

Android 4.0 شامل پشتیبانی از اعلان های غنی ، مانند دیدگاه های تعاملی برای اعلان های مداوم است. اجرای دستگاه باید به درستی اعلان های غنی را نمایش داده و اجرا کند ، همانطور که در API های Android ثبت شده است.

Android شامل API [ منابع ، 22 ] است که به توسعه دهندگان اجازه می دهد تا جستجو را در برنامه های خود بگنجانند و داده های برنامه خود را در جستجوی سیستم جهانی قرار دهند. به طور کلی ، این عملکرد شامل یک رابط کاربری واحد و گسترده است که به کاربران امکان می دهد نمایش داده ها را وارد کنند ، پیشنهادات را به عنوان نوع کاربران نشان می دهد و نتایج را نمایش می دهد. API های Android به توسعه دهندگان اجازه می دهند از این رابط استفاده مجدد کنند تا در برنامه های خود جستجو کنند و به توسعه دهندگان اجازه دهند تا نتایج را به رابط کاربری مشترک جهانی جستجوی ارائه دهند.

پیاده سازی های دستگاه باید شامل یک رابط کاربری جستجوی منفرد ، مشترک و در سطح سیستم باشد که بتواند در پاسخ به ورودی کاربر ، پیشنهادات زمان واقعی را داشته باشد. پیاده سازی دستگاه باید API هایی را که به توسعه دهندگان اجازه می دهد از این رابط کاربری استفاده مجدد کنند تا جستجو را در برنامه های خود انجام دهند ، پیاده سازی کنند. اجرای دستگاه باید API هایی را اجرا کند که به برنامه های شخص ثالث اجازه می دهد تا هنگام اجرای در حالت جستجوی جهانی ، پیشنهادات را به کادر جستجو اضافه کنند. اگر هیچ برنامه شخص ثالث نصب نشده باشد که از این قابلیت استفاده کند ، رفتار پیش فرض برای نمایش نتایج و پیشنهادات موتور جستجوی وب است.

3.8.4. نان تست

برنامه ها می توانند از API "Toast" (تعریف شده در [ منابع ، 23 ]) برای نمایش رشته های غیر معدنی کوتاه به کاربر نهایی استفاده کنند ، که پس از یک دوره زمانی کوتاه ناپدید می شوند. پیاده سازی دستگاه ها باید نان تست را از برنامه های کاربران نهایی به روش دید بالا نشان دهند.

3.8.5. تم ها

Android "مضامین" را به عنوان مکانیسمی برای برنامه های کاربردی در کل یک فعالیت یا برنامه کاربردی ارائه می دهد. Android 3.0 یک موضوع جدید "Holo" یا "هولوگرافی" را به عنوان مجموعه ای از سبک های تعریف شده برای توسعه دهندگان برنامه معرفی کرد تا در صورت تمایل به مطابقت با موضوع هولو ، مطابق با Android SDK [ منابع ، 24 ]. اجرای دستگاه نباید هیچ یک از ویژگی های تم Holo را در معرض برنامه ها تغییر دهد [ منابع ، 25 ].

Android 4.0 یک موضوع جدید "پیش فرض دستگاه" را به عنوان مجموعه ای از سبک های تعریف شده برای توسعه دهندگان برنامه معرفی می کند تا در صورت تمایل به مطابقت با ظاهر و احساس دستگاه مطابق با مجری دستگاه ، از آنها استفاده کنند. پیاده سازی دستگاه ممکن است ویژگی های موضوع Devedefault را در معرض برنامه ها تغییر دهد [ منابع ، 25 ].

3.8.6. تصاویر پس زمینه زنده

Android یک نوع مؤلفه و API و چرخه حیات مربوطه را تعریف می کند که به برنامه ها اجازه می دهد تا یک یا چند "تصاویر پس زمینه زنده" را در معرض کاربر نهایی قرار دهند [ منابع ، 26 ]. تصاویر پس زمینه زنده انیمیشن ها ، الگوهای یا تصاویر مشابه با قابلیت ورودی محدود است که به عنوان یک تصویر زمینه ، در پشت برنامه های دیگر نمایش داده می شود.

اگر بتواند تمام تصاویر پس زمینه زنده را اجرا کند ، بدون هیچ محدودیتی در عملکرد ، در یک فریم و فریمراسیون معقول و بدون تأثیر منفی بر سایر برنامه ها ، سخت افزاری در نظر گرفته می شود. اگر محدودیت در سخت افزار باعث ایجاد تصاویر پس زمینه و/یا برنامه های کاربردی برای خرابی ، نقص عملکرد ، مصرف بیش از حد CPU یا باتری شود ، یا با نرخ فریم غیرقابل قبول اجرا شود ، سخت افزار ناتوان از اجرای تصویر زمینه زنده محسوب می شود. به عنوان نمونه ، برخی از تصاویر پس زمینه زنده ممکن است از زمینه GL 1.0 یا 2.0 باز برای ارائه محتوای خود استفاده کنند. تصویر زمینه زنده به طور قابل اعتماد روی سخت افزاری که از چندین زمینه OpenGL پشتیبانی نمی کند ، اجرا نمی شود زیرا استفاده از تصویر زمینه زنده از یک زمینه OpenGL ممکن است با سایر برنامه های کاربردی که از یک زمینه OpenGL نیز استفاده می کنند ، مغایرت داشته باشد.

پیاده سازی های دستگاه قادر به اجرای تصاویر پس زمینه زنده به طور قابل اعتماد همانطور که در بالا توضیح داده شد باید تصاویر پس زمینه زنده را پیاده سازی کند. پیاده سازی های دستگاه مصمم برای اجرای تصاویر پس زمینه زنده به طور قابل اعتماد همانطور که در بالا توضیح داده شد ، نباید تصاویر پس زمینه زنده را پیاده سازی کند.

3.8.7. نمایشگاه برنامه اخیر

کد منبع بالادست Android 4.0 شامل یک رابط کاربری برای نمایش برنامه های اخیر با استفاده از تصویر تصویربرداری از وضعیت گرافیکی برنامه در لحظه آخرین کار کاربر از برنامه است. اجرای دستگاه ممکن است این رابط کاربری را تغییر داده یا از بین ببرد. با این حال ، نسخه آینده اندروید برای استفاده گسترده تر از این قابلیت ها برنامه ریزی شده است. پیاده سازی های دستگاه به شدت از استفاده از رابط کاربری بالادست Android 4.0 (یا یک رابط مبتنی بر تصویر کوچک) برای برنامه های اخیر تشویق می شوند ، وگرنه ممکن است با نسخه آینده Android سازگار نباشند.

3.8.8. تنظیمات مدیریت ورودی

Android 4.0 شامل پشتیبانی از موتورهای مدیریت ورودی است. Android 4.0 API به برنامه سفارشی IME اجازه می دهد تا تنظیمات قابل تنظیم کاربر را مشخص کند. پیاده سازی دستگاه ها باید روشی را برای کاربر برای دسترسی به تنظیمات IME در هر زمان که IME که چنین تنظیمات کاربر را نمایش می دهد ، شامل شود.

3.9 مدیریت دستگاه

Android 4.0 شامل ویژگی هایی است که به برنامه های آگاه از امنیت اجازه می دهد تا عملکردهای مدیریت دستگاه را در سطح سیستم انجام دهند ، مانند اجرای خط مشی رمز عبور یا انجام پاکسازی از راه دور ، از طریق API مدیریت دستگاه Android [ منابع ، 27 ]. پیاده سازی دستگاه ها باید اجرای کلاس DevicePolicyManager [ منابع ، 28 ] را فراهم کند ، و باید از طیف کاملی از خط مشی های مدیریت دستگاه تعریف شده در اسناد Android SDK [ منابع ، 27 ] پشتیبانی کند.

اگر پیاده سازی دستگاه از طیف کاملی از خط مشی های مدیریت دستگاه پشتیبانی نمی کند ، آنها نباید اجازه دهند برنامه های مدیریت دستگاه فعال شوند. به طور خاص ، اگر یک دستگاه از تمام خط مشی های مدیریت دستگاه پشتیبانی نکند ، اجرای دستگاه باید به android.app.admin.DevicePolicyManager.ACTION_ADD_DEVICE_ADMIN پاسخ دهد ، اما باید یک پیام را نشان دهد که به کاربر اطلاع می دهد که دستگاه از مدیریت دستگاه پشتیبانی نمی کند.

3.10 دسترسی

Android 4.0 یک لایه دسترسی را فراهم می کند که به کاربران دارای معلولیت کمک می کند تا راحت تر دستگاه های خود را حرکت دهند. علاوه بر این ، Android 4.0 API های پلتفرم را فراهم می کند که اجرای خدمات دسترسی را برای دریافت پاسخ به تماس برای رویدادهای کاربر و سیستم امکان پذیر می کند و مکانیسم های بازخورد متناوب مانند متن به گفتار ، بازخورد هاپتیک و ناوبری D-Pad/D-Pad را تولید می کند [ منابع ، 29 ] . اجرای دستگاه باید اجرای چارچوب دسترسی Android را مطابق با اجرای پیش فرض Android ارائه دهد. به طور خاص ، اجرای دستگاه باید شرایط زیر را برآورده کند.

  • اجرای دستگاه باید از پیاده سازی خدمات دسترسی به شخص ثالث از طریق API های android.accessibilityservice [ منابع ، 30 ] پشتیبانی کند.
  • پیاده سازی دستگاه ها باید AccessibilityEvent را ایجاد کرده و این رویدادها را به کلیه پیاده سازی های ثبت شده AccessibilityService به روشی متناسب با اجرای پیش فرض Android ارائه دهد.
  • پیاده سازی های دستگاه باید یک مکانیسم قابل دسترسی کاربر را برای فعال کردن و غیرفعال کردن خدمات دسترسی فراهم کند ، و باید این رابط را در پاسخ به android.provider.Settings.ACTION_ACCESSIBILITY_SETTINGS هدف نشان دهد.

علاوه بر این ، پیاده سازی دستگاه ها باید اجرای یک سرویس دسترسی به دستگاه را فراهم کند و باید مکانیسمی را برای کاربران فراهم کند تا سرویس دسترسی را هنگام تنظیم دستگاه فعال کنند. اجرای منبع باز از یک سرویس دسترسی از پروژه Free Eyes [ منابع ، 31 ] در دسترس است.

3.11 متن به گفتار

Android 4.0 شامل API هایی است که به برنامه های کاربردی اجازه می دهد از خدمات متن به گفتار (TTS) استفاده کنند و به ارائه دهندگان خدمات اجازه می دهد تا خدمات TTS را ارائه دهند [ منابع ، 32 ]. پیاده سازی دستگاه باید این شرایط مربوط به چارچوب Android TTS را برآورده کند:

  • پیاده سازی های دستگاه باید از API های Android TTS Framework پشتیبانی کنند و باید یک موتور TTS را شامل شود که از زبانهای موجود در دستگاه پشتیبانی می کند. توجه داشته باشید که نرم افزار منبع باز آندروید بالادست شامل اجرای موتور کامل TTS است.
  • پیاده سازی دستگاه باید از نصب موتورهای TTS شخص ثالث پشتیبانی کند.
  • اجرای دستگاه باید یک رابط قابل دسترسی کاربر را فراهم کند که به کاربران امکان می دهد موتور TTS را برای استفاده در سطح سیستم انتخاب کنند.

4- سازگاری بسته بندی برنامه

پیاده سازی های دستگاه باید پرونده های Android ".APK" را که توسط ابزار "AAPT" موجود در SDK رسمی Android ایجاد شده است ، نصب و اجرا کند.

پیاده سازی دستگاه ها نباید از .APK [ منابع ، 34 ] ، مانیفست اندرویدی [ منابع ، 35 ] ، Dalvik Bytecode [ منابع ، 17 ] ، یا فرمت های Bytecode Renderscript را به گونه ای گسترش دهد که مانع از نصب و اجرای صحیح آن پرونده ها شود. سایر دستگاه های سازگار. مجریان دستگاه باید از اجرای بالادست مرجع Dalvik و سیستم مدیریت بسته اجرای مرجع استفاده کنند.

5. سازگاری چندرسانه ای

اجرای دستگاه باید حداقل یک شکل از خروجی صوتی ، مانند بلندگوها ، جک هدفون ، اتصال بلندگو خارجی و غیره را شامل شود.

5.1. کدک های رسانه ای

اجرای دستگاه باید از قالب های اصلی رسانه های مشخص شده در اسناد Android SDK [ منابع ، 58 ] پشتیبانی کند ، به جز مواردی که در این سند صریح مجاز است. به طور خاص ، اجرای دستگاه باید از قالب های رسانه ، رمزگذار ، رمزگشایی ، انواع پرونده و قالب های کانتینر تعریف شده در جداول زیر پشتیبانی کند. همه این کدک ها به عنوان پیاده سازی نرم افزار در اجرای ترجیحی Android از پروژه منبع باز اندروید ارائه شده اند.

لطفاً توجه داشته باشید که نه Google و نه اتحاد گوشی آزاد هیچ گونه نمایشی را ارائه نمی دهند که این کدک ها توسط ثبت اختراعات شخص ثالث بدون کنترل نیستند. به کسانی که قصد استفاده از این کد منبع را در محصولات سخت افزاری یا نرم افزاری دارند ، توصیه می شود که پیاده سازی این کد ، از جمله در نرم افزار منبع باز یا نرم افزار اشتراک گذاری ، ممکن است نیاز به مجوزهای ثبت اختراع از طرف دارندگان ثبت اختراع مربوط داشته باشد.

توجه داشته باشید که این جداول نیازهای خاص بیت را برای اکثر کدک های ویدیویی ذکر نمی کنند زیرا سخت افزار دستگاه فعلی لزوماً از بیت هایی پشتیبانی نمی کند که دقیقاً بر روی بیت های مورد نیاز مشخص شده توسط استانداردهای مربوطه نقشه برداری شود. درعوض ، پیاده سازی دستگاه باید از بالاترین کاربردی Bitrate در سخت افزار ، تا حد تعریف شده توسط مشخصات پشتیبانی کند.

تایپ کنید قالب / کدک رمزگذار رمزگشا جزئیات قالب (ها) / قالبهای کانتینر
سمعی AAC LC/LTP ضروری
برای پیاده سازی دستگاه هایی که شامل سخت افزار میکروفون است و android.hardware.microphone تعریف می کند.
ضروری محتوای مونو/استریو در هر ترکیبی از نرخ بیت استاندارد تا 160 کیلوبیت بر ثانیه و نرخ نمونه برداری از 8 تا 48kHz
  • 3GPP (.3gp)
  • MPEG-4 (.mp4 ، .m4a)
  • ADTS RAW AAC (.AAC ، رمزگشایی در Android 3.1+ ، رمزگذاری در Android 4.0+ ، ADIF پشتیبانی نشده است)
  • MPEG-TS (.ts ، قابل جستجو نیست ، Android 3.0+)
HE-AACV1 (AAC+) ضروری
HE-AACV2 (پیشرفته AAC+) ضروری
AMR-NB ضروری
برای پیاده سازی دستگاه هایی که شامل سخت افزار میکروفون است و android.hardware.microphone تعریف می کند.
ضروری 4.75 تا 12.2 kbps نمونه برداری شده @ 8kHz 3GPP (.3gp)
AMR-WB ضروری
برای پیاده سازی دستگاه هایی که شامل سخت افزار میکروفون است و android.hardware.microphone تعریف می کند.
ضروری 9 نرخ از 6.60 kbit/s تا 23.85 kbit/s نمونه برداری @ 16kHz 3GPP (.3gp)
FLAC ضروری
(Android 3.1+)
مونو/استریو (بدون چند کاناله). نرخ نمونه تا 48 کیلوهرتز (اما حداکثر 44.1 کیلوهرتز در دستگاه هایی با خروجی 44.1 کیلوهرتز توصیه می شود ، زیرا Downsampler 48 تا 44.1 کیلوهرتز شامل فیلتر کم گذر نیست). 16 بیتی توصیه می شود ؛ هیچ DITH برای 24 بیتی درخواست نکرد. flac (.flac) فقط
MP3 ضروری Mono/Stereo 8-320Kbps ثابت (CBR) یا نرخ بیت متغیر (VBR) mp3 (.mp3)
MIDI ضروری MIDI نوع 0 و 1. DLS نسخه 1 و 2. XMF و موبایل XMF. پشتیبانی از قالب های زنگ RTTTL/RTX ، OTA و IMELODY
  • نوع 0 و 1 (.mid ، .xmf ، .mxmf)
  • rtttl/rtx (.rtttl ، .rtx)
  • OTA (.ota)
  • imelody (.imy)
وربیس ضروری
  • OGG (.ogg)
  • ماتروسکا (.mkv)
PCM/موج ضروری PCM خطی 8- و 16 بیتی (نرخ تا حد سخت افزار) موج (.wav)
تصویر JPEG ضروری ضروری پایه+مترقی JPEG (.jpg)
GIF ضروری gif (.gif)
PNG ضروری ضروری PNG (png.)
BMP ضروری BMP (.bmp)
WEBP ضروری ضروری وب (.webp)
ویدیو H.263 ضروری
مورد نیاز برای پیاده سازی دستگاه هایی که شامل سخت افزار دوربین است و android.hardware.camera یا android.hardware.camera.front را تعریف می کند.
ضروری
  • 3GPP (.3gp)
  • MPEG-4 (mp4.)
H.264 AVC ضروری
مورد نیاز برای پیاده سازی دستگاه هایی که شامل سخت افزار دوربین است و android.hardware.camera یا android.hardware.camera.front را تعریف می کند.
ضروری مشخصات پایه (BP)
  • 3GPP (.3gp)
  • MPEG-4 (mp4.)
  • MPEG-TS (.ts ، AAC فقط صوتی ، قابل جستجو نیست ، Android 3.0+)
MPEG-4 SP ضروری 3GPP (.3gp)
VP8 ضروری
(Android 2.3.3+)
WebM (.webm) و Matroska (.mkv ، Android 4.0+)

5.2 رمزگذاری ویدیویی

پیاده سازی های دستگاه Android که شامل یک دوربین پشتی است و android.hardware.camera باید از پروفایل های رمزگذاری ویدیویی زیر پشتیبانی کند.

SD (کیفیت پایین) SD (با کیفیت بالا) HD (هنگامی که توسط سخت افزار پشتیبانی می شود)
کدک ویدیویی مشخصات پایه H.264 مشخصات پایه H.264 مشخصات پایه H.264
کیفیت ویدیو 176 x 144 px 480 x 360 px 1280 x 720 پیکسل
نرخ فریم ویدیو 12 فریم بر ثانیه 30 فریم بر ثانیه 30 فریم بر ثانیه
میزان بیت ویدیو 56 کیلوبیت بر ثانیه 500 کیلوبیت در ثانیه یا بالاتر 2 مگابیت در ثانیه یا بالاتر
کدک صوتی AAC-LC AAC-LC AAC-LC
کانال های صوتی 1 (مونو) 2 (استریو) 2 (استریو)
بیتریت صدا 24 کیلوبیت بر ثانیه 128 کیلوبیت بر ثانیه 192 کیلوبیت بر ثانیه

5.3. ضبط صدا

هنگامی که یک برنامه از android.media.AudioRecord API برای شروع ضبط یک جریان صوتی استفاده کرده است ، پیاده سازی دستگاه هایی که شامل سخت افزار میکروفون است و android.hardware.microphone را باید با هر یک از این رفتارها نمونه و ضبط کند:

  • دستگاه باید دامنه تقریباً مسطح در مقابل ویژگی های فرکانس را نشان دهد. به طور خاص ، 3 دسی بل ، از 100 هرتز تا 4000 هرتز
  • حساسیت ورودی صوتی باید به گونه ای تنظیم شود که یک منبع قدرت صدا 90 دسی بل (SPL) در 1000 هرتز RMS از 2500 برای نمونه های 16 بیتی تولید کند.
  • سطح دامنه PCM باید به صورت خطی تغییرات SPL ورودی را حداقل در محدوده 30 دسی بل از -18 dB به +12 dB RE 90 dB SPL در میکروفون تغییر دهد.
  • اعوجاج هارمونیک کل باید از 100 هرتز تا 4000 هرتز در سطح ورودی SPL 90 دسی بل کمتر از 1 ٪ باشد.

علاوه بر مشخصات ضبط فوق ، هنگامی که یک برنامه شروع به ضبط یک جریان صوتی با استفاده از android.media.MediaRecorder.AudioSource.VOICE_RECOGNITION منبع صوتی کرد:

  • در صورت وجود ، پردازش کاهش نویز باید غیرفعال شود.
  • در صورت وجود ، کنترل افزایش اتوماتیک باید غیرفعال شود.

توجه: در حالی که برخی از الزامات ذکر شده در بالا به عنوان "باید" برای Android 4.0 بیان شده است ، تعریف سازگاری برای نسخه آینده برای تغییر این موارد به "باید" برنامه ریزی شده است. یعنی این الزامات در Android 4.0 اختیاری است اما توسط نسخه آینده مورد نیاز خواهد بود . دستگاه های موجود و جدید که Android 4.0 را اجرا می کنند ، به شدت تشویق می شوند که این نیازها را در Android 4.0 برآورده کنند ، یا در صورت بروزرسانی به نسخه آینده قادر به دستیابی به سازگاری اندرویدی نخواهند بود.

5.4. تأخیر صوتی

تأخیر صوتی به طور گسترده ای به عنوان فاصله بین زمانی که یک برنامه درخواست پخش صوتی یا عملکرد ضبط را درخواست می کند ، تعریف می شود و هنگامی که اجرای دستگاه در واقع شروع به کار می کند. بسیاری از کلاس های برنامه ها برای دستیابی به تأثیرات در زمان واقعی چنین جلوه های صوتی یا ارتباطات VoIP به تأخیر کوتاه متکی هستند. پیاده سازی دستگاه هایی که شامل سخت افزار میکروفون است و android.hardware.microphone اعلام می کند. Microphone باید تمام نیازهای تأخیر صوتی را که در این بخش بیان شده است ، برآورده کند. برای جزئیات بیشتر در مورد شرایطی که سخت افزار میکروفون ممکن است توسط پیاده سازی دستگاه حذف شود ، به بخش 7 مراجعه کنید.

برای اهداف این بخش:

  • "تأخیر خروجی سرد" به عنوان فاصله بین زمانی که یک برنامه درخواست پخش صوتی و هنگامی که صدا شروع به پخش می کند ، تعریف می شود ، هنگامی که سیستم صوتی قبل از درخواست بیکار بوده و از آن استفاده می کند
  • "تأخیر خروجی گرم" به عنوان فاصله بین زمانی که یک برنامه درخواست پخش صوتی را درخواست می کند و هنگامی که صدا شروع به پخش می کند ، تعریف شده است ، وقتی اخیراً از سیستم صوتی استفاده شده است اما در حال حاضر بیکار است (یعنی ساکت است)
  • "تأخیر در خروجی مداوم" به عنوان فاصله زمانی تعریف شده است که یک برنامه از نمونه ای که باید پخش شود و هنگامی که بلندگو از نظر جسمی صدای مربوطه را پخش می کند ، در حالی که دستگاه در حال حاضر دستگاه پخش صوتی است
  • "تأخیر ورودی سرد" به عنوان فاصله بین زمانی که یک برنامه درخواست ضبط صوتی را درخواست می کند و هنگامی که اولین نمونه از طریق پاسخ به تماس خود به برنامه تحویل داده می شود ، تعریف می شود ، هنگامی که سیستم صوتی و میکروفون قبل از درخواست بیکار بوده و از آن استفاده می کنند.
  • "تأخیر ورودی مداوم" هنگامی که صدای محیط رخ می دهد تعریف می شود و وقتی نمونه مربوط به آن صدا از طریق پاسخ به تماس خود به یک برنامه ضبط تحویل داده می شود ، در حالی که دستگاه در حالت ضبط است

با استفاده از تعاریف فوق ، اجرای دستگاه باید هر یک از این خصوصیات را به نمایش بگذارد:

  • تأخیر خروجی سرد 100 میلی ثانیه یا کمتر
  • تأخیر خروجی گرم 10 میلی ثانیه یا کمتر
  • تأخیر مداوم خروجی 45 میلی ثانیه یا کمتر
  • تأخیر ورودی سرد 100 میلی ثانیه یا کمتر
  • تأخیر مداوم ورودی 50 میلی ثانیه یا کمتر

توجه: در حالی که الزامات ذکر شده در بالا به عنوان "باید" برای Android 4.0 بیان شده است ، تعریف سازگاری برای نسخه آینده برنامه ریزی شده است تا این موارد را به "باید" تغییر دهد. یعنی این الزامات در Android 4.0 اختیاری است اما توسط نسخه آینده مورد نیاز خواهد بود . دستگاه های موجود و جدید که Android 4.0 را اجرا می کنند ، به شدت تشویق می شوند که این نیازها را در Android 4.0 برآورده کنند ، یا در صورت بروزرسانی به نسخه آینده قادر به دستیابی به سازگاری اندرویدی نخواهند بود.

اگر اجرای دستگاه الزامات این بخش را برآورده کند ، ممکن است با گزارش ویژگی "Android.Hardware.Audio.Low-Latency" از طریق android.content.pm.PackageManager ، پشتیبانی از صدای کم تأخیر را گزارش دهد. [ منابع ، 37 ] برعکس ، اگر اجرای دستگاه این الزامات را برآورده نکند ، نباید از پشتیبانی از صدای کم تأخیر خبر دهد.

5.5. پروتکل های شبکه

دستگاه ها باید از پروتکل های شبکه رسانه ای برای پخش صوتی و تصویری همانطور که در اسناد Android SDK مشخص شده است پشتیبانی کنند [ منابع ، 58 ]. به طور خاص ، دستگاه ها باید از پروتکل های شبکه رسانه زیر پشتیبانی کنند:

  • RTSP (RTP ، SDP)
  • HTTP (ها) جریان مترقی
  • HTTP (S) پیش نویس پروتکل پخش مستقیم ، نسخه 3 [ منابع ، 59 ]

6. سازگاری ابزار توسعه دهنده

پیاده سازی دستگاه باید از ابزارهای توسعه دهنده Android ارائه شده در Android SDK پشتیبانی کند. به طور خاص ، دستگاه های سازگار با اندرویدی باید با:

  • Bridge Debug Android (معروف به ADB) [ منابع ، 33 ]
    پیاده سازی دستگاه باید از کلیه عملکردهای adb مطابق مستندات Android SDK پشتیبانی کند. Daemon adb در سمت دستگاه باید به طور پیش فرض غیرفعال باشد و برای روشن کردن پل اشکال زدایی اندرویدی باید یک مکانیسم قابل دسترسی کاربر وجود داشته باشد.
  • سرویس مانیتور اشکال زدایی Dalvik (معروف به DDMS) [ منابع ، 33 ]
    پیاده سازی دستگاه باید از تمام ویژگی های ddms همانطور که در Android SDK ثبت شده است ، پشتیبانی کند. از آنجا که ddms از adb استفاده می کند ، پشتیبانی از ddms باید به طور پیش فرض غیرفعال باشد ، اما هر زمان که کاربر پل اشکال زدایی اندرویدی را فعال کرده باشد ، باید پشتیبانی شود.
  • میمون [ منابع ، 36 ]
    پیاده سازی های دستگاه باید شامل چارچوب میمون باشد و آن را برای استفاده از برنامه ها در دسترس قرار دهد.

بیشتر سیستم های مبتنی بر لینوکس و سیستم های اپل مکینتاش دستگاه های Android را با استفاده از ابزارهای استاندارد SDK Android ، بدون پشتیبانی اضافی ، تشخیص می دهند. با این حال سیستم های ویندوز مایکروسافت به طور معمول به درایور دستگاه های جدید Android نیاز دارند. (به عنوان مثال ، شناسه های جدید فروشنده و گاهی اوقات شناسه های دستگاه جدید به درایورهای USB سفارشی برای سیستم های ویندوز نیاز دارند.) اگر اجرای دستگاه توسط ابزار adb مطابق با استاندارد Android SDK شناخته نشده باشد ، مجریان دستگاه باید درایورهای ویندوز را فراهم کنند که به توسعه دهندگان اجازه می دهند به آنها متصل شوند دستگاه با استفاده از پروتکل adb . این درایورها باید در هر دو نسخه 32 بیتی و 64 بیتی برای ویندوز XP ، ویندوز ویستا و ویندوز 7 تهیه شوند.

7. سازگاری سخت افزار

اگر یک دستگاه شامل یک مؤلفه سخت افزار خاص باشد که دارای API مربوطه برای توسعه دهندگان شخص ثالث باشد ، اجرای دستگاه باید آن API را مطابق با اسناد Android SDK اجرا کند. اگر یک API در SDK با یک مؤلفه سخت افزاری که گفته می شود اختیاری است و اجرای دستگاه دارای آن مؤلفه نیست:

  • تعاریف کلاس کامل (همانطور که توسط SDK مستند شده است) برای API های مؤلفه هنوز هم باید موجود باشد
  • رفتارهای API باید به صورت غیر معقول به عنوان No-Ops اجرا شود
  • روشهای API باید مقادیر تهی را در جایی که توسط مستندات SDK مجاز است بازگرداند
  • روشهای API باید اجرای NO-OP کلاس ها را بازگرداند که مقادیر تهی توسط مستندات SDK مجاز نیستند
  • روشهای API نباید استثنائاتی را که توسط مستندات SDK ثبت نشده است ، پرتاب کند

نمونه بارز سناریویی که این الزامات در آن اعمال می شود API تلفنی است: حتی در دستگاه های غیر تلفن ، این API ها باید به عنوان No-Ops معقول اجرا شوند.

پیاده سازی های دستگاه باید اطلاعات دقیق پیکربندی سخت افزار را از طریق روش های getSystemAvailableFeatures() و hasSystemFeature(String) در کلاس android.content.pm.PackageManager گزارش دهند. [ منابع ، 37 ]

7.1. نمایش و گرافیک

Android 4.0 شامل امکاناتی است که به طور خودکار دارایی های برنامه و طرح های UI را به طور مناسب برای دستگاه تنظیم می کند تا اطمینان حاصل شود که برنامه های شخص ثالث به خوبی در انواع تنظیمات سخت افزاری اجرا می شوند [ منابع ، 38 ]. دستگاه ها باید به طور صحیح این API ها و رفتارها را اجرا کنند ، همانطور که در این بخش شرح داده شده است.

واحدهای ارجاع شده توسط الزامات موجود در این بخش به شرح زیر است:

  • "اندازه مورب فیزیکی" فاصله اینچ بین دو گوشه مخالف قسمت روشن شده صفحه نمایش است.
  • "DPI" (به معنی "نقاط در هر اینچ") تعداد پیکسل های موجود توسط یک دهانه افقی یا عمودی خطی 1 "است.
  • "نسبت ابعاد" نسبت ابعاد طولانی تر صفحه به بعد کوتاه تر است. به عنوان مثال ، نمایشگر 480x854 پیکسل 854 /480 = 1.779 یا تقریباً "16: 9" خواهد بود.
  • "پیکسل مستقل از چگالی" یا ("DP") واحد پیکسل مجازی است که به صفحه 160 dpi نرمال می شود ، به صورت: pixels = dps * (density / 160) محاسبه می شود.

7.1.1. پیکربندی صفحه نمایش

اندازه صفحه نمایش

Android UI Framework از انواع مختلف صفحه نمایش پشتیبانی می کند و به برنامه های کاربردی اجازه می دهد تا از اندازه صفحه نمایش دستگاه (با نام "طرح صفحه") از طریق android.content.res.Configuration.screenLayout با SCREENLAYOUT_SIZE_MASK استفاده کنند. اجرای دستگاه باید اندازه صحیح صفحه نمایش را مطابق با اسناد Android SDK [ منابع ، 38 ] تعریف کند و توسط پلت فرم Android بالادست تعیین شود. به طور خاص ، پیاده سازی دستگاه باید اندازه صحیح صفحه را با توجه به ابعاد صفحه پیکسل مستقل از چگالی منطقی زیر (DP) گزارش کند.

  • دستگاه ها باید اندازه صفحه نمایش حداقل 426 dp x 320 dp ("کوچک")
  • دستگاه هایی که اندازه صفحه نمایش "عادی" را گزارش می کنند باید دارای اندازه صفحه نمایش حداقل 470 dp x 320 dp باشند
  • دستگاه هایی که اندازه صفحه نمایش "بزرگ" را گزارش می کنند باید دارای اندازه صفحه نمایش حداقل 640 dp x 480 dp باشند
  • دستگاه هایی که اندازه صفحه نمایش "Xlarge" را گزارش می کنند باید دارای اندازه صفحه نمایش حداقل 960 dp x 720 dp باشد

علاوه بر این ، دستگاه ها باید اندازه صفحه نمایش حداقل 2.5 اینچ در اندازه مورب فیزیکی داشته باشند.

دستگاه ها نباید در هر زمان اندازه صفحه نمایش گزارش شده خود را تغییر دهند.

برنامه ها به صورت اختیاری نشان می دهند که از اندازه صفحه نمایش از طریق ویژگی <supports-screens> در پرونده androidmanifest.xml پشتیبانی می کنند. پیاده سازی های دستگاه باید به درستی از پشتیبانی اعلام شده برنامه ها برای صفحه های کوچک ، عادی ، بزرگ و xlarge ، همانطور که در مستندات SDK Android شرح داده شده است ، احترام بگذارد.

نسبت ابعاد صفحه نمایش

نسبت ابعاد باید بین 1.3333 (4: 3) و 1.85 (16: 9) باشد.

تراکم صفحه نمایش

Android UI Framework مجموعه ای از تراکم های منطقی استاندارد را برای کمک به توسعه دهندگان برنامه در هدف قرار دادن منابع برنامه را تعریف می کند. پیاده سازی دستگاه باید یکی از تراکم های فریم ورک منطقی زیر را از طریق API های android.util.DisplayMetrics گزارش کند و باید برنامه ها را در این چگالی استاندارد اجرا کند.

  • 120 dpi ، معروف به "LDPI"
  • 160 dpi ، معروف به "MDPI"
  • 213 dpi ، معروف به "TVDPI"
  • 240 dpi ، معروف به "HDPI"
  • 320 dpi ، معروف به "xhdpi"
پیاده سازی دستگاه باید چگالی استاندارد فریم ورک Android را که از نظر عددی نزدیک به چگالی فیزیکی صفحه نمایش است ، تعریف کند ، مگر اینکه چگالی منطقی اندازه صفحه نمایش گزارش شده را زیر حداقل پشتیبانی کند. اگر چگالی چارچوب استاندارد Android که از نظر عددی نزدیک به چگالی فیزیکی نزدیک است ، در اندازه صفحه نمایش کوچکتر از کوچکترین اندازه صفحه نمایش سازگار با پشتیبانی (عرض 320 DP) باشد ، اجرای دستگاه باید کمترین چگالی چارچوب استاندارد Android را گزارش کند.

7.1.2. معیارهای نمایش

پیاده سازی دستگاه باید مقادیر صحیح را برای کلیه معیارهای نمایش تعریف شده در android.util.DisplayMetrics [ منابع ، 39 ] گزارش دهد.

7.1.3. جهت صفحه نمایش

دستگاه ها باید از جهت گیری پویا توسط برنامه هایی برای جهت گیری پرتره یا صفحه نمایش چشم انداز پشتیبانی کنند. یعنی دستگاه باید به درخواست برنامه برای جهت گیری صفحه نمایش خاص احترام بگذارد. اجرای دستگاه ممکن است به عنوان پیش فرض ، پرتره یا جهت گیری چشم انداز را انتخاب کند.

دستگاه ها باید هر زمان که از طریق Android.content.res.configuration.orientation ، android.view.display.getorientation () یا سایر API ها پرس و جو شوند ، مقدار صحیح را برای جهت گیری فعلی دستگاه گزارش دهند.

دستگاه ها هنگام تغییر جهت گیری نباید اندازه یا تراکم صفحه گزارش شده را تغییر دهند.

دستگاه ها باید گزارش دهند که از جهت گیری های صفحه نمایش ( android.hardware.screen.portrait و/یا android.hardware.screen.landscape ) پشتیبانی می کنند و باید حداقل یک جهت گیری پشتیبانی شده را گزارش دهند. به عنوان مثال ، دستگاهی با صفحه نمایش منظره با جهت گیری ثابت ، مانند تلویزیون یا لپ تاپ ، فقط باید android.hardware.screen.landscape گزارش کند.

7.1.4. شتاب گرافیکی 2D و 3D

اجرای دستگاه باید از OpenGL ES 1.0 و 2.0 پشتیبانی کند ، همانطور که در اسناد Android SDK تجسم یافته و مفصل است. اجرای دستگاه همچنین باید از Android Renderscript پشتیبانی کند ، همانطور که در اسناد Android SDK [ منابع ، 8 ] شرح داده شده است.

اجرای دستگاه همچنین باید خود را به درستی به عنوان پشتیبانی از OpenGL ES 1.0 و 2.0 شناسایی کند. به این معنا که:

  • API های مدیریت شده (مانند از طریق روش GLES10.getString() ) باید پشتیبانی از OpenGL ES 1.0 و 2.0 را گزارش دهند
  • API های OpenGL C/C ++ بومی (یعنی موارد موجود در برنامه ها از طریق libgles_v1cm.so ، libgles_v2.so یا libegl.so) باید پشتیبانی از OpenGL ES 1.0 و 2.0 را گزارش دهند.

اجرای دستگاه ممکن است هرگونه پسوند مورد نظر OpenGL ES را پیاده سازی کند. با این حال ، پیاده سازی دستگاه باید از طریق API های مدیریت شده و بومی API همه رشته های پسوند که از آنها پشتیبانی می کنند گزارش دهند ، و برعکس نباید رشته های پسوند را که از آنها پشتیبانی نمی کنند گزارش دهند.

توجه داشته باشید که Android 4.0 شامل پشتیبانی از برنامه های کاربردی است تا به صورت اختیاری مشخص کنند که آنها به قالب های خاص فشرده سازی بافت OpenGL خاص نیاز دارند. این قالبها به طور معمول خاص فروشنده هستند. اجرای دستگاه توسط Android 4.0 برای اجرای هر قالب خاص فشرده سازی بافت مورد نیاز نیست. با این حال ، آنها باید از طریق روش getString() در API OpenGL ، هر قالب فشرده سازی بافت را که از آنها پشتیبانی می کنند ، گزارش دهند.

Android 3.0 مکانیسمی را برای برنامه های کاربردی معرفی کرد تا اعلام کند که آنها می خواهند شتاب سخت افزاری را برای گرافیک 2D در برنامه ، فعالیت ، پنجره یا سطح مشاهده با استفاده از یک برچسب android:hardwareAccelerated یا مستقیم [ منابع ، 9 ] فراهم کنند.

در Android 4.0 ، اجرای دستگاه باید شتاب سخت افزاری را به طور پیش فرض فعال کند و اگر توسعه دهنده با تنظیم android:hardwareAccelerated="false" یا غیرفعال کردن شتاب سخت افزار مستقیم از طریق API های Android View ، باید شتاب سخت افزاری را غیرفعال کند.

علاوه بر این ، اجرای دستگاه باید رفتاری مطابق با اسناد Android SDK در مورد شتاب سخت افزاری [ منابع ، 9 ] نشان دهد.

Android 4.0 شامل یک شیء TextureView است که به توسعه دهندگان اجازه می دهد تا بافت های OpenGL ES را به طور مستقیم با شتاب سخت افزاری به عنوان اهداف ارائه شده در یک سلسله مراتب UI ادغام کنند. پیاده سازی های دستگاه باید از API TextureView پشتیبانی کند و باید با اجرای Android بالادست رفتار مداوم داشته باشد.

7.1.5. حالت سازگاری برنامه میراث

Android 4.0 یک "حالت سازگاری" را مشخص می کند که در آن چارچوب در یک حالت معادل صفحه نمایش "عادی" (عرض 320dp) به نفع برنامه های میراث برای نسخه های قدیمی Android که استقلال اندازه صفحه نمایش از قبل تاریخ ایجاد نشده است ، کار می کند. پیاده سازی های دستگاه باید شامل پشتیبانی از حالت سازگاری برنامه میراث است که توسط کد منبع باز اندرویدی بالادست اجرا شده است. یعنی اجرای دستگاه نباید محرک ها یا آستانه هایی را که در آن حالت سازگاری فعال می شود تغییر دهد و نباید رفتار حالت سازگاری را تغییر دهد.

7.1.6. انواع صفحه نمایش

صفحه های اجرای دستگاه به عنوان یکی از دو نوع طبقه بندی می شوند:

  • پیاده سازی های صفحه نمایش ثابت: صفحه نمایش یک پانل واحد است که فقط از یک عرض و ارتفاع پیکسل پشتیبانی می کند. به طور معمول صفحه نمایش از نظر جسمی با دستگاه ادغام می شود. نمونه ها شامل تلفن های همراه ، تبلت و غیره است.
  • پیاده سازی های صفحه نمایش متغیر پیکسل: اجرای دستگاه یا صفحه نمایش تعبیه شده ندارد و شامل یک درگاه خروجی ویدیویی مانند VGA یا HDMI برای نمایش است ، یا دارای صفحه نمایش تعبیه شده است که می تواند ابعاد پیکسل را تغییر دهد. مثالها شامل تلویزیون ، جعبه های تنظیم شده و غیره است.

پیاده سازی دستگاه های پیکسل ثابت

پیاده سازی دستگاه های ثابت پیکسل ممکن است از صفحه نمایش هر ابعاد پیکسل استفاده کند ، مشروط بر اینکه آنها الزامات تعریف شده این تعریف سازگاری را برآورده کنند.

پیاده سازی های ثابت پیکسل ممکن است شامل یک درگاه خروجی ویدیویی برای استفاده با صفحه نمایش خارجی باشد. با این حال ، اگر این نمایشگر برای اجرای برنامه ها استفاده شود ، دستگاه باید شرایط زیر را برآورده کند:

  • دستگاه باید همان پیکربندی صفحه نمایش و معیارهای نمایش را گزارش کند ، همانطور که در بخش های 7.1.1 و 7.1.2 به عنوان صفحه نمایش پیکسل ثابت ارائه شده است.
  • دستگاه باید همان چگالی منطقی را به عنوان صفحه نمایش ثابت گزارش کند.
  • دستگاه باید ابعاد صفحه نمایش را که همانند صفحه نمایش ثابت است ، یا بسیار نزدیک به صفحه نمایش ثابت گزارش دهند.

به عنوان مثال ، یک تبلت که اندازه مورب 7 "با وضوح تصویر 1024x600 پیکسل است ، یک نمایشگر MDPI بزرگ پیکسل در نظر گرفته می شود. اگر حاوی یک درگاه خروجی ویدیویی باشد که در 720p یا 1080p نمایش داده می شود ، اجرای دستگاه باید به گونه ای مقیاس خروجی را مقیاس کند. برنامه ها فقط در یک پنجره بزرگ MDPI ، صرف نظر از اینکه صفحه نمایش ثابت یا درگاه خروجی ویدیویی در حال استفاده است ، اجرا می شوند.

پیاده سازی دستگاه متغیر پیکسل

پیاده سازی دستگاه های پیکسل متغیر باید از یک یا هر دو از 1280x720 یا 1920x1080 (یعنی 720p یا 1080p) پشتیبانی کند. پیاده سازی دستگاه با نمایشگرهای پیکسل متغیر نباید از هیچ پیکربندی یا حالت صفحه دیگر پشتیبانی کند. پیاده سازی دستگاه با صفحه های پیکسل متغیر ممکن است پیکربندی صفحه یا حالت را در زمان اجرا یا زمان بوت تغییر دهد. به عنوان مثال ، کاربر یک جعبه تنظیم شده ممکن است یک صفحه نمایش 720p را با صفحه نمایش 1080p جایگزین کند و اجرای دستگاه ممکن است مطابق آن تنظیم شود.

علاوه بر این ، پیاده سازی دستگاه های متغیر پیکسل باید سطل پیکربندی زیر را برای این ابعاد پیکسل گزارش دهد:

  • 1280x720 (also known as 720p): 'large' screen size, 'tvdpi' (213 dpi) density
  • 1920x1080 (also known as 1080p): 'large' screen size, 'xhdpi' (320 dpi) density

For clarity, device implementations with variable pixel dimensions are restricted to 720p or 1080p in Android 4.0, and MUST be configured to report screen size and density buckets as noted above.

7.1.7. فناوری صفحه نمایش

The Android platform includes APIs that allow applications to render rich graphics to the display. Devices MUST support all of these APIs as defined by the Android SDK unless specifically allowed in this document. به طور مشخص:

  • Devices MUST support displays capable of rendering 16-bit color graphics and SHOULD support displays capable of 24-bit color graphics.
  • Devices MUST support displays capable of rendering animations.
  • The display technology used MUST have a pixel aspect ratio (PAR) between 0.9 and 1.1. That is, the pixel aspect ratio MUST be near square (1.0) with a 10% tolerance.

7.2. دستگاه های ورودی

7.2.1. صفحه کلید

پیاده سازی دستگاه:

  • MUST include support for the Input Management Framework (which allows third party developers to create Input Management Engines - ie soft keyboard) as detailed at http://developer.android.com
  • MUST provide at least one soft keyboard implementation (regardless of whether a hard keyboard is present)
  • MAY include additional soft keyboard implementations
  • MAY include a hardware keyboard
  • MUST NOT include a hardware keyboard that does not match one of the formats specified in android.content.res.Configuration.keyboard [ Resources, 40 ] (that is, QWERTY, or 12-key)

7.2.2. Non-touch Navigation

پیاده سازی دستگاه:

  • MAY omit a non-touch navigation option (that is, may omit a trackball, d-pad, or wheel)
  • MUST report the correct value for android.content.res.Configuration.navigation [ Resources, 40 ]
  • MUST provide a reasonable alternative user interface mechanism for the selection and editing of text, compatible with Input Management Engines. The upstream Android open source software includes a selection mechanism suitable for use with devices that lack non-touch navigation inputs.

7.2.3. کلیدهای ناوبری

The Home, Menu and Back functions are essential to the Android navigation paradigm. Device implementations MUST make these functions available to the user at all times when running applications. These functions MAY be implemented via dedicated physical buttons (such as mechanical or capacitive touch buttons), or MAY be implemented using dedicated software keys, gestures, touch panel, etc. Android 4.0 supports both implementations.

Device implementations MAY use a distinct portion of the screen to display the navigation keys, but if so, MUST meet these requirements:

  • Device implementation navigation keys MUST use a distinct portion of the screen, not available to applications, and MUST NOT obscure or otherwise interfere with the portion of the screen available to applications.
  • Device implementations MUST make available a portion of the display to applications that meets the requirements defined in Section 7.1.1 .
  • Device implementations MUST display the navigation keys when applications do not specify a system UI mode, or specify SYSTEM_UI_FLAG_VISIBLE .
  • Device implementations MUST present the navigation keys in an unobtrusive "low profile" (eg. dimmed) mode when applications specify SYSTEM_UI_FLAG_LOW_PROFILE .
  • Device implementations MUST hide the navigation keys when applications specify SYSTEM_UI_FLAG_HIDE_NAVIGATION .
  • Device implementation MUST present a Menu key to applications when targetSdkVersion <= 10 and SHOULD NOT present a Menu key when the targetSdkVersion > 10.

7.2.4. ورودی صفحه لمسی

پیاده سازی دستگاه:

  • MUST have a pointer input system of some kind (either mouse-like, or touch)
  • MAY have a touchscreen of any modality (such as capacitive or resistive)
  • SHOULD support fully independently tracked pointers, if a touchscreen supports multiple pointers
  • MUST report the value of android.content.res.Configuration.touchscreen [ Resources, 40 ] corresponding to the type of the specific touchscreen on the device

Android 4.0 includes support for a variety of touch screens, touch pads, and fake touch input devices. Touch screen based device implementations are associated with a display [ Resources, 61 ] such that the user has the impression of directly manipulating items on screen. Since the user is directly touching the screen, the system does not require any additional affordances to indicate the objects being manipulated. In contrast, a fake touch interface provides a user input system that approximates a subset of touchscreen capabilities. For example, a mouse or remote control that drives an on-screen cursor approximates touch, but requires the user to first point or focus then click. Numerous input devices like the mouse, trackpad, gyro-based air mouse, gyro-pointer, joystick, and multi-touch trackpad can support fake touch interactions. Android 4.0 includes the feature constant android.hardware.faketouch , which corresponds to a high-fidelity non-touch (that is, pointer-based) input device such as a mouse or trackpad that can adequately emulate touch-based input (including basic gesture support), and indicates that the device supports an emulated subset of touchscreen functionality. Device implementations that declare the fake touch feature MUST meet the fake touch requirements in Section 7.2.5 .

Device implementations MUST report the correct feature corresponding to the type of input used. Device implementations that include a touchscreen (single-touch or better) MUST also report the platform feature constant android.hardware.faketouch . Device implementations that do not include a touchscreen (and rely on a pointer device only) MUST NOT report any touchscreen feature, and MUST report only android.hardware.faketouch if they meet the fake touch requirements in Section 7.2.5 .

7.2.5. Fake touch input

Device implementations that declare support for android.hardware.faketouch

  • MUST report the absolute X and Y screen positions of the pointer location and display a visual pointer on the screen[ Resources, 60 ]
  • MUST report touch event with the action code [ Resources, 60 ] that specifies the state change that occurs on the pointer going down or up on the screen [ Resources, 60 ]
  • MUST support pointer down and up on an object on the screen, which allows users to emulate tap on an object on the screen
  • MUST support pointer down , pointer up , pointer down then pointer up in the same place on an object on the screen within a time threshold, which allows users to emulate double tap on an object on the screen [ Resources, 60 ]
  • MUST support pointer down on an arbitrary point on the screen, pointer move to any other arbitrary point on the screen, followed by a pointer up , which allows users to emulate a touch drag
  • MUST support pointer down then allow users to quickly move the object to a different position on the screen and then pointer up on the screen, which allows users to fling an object on the screen

Devices that declare support for android.hardware.faketouch.multitouch.distinct MUST meet the requirements for faketouch above, and MUST also support distinct tracking of two or more independent pointer inputs.

7.2.6. میکروفون

Device implementations MAY omit a microphone. However, if a device implementation omits a microphone, it MUST NOT report the android.hardware.microphone feature constant, and must implement the audio recording API as no-ops, per Section 7 . Conversely, device implementations that do possess a microphone:

  • MUST report the android.hardware.microphone feature constant
  • SHOULD meet the audio quality requirements in Section 5.3
  • SHOULD meet the audio latency requirements in Section 5.4

7.3. حسگرها

Android 4.0 includes APIs for accessing a variety of sensor types. Devices implementations generally MAY omit these sensors, as provided for in the following subsections. If a device includes a particular sensor type that has a corresponding API for third-party developers, the device implementation MUST implement that API as described in the Android SDK documentation. For example, device implementations:

  • MUST accurately report the presence or absence of sensors per the android.content.pm.PackageManager class. [ Resources, 37 ]
  • MUST return an accurate list of supported sensors via the SensorManager.getSensorList() and similar methods
  • MUST behave reasonably for all other sensor APIs (for example, by returning true or false as appropriate when applications attempt to register listeners, not calling sensor listeners when the corresponding sensors are not present; etc.)
  • MUST report all sensor measurements using the relevant International System of Units (ie metric) values for each sensor type as defined in the Android SDK documentation [ Resources, 41 ]

The list above is not comprehensive; the documented behavior of the Android SDK is to be considered authoritative.

Some sensor types are synthetic, meaning they can be derived from data provided by one or more other sensors. (Examples include the orientation sensor, and the linear acceleration sensor.) Device implementations SHOULD implement these sensor types, when they include the prerequisite physical sensors.

The Android 4.0 APIs introduce a notion of a "streaming" sensor, which is one that returns data continuously, rather than only when the data changes. Device implementations MUST continuously provide periodic data samples for any API indicated by the Android 4.0 SDK documentation to be a streaming sensor.

7.3.1. شتاب سنج

Device implementations SHOULD include a 3-axis accelerometer. If a device implementation does include a 3-axis accelerometer, it:

  • MUST be able to deliver events at 50 Hz or greater
  • MUST comply with the Android sensor coordinate system as detailed in the Android APIs (see [ Resources, 41 ])
  • MUST be capable of measuring from freefall up to twice gravity (2g) or more on any three-dimensional vector
  • MUST have 8-bits of accuracy or more
  • MUST have a standard deviation no greater than 0.05 m/s^2

7.3.2. مغناطیس سنج

Device implementations SHOULD include a 3-axis magnetometer (ie compass.) If a device does include a 3-axis magnetometer, it:

  • MUST be able to deliver events at 10 Hz or greater
  • MUST comply with the Android sensor coordinate system as detailed in the Android APIs (see [ Resources, 41 ]).
  • MUST be capable of sampling a range of field strengths adequate to cover the geomagnetic field
  • MUST have 8-bits of accuracy or more
  • MUST have a standard deviation no greater than 0.5 µT

7.3.3. جی پی اس

Device implementations SHOULD include a GPS receiver. If a device implementation does include a GPS receiver, it SHOULD include some form of "assisted GPS" technique to minimize GPS lock-on time.

7.3.4. ژیروسکوپ

Device implementations SHOULD include a gyroscope (ie angular change sensor.) Devices SHOULD NOT include a gyroscope sensor unless a 3-axis accelerometer is also included. If a device implementation includes a gyroscope, it:

  • MUST be temperature compensated
  • MUST be capable of measuring orientation changes up to 5.5*Pi radians/second (that is, approximately 1,000 degrees per second)
  • MUST be able to deliver events at 100 Hz or greater
  • MUST have 12-bits of accuracy or more
  • MUST have a variance no greater than 1e-7 rad^2 / s^2 per Hz (variance per Hz, or rad^2 / s). The variance is allowed to vary with the sampling rate, but must be constrained by this value. In other words, if you measure the variance of the gyro at 1 Hz sampling rate it should be no greater than 1e-7 rad^2/s^2.
  • MUST have timestamps as close to when the hardware event happened as possible. The constant latency must be removed.

7.3.5. فشارسنج

Device implementations MAY include a barometer (ie ambient air pressure sensor.) If a device implementation includes a barometer, it:

  • MUST be able to deliver events at 5 Hz or greater
  • MUST have adequate precision to enable estimating altitude

7.3.7. دماسنج

Device implementations MAY but SHOULD NOT include a thermometer (ie temperature sensor.) If a device implementation does include a thermometer, it MUST measure the temperature of the device CPU. It MUST NOT measure any other temperature. (Note that this sensor type is deprecated in the Android 4.0 APIs.)

7.3.7. Photometer

Device implementations MAY include a photometer (ie ambient light sensor.)

7.3.8. سنسور مجاورت

Device implementations MAY include a proximity sensor. If a device implementation does include a proximity sensor, it MUST measure the proximity of an object in the same direction as the screen. That is, the proximity sensor MUST be oriented to detect objects close to the screen, as the primary intent of this sensor type is to detect a phone in use by the user. If a device implementation includes a proximity sensor with any other orientation, it MUST NOT be accessible through this API. If a device implementation has a proximity sensor, it MUST be have 1-bit of accuracy or more.

7.4. اتصال داده

7.4.1. تلفن

"Telephony" as used by the Android 4.0 APIs and this document refers specifically to hardware related to placing voice calls and sending SMS messages via a GSM or CDMA network. While these voice calls may or may not be packet-switched, they are for the purposes of Android 4.0 considered independent of any data connectivity that may be implemented using the same network. In other words, the Android "telephony" functionality and APIs refer specifically to voice calls and SMS; for instance, device implementations that cannot place calls or send/receive SMS messages MUST NOT report the "android.hardware.telephony" feature or any sub-features, regardless of whether they use a cellular network for data connectivity.

Android 4.0 MAY be used on devices that do not include telephony hardware. That is, Android 4.0 is compatible with devices that are not phones. However, if a device implementation does include GSM or CDMA telephony, it MUST implement full support for the API for that technology. Device implementations that do not include telephony hardware MUST implement the full APIs as no-ops.

7.4.2. IEEE 802.11 (WiFi)

Android 4.0 device implementations SHOULD include support for one or more forms of 802.11 (b/g/a/n, etc.) If a device implementation does include support for 802.11, it MUST implement the corresponding Android API.

7.4.3. بلوتوث

Device implementations SHOULD include a Bluetooth transceiver. Device implementations that do include a Bluetooth transceiver MUST enable the RFCOMM-based Bluetooth API as described in the SDK documentation [ Resources, 42 ]. Device implementations SHOULD implement relevant Bluetooth profiles, such as A2DP, AVRCP, OBEX, etc. as appropriate for the device.

The Compatibility Test Suite includes cases that cover basic operation of the Android RFCOMM Bluetooth API. However, since Bluetooth is a communications protocol between devices, it cannot be fully tested by unit tests running on a single device. Consequently, device implementations MUST also pass the human-driven Bluetooth test procedure described in Appendix A.

7.4.4. Near-Field Communications

Device implementations SHOULD include a transceiver and related hardware for Near-Field Communications (NFC). If a device implementation does include NFC hardware, then it:

  • MUST report the android.hardware.nfc feature from the android.content.pm.PackageManager.hasSystemFeature() method. [ Resources, 37 ]
  • MUST be capable of reading and writing NDEF messages via the following NFC standards:
    • MUST be capable of acting as an NFC Forum reader/writer (as defined by the NFC Forum technical specification NFCForum-TS-DigitalProtocol-1.0) via the following NFC standards:
      • NfcA (ISO14443-3A)
      • NfcB (ISO14443-3B)
      • NfcF (JIS 6319-4)
      • IsoDep (ISO 14443-4)
      • NFC Forum Tag Types 1, 2, 3, 4 (defined by the NFC Forum)
  • SHOULD be capable of reading and writing NDEF messages via the following NFC standards. Note that while the NFC standards below are stated as "SHOULD" for Android 4.0, the Compatibility Definition for a future version is planned to change these to "MUST". That is, these stanards are optional in Android 4.0 but will be required in future versions. Existing and new devices that run Android 4.0 are very strongly encouraged to meet these requirements in Android 4.0 so they will be able to upgrade to the future platform releases.
    • NfcV (ISO 15693)
  • MUST be capable of transmitting and receiving data via the following peer-to-peer standards and protocols:
    • ISO 18092
    • LLCP 1.0 (defined by the NFC Forum)
    • SDP 1.0 (defined by the NFC Forum)
    • NDEF Push Protocol [ Resources, 43 ]
    • SNEP 1.0 (defined by the NFC Forum)
  • MUST include support for Android Beam:
    • MUST implement the SNEP default server. Valid NDEF messages received by the default SNEP server MUST be dispatched to applications using the android.nfc.ACTION_NDEF_DISCOVERED intent. Disabling Android Beam in settings MUST NOT disable dispatch of incoming NDEF message.
    • MUST implement the NPP server. Messages received by the NPP server MUST be processed the same way as the SNEP default server.
    • MUST implement a SNEP client and attempt to send outbound P2P NDEF to the default SNEP server when Android Beam is enabled. If no default SNEP server is found then the client MUST attempt to send to an NPP server.
    • MUST allow foreground activities to set the outbound P2P NDEF message using android.nfc.NfcAdapter.setNdefPushMessage, and android.nfc.NfcAdapter.setNdefPushMessageCallback, and android.nfc.NfcAdapter.enableForegroundNdefPush.
    • SHOULD use a gesture or on-screen confirmation, such as 'Touch to Beam', before sending outbound P2P NDEF messages.
    • SHOULD enable Android Beam by default
  • MUST poll for all supported technologies while in NFC discovery mode.
  • SHOULD be in NFC discovery mode while the device is awake with the screen active and the lock-screen unlocked.

(Note that publicly available links are not available for the JIS, ISO, and NFC Forum specifications cited above.)

Additionally, device implementations MAY include reader/writer support for the following MIFARE technologies.

Note that Android 4.0 includes APIs for these MIFARE types. If a device implementation supports MIFARE in the reader/writer role, it:

  • MUST implement the corresponding Android APIs as documented by the Android SDK
  • MUST report the feature com.nxp.mifare from the android.content.pm.PackageManager.hasSystemFeature() method. [ Resources, 37 ] Note that this is not a standard Android feature, and as such does not appear as a constant on the PackageManager class.
  • MUST NOT implement the corresponding Android APIs nor report the com.nxp.mifare feature unless it also implements general NFC support as described in this section

If a device implementation does not include NFC hardware, it MUST NOT declare the android.hardware.nfc feature from the android.content.pm.PackageManager.hasSystemFeature() method [ Resources, 37 ], and MUST implement the Android 4.0 NFC API as a no-op.

As the classes android.nfc.NdefMessage and android.nfc.NdefRecord represent a protocol-independent data representation format, device implementations MUST implement these APIs even if they do not include support for NFC or declare the android.hardware.nfc feature.

7.4.5. Minimum Network Capability

Device implementations MUST include support for one or more forms of data networking. Specifically, device implementations MUST include support for at least one data standard capable of 200Kbit/sec or greater. Examples of technologies that satisfy this requirement include EDGE, HSPA, EV-DO, 802.11g, Ethernet, etc.

Device implementations where a physical networking standard (such as Ethernet) is the primary data connection SHOULD also include support for at least one common wireless data standard, such as 802.11 (WiFi).

Devices MAY implement more than one form of data connectivity.

7.5. دوربین ها

Device implementations SHOULD include a rear-facing camera, and MAY include a front-facing camera. A rear-facing camera is a camera located on the side of the device opposite the display; that is, it images scenes on the far side of the device, like a traditional camera. A front-facing camera is a camera located on the same side of the device as the display; that is, a camera typically used to image the user, such as for video conferencing and similar applications.

7.5.1. دوربین عقب

Device implementations SHOULD include a rear-facing camera. If a device implementation includes a rear-facing camera, it:

  • MUST have a resolution of at least 2 megapixels
  • SHOULD have either hardware auto-focus, or software auto-focus implemented in the camera driver (transparent to application software)
  • MAY have fixed-focus or EDOF (extended depth of field) hardware
  • MAY include a flash. If the Camera includes a flash, the flash lamp MUST NOT be lit while an android.hardware.Camera.PreviewCallback instance has been registered on a Camera preview surface, unless the application has explicitly enabled the flash by enabling the FLASH_MODE_AUTO or FLASH_MODE_ON attributes of a Camera.Parameters object. Note that this constraint does not apply to the device's built-in system camera application, but only to third-party applications using Camera.PreviewCallback .

7.5.2. دوربین جلو

Device implementations MAY include a front-facing camera. If a device implementation includes a front-facing camera, it:

  • MUST have a resolution of at least VGA (that is, 640x480 pixels)
  • MUST NOT use a front-facing camera as the default for the Camera API. That is, the camera API in Android 4.0 has specific support for front-facing cameras, and device implementations MUST NOT configure the API to to treat a front-facing camera as the default rear-facing camera, even if it is the only camera on دستگاه
  • MAY include features (such as auto-focus, flash, etc.) available to rear-facing cameras as described in Section 7.5.1.
  • MUST horizontally reflect (ie mirror) the stream displayed by an app in a CameraPreview, as follows:
    • If the device implementation is capable of being rotated by user (such as automatically via an accelerometer or manually via user input), the camera preview MUST be mirrored horizontally relative to the device's current orientation.
    • If the current application has explicitly requested that the Camera display be rotated via a call to the android.hardware.Camera.setDisplayOrientation() [ Resources, 50 ] method, the camera preview MUST be mirrored horizontally relative to the orientation specified by the application.
    • Otherwise, the preview MUST be mirrored along the device's default horizontal axis.
  • MUST mirror the image displayed by the postview in the same manner as the camera preview image stream. (If the device implementation does not support postview, this requirement obviously does not apply.)
  • MUST NOT mirror the final captured still image or video streams returned to application callbacks or committed to media storage

7.5.3. Camera API Behavior

Device implementations MUST implement the following behaviors for the camera-related APIs, for both front- and rear-facing cameras:

  1. If an application has never called android.hardware.Camera.Parameters.setPreviewFormat(int) , then the device MUST use android.hardware.PixelFormat.YCbCr_420_SP for preview data provided to application callbacks.
  2. If an application registers an android.hardware.Camera.PreviewCallback instance and the system calls the onPreviewFrame() method when the preview format is YCbCr_420_SP, the data in the byte[] passed into onPreviewFrame() must further be in the NV21 encoding format. That is, NV21 MUST be the default.
  3. Device implementations MUST support the YV12 format (as denoted by the android.graphics.ImageFormat.YV12 constant) for camera previews for both front- and rear-facing cameras. (The hardware video decoder and camera may use any native pixel format, but the device implementation MUST support conversion to YV12.)

Device implementations MUST implement the full Camera API included in the Android 4.0 SDK documentation [ Resources, 51 ]), regardless of whether the device includes hardware autofocus or other capabilities. For instance, cameras that lack autofocus MUST still call any registered android.hardware.Camera.AutoFocusCallback instances (even though this has no relevance to a non-autofocus camera.) Note that this does apply to front-facing cameras; for instance, even though most front-facing cameras do not support autofocus, the API callbacks must still be "faked" as described.

Device implementations MUST recognize and honor each parameter name defined as a constant on the android.hardware.Camera.Parameters class, if the underlying hardware supports the feature. If the device hardware does not support a feature, the API must behave as documented. Conversely, Device implementations MUST NOT honor or recognize string constants passed to the android.hardware.Camera.setParameters() method other than those documented as constants on the android.hardware.Camera.Parameters . That is, device implementations MUST support all standard Camera parameters if the hardware allows, and MUST NOT support custom Camera parameter types.

Device implementations MUST broadcast the Camera.ACTION_NEW_PICTURE intent whenever a new picture is taken by the camera and the entry of the picture has been added to the media store.

Device implementations MUST broadcast the Camera.ACTION_NEW_VIDEO intent whenever a new video is recorded by the camera and the entry of the picture has been added to the media store.

7.5.4. Camera Orientation

Both front- and rear-facing cameras, if present, MUST be oriented so that the long dimension of the camera aligns with the screen's long dimension. That is, when the device is held in the landscape orientation, cameras MUST capture images in the landscape orientation. This applies regardless of the device's natural orientation; that is, it applies to landscape-primary devices as well as portrait-primary devices.

7.6. حافظه و ذخیره سازی

7.6.1. Minimum Memory and Storage

Device implementations MUST have at least 340MB of memory available to the kernel and userspace. The 340MB MUST be in addition to any memory dedicated to hardware components such as radio, video, and so on that is not under the kernel's control.

Device implementations MUST have at least 350MB of non-volatile storage available for application private data. That is, the /data partition MUST be at least 350MB.

The Android APIs include a Download Manager that applications may use to download data files [ Resources, 56 ]. The device implementation of the Download Manager MUST be capable of downloading individual files of at least 100MB in size to the default "cache" location.

7.6.2. Application Shared Storage

Device implementations MUST offer shared storage for applications. The shared storage provided MUST be at least 1GB in size.

Device implementations MUST be configured with shared storage mounted by default, "out of the box". If the shared storage is not mounted on the Linux path /sdcard , then the device MUST include a Linux symbolic link from /sdcard to the actual mount point.

Device implementations MUST enforce as documented the android.permission.WRITE_EXTERNAL_STORAGE permission on this shared storage. Shared storage MUST otherwise be writable by any application that obtains that permission.

Device implementations MAY have hardware for user-accessible removable storage, such as a Secure Digital card. Alternatively, device implementations MAY allocate internal (non-removable) storage as shared storage for apps.

Regardless of the form of shared storage used, device implementations MUST provide some mechanism to access the contents of shared storage from a host computer, such as USB mass storage (UMS) or Media Transfer Protocol (MTP). Device implementations MAY use USB mass storage, but SHOULD use Media Transfer Protocol. If the device implementation supports Media Transfer Protocol:

  • The device implementation SHOULD be compatible with the reference Android MTP host, Android File Transfer [ Resources, 57 ].
  • The device implementation SHOULD report a USB device class of 0x00 .
  • The device implementation SHOULD report a USB interface name of 'MTP'.

If the device implementation lacks USB ports, it MUST provide a host computer with access to the contents of shared storage by some other means, such as a network file system.

It is illustrative to consider two common examples. If a device implementation includes an SD card slot to satisfy the shared storage requirement, a FAT-formatted SD card 1GB in size or larger MUST be included with the device as sold to users, and MUST be mounted by default. Alternatively, if a device implementation uses internal fixed storage to satisfy this requirement, that storage MUST be 1GB in size or larger and mounted on /sdcard (or /sdcard MUST be a symbolic link to the physical location if it is mounted elsewhere.)

Device implementations that include multiple shared storage paths (such as both an SD card slot and shared internal storage) SHOULD modify the core applications such as the media scanner and ContentProvider to transparently support files placed in both locations.

7.7. یو اس بی

Device implementations SHOULD include a USB client port, and SHOULD include a USB host port.

If a device implementation includes a USB client port:

  • the port MUST be connectable to a USB host with a standard USB-A port
  • the port SHOULD use the micro USB form factor on the device side
  • it MUST allow a host connected to the device to access the contents of the shared storage volume using either USB mass storage or Media Transfer Protocol
  • it MUST implement the Android Open Accessory API and specification as documented in the Android SDK documentation, and MUST declare support for the hardware feature android.hardware.usb.accessory [ Resources, 51 ]

If a device implementation includes a USB host port:

  • it MAY use a non-standard port form factor, but if so MUST ship with a cable or cables adapting the port to standard USB-A
  • it MUST implement the Android USB host API as documented in the Android SDK, and MUST declare support for the hardware feature android.hardware.usb.host [ Resources, 52 ]

Device implementations MUST implement the Android Debug Bridge. If a device implementation omits a USB client port, it MUST implement the Android Debug Bridge via local-area network (such as Ethernet or 802.11)

8. Performance Compatibility

Device implementations MUST meet the key performance metrics of an Android 4.0 compatible device defined in the table below:

متریک Performance Threshold نظرات
Application Launch Time The following applications should launch within the specified time.
  • Browser: less than 1300ms
  • Contacts: less than 700ms
  • Settings: less than 700ms
The launch time is measured as the total time to complete loading the default activity for the application, including the time it takes to start the Linux process, load the Android package into the Dalvik VM, and call onCreate.
Simultaneous Applications When multiple applications have been launched, re-launching an already-running application after it has been launched must take less than the original launch time.

9. Security Model Compatibility

Device implementations MUST implement a security model consistent with the Android platform security model as defined in Security and Permissions reference document in the APIs [ Resources, 54 ] in the Android developer documentation. Device implementations MUST support installation of self-signed applications without requiring any additional permissions/certificates from any third parties/authorities. Specifically, compatible devices MUST support the security mechanisms described in the follow sub-sections.

9.1. مجوزها

Device implementations MUST support the Android permissions model as defined in the Android developer documentation [ Resources, 54 ]. Specifically, implementations MUST enforce each permission defined as described in the SDK documentation; no permissions may be omitted, altered, or ignored. Implementations MAY add additional permissions, provided the new permission ID strings are not in the android.* namespace.

9.2. UID and Process Isolation

Device implementations MUST support the Android application sandbox model, in which each application runs as a unique Unix-style UID and in a separate process. Device implementations MUST support running multiple applications as the same Linux user ID, provided that the applications are properly signed and constructed, as defined in the Security and Permissions reference [ Resources, 54 ].

9.3. Filesystem Permissions

Device implementations MUST support the Android file access permissions model as defined in as defined in the Security and Permissions reference [ Resources, 54 ].

9.4. Alternate Execution Environments

Device implementations MAY include runtime environments that execute applications using some other software or technology than the Dalvik virtual machine or native code. However, such alternate execution environments MUST NOT compromise the Android security model or the security of installed Android applications, as described in this section.

Alternate runtimes MUST themselves be Android applications, and abide by the standard Android security model, as described elsewhere in Section 9.

Alternate runtimes MUST NOT be granted access to resources protected by permissions not requested in the runtime's AndroidManifest.xml file via the <uses-permission> mechanism.

Alternate runtimes MUST NOT permit applications to make use of features protected by Android permissions restricted to system applications.

Alternate runtimes MUST abide by the Android sandbox model. به طور مشخص:

  • Alternate runtimes SHOULD install apps via the PackageManager into separate Android sandboxes (that is, Linux user IDs, etc.)
  • Alternate runtimes MAY provide a single Android sandbox shared by all applications using the alternate runtime.
  • Alternate runtimes and installed applications using an alternate runtime MUST NOT reuse the sandbox of any other app installed on the device, except through the standard Android mechanisms of shared user ID and signing certificate
  • Alternate runtimes MUST NOT launch with, grant, or be granted access to the sandboxes corresponding to other Android applications.

Alternate runtimes MUST NOT be launched with, be granted, or grant to other applications any privileges of the superuser (root), or of any other user ID.

The .apk files of alternate runtimes MAY be included in the system image of a device implementation, but MUST be signed with a key distinct from the key used to sign other applications included with the device implementation.

When installing applications, alternate runtimes MUST obtain user consent for the Android permissions used by the application. That is, if an application needs to make use of a device resource for which there is a corresponding Android permission (such as Camera, GPS, etc.), the alternate runtime MUST inform the user that the application will be able to access that resource . If the runtime environment does not record application capabilities in this manner, the runtime environment MUST list all permissions held by the runtime itself when installing any application using that runtime.

10. Software Compatibility Testing

Device implementations MUST pass all tests described in this section.

However, note that no software test package is fully comprehensive. For this reason, device implementers are very strongly encouraged to make the minimum number of changes as possible to the reference and preferred implementation of Android 4.0 available from the Android Open Source Project. This will minimize the risk of introducing bugs that create incompatibilities requiring rework and potential device updates.

10.1. مجموعه تست سازگاری

Device implementations MUST pass the Android Compatibility Test Suite (CTS) [ Resources, 2 ] available from the Android Open Source Project, using the final shipping software on the device. Additionally, device implementers SHOULD use the reference implementation in the Android Open Source tree as much as possible, and MUST ensure compatibility in cases of ambiguity in CTS and for any reimplementations of parts of the reference source code.

The CTS is designed to be run on an actual device. Like any software, the CTS may itself contain bugs. The CTS will be versioned independently of this Compatibility Definition, and multiple revisions of the CTS may be released for Android 4.0. Device implementations MUST pass the latest CTS version available at the time the device software is completed.

10.2. تأیید کننده CTS

Device implementations MUST correctly execute all applicable cases in the CTS Verifier. The CTS Verifier is included with the Compatibility Test Suite, and is intended to be run by a human operator to test functionality that cannot be tested by an automated system, such as correct functioning of a camera and sensors.

The CTS Verifier has tests for many kinds of hardware, including some hardware that is optional. Device implementations MUST pass all tests for hardware which they possess; for instance, if a device possesses an accelerometer, it MUST correctly execute the Accelerometer test case in the CTS Verifier. Test cases for features noted as optional by this Compatibility Definition Document MAY be skipped or omitted.

Every device and every build MUST correctly run the CTS Verifier, as noted above. However, since many builds are very similar, device implementers are not expected to explicitly run the CTS Verifier on builds that differ only in trivial ways. Specifically, device implementations that differ from an implementation that has passed the CTS Verfier only by the set of included locales, branding, etc. MAY omit the CTS Verifier test.

10.3. کاربردهای مرجع

Device implementers MUST test implementation compatibility using the following open source applications:

  • The "Apps for Android" applications [ Resources, 55 ].
  • Replica Island (available in Android Market)

Each app above MUST launch and behave correctly on the implementation, for the implementation to be considered compatible.

11. Updatable Software

Device implementations MUST include a mechanism to replace the entirety of the system software. The mechanism need not perform "live" upgrades - that is, a device restart MAY be required.

Any method can be used, provided that it can replace the entirety of the software preinstalled on the device. For instance, any of the following approaches will satisfy this requirement:

  • Over-the-air (OTA) downloads with offline update via reboot
  • "Tethered" updates over USB from a host PC
  • "Offline" updates via a reboot and update from a file on removable storage

The update mechanism used MUST support updates without wiping user data. That is, the update mechanism MUST preserve application private data and application shared data. Note that the upstream Android software includes an update mechanism that satisfies this requirement.

If an error is found in a device implementation after it has been released but within its reasonable product lifetime that is determined in consultation with the Android Compatibility Team to affect the compatibility of third-party applications, the device implementer MUST correct the error via a software update available that can be applied per the mechanism just described.

12. تماس با ما

You can contact the document authors at compatibility@android.com for clarifications and to bring up any issues that you think the document does not cover.

Appendix A - Bluetooth Test Procedure

The Compatibility Test Suite includes cases that cover basic operation of the Android RFCOMM Bluetooth API. However, since Bluetooth is a communications protocol between devices, it cannot be fully tested by unit tests running on a single device. Consequently, device implementations MUST also pass the human-operated Bluetooth test procedure described below.

The test procedure is based on the BluetoothChat sample app included in the Android open source project tree. The procedure requires two devices:

  • a candidate device implementation running the software build to be tested
  • a separate device implementation already known to be compatible, and of a model from the device implementation being tested - that is, a "known good" device implementation

The test procedure below refers to these devices as the "candidate" and "known good" devices, respectively.

راه اندازی و نصب

  1. Build BluetoothChat.apk via 'make samples' from an Android source code tree.
  2. Install BluetoothChat.apk on the known-good device.
  3. Install BluetoothChat.apk on the candidate device.

Test Bluetooth Control by Apps

  1. Launch BluetoothChat on the candidate device, while Bluetooth is disabled.
  2. Verify that the candidate device either turns on Bluetooth, or prompts the user with a dialog to turn on Bluetooth.

Test Pairing and Communication

  1. Launch the Bluetooth Chat app on both devices.
  2. Make the known-good device discoverable from within BluetoothChat (using the Menu).
  3. On the candidate device, scan for Bluetooth devices from within BluetoothChat (using the Menu) and pair with the known-good device.
  4. Send 10 or more messages from each device, and verify that the other device receives them correctly.
  5. Close the BluetoothChat app on both devices by pressing Home .
  6. Unpair each device from the other, using the device Settings app.

Test Pairing and Communication in the Reverse Direction

  1. Launch the Bluetooth Chat app on both devices.
  2. Make the candidate device discoverable from within BluetoothChat (using the Menu).
  3. On the known-good device, scan for Bluetooth devices from within BluetoothChat (using the Menu) and pair with the candidate device.
  4. Send 10 or messages from each device, and verify that the other device receives them correctly.
  5. Close the Bluetooth Chat app on both devices by pressing Back repeatedly to get to the Launcher.

Test Re-Launches

  1. Re-launch the Bluetooth Chat app on both devices.
  2. Send 10 or messages from each device, and verify that the other device receives them correctly.

Note: the above tests have some cases which end a test section by using Home, and some using Back. These tests are not redundant and are not optional: the objective is to verify that the Bluetooth API and stack works correctly both when Activities are explicitly terminated (via the user pressing Back, which calls finish()), and implicitly sent to background (via the user pressing Home.) Each test sequence MUST be performed as described.