تعریف سازگاری اندروید 4.3

تجدید نظر 1
آخرین به روز رسانی: 23 جولای 2013

حق نشر © 2013، 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. تماس با ما

1. معرفی

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

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

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

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

در مواردی که این تعریف یا تست‌های نرم‌افزاری توضیح داده شده در بخش 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.3: http://source.android.com/docs/compatibility/4.3/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_guidelines/icon_design_status_bar.html
  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. مرجع 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، systrace): 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. دوربین: 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 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. انتقال اتصال NFC: http://www.nfc-forum.org/specs/spec_list/#conn_handover
  61. جفت‌سازی ساده بلوتوث ایمن با استفاده از NFC: http://www.nfc-forum.org/resources/AppDocs/NFCForum_AD_BTSSP_1_0.pdf
  62. Wifi Multicast API: http://developer.android.com/reference/android/net/wifi/WifiManager.MulticastLock.html
  63. Action Assist: http://developer.android.com/reference/android/content/Intent.html#ACTION_ASSIST
  64. مشخصات شارژ USB: http://www.usb.org/developers/devclass_docs/USB_Battery_Charging_1.2.pdf
  65. Android Beam: http://developer.android.com/guide/topics/nfc/nfc.html
  66. Android USB Audio: http://developer.android.com/reference/android/hardware/usb/UsbConstants.html#USB_CLASS_AUDIO
  67. تنظیمات اشتراک‌گذاری NFC Android: http://developer.android.com/reference/android/provider/Settings.html#ACTION_NFCSHARING_SETTINGS
  68. Wifi Direct (Wifi P2P): http://developer.android.com/reference/android/net/wifi/p2p/WifiP2pManager.html
  69. ویجت قفل و صفحه اصلی: http://developer.android.com/reference/android/appwidget/AppWidgetProviderInfo.html
  70. مرجع UserManager: http://developer.android.com/reference/android/os/UserManager.html
  71. مرجع حافظه خارجی: https://source.android.com/docs/core/storage
  72. APIهای حافظه خارجی: http://developer.android.com/reference/android/os/Environment.html
  73. کد کوتاه پیامکی: http://en.wikipedia.org/wiki/Short_code
  74. سرویس گیرنده کنترل از راه دور رسانه: http://developer.android.com/reference/android/media/RemoteControlClient.html
  75. مدیر نمایش: http://developer.android.com/reference/android/hardware/display/DisplayManager.html
  76. رویاها: http://developer.android.com/reference/android/service/dreams/DreamService.html
  77. تنظیمات مربوط به توسعه برنامه Android: http://developer.android.com/reference/android/provider/Settings.html#ACTION_APPLICATION_DEVELOPMENT_SETTINGS
  78. دوربین: http://developer.android.com/reference/android/hardware/Camera.Parameters.html
  79. برنامه افزودنی EGL-EGL_ANDROID_RECORDABLE: http://www.khronos.org/registry/egl/extensions/ANDROID/EGL_ANDROID_recordable.txt
  80. Motion Event API: http://developer.android.com/reference/android/view/MotionEvent.html
  81. پیکربندی ورودی لمسی: http://source.android.com/docs/core/interaction/input/touch-devices.html

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

3. نرم افزار

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

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

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

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

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

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

3.2.1. مجوزها

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

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

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

پارامتر نظرات
android.os.Build.VERSION.RELEASE نسخه سیستم اندروید در حال اجرا، در قالب قابل خواندن توسط انسان. این فیلد باید دارای یکی از مقادیر رشته تعریف شده در [ منابع، 7 ] باشد.
android.os.Build.VERSION.SDK نسخه سیستم Android در حال اجرا، در قالبی که برای کد برنامه شخص ثالث قابل دسترسی است. برای اندروید 4.3، این فیلد باید دارای عدد صحیح 18 باشد.
android.os.Build.VERSION.SDK_INT نسخه سیستم Android در حال اجرا، در قالبی که برای کد برنامه شخص ثالث قابل دسترسی است. برای اندروید 4.3، این فیلد باید دارای عدد صحیح 18 باشد.
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.3/JRN53/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 را مدیریت می کنند، انتخاب کند، اما محدود به آن نمی شود.

