API های اندروید 5.1
با مجموعه‌ها، منظم بمانید
ذخیره و طبقه‌بندی محتوا براساس اولویت‌های شما.
سطح API: 22
Android 5.1 ( LOLLIPOP_MR1 ) به‌روزرسانی نسخه Lollipop است که ویژگی‌های جدیدی را برای کاربران و توسعه‌دهندگان برنامه ارائه می‌کند. این سند مقدمه ای بر قابل توجه ترین API های جدید ارائه می دهد.
برای نگاهی سطح بالا به ویژگی‌های پلتفرم جدید، به نکات برجسته Android Lollipop مراجعه کنید.
سطح API هدف خود را به روز کنید
برای شروع ساخت برنامه برای Android 5.1، از مدیر SDK برای دانلود پلتفرم Android 5.1 SDK و تصاویر سیستم استفاده کنید. سپس پروژه توسعه برنامه خود را طوری تنظیم کنید که از targetSdkVersion "22" استفاده کند. برنامه خود را روی یک تصویر سیستم اندروید 5.1 نصب کنید، آن را تست کنید، سپس برنامه به روز شده را با این تغییر منتشر کنید.
می‌توانید از APIهای Android 5.1 استفاده کنید و در عین حال از نسخه‌های قدیمی‌تر نیز با افزودن شرایطی به کد خود استفاده کنید که سطح API سیستم را قبل از اجرای APIهایی که توسط minSdkVersion شما پشتیبانی نمی‌شوند بررسی می‌کنند. برای اطلاعات بیشتر در مورد حفظ سازگاری به عقب، پشتیبانی از نسخه‌های مختلف پلتفرم را بخوانید.
برای اطلاعات بیشتر در مورد نحوه عملکرد سطوح API، سطح API چیست؟
پشتیبانی از چند سیم کارت
Android 5.1 پشتیبانی از استفاده همزمان بیش از یک سیم کارت حامل تلفن همراه را اضافه می کند. این ویژگی به کاربران امکان می دهد سیم کارت های اضافی را در دستگاه هایی که دارای دو یا چند اسلات سیم کارت هستند فعال کرده و استفاده کنند.
شما می توانید از طریق کلاس SubscriptionManager به اطلاعات مربوط به سیم کارت فعال فعلی دسترسی داشته باشید، از جمله اینکه آیا دستگاه در شبکه فعلی رومینگ در نظر گرفته می شود یا خیر. این اطلاعات برای برنامه‌نویسانی مفید است که می‌خواهند دسترسی به داده‌های برنامه‌هایشان را برای کاربران دستگاهی که به هزینه‌های دسترسی به داده حساس هستند، کاهش یا خاموش کنند. با درخواست مجوز READ_PHONE_STATE و تنظیم SubscriptionManager.OnSubscriptionsChangedListener در شیء SubscriptionManager ، برنامه شما می‌تواند از تغییرات در اتصال شبکه فعلی دستگاه مطلع شود.
کلاس های HTTP منسوخ شده
کلاس‌های org.apache.http و کلاس android.net.http.AndroidHttpClient در اندروید 5.1 منسوخ شده‌اند. این کلاس‌ها دیگر نگهداری نمی‌شوند و باید هر کد برنامه را با استفاده از این APIها در اسرع وقت به کلاس‌های URLConnection منتقل کنید.
خدمات حامل
Android 5.1 برای ارائه‌دهندگان خدمات مخابراتی پشتیبانی می‌کند تا برنامه‌هایی را ایجاد کنند که می‌توانند وظایف تامین حامل را در دستگاه Android انجام دهند. این APIها روشی امن و انعطاف‌پذیر برای برنامه‌های توسعه‌یافته اپراتور برای انجام این وظایف و توزیع از طریق Google Play فراهم می‌کنند. برنامه‌هایی که از این عملکردها استفاده می‌کنند باید با گواهی منطبق با گواهی کارت مدار مجتمع جهانی دستگاه (UICC) امضا شوند.
API های سرویس حامل به کلاس TelephonyManager ، کلاس SmsManager و کلاس جدید CarrierMessagingService اضافه شده اند. برنامه ها می توانند با فراخوانی متد hasCarrierPrivileges() دسترسی به این API ها را بررسی کنند. برنامه‌هایی که این APIها را بدون دسترسی فراخوانی می‌کنند، یک SecurityException دریافت می‌کنند.
محتوا و نمونه کدها در این صفحه مشمول پروانههای توصیفشده در پروانه محتوا هستند. جاوا و OpenJDK علامتهای تجاری یا علامتهای تجاری ثبتشده Oracle و/یا وابستههای آن هستند.
تاریخ آخرین به‌روزرسانی 2025-07-29 بهوقت ساعت هماهنگ جهانی.
[[["درک آسان","easyToUnderstand","thumb-up"],["مشکلم را برطرف کرد","solvedMyProblem","thumb-up"],["غیره","otherUp","thumb-up"]],[["اطلاعاتی که نیاز دارم وجود ندارد","missingTheInformationINeed","thumb-down"],["بیشازحد پیچیده/ مراحل بسیار زیاد","tooComplicatedTooManySteps","thumb-down"],["قدیمی","outOfDate","thumb-down"],["مشکل ترجمه","translationIssue","thumb-down"],["مشکل کد / نمونهها","samplesCodeIssue","thumb-down"],["غیره","otherDown","thumb-down"]],["تاریخ آخرین به‌روزرسانی 2025-07-29 بهوقت ساعت هماهنگ جهانی."],[],[],null,["# Android 5.1 APIs\n\nAPI Level: 22\n\n\nAndroid 5.1\n([LOLLIPOP_MR1](/reference/android/os/Build.VERSION_CODES#LOLLIPOP_MR1))\nis an update to the Lollipop release that offers new features for users and app developers.\nThis document provides an introduction to the most notable new APIs.\n\n\nFor a high-level look at the new platform features, see the [Android Lollipop highlights](/about/versions/lollipop).\n\n### Update your target API level\n\n\nTo start building apps for Android 5.1, use the\n[SDK Manager](/tools/help/sdk-manager) to download the Android 5.1 SDK\nPlatform and System Images. Then set your app development project to use a\n[`targetSdkVersion`](/guide/topics/manifest/uses-sdk-element#target)\nof `\"22\"`. Install your app on an Android 5.1\nsystem image, test it, then publish the updated app with this change.\n\n\nYou can use Android 5.1 APIs while also supporting older versions by adding\nconditions to your code that check for the system API level before executing APIs not supported\nby your [`minSdkVersion`](/guide/topics/manifest/uses-sdk-element#min). To learn more about maintaining backward compatibility, read [Supporting Different Platform\nVersions](/training/basics/supporting-devices/platforms).\n\n\nFor more information about how API levels work, read [What is API Level?](/guide/topics/manifest/uses-sdk-element#ApiLevels)\n\nMultiple SIM Card Support\n-------------------------\n\n\nAndroid 5.1 adds support for using more than one cellular carrier SIM card at a time. This\nfeature lets users activate and use additional SIMs on devices that have two or more SIM card\nslots.\n\n\nYou can access information about the currently active SIM through the [SubscriptionManager](/reference/android/telephony/SubscriptionManager) class, including whether or not the device is considered\nto be roaming on the current network. This information is useful for developers who want to\nthrottle their apps' data access down or off for device users who are sensitive to data access\ncharges. Your app can be alerted to changes in a device's current network connection by\nrequesting the [READ_PHONE_STATE](/reference/android/Manifest.permission#READ_PHONE_STATE) permission and setting [SubscriptionManager.OnSubscriptionsChangedListener](/reference/android/telephony/SubscriptionManager.OnSubscriptionsChangedListener) on the [SubscriptionManager](/reference/android/telephony/SubscriptionManager) object.\n\nDeprecated HTTP Classes\n-----------------------\n\n\nThe `org.apache.http` classes and the `android.net.http.AndroidHttpClient` class\nhave been deprecated in Android 5.1. These classes are no longer being maintained and you should\nmigrate any app code using these APIs to the [URLConnection](/reference/java/net/URLConnection) classes as soon as\npossible.\n\nCarrier Services\n----------------\n\n\nAndroid 5.1 provides support for telecommunication service providers to create apps that can\nperform carrier provisioning tasks on an Android device. These APIs provide a secure and flexible\nway for carrier-developed apps to perform these tasks and be distributed through Google Play. Apps\nthat use these functions must be signed by a certificate that matches the certificate in the\ndevice's Universal Integrated Circuit Card (UICC).\n\n\nThe carrier service APIs have been added to the [TelephonyManager](/reference/android/telephony/TelephonyManager) class,\nthe [SmsManager](/reference/android/telephony/SmsManager) class, and the new [CarrierMessagingService](/reference/android/service/carrier/CarrierMessagingService) class. Apps can check for access to these APIs\nby calling the [hasCarrierPrivileges()](/reference/android/telephony/TelephonyManager#hasCarrierPrivileges()) method. Apps that\ncall these APIs without access receive a [SecurityException](/reference/java/lang/SecurityException)."]]