با این حال، اگر فعالیت پیش‌فرض فیلتر مشخص‌تری برای URI داده ارائه دهد، ممکن است پیاده‌سازی‌های دستگاه، فعالیت‌های پیش‌فرض را برای الگوهای URI خاص (مانند http://play.google.com) ارائه دهند. به عنوان مثال، فیلتر قصدی که URI داده "http://www.android.com" را مشخص می کند، از فیلتر مرورگر برای "http://" خاص تر است. پیاده‌سازی‌های دستگاه باید یک رابط کاربری برای کاربران فراهم کنند تا فعالیت پیش‌فرض را برای 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 تعدادی رابط باینری برنامه (ABIs) را در Android NDK در فایل docs/CPU-ARCH-ABIS.html تعریف می‌کند. اگر پیاده‌سازی دستگاه با یک یا چند 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)
  • libGLESv3.so (OpenGL ES 3.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 را گزارش کند.

توجه داشته باشید که پیاده‌سازی‌های دستگاه باید شامل libGLESv3.so باشد و باید پیوند نمادین (سمبلیک) به libGLESv2.so باشد. در پیاده‌سازی‌های دستگاهی که از OpenGL ES 3.0، libGLESv2.so پشتیبانی می‌کنند، باید نمادهای تابع OpenGL ES 3.0 را علاوه بر نمادهای عملکرد OpenGL ES 2.0 صادر کنند.

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

3.4. سازگاری وب

3.4.1. سازگاری WebView

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

  • پیاده‌سازی‌های دستگاه android.webkit.WebView باید بر اساس ساخت WebKit 534.30 از درخت متن باز Android برای Android 4.3 باشد. این ساخت شامل مجموعه خاصی از عملکردها و اصلاحات امنیتی برای 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 یکسان باشد.
    • پیاده سازی دستگاه ممکن است Mobile در رشته عامل کاربر حذف کند

مؤلفه 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 مطابقت داشته باشد [ منابع، 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 4.3 شامل یک برنامه راه‌انداز (صفحه اصلی) و پشتیبانی از برنامه‌های شخص ثالث برای جایگزینی لانچر دستگاه (صفحه اصلی) است. پیاده‌سازی‌های دستگاهی که به برنامه‌های شخص ثالث اجازه می‌دهند صفحه اصلی دستگاه را جایگزین کنند، باید ویژگی پلتفرم android.software.home_screen را اعلام کنند.

3.8.2. ابزارک ها

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

  • راه‌اندازهای دستگاه باید شامل پشتیبانی داخلی برای AppWidgets باشند و امکانات رابط کاربری را برای افزودن، پیکربندی، مشاهده و حذف AppWidgets مستقیماً در Launcher در معرض نمایش بگذارند.
  • پیاده‌سازی دستگاه باید دارای قابلیت رندر کردن ویجت‌هایی باشد که 4×4 در اندازه شبکه استاندارد هستند. (برای جزئیات، دستورالعمل‌های طراحی ابزارک برنامه را در مستندات Android SDK [ منابع، 18 ] ببینید.
  • پیاده‌سازی‌های دستگاهی که شامل پشتیبانی از صفحه قفل می‌شوند، باید از ویجت‌های برنامه در صفحه قفل پشتیبانی کنند.

3.8.3. اطلاعیه

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

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

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

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

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

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

3.8.5. نان تست

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

3.8.6. تم ها

اندروید «موضوعات» را به عنوان مکانیزمی برای برنامه‌ها برای اعمال سبک‌ها در کل یک فعالیت یا برنامه ارائه می‌کند. Android 4.3 شامل یک تم «هولو» یا «هولوگرافیک» به عنوان مجموعه‌ای از سبک‌های تعریف‌شده برای توسعه‌دهندگان برنامه است تا اگر می‌خواهند با ظاهر و احساس تم Holo مطابق با Android SDK [ منابع، 24 ] استفاده کنند. پیاده‌سازی دستگاه نباید هیچ یک از ویژگی‌های موضوع Holo را که در معرض برنامه‌ها قرار می‌گیرد تغییر دهد [ منابع، 25 ].

Android 4.3 شامل یک تم جدید «Device Default» به عنوان مجموعه‌ای از سبک‌های تعریف‌شده برای توسعه‌دهندگان برنامه است تا در صورتی که می‌خواهند با ظاهر و احساس تم دستگاه مطابقت داشته باشند، همانطور که پیاده‌کننده دستگاه تعریف کرده است، از آن استفاده کنند. پیاده‌سازی‌های دستگاه ممکن است ویژگی‌های موضوع DeviceDefault را که در معرض برنامه‌ها قرار می‌گیرند، تغییر دهند [ منابع، 25 ].

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

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

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

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

3.8.8. نمایش برنامه اخیر

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

3.8.9. مدیریت ورودی

Android 4.3 شامل پشتیبانی از مدیریت ورودی و پشتیبانی از ویرایشگرهای روش ورودی شخص ثالث است. پیاده‌سازی‌های دستگاهی که به کاربران اجازه می‌دهند از روش‌های ورودی شخص ثالث در دستگاه استفاده کنند، باید ویژگی پلتفرم android.software.input_methods را اعلام کرده و از APIهای IME همانطور که در مستندات Android SDK تعریف شده است، پشتیبانی کنند.

پیاده‌سازی‌های دستگاهی که ویژگی android.software.input_methods را اعلام می‌کنند باید مکانیزمی در دسترس کاربر برای افزودن و پیکربندی روش‌های ورودی شخص ثالث ارائه دهند. پیاده سازی دستگاه باید رابط تنظیمات را در پاسخ به هدف android.settings.INPUT_METHOD_SETTINGS نمایش دهد.

3.8.10. کنترل از راه دور رسانه قفل صفحه نمایش

Android 4.3 شامل پشتیبانی از Remote Control API است که به برنامه‌های رسانه اجازه می‌دهد با کنترل‌های پخش که در نمای راه دور مانند صفحه قفل دستگاه نمایش داده می‌شوند، یکپارچه شوند [ Resources, 74 ]. پیاده‌سازی‌های دستگاهی که از صفحه قفل در دستگاه پشتیبانی می‌کنند و به کاربران اجازه می‌دهند ویجت‌ها را در صفحه اصلی اضافه کنند، باید شامل پشتیبانی از جاسازی کنترل‌های از راه دور در صفحه قفل دستگاه باشد [ منابع، 69 ].

3.8.11. رویاها

Android 4.3 شامل پشتیبانی از محافظ های صفحه نمایش تعاملی به نام Dreams [ منابع، 76 ] است. Dreams به کاربران این امکان را می‌دهد تا زمانی که دستگاه شارژ بی‌حرکت است یا در پایه میز قرار دارد، با برنامه‌ها تعامل داشته باشند. پیاده سازی دستگاه باید شامل پشتیبانی از Dreams و ارائه یک گزینه تنظیمات برای کاربران برای پیکربندی Dreams باشد.

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

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

3.10 دسترسی

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

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

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

3.11 تبدیل متن به گفتار

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

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

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

پیاده سازی های دستگاه باید فایل های Android ".apk" را نصب و اجرا کنند که توسط ابزار "aapt" موجود در SDK رسمی Android [ منابع، 33 ] تولید شده است.

پیاده‌سازی دستگاه‌ها نباید فرمت‌های apk [ Resources, 34 ]، Android Manifest [ Resources, 35 ]، بایت کد Dalvik [ منابع، 17 ] یا رندر اسکریپت بایت کد را به گونه‌ای گسترش دهند که مانع از نصب و اجرای صحیح آن فایل‌ها شود. سایر دستگاه های سازگار پیاده‌کننده‌های دستگاه باید از پیاده‌سازی بالادستی مرجع Dalvik و سیستم مدیریت بسته پیاده‌سازی مرجع استفاده کنند.

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

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

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

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

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

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

تایپ کنید قالب / کدک رمزگذار رمزگشا جزئیات نوع فایل (ها) / قالب های کانتینر
سمعی نمایه MPEG-4 AAC (AAC LC) برای پیاده سازی دستگاهی که شامل سخت افزار میکروفون است و android.hardware.microphone تعریف می کند، مورد نیاز است. ضروری پشتیبانی از محتوای مونو/استریو/5.0/5.1* با نرخ نمونه برداری استاندارد از 8 تا 48 کیلوهرتز.
  • 3GPP (.3gp)
  • MPEG-4 (mp4, .m4a)
  • ADTS خام AAC (aac.، رمزگشایی در Android نسخه 3.1 و بالاتر، رمزگذاری در Android نسخه 4.0 و بالاتر، ADIF پشتیبانی نمی‌شود)
  • MPEG-TS (.ts، غیر قابل جستجو، Android نسخه 3.0 و بالاتر)
نمایه MPEG-4 HE AAC (AAC+) برای پیاده سازی دستگاهی که شامل سخت افزار میکروفون و تعریف android.hardware.microphone هستند، مورد نیاز است ضروری پشتیبانی از محتوای مونو/استریو/5.0/5.1* با نرخ نمونه برداری استاندارد از 16 تا 48 کیلوهرتز.
نمایه MPEG-4 HE AAC v2 (AAC+ پیشرفته) ضروری پشتیبانی از محتوای مونو/استریو/5.0/5.1* با نرخ نمونه برداری استاندارد از 16 تا 48 کیلوهرتز.
نوع شیء صوتی MPEG-4 ER AAC ELD (AAC با تاخیر کم پیشرفته) برای پیاده سازی دستگاهی که شامل سخت افزار میکروفون و تعریف android.hardware.microphone هستند، مورد نیاز است ضروری پشتیبانی از محتوای مونو/استریو با نرخ نمونه برداری استاندارد از 16 تا 48 کیلوهرتز.
AMR-NB برای پیاده سازی دستگاهی که شامل سخت افزار میکروفون است و android.hardware.microphone تعریف می کند، مورد نیاز است. ضروری نمونه برداری از 4.75 تا 12.2 کیلوبیت بر ثانیه @ 8kHz 3GPP (.3gp)
AMR-WB برای پیاده سازی دستگاهی که شامل سخت افزار میکروفون است و android.hardware.microphone تعریف می کند، مورد نیاز است. ضروری 9 نرخ از 6.60 کیلوبیت بر ثانیه تا 23.85 کیلوبیت بر ثانیه نمونه برداری در 16 کیلوهرتز 3GPP (.3gp)
FLAC ضروری
(اندروید 3.1 و بالاتر)
مونو/استریو (بدون چند کانال). نرخ نمونه تا 48 کیلوهرتز (اما تا 44.1 کیلوهرتز در دستگاه‌هایی با خروجی 44.1 کیلوهرتز توصیه می‌شود، زیرا نمونه‌برداری پایین 48 تا 44.1 کیلوهرتز فاقد فیلتر پایین‌گذر است). 16 بیتی توصیه می شود. هیچ دودی برای 24 بیت اعمال نشد. فقط FLAC (.flac).
MP3 ضروری ثابت مونو/استریو 8-320 کیلوبیت بر ثانیه (CBR) یا نرخ بیت متغیر (VBR) MP3 (mp3.)
MIDI ضروری MIDI نوع 0 و 1. DLS نسخه 1 و 2. XMF و Mobile XMF. پشتیبانی از فرمت های آهنگ زنگ RTTTL/RTX، OTA و iMelody
  • نوع 0 و 1 (.mid، .xmf، .mxmf)
  • RTTTL/RTX (rttl.، rtx.)
  • OTA (.ota)
  • iMelody (.imy)
وربیس ضروری
  • Ogg (.ogg)
  • Matroska (.mkv)
PCM/WAVE ضروری ضروری PCM خطی 8 بیتی و 16 بیتی** (نرخ تا سقف سخت افزار). دستگاه ها باید از نرخ نمونه برداری برای ضبط خام PCM در فرکانس های 8000، 16000 و 44100 هرتز پشتیبانی کنند. موج (.wav)
تصویر JPEG ضروری ضروری پایه + پیشرو JPEG (jpg.)
GIF ضروری GIF (.gif)
PNG ضروری ضروری PNG (png.)
BMP ضروری BMP (.bmp)
WEBP ضروری ضروری 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 ضروری
(اندروید 4.3 و بالاتر)
ضروری
(اندروید 2.3.3 و بالاتر)
WebM (webm.) و Matroska (.mkv، Android 4.0+)***
  • * توجه: فقط downmix از محتوای 5.0/5.1 مورد نیاز است. ضبط یا رندر بیش از 2 کانال اختیاری است.
  • **توجه: ضبط PCM خطی 16 بیتی الزامی است. ضبط PCM خطی 8 بیتی اجباری نیست.
  • ***توجه: پیاده سازی دستگاه باید از نوشتن فایل های Matroska WebM پشتیبانی کند.

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

پیاده‌سازی‌های دستگاه Android که شامل دوربین پشتی هستند و android.hardware.camera اعلام می‌کنند، باید از نمایه‌های رمزگذاری ویدیوی H.264 زیر پشتیبانی کنند.

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

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

SD (کیفیت پایین) SD (کیفیت بالا) HD 720p
(در صورت پشتیبانی از سخت افزار)
HD 1080p
(در صورت پشتیبانی از سخت افزار)
کیفیت ویدیو 320 × 180 پیکسل 640 x 360 پیکسل 1280 x 720 پیکسل 1920 x 1080 پیکسل
نرخ فریم ویدیو 30 فریم بر ثانیه 30 فریم بر ثانیه 30 فریم بر ثانیه 30 فریم بر ثانیه
میزان بیت ویدیو 800 کیلوبیت بر ثانیه 2 مگابیت بر ثانیه 4 مگابیت بر ثانیه 10 مگابیت بر ثانیه

5.3 رمزگشایی ویدیو

پیاده‌سازی دستگاه Android باید از نمایه‌های رمزگشایی ویدیوی VP8 و H.264 زیر پشتیبانی کند.

SD (کیفیت پایین) SD (کیفیت بالا) HD 720p
(در صورت پشتیبانی از سخت افزار)
HD 1080p
(در صورت پشتیبانی از سخت افزار)
کیفیت ویدیو 320 × 180 پیکسل 640 x 360 پیکسل 1280 x 720 پیکسل 1920 x 1080 پیکسل
نرخ فریم ویدیو 30 فریم بر ثانیه 30 فریم بر ثانیه 30 فریم بر ثانیه 30 فریم بر ثانیه
میزان بیت ویدیو 800 کیلوبیت بر ثانیه 2 مگابیت بر ثانیه 8 مگابیت بر ثانیه 20 مگابیت بر ثانیه

5.4. ضبط صدا

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

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

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

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

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

5.5. تأخیر صوتی

تأخیر صوتی، تأخیر زمانی است که سیگنال صوتی از یک سیستم عبور می کند. بسیاری از کلاس‌های برنامه‌ها برای دستیابی به جلوه‌های صوتی بلادرنگ به تأخیرهای کوتاه متکی هستند.

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

  • "تأخیر خروجی" به عنوان فاصله زمانی بین زمانی که یک برنامه یک فریم از داده های کدگذاری شده با PCM می نویسد و زمانی که صدای مربوطه می تواند توسط یک شنونده خارجی شنیده شود یا توسط یک مبدل مشاهده شود تعریف می شود.
  • "تأخیر خروجی سرد" به عنوان تأخیر خروجی برای اولین فریم تعریف می شود، زمانی که سیستم خروجی صدا قبل از درخواست بیکار بوده و خاموش شده باشد.
  • «تأخیر خروجی پیوسته» به عنوان تأخیر خروجی برای فریم‌های بعدی، پس از اینکه دستگاه قبلاً صدا را پخش می‌کند، تعریف می‌شود.
  • "تأخیر ورودی" فاصله زمانی بین زمانی که یک صدای خارجی به دستگاه ارائه می شود و زمانی که یک برنامه کاربردی فریم مربوطه از داده های رمزگذاری شده با PCM را می خواند، است.
  • "تأخیر ورودی سرد" به عنوان مجموع زمان ورودی از دست رفته و تاخیر ورودی برای اولین فریم تعریف می شود، زمانی که سیستم ورودی صوتی قبل از درخواست بیکار و خاموش شده باشد.
  • «تأخیر ورودی پیوسته» به عنوان تأخیر ورودی برای فریم‌های بعدی تعریف می‌شود، در حالی که دستگاه از قبل صدا را ضبط می‌کند.
  • "OpenSL ES PCM buffer queue API" مجموعه ای از APIهای OpenSL ES مرتبط با PCM در Android NDK است. به NDK_root /docs/opensles/index.html مراجعه کنید

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

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

اگر پیاده‌سازی دستگاهی پس از هر کالیبراسیون اولیه هنگام استفاده از OpenSL ES PCM صف بافر API، برای تأخیر مداوم خروجی و تأخیر خروجی سرد بیش از حداقل یک دستگاه خروجی صوتی پشتیبانی‌شده، الزامات این بخش را برآورده کند، ممکن است پشتیبانی از صدای کم تأخیر را گزارش کند. ، با گزارش ویژگی "android.hardware.audio.low-latency" از طریق کلاس android.content.pm.PackageManager . [ منابع، 37 ] برعکس، اگر پیاده‌سازی دستگاه این الزامات را برآورده نمی‌کند، نباید پشتیبانی از صدای با تأخیر کم را گزارش کند.

طبق بخش 7.2.5 ، سخت افزار میکروفون ممکن است توسط پیاده سازی دستگاه حذف شود.

پیاده‌سازی‌های دستگاهی که شامل سخت‌افزار میکروفون هستند و android.hardware.microphone اعلام می‌کنند، باید این الزامات تأخیر صوتی ورودی را برآورده کنند:

  • تأخیر ورودی سرد 100 میلی ثانیه یا کمتر
  • تأخیر ورودی پیوسته 50 میلی ثانیه یا کمتر

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

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

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

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

6.1 ابزارهای توسعه دهنده

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

  • پل اشکال زدایی اندروید (معروف به adb) [ منابع، 33 ]
    پیاده سازی دستگاه باید از همه عملکردهای adb همانطور که در Android SDK مستند شده است پشتیبانی کند. دیمون adb سمت دستگاه باید به طور پیش‌فرض غیرفعال باشد و باید مکانیزمی در دسترس کاربر برای روشن کردن Android Debug Bridge وجود داشته باشد.
  • اندروید 4.3 شامل پشتیبانی از adb امن است. Secure adb، adb را در میزبان های احراز هویت شناخته شده فعال می کند. پیاده سازی دستگاه باید از adb ایمن پشتیبانی کند.
  • Dalvik Debug Monitor Service (معروف به ddms) [ منابع، 33 ]
    پیاده سازی دستگاه باید از همه ویژگی های ddms همانطور که در Android SDK مستند شده است پشتیبانی کند. از آنجایی که ddms از adb استفاده می کند، پشتیبانی از ddms باید به طور پیش فرض غیرفعال باشد، اما هر زمان که کاربر پل اشکال زدایی اندروید را فعال کرده باشد، باید پشتیبانی شود.
  • میمون [ منابع، 36 ]
    پیاده سازی دستگاه باید چارچوب Monkey را شامل شود و آن را برای استفاده برنامه ها در دسترس قرار دهد.
  • SysTrace [ منابع، 33 ]
    پیاده سازی دستگاه باید از ابزار systrace همانطور که در Android SDK مستند شده است پشتیبانی کند. Systrace باید به طور پیش‌فرض غیرفعال باشد، و باید مکانیزمی برای روشن کردن Systrace وجود داشته باشد.

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

6.2 گزینه های توسعه دهنده

Android 4.3 شامل پشتیبانی از توسعه دهندگان برای پیکربندی تنظیمات مربوط به توسعه برنامه است. پیاده‌سازی‌های دستگاه باید به قصد android.settings.APPLICATION_DEVELOPMENT_SETTINGS برای نمایش تنظیمات مربوط به توسعه برنامه احترام بگذارند [ منابع، 77 ]. اجرای upstream Android منوی Developer Options را به طور پیش‌فرض پنهان می‌کند و کاربران را قادر می‌سازد تا پس از فشار دادن هفت (7) بار روی گزینه Settings > About Device > Build Number گزینه‌های Developer Options را اجرا کنند. پیاده سازی دستگاه باید یک تجربه ثابت برای گزینه های برنامه نویس ارائه دهد. به طور خاص، پیاده‌سازی‌های دستگاه باید به‌طور پیش‌فرض گزینه‌های توسعه‌دهنده را پنهان کنند و باید مکانیزمی برای فعال کردن گزینه‌های توسعه‌دهنده فراهم کنند که با پیاده‌سازی بالادستی Android سازگار باشد.

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

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

  • تعاریف کامل کلاس (همانطور که توسط SDK مستند شده است) برای APIهای مؤلفه باید هنوز وجود داشته باشد
  • رفتارهای API باید به صورت بدون عملیات به روشی معقول اجرا شوند
  • روش‌های API باید مقادیر تهی را در مواردی که توسط اسناد SDK مجاز است، برگردانند
  • روش‌های API باید پیاده‌سازی‌های بدون عملیات کلاس‌هایی را که در آن‌ها مقادیر تهی توسط اسناد SDK مجاز نیستند، برگردانند.
  • متدهای API نباید استثناهایی را که توسط مستندات SDK مستند نشده است ایجاد کنند

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

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

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

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

واحدهای مورد نیاز در این بخش به شرح زیر تعریف می شوند:

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

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

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

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

  • اندازه صفحه نمایش دستگاه ها باید حداقل 426 dp x 320 dp ("کوچک") باشد.
  • دستگاه هایی که اندازه صفحه نمایش "عادی" را گزارش می کنند باید دارای اندازه صفحه نمایش حداقل 480 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"
  • 480 dpi ، معروف به "xxhdpi"
  • 640 dpi ، معروف به "xxxhdpi"
پیاده سازی دستگاه باید چگالی استاندارد فریم ورک 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 تجسم یافته و مفصل است. پیاده سازی دستگاه باید از OpenGL ES 3.0 در دستگاه هایی که قادر به پشتیبانی از OpenGL ES 3.0 هستند پشتیبانی کند. اجرای دستگاه همچنین باید از Android Renderscript پشتیبانی کند ، همانطور که در اسناد Android SDK [ منابع ، 8 ] شرح داده شده است.

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

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

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

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

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

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

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

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

Android 4.3 شامل پشتیبانی از EGL_ANDROID_RECORDABLE ، یک ویژگی EGLCONFIG است که نشان می دهد آیا EGLCONFIG از ارائه به یک AnativeWindow پشتیبانی می کند که تصاویر را به یک فیلم ضبط می کند. پیاده سازی دستگاه باید از پسوند EGL_ANDROID_RECORDABLE پشتیبانی کند [ منابع ، 79 ].

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

Android 4.3 یک "حالت سازگاری" را مشخص می کند که در آن چارچوب در حالت معادل صفحه نمایش "عادی" (عرض 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 (همچنین به عنوان 720p نیز شناخته می شود): اندازه صفحه نمایش بزرگ ، "TVDPI" (213 dpi) چگالی
  • 1920x1080 (همچنین به عنوان 1080p شناخته می شود): اندازه صفحه نمایش بزرگ ، "XHDPI" (320 dpi) چگالی

برای وضوح ، پیاده سازی دستگاه با ابعاد پیکسل متغیر در Android 4.3 به 720p یا 1080p محدود می شود و باید برای گزارش اندازه صفحه نمایش و چگالی همانطور که در بالا ذکر شد ، پیکربندی شود.

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

پلت فرم Android شامل API است که به برنامه ها اجازه می دهد تا گرافیک های غنی را به صفحه نمایش ارائه دهند. دستگاه ها باید از همه این API ها مطابق با Android SDK پشتیبانی کنند ، مگر اینکه به طور خاص در این سند مجاز باشد. به طور مشخص:

  • دستگاه ها باید از نمایشگرهایی که قادر به ارائه گرافیک رنگی 16 بیتی هستند پشتیبانی کنند و باید از نمایشگرهایی که قادر به گرافیک رنگی 24 بیتی هستند پشتیبانی کنند.
  • دستگاه ها باید از نمایشگرهایی که قادر به ارائه انیمیشن هستند پشتیبانی کنند.
  • فناوری نمایشگر مورد استفاده باید دارای نسبت ابعاد پیکسل (PAR) بین 0.9 و 1.1 باشد. یعنی نسبت ابعاد پیکسل باید نزدیک مربع (1.0) با تحمل 10 ٪ باشد.

7.1.8. نمایش های خارجی

Android 4.3 شامل پشتیبانی از نمایشگر ثانویه برای فعال کردن قابلیت اشتراک گذاری رسانه ها و API های توسعه دهنده برای دسترسی به نمایشگرهای خارجی است. اگر یک دستگاه از یک صفحه نمایش خارجی یا از طریق یک اتصال نمایشگر سیمی ، بی سیم یا تعبیه شده پشتیبانی کند ، اجرای دستگاه باید API Display Manager را همانطور که در اسناد Android SDK شرح داده شده است ، پیاده سازی کند [ منابع ، 75 ]. پیاده سازی دستگاه هایی که از خروجی ویدیوی ایمن پشتیبانی می کنند و قادر به پشتیبانی از سطوح امن هستند ، باید پشتیبانی را برای Display.FLAG_SECURE اعلام کنند. به طور خاص ، پیاده سازی دستگاه هایی که پشتیبانی از Display.FLAG_SECURE را اعلام می کنند ، باید از HDCP 2.x یا بالاتر برای نمایشگرهای بی سیم Miracast یا HDCP 1.2 یا بالاتر برای نمایشگرهای سیمی پشتیبانی کنند. اجرای منبع باز اندروید بالادست شامل پشتیبانی از نمایشگرهای بی سیم (Miracast) و سیمی (HDMI) است که این نیاز را برآورده می کند.

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

7.2.1. صفحه کلید

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

  • باید شامل پشتیبانی از چارچوب مدیریت ورودی (که به توسعه دهندگان شخص ثالث اجازه می دهد موتورهای مدیریت ورودی - یعنی صفحه کلید نرم) ایجاد کنند ، همانطور که در http://developer.android.com به تفصیل شرح داده شده است.
  • باید حداقل یک اجرای صفحه کلید نرم (بدون توجه به وجود صفحه کلید سخت) ارائه کند.
  • ممکن است شامل اجرای صفحه کلید نرم افزاری اضافی باشد
  • ممکن است شامل یک صفحه کلید سخت افزاری باشد
  • نباید شامل یک صفحه کلید سخت افزاری باشد که با یکی از قالب های مشخص شده در android.content.res.Configuration.keyboard مطابقت ندارد.

7.2.2. ناوبری بدون لمس

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

  • ممکن است یک گزینه ناوبری غیر لمسی را حذف کند (یعنی ممکن است یک گوی، d-pad یا چرخ را حذف کند)
  • باید مقدار صحیح را برای android.content.res.Configuration.navigation [ منابع ، 40 ] گزارش دهد
  • باید یک مکانیسم رابط کاربری جایگزین معقول برای انتخاب و ویرایش متن، سازگار با موتورهای مدیریت ورودی ارائه کند. اجرای منبع باز اندروید بالادست شامل یک مکانیسم انتخاب مناسب برای استفاده با دستگاه هایی است که فاقد ورودی های ناوبری غیر لمسی هستند.

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

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

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

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

  • کلیدهای ناوبری اجرای دستگاه باید از بخش مشخصی از صفحه استفاده کنند ، در دسترس برنامه ها نیستند ، و نباید مبهم یا در غیر این صورت با بخشی از صفحه نمایش موجود در برنامه ها تداخل داشته باشند.
  • پیاده سازی دستگاه باید بخشی از نمایشگر را برای برنامه هایی که مطابق با الزامات تعریف شده در بخش 7.1.1 است ، در دسترس قرار دهد.
  • اجرای دستگاه باید کلیدهای ناوبری را نشان دهد که برنامه ها حالت UI سیستم را مشخص نکنند ، یا SYSTEM_UI_FLAG_VISIBLE را مشخص کنند.
  • اجرای دستگاه باید کلیدهای ناوبری را در حالت "کم مشخصات" (به عنوان مثال کم رنگ) بدون استفاده از برنامه ها SYSTEM_UI_FLAG_LOW_PROFILE مشخص کند.
  • اجرای دستگاه باید کلیدهای ناوبری را پنهان کند وقتی برنامه ها SYSTEM_UI_FLAG_HIDE_NAVIGATION را مشخص می کنند.
  • اجرای دستگاه باید یک کلید منو را برای برنامه ها در هنگام TargetSdkVersion <= 10 ارائه دهد و نباید یک کلید منو را در هنگام TargetSdkVersion> 10 ارائه دهد.

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

پیاده سازی دستگاه باید از نوع ورودی اشاره گر به نوعی (یا مانند ماوس یا لمس) برخوردار باشد. با این حال ، اگر اجرای دستگاه از یک سیستم ورودی اشاره گر پشتیبانی نمی کند ، نباید از android.hardware.touchscreen یا android.hardware.faketouch ثابت گزارش کند. پیاده سازی دستگاه هایی که شامل یک سیستم ورودی اشاره گر است:

  • اگر سیستم ورودی دستگاه از چندین نشانگر پشتیبانی کند ، باید از نشانگرهای کاملاً مستقل پشتیبانی کند
  • باید مقدار android.content.res.Configuration.touchscreen [ منابع ، 40 ] مربوط به نوع صفحه لمسی خاص موجود در دستگاه را گزارش کند.

Android 4.3 شامل پشتیبانی از انواع صفحه های لمسی ، لنت های لمسی و دستگاه های ورودی لمسی جعلی است. پیاده سازی دستگاه های مبتنی بر صفحه نمایش لمسی با یک صفحه نمایش [ منابع ، 81 ] همراه است به گونه ای که کاربر تصور می کند که موارد دستکاری مستقیم روی صفحه را داشته باشد. از آنجا که کاربر مستقیماً در حال لمس کردن صفحه است ، سیستم برای نشان دادن اشیاء دستکاری شده به هیچ هزینه اضافی نیاز ندارد. در مقابل ، یک رابط لمسی جعلی یک سیستم ورودی کاربر را فراهم می کند که زیر مجموعه ای از قابلیت های صفحه لمسی را تقریبی می کند. به عنوان مثال ، یک کنترل ماوس یا از راه دور که یک مکان نما روی صفحه را هدایت می کند ، لمس را تقریبی می کند ، اما به کاربر نیاز دارد که ابتدا نقطه یا تمرکز کند و سپس کلیک کند. دستگاه های ورودی بی شماری مانند ماوس ، TrackPad ، موش هوای مبتنی بر Gyro ، Gyro-Pointer ، Joystick و TrackPad چند لمسی می توانند از تعامل لمسی جعلی پشتیبانی کنند. Android 4.0 شامل ویژگی android.hardware.faketouch است که مربوط به یک دستگاه ورودی غیر لمسی (یعنی مبتنی بر اشاره گر) مانند ماوس یا پیست است که می تواند به اندازه کافی از ورودی مبتنی بر لمس استفاده کند (از جمله ژست اساسی پشتیبانی) ، و نشان می دهد که دستگاه از زیر مجموعه تقلیدی از عملکرد صفحه لمسی پشتیبانی می کند. پیاده سازی دستگاه هایی که ویژگی لمسی جعلی را اعلام می کنند باید در بخش 7.2.5 نیازهای لمسی جعلی را برآورده کنند.

پیاده سازی دستگاه باید ویژگی صحیح مربوط به نوع ورودی مورد استفاده را گزارش دهد. پیاده سازی های دستگاه که شامل یک صفحه لمسی (تک لمسی یا بهتر) است باید ویژگی پلتفرم ثابت android.hardware.touchscreen را گزارش کند. پیاده سازی دستگاه هایی که از ویژگی های سیستم عامل ثابت android.hardware.touchscreen گزارش می کنند نیز باید ویژگی سیستم عامل android.hardware.faketouch را گزارش کند. پیاده سازی های دستگاه که شامل صفحه لمسی نیست (و فقط به یک دستگاه اشاره گر تکیه می کند) نباید هیچ ویژگی صفحه لمسی را گزارش کند ، و در صورت برآورده کردن نیازهای لمسی جعلی در بخش 7.2.5 فقط باید android.hardware.faketouch را گزارش دهد.

7.2.5. ورودی لمسی جعلی

پیاده سازی دستگاه هایی که پشتیبانی از android.hardware.faketouch را اعلام می کنند

  • باید موقعیت های صفحه نمایش مطلق X و Y را از محل نشانگر گزارش دهید و یک نشانگر بصری را روی صفحه نمایش دهید [ منابع ، 80 ]
  • باید رویداد لمسی را با کد عمل [ منابع ، 80 ] گزارش دهد که تغییر دولت را که روی نشانگر در حال down آمدن یا up روی صفحه است ، مشخص می کند [ منابع ، 80 ]
  • باید از نشانگر down و up روی یک شی روی صفحه پشتیبانی کند ، که به کاربران امکان می دهد تا شیر را روی یک شی روی صفحه تقلید کنند
  • باید از نشانگر down ، نشانگر up ، نشانگر down سپس up در همان مکان روی یک شی روی صفحه در یک آستانه زمان ، که به کاربران امکان می دهد تا دو شیء را روی یک شی روی صفحه نشان دهند [ منابع ، 80 ]
  • باید down اشاره گر در یک نقطه دلخواه روی صفحه پشتیبانی کند ، نشانگر به هر نقطه دلخواه دیگر روی صفحه حرکت می کند و به دنبال آن یک نشانگر up ، که به کاربران امکان می دهد یک لمس لمسی را تقلید کنند
  • باید از اشاره گر down پشتیبانی کند و سپس به کاربران اجازه می دهد تا شیء را به سرعت به موقعیت دیگری روی صفحه منتقل کنند و سپس روی صفحه نمایش up ، که به کاربران امکان می دهد یک شیء را روی صفحه بچرخانند

دستگاه هایی که پشتیبانی از android.hardware.faketouch.multitouch.distinct را اعلام می کنند باید الزامات Faketouch را در بالا برآورده کنند ، و همچنین باید از ردیابی مجزا از دو یا چند ورودی اشاره گر مستقل پشتیبانی کنند.

7.2.6. میکروفون

اجرای دستگاه ممکن است میکروفون را حذف کند. با این حال ، اگر اجرای دستگاه میکروفون را از بین ببرد ، نباید از ویژگی های android.hardware.microphone ثابت گزارش کند ، و باید در هر بخش 7 API ضبط صوتی را به عنوان NO-OPS پیاده سازی کند. برعکس ، پیاده سازی دستگاه هایی که دارای میکروفون هستند:

  • باید از ویژگی android.hardware.microphone ثابت گزارش دهید
  • باید در بخش 5.4 الزامات کیفیت صوتی را برآورده کند
  • باید در بخش 5.5 نیازهای تأخیر صوتی را برآورده کند

7.3. حسگرها

Android 4.3 شامل API برای دسترسی به انواع سنسور است. پیاده سازی دستگاه ها معمولاً ممکن است این حسگرها را حذف کنند، همانطور که در بخش های فرعی زیر ارائه شده است. اگر دستگاهی شامل یک نوع حسگر خاص است که دارای یک API مربوطه برای توسعه دهندگان شخص ثالث است، پیاده سازی دستگاه باید آن API را همانطور که در مستندات Android SDK توضیح داده شده است پیاده سازی کند. به عنوان مثال، پیاده سازی دستگاه:

  • باید وجود یا عدم وجود حسگرها را در کلاس android.content.pm.PackageManager به دقت گزارش کند. [ منابع ، 37 ]
  • باید فهرست دقیقی از حسگرهای پشتیبانی شده را از طریق SensorManager.getSensorList() و روش های مشابه برگرداند.
  • باید برای همه APIهای حسگر دیگر رفتار منطقی داشته باشد (به عنوان مثال، با برگرداندن درست یا نادرست در صورت لزوم وقتی برنامه‌ها تلاش می‌کنند شنوندگان را ثبت کنند، عدم فراخوانی شنوندگان حسگر زمانی که حسگرهای مربوطه وجود ندارند، و غیره)
  • باید تمام اندازه گیری های سنسور را با استفاده از مقادیر بین المللی مربوط به واحدهای واحد (IE) برای هر نوع سنسور همانطور که در مستندات Android SDK تعریف شده است گزارش دهید [ منابع ، 41 ]

فهرست بالا جامع نیست. رفتار مستند Android SDK باید معتبر در نظر گرفته شود.

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

Android 4.3 شامل مفهوم سنسور "جریان" است که به جای تغییر داده ها ، داده ها را به طور مداوم باز می گرداند. اجرای دستگاه باید به طور مداوم نمونه های داده دوره ای را برای هر API که توسط مستندات Android 4.3 SDK نشان داده شده است ، یک سنسور جریان ارائه دهد. توجه داشته باشید که اجرای دستگاه باید اطمینان حاصل کند که جریان سنسور نباید از ورود CPU دستگاه به حالت تعلیق جلوگیری کند یا از حالت تعلیق بیدار شود.

7.3.1. شتاب سنج

پیاده سازی دستگاه باید شامل شتاب سنج 3 محوره باشد. اگر پیاده سازی دستگاه شامل شتاب سنج 3 محوره باشد، این موارد:

  • باید بتواند رویدادهایی را با سرعت 120 هرتز یا بیشتر ارائه دهد. توجه داشته باشید که در حالی که فرکانس شتاب سنج فوق به عنوان "باید" برای Android 4.3 بیان شده است ، تعریف سازگاری برای نسخه آینده برنامه ریزی شده است تا اینها را به "باید" تغییر دهد. یعنی این استانداردها در Android 4.3 اختیاری هستند اما در نسخه های آینده مورد نیاز خواهند بود . دستگاه های موجود و جدید که Android 4.3 را اجرا می کنند ، به شدت تشویق می شوند که این نیازها را در Android 4.3 برآورده کنند تا بتوانند به نسخه های پلت فرم آینده ارتقا دهند
  • باید با سیستم مختصات سنسور اندروید به شرح مفصل API های Android عمل کند (به [ منابع ، 41 ] مراجعه کنید)
  • باید قادر به اندازه گیری از سقوط آزاد تا دو برابر گرانش (2 گرم) یا بیشتر در هر بردار سه بعدی باشد.
  • باید دقت 8 بیتی یا بیشتر داشته باشد
  • انحراف معیار باید از 0.05 m/s^2 بیشتر نباشد

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

پیاده سازی دستگاه باید شامل یک مغناطیس سنج 3 محوره (یعنی قطب نما) باشد.

  • باید بتواند رویدادها را با فرکانس 10 هرتز یا بیشتر ارائه دهد
  • باید با سیستم مختصات سنسور اندروید به شرح مفصل API های Android مطابقت داشته باشد (به [ منابع ، 41 ] مراجعه کنید).
  • باید قادر به نمونه برداری از طیفی از قدرت میدان مناسب برای پوشش میدان ژئومغناطیسی باشد.
  • باید دقت 8 بیتی یا بیشتر داشته باشد
  • انحراف معیار باید از 0.5 µT بیشتر نباشد

7.3.3. جی پی اس

پیاده سازی دستگاه باید شامل گیرنده GPS باشد. اگر پیاده‌سازی دستگاه شامل گیرنده GPS باشد، باید نوعی تکنیک «جی‌پی‌اس کمکی» را برای به حداقل رساندن زمان قفل شدن GPS در خود داشته باشد.

7.3.4. ژیروسکوپ

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

  • باید جبران شود
  • باید قابلیت اندازه گیری تغییرات جهت را تا 5.5*Pi رادیان در ثانیه (یعنی تقریباً 1000 درجه در ثانیه) داشته باشد.
  • باید بتواند رویدادهای 200 هرتز یا بیشتر را ارائه دهد. توجه داشته باشید که در حالی که فرکانس ژیروسکوپ فوق به عنوان "باید" برای Android 4.3 بیان شده است ، تعریف سازگاری برای نسخه آینده برنامه ریزی شده است تا اینها را به "باید" تغییر دهد. یعنی این استانداردها در Android 4.3 اختیاری هستند اما در نسخه های آینده مورد نیاز خواهند بود . دستگاه های موجود و جدید که Android 4.3 را اجرا می کنند ، به شدت تشویق می شوند که این نیازها را در Android 4.3 برآورده کنند تا بتوانند به نسخه های پلت فرم آینده ارتقا دهند
  • باید 12 بیت دقت یا بیشتر داشته باشد
  • باید واریانس بیش از 1E-7 RAD^2 / S^2 در هر هرتز (واریانس در هرتز یا Rad^2 / s) داشته باشد. واریانس مجاز است با نرخ نمونه برداری متفاوت باشد ، اما باید با این مقدار محدود شود. به عبارت دیگر ، اگر واریانس ژیرو را با نرخ نمونه برداری 1 هرتز اندازه گیری کنید ، نباید از 1E-7 RAD^2/S^2 بیشتر باشد.
  • باید زمانی که ممکن است رویداد سخت افزاری اتفاق بیفتد ، زمان بندی داشته باشد. تأخیر ثابت باید برداشته شود.

7.3.5. فشارسنج

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

  • باید بتواند رویدادها را با فرکانس 5 هرتز یا بیشتر ارائه دهد
  • برای فعال کردن تخمین ارتفاع باید دقت کافی داشته باشد
  • باید جبران شود

7.3.6. دماسنج

پیاده سازی دستگاه ممکن است اما نباید شامل یک دماسنج (یعنی سنسور دما) باشد. اگر پیاده سازی دستگاه شامل دماسنج باشد، باید دمای CPU دستگاه را اندازه گیری کند. نباید دمای دیگری را اندازه گیری کند. (توجه داشته باشید که این نوع سنسور در API های Android 4.3 مستهلک می شود.)

7.3.7. فتومتر

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

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

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

7.4. اتصال داده

7.4.1. تلفن

"تلفنی" همانطور که توسط API های Android 4.3 استفاده می شود و این سند به طور خاص به سخت افزار مربوط به قرار دادن تماس های صوتی و ارسال پیام پیامکی از طریق شبکه GSM یا CDMA اشاره دارد. در حالی که این تماس های صوتی ممکن است بسته بندی بسته باشد یا نباشد ، آنها برای اهداف اندروید 4.3 مستقل از هرگونه اتصال داده ای هستند که ممکن است با استفاده از همان شبکه اجرا شود. به عبارت دیگر، عملکرد Android "telephony" و API ها به طور خاص به تماس های صوتی و پیامک اشاره دارد. برای مثال، پیاده‌سازی‌های دستگاهی که نمی‌توانند تماس برقرار کنند یا پیام‌های SMS ارسال/دریافت کنند، نباید ویژگی «android.hardware.telephony» یا هر ویژگی فرعی را گزارش کنند، صرف نظر از اینکه از شبکه سلولی برای اتصال داده استفاده می‌کنند یا خیر.

Android 4.3 ممکن است در دستگاه هایی که شامل سخت افزار تلفنی نیستند استفاده شود. یعنی Android 4.3 با دستگاه هایی که تلفن نیستند سازگار است. با این حال، اگر پیاده‌سازی دستگاه شامل تلفن GSM یا CDMA باشد، باید پشتیبانی کامل از API برای آن فناوری را اجرا کند. پیاده‌سازی‌های دستگاهی که شامل سخت‌افزار تلفن نمی‌شوند، باید APIهای کامل را به‌عنوان بدون عملیات اجرا کنند.

7.4.2. IEEE 802.11 (WiFi)

اجرای دستگاه Android 4.3 باید شامل پشتیبانی از یک یا چند شکل 802.11 (b/g/a/n و غیره) باشد.

پیاده سازی دستگاه باید API Multicast را همانطور که در مستندات SDK شرح داده شده است ، پیاده سازی کند [ منابع ، 62 ]. پیاده سازی دستگاه هایی که شامل پشتیبانی WiFi هستند باید از DNS Multicast (MDNS) پشتیبانی کنند. پیاده سازی دستگاه ها نباید در هر زمان از کار ، بسته های MDNS (224.0.0.251) را فیلتر کند ، از جمله اینکه صفحه نمایش در حالت فعال نیست.

7.4.2.1. ارتباط مستقیم به کمک وای - فای

پیاده سازی دستگاه ها باید شامل پشتیبانی از WiFi Direct (WiFi Peer-to-Peer) باشد. اگر اجرای دستگاه شامل پشتیبانی از WiFi Direct باشد ، باید API مربوط به Android را همانطور که در مستندات SDK شرح داده شده است ، پیاده سازی کند [ منابع ، 68 ]. اگر اجرای دستگاه شامل پشتیبانی از WiFi Direct است ، پس از آن:

  • باید از عملکرد وای فای منظم پشتیبانی کند
  • باید از عملکرد مستقیم WiFi و WiFi پشتیبانی کند

7.4.3. بلوتوث

پیاده سازی دستگاه باید شامل یک گیرنده بلوتوث باشد. پیاده سازی های دستگاه که شامل یک فرستنده بلوتوث است باید API بلوتوث مبتنی بر RFCOMM را همانطور که در مستندات SDK شرح داده شده است فعال کند و از ویژگی های سخت افزاری Android.hardware.bluetooth [ منابع ، 42 ] اعلام کند. پیاده سازی های دستگاه باید پروفایل های بلوتوث مربوطه مانند A2DP، AVRCP، OBEX، و غیره را مطابق با دستگاه اجرا کنند.

پیاده سازی دستگاه هایی که شامل پشتیبانی از Bluetooth GATT (مشخصات ویژگی های عمومی) برای فعال کردن ارتباط با دستگاه های Smart Smart یا Smart Smart باید API بلوتوث مبتنی بر GATT باشد ، همانطور که در مستندات SDK شرح داده شده است و از ویژگی های سخت افزاری Android.hardware.bluetooth_le [ منابع ، منابع ، اعلام می کند. 42 ].

7.4.4. ارتباطات میدان نزدیک

پیاده سازی دستگاه باید شامل یک فرستنده گیرنده و سخت افزار مرتبط برای ارتباطات میدان نزدیک (NFC) باشد. اگر پیاده سازی دستگاه شامل سخت افزار NFC باشد، آنگاه:

  • باید ویژگی android.hardware.nfc را از روش android.content.pm.PackageManager.hasSystemFeature() گزارش کند. [ منابع ، 37 ]
  • باید قادر به خواندن و نوشتن پیام های NDEF از طریق استانداردهای NFC زیر باشد:
    • باید بتواند به عنوان خواننده/نویسنده انجمن NFC (همانطور که توسط مشخصات فنی انجمن NFC NFCForum-TS-DigitalProtocol-1.0 تعریف شده است) از طریق استانداردهای NFC زیر عمل کند:
      • NfcA (ISO14443-3A)
      • NfcB (ISO14443-3B)
      • NfcF (JIS 6319-4)
      • IsoDep (ISO 14443-4)
      • انواع برچسب انجمن NFC 1، 2، 3، 4 (تعریف شده توسط انجمن NFC)
  • باید قادر به خواندن و نوشتن پیام های NDEF از طریق استانداردهای NFC زیر باشد. توجه داشته باشید که در حالی که استانداردهای NFC در زیر به عنوان "باید" برای Android 4.3 بیان شده است ، برنامه ریزی سازگاری برای نسخه آینده برنامه ریزی شده است تا این موارد را به "باید" تغییر دهد. یعنی این استانداردها در Android 4.3 اختیاری هستند اما در نسخه های آینده مورد نیاز خواهند بود . دستگاه های موجود و جدید که Android 4.3 را اجرا می کنند ، به شدت تشویق می شوند تا این نیازها را در Android 4.3 برآورده کنند تا بتوانند به نسخه های آینده پلت فرم ارتقا دهند.
    • NfcV (ISO 15693)
  • باید قادر به انتقال و دریافت داده ها از طریق استانداردها و پروتکل های نظیر به نظیر زیر باشد:
    • ISO 18092
    • LLCP 1.0 (تعریف شده توسط انجمن NFC)
    • SDP 1.0 (تعریف شده توسط انجمن NFC)
    • پروتکل فشار NDEF [ منابع ، 43 ]
    • SNEP 1.0 (تعریف شده توسط انجمن NFC)
  • باید شامل پشتیبانی از پرتو اندرویدی [ منابع ، 65 ]:
    • باید سرور پیش فرض SNEP را پیاده سازی کند. پیام های معتبر NDEF دریافت شده توسط سرور پیش فرض SNEP باید با استفاده از android.nfc.action_ndef_discovered به برنامه ها ارسال شوند. غیرفعال کردن پرتو اندرویدی در تنظیمات نباید ارسال پیام NDEF ورودی را از بین ببرد.
    • پیاده سازی های دستگاه باید از Android.settings.nfcsharing_settings قصد نشان دادن تنظیمات اشتراک NFC [ منابع ، 67 ] را احترام بگذارد.
    • باید سرور NPP را پیاده سازی کند. پیام های دریافت شده توسط سرور NPP باید به همان روش سرور پیش فرض SNEP پردازش شوند.
    • باید یک مشتری SNEP را پیاده سازی کرده و سعی کنید هنگام فعال شدن پرتوی Android ، P2P NDEF را به سرور پیش فرض SNEP ارسال کنید. اگر سرور SNEP پیش فرض پیدا نشده است ، مشتری باید سعی کند به سرور NPP ارسال کند.
    • باید به فعالیتهای پیش زمینه اجازه دهد تا پیام Outbound P2P NDEF را با استفاده از Android.nfc.nfcadapter.setndefpushmessage ، و android.nfc.nfcadapter.setndefpushmessagecallback و android.nfc.nfcadapter.enableforefordroundndefpush تنظیم کنند.
    • قبل از ارسال پیام های Outbound P2P NDEF ، باید از یک ژست یا تأیید روی صفحه ، مانند "Touch to Beam" استفاده کنید.
    • باید پرتو اندرویدی را به طور پیش فرض فعال کند
    • هنگامی که دستگاه از پروفایل فشار شیء بلوتوث پشتیبانی می کند ، باید از انتقال اتصال NFC به بلوتوث پشتیبانی کند. پیاده سازی های دستگاه باید هنگام استفاده از Android.nfc.nfcadapter.setBeampushuris ، با اجرای "اتصال اتصال به نسخه 1.2" [ منابع ، 60 ] و "بلوتوث ، جفت شدن ساده با استفاده از نسخه NFC 1.0" [ منابع ، 61 ] مشخصات ، از انتقال اتصال به بلوتوث پشتیبانی کند. انجمن NFC. چنین اجرای باید از درخواست های SNEP برای تبادل سوابق درخواست / انتخاب از طریق NFC استفاده کند ، و باید از پروفایل فشار شیء بلوتوث برای انتقال واقعی داده بلوتوث استفاده کند.
  • باید در مورد همه فن آوری های پشتیبانی شده در حالی که در حالت Discovery NFC است ، نظرسنجی کنید.
  • باید در حالت کشف NFC باشد در حالی که دستگاه با صفحه فعال بیدار است و صفحه قفل قفل شده است.

(توجه داشته باشید که پیوندهای در دسترس عموم برای مشخصات انجمن JIS، ISO و NFC ذکر شده در بالا در دسترس نیستند.)

علاوه بر این ، اجرای دستگاه ممکن است شامل پشتیبانی خواننده/نویسنده برای فن آوری های Mifare زیر باشد.

توجه داشته باشید که Android 4.3 شامل API برای این انواع Mifare است. اگر اجرای دستگاه از Mifare در نقش خواننده/نویسنده پشتیبانی کند ، آن:

  • باید APIهای Android مربوطه را همانطور که توسط Android SDK مستند شده است پیاده سازی کنید
  • باید ویژگی com.nxp.mifare را از متد android.content.pm.PackageManager.hasSystemFeature() گزارش کنید. [ منابع ، 37 ] توجه داشته باشید که این یک ویژگی استاندارد Android نیست ، و به همین ترتیب به عنوان ثابت در کلاس PackageManager ظاهر نمی شود.
  • نباید APIهای Android مربوطه را پیاده‌سازی کند و ویژگی com.nxp.mifare را گزارش نکند، مگر اینکه پشتیبانی عمومی NFC را همانطور که در این بخش توضیح داده شده است، اجرا کند.

اگر اجرای دستگاه سخت افزار NFC را شامل نمی شود ، نباید ویژگی Android.hardware.nfc را از android.content.pm.PackageManager.hasSystemFeature() [ منابع ، 37 ] اعلام کند ، و باید Android 4.3 NFC API را اجرا کند. بدون عملیات

از آنجایی که کلاس‌های android.nfc.NdefMessage و android.nfc.NdefRecord یک فرمت نمایش داده مستقل از پروتکل را نشان می‌دهند، پیاده‌سازی‌های دستگاه باید این APIها را اجرا کنند، حتی اگر شامل پشتیبانی از NFC نباشند یا ویژگی android.hardware.nfc را اعلام نکنند.

7.4.5. حداقل قابلیت شبکه

پیاده سازی دستگاه باید شامل پشتیبانی از یک یا چند شکل شبکه داده باشد. به طور خاص، پیاده سازی دستگاه باید شامل پشتیبانی از حداقل یک استاندارد داده با قابلیت 200 کیلوبیت بر ثانیه یا بیشتر باشد. نمونه هایی از فناوری هایی که این نیاز را برآورده می کنند عبارتند از EDGE، HSPA، EV-DO، 802.11g، اترنت و غیره.

اجرای دستگاه که در آن یک استاندارد شبکه فیزیکی (مانند اترنت) اتصال اصلی داده ها نیز باید شامل حداقل یک استاندارد داده بی سیم مشترک مانند 802.11 (WIFI) باشد.

دستگاه ها ممکن است بیش از یک شکل از اتصال داده ها را پیاده سازی کنند.

7.5. دوربین ها

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

7.5.1. دوربین عقب

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

  • باید حداقل 2 مگاپیکسل وضوح داشته باشد
  • باید یا فوکوس خودکار سخت افزاری یا نرم افزاری که در درایور دوربین اجرا شده است (شفاف برای نرم افزار برنامه)
  • ممکن است سخت افزار فوکوس ثابت یا EDOF (عمق گسترده فیلد) داشته باشد
  • ممکن است شامل یک فلاش باشد. اگر دوربین شامل فلاش باشد ، لامپ فلش نباید روشن شود در حالی که یک android.hardware.camera.previewcallback در یک سطح پیش نمایش دوربین ثبت شده است ، مگر اینکه برنامه به صراحت با فعال کردن ویژگی های FLASH_MODE_AUTO یا FLASH_MODE_ON از یک فلاش فعال شود. Camera.Parameters Object. توجه داشته باشید که این محدودیت در مورد برنامه دوربین داخلی سیستم داخلی اعمال نمی شود ، بلکه فقط برای برنامه های شخص ثالث با استفاده از Camera.PreviewCallback است.

7.5.2. دوربین جلو

پیاده سازی دستگاه ممکن است شامل یک دوربین جلوی باشد. اگر اجرای دستگاه شامل یک دوربین جلوی است ، آن:

  • باید وضوح حداقل VGA داشته باشد (یعنی 640x480 پیکسل)
  • نباید از دوربین جلوی آن به عنوان پیش فرض API دوربین استفاده کند. یعنی API دوربین در Android 4.3 از پشتیبانی ویژه ای برای دوربین های جلوی آن برخوردار است و پیاده سازی دستگاه ها نباید API را پیکربندی کند تا بتواند یک دوربین جلوی را به عنوان دوربین پیش فرض عقب درمان کند ، حتی اگر این تنها دوربین باشد دستگاه
  • ممکن است شامل ویژگی هایی (مانند فوکوس خودکار ، فلاش و غیره) در دسترس دوربین های عقب باشد که در بخش 7.5.1 توضیح داده شده است.
  • باید به صورت افقی منعکس شود (یعنی آینه) جریان نمایش داده شده توسط یک برنامه در یک دوربین فیلمبرداری ، به شرح زیر است:
    • اگر اجرای دستگاه قادر به چرخش توسط کاربر باشد (مانند به طور خودکار از طریق شتاب سنج یا دستی از طریق ورودی کاربر) ، پیش نمایش دوربین باید نسبت به جهت گیری فعلی دستگاه به صورت افقی آینه شود.
    • اگر برنامه فعلی به صراحت درخواست کرده است که صفحه نمایش دوربین از طریق تماس با android.hardware.Camera.setDisplayOrientation() [ منابع ، 50 ] چرخانده شود ، پیش نمایش دوربین باید به صورت افقی نسبت به جهت گیری مشخص شده توسط برنامه آینه شود.
    • در غیر این صورت ، پیش نمایش باید در امتداد محور افقی پیش فرض دستگاه آینه شود.
  • باید تصویر نمایش داده شده توسط پس از نمایش را به همان روشی که جریان تصویر پیش نمایش دوربین نشان داده شده است ، آینه کند. (اگر اجرای دستگاه پس از بررسی پشتیبانی نمی کند ، بدیهی است که این نیاز صدق نمی کند.)
  • نباید آینه ای از تصویر نهایی یا جریان های ویدئویی نهایی را که به تماس های برنامه کاربردی بازگردانده شده یا به ذخیره سازی رسانه ها بازگردانده شده است.

7.5.3. رفتار API دوربین

پیاده سازی دستگاه باید رفتارهای زیر را برای API های مربوط به دوربین ، برای هر دو دوربین جلو و عقب اجرا کند:

  1. اگر یک برنامه هرگز android.hardware.Camera.Parameters.setPreviewFormat(int) را صدا نکرده است ، دستگاه باید از android.hardware.PixelFormat.YCbCr_420_SP برای داده های پیش نمایش ارائه شده به تماس های برنامه استفاده کند.
  2. اگر یک برنامه یک android.hardware.Camera.PreviewCallback را ثبت کند و سیستم روش onPreviewFrame() را فراخوانی می کند وقتی که فرمت پیش نمایش YCBCR_420_SP است ، داده های موجود در byte[] به onPreviewFrame() باید بیشتر در قالب رمزگذاری NV21 باشد. یعنی NV21 باید پیش فرض باشد.
  3. اجرای دستگاه باید از فرمت YV12 (همانطور که توسط android.graphics.ImageFormat.YV12 ثابت) پشتیبانی می کند ، برای پیش نمایش دوربین برای هر دو دوربین جلو و عقب پشتیبانی کند. (رمزگذار و دوربین فیلمبرداری سخت افزار ممکن است از هر فرمت پیکسل بومی استفاده کند ، اما اجرای دستگاه باید از تبدیل به YV12 پشتیبانی کند.)

پیاده سازی دستگاه باید API کامل دوربین موجود در اسناد Android 4.3 SDK [ منابع ، 51 ]) را پیاده سازی کند ، صرف نظر از اینکه دستگاه شامل فوکوس خودکار سخت افزار یا سایر قابلیت ها باشد. به عنوان مثال ، دوربین هایی که فاقد فوکوس خودکار هستند ، هنوز هم باید با هر موارد android.hardware.Camera.AutoFocusCallback تماس بگیرند (حتی اگر این هیچ ارتباطی با دوربین غیر خودکار ندارد.) توجه داشته باشید که این کار در مورد دوربین های جلویی اعمال می شود. به عنوان مثال ، حتی اگر بیشتر دوربین های جلوی فوکوس خودکار از فوکوس خودکار پشتیبانی نمی کنند ، تماس های API هنوز هم باید همانطور که توضیح داده شد "جعلی" باشد.

اجرای دستگاه باید هر نام پارامتر را که به عنوان ثابت در کلاس android.hardware.Camera.Parameters تعریف شده است ، تشخیص و احترام بگذارد ، در صورتی که سخت افزار اساسی از این ویژگی پشتیبانی می کند. اگر سخت افزار دستگاه از یک ویژگی پشتیبانی نمی کند ، API باید مطابق مستند سازی رفتار کند. در مقابل ، پیاده سازی دستگاه ها نباید از ثابت های رشته ای که به android.hardware.Camera.setParameters() به غیر از مواردی که به عنوان ثابت در android.hardware.Camera.Parameters ثبت شده است ، افتخار یا تشخیص دهد. یعنی اجرای دستگاه در صورت اجازه سخت افزار باید از تمام پارامترهای استاندارد دوربین پشتیبانی کند و نباید از انواع پارامتر دوربین سفارشی پشتیبانی کند. به عنوان مثال ، پیاده سازی دستگاه هایی که از ضبط تصویر با استفاده از تکنیک های تصویربرداری Dynamic Range (HDR) پشتیبانی می کنند ، باید از دوربین پارامتر دوربین پشتیبانی کنند Camera.SCENE_MODE_HDR [ منابع ، 78 ]).

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

پیاده سازی های دستگاه باید هر زمان که یک فیلم جدید توسط Camera.ACTION_NEW_VIDEO ضبط شود و ورود تصویر به فروشگاه رسانه اضافه شود ، باید دوربین را پخش کنید.

7.5.4. جهت گیری دوربین

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

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

7.6.1. حداقل حافظه و ذخیره سازی

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

پیاده سازی دستگاه باید حداقل 512 مگابایت ذخیره غیر فرار برای داده های خصوصی برنامه داشته باشد. یعنی پارتیشن /data باید حداقل 512MB باشد. پیاده سازی دستگاه هایی که Android 4.3 را اجرا می کنند ، به شدت تشویق می شوند که حداقل 1 گیگابایت ذخیره غیر فرار برای داده های خصوصی برنامه کاربردی داشته باشند تا بتوانند به نسخه های پلت فرم آینده ارتقا دهند.

API های Android شامل یک مدیر بارگیری است که ممکن است برنامه ها برای بارگیری پرونده های داده استفاده کنند [ منابع ، 56 ]. اجرای دستگاه مدیر بارگیری باید قادر به بارگیری پرونده های جداگانه حداقل 100 مگابایت در محل پیش فرض "حافظه پنهان" باشد.

7.6.2. برنامه ذخیره سازی مشترک

پیاده سازی دستگاه باید ذخیره مشترک را برای برنامه ها ارائه دهد. ذخیره مشترک ارائه شده باید حداقل 1 گیگابایت باشد.

پیاده سازی های دستگاه باید با ذخیره سازی مشترک به طور پیش فرض ، "خارج از جعبه" تنظیم شود. اگر ذخیره سازی مشترک در مسیر Linux Path /sdcard نصب نشده باشد ، دستگاه باید یک پیوند نمادین لینوکس از /sdcard را به نقطه نصب واقعی شامل شود.

اجرای دستگاه باید به صورت مستند android.permission.WRITE_EXTERNAL_STORAGE در این ذخیره سازی مشترک اجرا شود. ذخیره مشترک باید در غیر این صورت با هر برنامه ای که این مجوز را بدست می آورد ، قابل ارسال باشد.

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

صرف نظر از شکل ذخیره سازی مشترک مورد استفاده ، پیاده سازی دستگاه ها باید مکانیسم را برای دسترسی به محتوای ذخیره مشترک از یک رایانه میزبان ، مانند ذخیره انبوه USB (UMS) یا پروتکل انتقال رسانه (MTP) فراهم کند. اجرای دستگاه ممکن است از ذخیره انبوه USB استفاده کند ، اما باید از پروتکل انتقال رسانه استفاده کند. اگر اجرای دستگاه از پروتکل انتقال رسانه پشتیبانی کند:

  • اجرای دستگاه باید با میزبان Android MTP مرجع ، انتقال فایل Android [ منابع ، 57 ] سازگار باشد.
  • اجرای دستگاه باید یک کلاس دستگاه USB 0x00 را گزارش کند.
  • اجرای دستگاه باید نام رابط USB "MTP" را گزارش کند.

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

در نظر گرفتن دو مثال مشترک ، مشخص است. اگر اجرای دستگاه شامل یک شکاف کارت SD برای برآورده کردن نیاز ذخیره سازی مشترک باشد ، یک کارت SD 1 گیگابایتی با فرمت چربی یا بزرگتر باید با دستگاه در نظر گرفته شود که به کاربران فروخته می شود و باید به طور پیش فرض نصب شود. از طرف دیگر ، اگر اجرای دستگاه برای برآورده کردن این نیاز از حافظه داخلی ثابت استفاده می کند ، آن ذخیره سازی باید از نظر اندازه 1 گیگابایت باشد یا بزرگتر و نصب شده بر روی /sdcard (یا /sdcard در صورت نصب در جای دیگر ، باید یک پیوند نمادین برای مکان فیزیکی باشد.)

پیاده سازی دستگاه هایی که شامل چندین مسیر ذخیره سازی مشترک (مانند هر دو شکاف کارت SD و ذخیره داخلی مشترک) هستند باید برنامه های اصلی مانند اسکنر رسانه و ContentProvider را برای پشتیبانی شفاف از پرونده های موجود در هر دو مکان اصلاح کنند.

7.7. یو اس بی

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

اگر اجرای دستگاه شامل یک درگاه مشتری USB است:

  • درگاه باید با یک درگاه USB-A استاندارد به یک میزبان USB متصل شود
  • درگاه باید از ضریب فرم Micro USB در سمت دستگاه استفاده کند. دستگاه های موجود و جدید که Android 4.3 را اجرا می کنند ، به شدت تشویق می شوند که این نیازها را در Android 4.3 برآورده کنند تا بتوانند به نسخه های پلت فرم آینده ارتقا دهند
  • بندر باید در وسط لبه قرار داشته باشد. پیاده سازی های دستگاه یا باید پورت را در پایین دستگاه (مطابق با جهت گیری طبیعی) قرار دهند یا چرخش صفحه نرم افزار را برای همه برنامه ها (از جمله صفحه اصلی) فعال کنند ، به طوری که هنگام هدایت دستگاه با پورت در پایین ، صفحه نمایش به درستی ترسیم می شود. دستگاه های موجود و جدید که Android 4.3 را اجرا می کنند ، به شدت تشویق می شوند تا این نیازها را در Android 4.3 برآورده کنند تا بتوانند به نسخه های آینده پلت فرم ارتقا دهند.
  • اگر دستگاه درگاه های دیگری (مانند درگاه شارژ غیر USB) داشته باشد ، باید در همان لبه درگاه میکرو USB قرار داشته باشد
  • این باید به یک میزبان متصل به دستگاه اجازه دهد تا با استفاده از ذخیره انبوه USB یا پروتکل انتقال رسانه به محتویات حجم ذخیره مشترک دسترسی پیدا کند
  • این باید API و مشخصات Android Open Accessory را که در اسناد Android SDK ثبت شده است ، پیاده سازی کند ، و باید پشتیبانی از ویژگی های سخت افزاری android.hardware.usb.accessory [ منابع ، 52 ] را اعلام کند.
  • این باید کلاس صوتی USB را همانطور که در اسناد Android SDK ثبت شده است ، پیاده سازی کند [ منابع ، 66 ]
  • این باید پشتیبانی از مشخصات شارژ باتری USB را پیاده سازی کند [ منابع ، 64 ] دستگاه های موجود و جدید که Android 4.3 را اجرا می کنند ، به شدت تشویق می شوند تا این نیازها را در Android 4.3 برآورده کنند ، بنابراین آنها قادر به ارتقاء به نسخه های آینده پلت فرم هستند

اگر اجرای دستگاه شامل یک درگاه میزبان USB باشد:

  • این ممکن است از یک فاکتور شکل درگاه غیر استاندارد استفاده کند ، اما در این صورت باید با کابل یا کابل هایی که درگاه را با USB-A استاندارد سازگار می کند ، حمل شود
  • این باید API میزبان Android USB را به عنوان مستند در Android SDK پیاده سازی کند ، و باید پشتیبانی از ویژگی های سخت افزاری android.hardware.usb.host [ منابع ، 53 ] را اعلام کند.

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. سازگاری با عملکرد

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

متریک آستانه عملکرد نظرات
زمان راه اندازی برنامه برنامه های زیر باید در زمان مشخص شده راه اندازی شوند.
  • مرورگر: کمتر از 1300ms
  • Contacts: less than 700ms
  • Settings: less than 700ms
زمان راه اندازی به عنوان زمان کل برای تکمیل بارگذاری فعالیت پیش فرض برای برنامه ، از جمله زمان لازم برای شروع فرآیند لینوکس ، بارگذاری بسته اندرویدی در Dalvik VM و تماس با شما اندازه گیری می شود.
برنامه های کاربردی همزمان هنگامی که چندین برنامه راه اندازی شده است ، پس از راه اندازی مجدد ، دوباره راه اندازی یک برنامه در حال اجرا دوباره باید کمتر از زمان راه اندازی اصلی باشد.

9. سازگاری مدل امنیتی

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. اجرای دستگاه باید بدون نیاز به مجوز/گواهینامه اضافی از طرف شخص ثالث/مقامات ، از نصب برنامه های خود امضا شده پشتیبانی کند. به طور خاص ، دستگاه های سازگار باید از مکانیسم های امنیتی شرح داده شده در زیر بخش های زیر پشتیبانی کنند.

9.1. مجوزها

Device implementations MUST support the Android permissions model as defined in the Android developer documentation [ Resources, 54 ]. به طور خاص ، پیاده سازی ها باید هر مجوز تعریف شده را که در مستندات SDK شرح داده شده است ، اجرا کند. هیچ مجوز ممکن نیست حذف ، تغییر یا نادیده گرفته شود. پیاده سازی ها ممکن است مجوزهای اضافی را اضافه کنند ، مشروط بر اینکه رشته های مجوز جدید در Android نباشند.* فضای نام.

9.2. UID و جداسازی فرآیند

پیاده سازی دستگاه باید از مدل Android Application Sandbox پشتیبانی کند ، که در آن هر برنامه به عنوان یک UID منحصر به فرد UNIX و در یک فرآیند جداگانه اجرا می شود. 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. مجوزهای سیستم فایل

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

9.4. محیط های اجرایی جایگزین

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

زمان های جایگزین جایگزین باید خود برنامه های Android باشند و از مدل امنیت استاندارد Android پیروی کنند ، همانطور که در جای دیگر بخش 9 شرح داده شده است.

زمان های جایگزین نباید به منابع محافظت شده توسط مجوزهای درخواست نشده در پرونده AndroidManifest.xml از طریق مکانیسم <uses-permission> دسترسی پیدا کند.

زمان های جایگزین جایگزین نباید به برنامه ها اجازه دهند از ویژگی های محافظت شده توسط مجوزهای اندرویدی محدود به برنامه های سیستم استفاده کنند.

زمان های جایگزین باید از مدل Sandbox Android پیروی کنند. به طور مشخص:

  • برنامه های جایگزین جایگزین باید برنامه ها را از طریق PackageManager در ماسه های جداگانه Android (یعنی شناسه های کاربر لینوکس و غیره) نصب کنند.
  • Alternate runtimes MAY provide a single Android sandbox shared by all applications using the alternate runtime
  • زمان های جایگزین و برنامه های نصب شده با استفاده از زمان اجرا متناوب نباید از جعبه ماسه ای از برنامه های دیگر نصب شده در دستگاه استفاده مجدد کنید ، مگر از طریق مکانیسم های استاندارد Android شناسه کاربر مشترک و گواهی امضای
  • Alternate runtimes MUST NOT launch with, grant, or be granted access to the sandboxes corresponding to other Android applications

زمان های متناوب نباید با هرگونه امتیاز از Superuser (ROOT) یا هر شناسه کاربر دیگر ، به برنامه های دیگر اعطا شود ، یا به برنامه های دیگر اعطا شود.

پرونده های .APK از زمان های جایگزین ممکن است در تصویر سیستم اجرای دستگاه گنجانده شود ، اما باید با یک کلید متمایز از کلید مورد استفاده برای امضای سایر برنامه های موجود در اجرای دستگاه امضا شود.

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

9.5. Multi-User Support

Android 4.3 includes support for multiple users and provides support for full user isolation [ Resources, 70 ].

Device implementations MUST meet these requirements related to multi-user support [ Resources, 71 ]:

  • As the behavior of the telephony APIs on devices with multiple users is currently undefined, device implementations that declare android.hardware.telephony MUST NOT enable multi-user support.
  • Device implementations MUST, for each user, implement a security model consistent with the Android platform security model as defined in Security and Permissions reference document in the APIs [Resources, 54]
  • Android 4.3 includes support for restricted profiles, a feature that allows device owners to manage additional users and their capabilities on the device. With restricted profiles, device owners can quickly set up separate environments for additional users to work in, with the ability to manage finer-grained restrictions in the apps that are available in those environments. Device implementations that include support for multiple users MUST include support for restricted profiles. The upstream Android Open Source Project includes an implementation that satisfies this requirement.

Each user instance on an Android device MUST have separate and isolated external storage directories. Device implementations MAY store multiple users' data on the same volume or filesystem. However, the device implementation MUST ensure that applications owned by and running on behalf a given user cannot list, read, or write to data owned by any other user. Note that removable media, such as SD card slots, can allow one user to access another's data by means of a host PC. For this reason, device implementations that use removable media for the external storage APIs MUST encrypt the contents of the SD card if multi-user is enabled using a key stored only on non-removable media accessible only to the system. As this will make the media unreadable by a host PC, device implementations will be required to switch to MTP or a similar system to provide host PCs with access to the current user's data. Accordingly, device implementations MAY but SHOULD NOT enable multi-user if they use removable media [ Resources, 72 ] for primary external storage. The upstream Android Open Source Project includes an implementation that uses internal device storage for application external storage APIs; device implementations SHOULD use this configuration and software implementation. Device implementations that include multiple external storage paths MUST NOT allow Android applications to write to the secondary external storage.

9.6. Premium SMS Warning

Android 4.3 includes support for warning users for any outgoing premium SMS message [ Resources, 73 ] . Premium SMS messages are text messages sent to a service registered with a carrier that may incur a charge to the user. Device implementations that declare support for android.hardware.telephony MUST warn users before sending a SMS message to numbers identified by regular expressions defined in /data/misc/sms/codes.xml file in the device. The upstream Android Open Source Project provides an implementation that satisfies this requirement.

9.7. Kernel Security Features

The Android Sandbox in Android 4.3 includes features that can use the SELinux mandatory access control system (MAC) and other security features in the Linux kernel. Device implementations MUST support SELinux MAC. Note that the upstream Android Open Source Project provides an implementation that satisfies this requirement.

SELinux or any security features implemented below the Android framework MUST maintain compatibility with existing applications. These features SHOULD be invisible to users and developers. These features SHOULD NOT be user or developer configurable. If any API for configuration of policy is exposed to an application that can affect another application (such as a Device Administration API), the API MUST NOT allow configurations that break compatibility. To ensure continued compatibility the reference implementation allows the use of SELinux in a permissive mode and supports dynamic policy updates without requiring a system image update. Device implementations using SELinux MUST support this permissive mode, support dynamic policy updates and log any policy violations without breaking applications or affecting system behavior. Implementations using SELinux SHOULD load policy from /sepolicy file on the device. The upstream Android Open Source Project provides an implementation that satisfies this requirement. Device implementations SHOULD use the reference implementation in the Android Open Source Project, and device implementations MUST be compatible with the upstream Android Open Source Project.

10. تست سازگاری نرم افزار

پیاده سازی دستگاه باید تمام تست های شرح داده شده در این بخش را پشت سر بگذارد.

با این حال ، توجه داشته باشید که هیچ بسته آزمایش نرم افزاری کاملاً جامع نیست. 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.3 available from the Android Open Source Project. این امر خطر معرفی اشکالات ایجاد ناسازگاری را که نیاز به کار مجدد و به روزرسانی های بالقوه دستگاه ایجاد می کنند ، به حداقل می رساند.

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

پیاده سازی های دستگاه باید با استفاده از نرم افزار حمل و نقل نهایی در دستگاه ، مجموعه تست سازگاری Android (CTS) [ منابع ، 2 ] موجود از پروژه منبع باز اندروید را منتقل کند. علاوه بر این ، مجریان دستگاه باید تا حد امکان از اجرای مرجع در درخت منبع باز اندروید استفاده کنند و باید سازگاری را در موارد ابهام در CTS و برای هرگونه برنامه ریزی مجدد بخش هایی از کد منبع مرجع تضمین کنند.

CTS به گونه ای طراحی شده است که بر روی یک دستگاه واقعی اجرا شود. مانند هر نرم افزاری ، CTS ممکن است خود دارای اشکالات باشد. The CTS will be versioned independently of this Compatibility Definition, and multiple revisions of the CTS may be released for Android 4.3. اجرای دستگاه باید آخرین نسخه CTS موجود در زمان تکمیل نرم افزار دستگاه را منتقل کند.

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

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

تأیید کننده CTS تست هایی برای انواع سخت افزاری از جمله برخی از سخت افزار اختیاری دارد. پیاده سازی دستگاه باید تمام آزمایشات مربوط به سخت افزاری را که در اختیار دارند ، بگذرد. به عنوان مثال ، اگر دستگاهی دارای شتاب سنج باشد ، باید به درستی مورد آزمایش شتاب سنج را در تأیید کننده CTS انجام دهد. موارد آزمون برای ویژگی های ذکر شده به عنوان اختیاری توسط این سند تعریف سازگاری ممکن است پرش یا حذف شود.

هر دستگاه و هر ساختاری باید همانطور که در بالا ذکر شد ، تأیید کننده CTS را به درستی اجرا کند. با این حال ، از آنجا که بسیاری از ساختها بسیار مشابه هستند ، انتظار نمی رود که مجریان دستگاه صریحاً تأیید کننده CTS را بر روی ساختهایی اجرا کنند که فقط از نظر روشهای بی اهمیت متفاوت هستند. Specifically, device implementations that differ from an implementation that has passed the CTS Verifier 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 Google Play Store)

هر برنامه فوق باید به درستی در مورد اجرای راه اندازی و رفتار کند تا اجرای آن سازگار باشد.

11. نرم افزار قابل به روز رسانی

پیاده سازی دستگاه ها باید شامل مکانیسمی برای جایگزینی کل نرم افزار سیستم باشد. The mechanism need not perform "live" upgrades - that is, a device restart MAY be required.

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

  • بارگیری از طریق هوا (OTA) با بروزرسانی آفلاین از طریق راه اندازی مجدد
  • "Tethered" به روزرسانی های USB از یک کامپیوتر میزبان
  • به روزرسانی های "آفلاین" از طریق راه اندازی مجدد و به روزرسانی از یک پرونده در ذخیره سازی قابل جابجایی

مکانیسم بروزرسانی مورد استفاده باید بدون پاک کردن داده های کاربر به روزرسانی ها را پشتیبانی کند. That is, the update mechanism MUST preserve application private data and application shared data. توجه داشته باشید که نرم افزار Android بالادست شامل یک مکانیسم به روزرسانی است که این نیاز را برآورده می کند.

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

12. تماس با ما

برای توضیحات می توانید با نویسندگان سند در catractibility@android.com تماس بگیرید و هرگونه مسئله ای را که فکر می کنید این سند پوشش نمی دهد مطرح کنید.