API Level: {@sdkPlatformApiLevel}
+ ++ Android 5.1 + (LOLLIPOP_MR1) + is an update to the Lollipop release that offers new features for users and app developers. + This document provides an introduction to the most notable new APIs. +
+ ++ For a high-level look at the new platform features, see the Android Lollipop highlights. +
+ + +
+ To start building apps for Android 5.1, use the
+ SDK Manager to download the Android 5.1 SDK
+ Platform and System Images. Then set your app development project to use a
+ {@code targetSdkVersion}
+ of "{@sdkPlatformApiLevel}". Install your app on an Android {@sdkPlatformVersion}
+ system image, test it, then publish the updated app with this change.
+
+ You can use Android {@sdkPlatformVersion} APIs while also supporting older versions by adding + conditions to your code that check for the system API level before executing APIs not supported + by your {@code + minSdkVersion}. To learn more about maintaining backward compatibility, read Supporting Different Platform + Versions. +
+ ++ For more information about how API levels work, read What is API Level? +
+ ++ Android 5.1 adds support for using more than one cellular carrier SIM card at a time. This + feature lets users activate and use additional SIMs on devices that have two or more SIM card + slots. +
+ ++ You can access information about the currently active SIM through the {@link + android.telephony.SubscriptionManager} class, including whether or not the device is considered + to be roaming on the current network. This information is useful for developers who want to + throttle their apps' data access down or off for device users who are sensitive to data access + charges. Your app can be alerted to changes in a device's current network connection by + requesting the {@link android.Manifest.permission#READ_PHONE_STATE} permission and setting {@link + android.telephony.SubscriptionManager.OnSubscriptionsChangedListener} on the {@link + android.telephony.SubscriptionManager} object. +
+ + ++ The {@code org.apache.http} classes and the {@link android.net.http.AndroidHttpClient} class + have been deprecated in Android 5.1. These classes are no longer being maintained and you should + migrate any app code using these APIs to the {@link java.net.URLConnection} classes as soon as + possible. +
+ + ++ Android 5.1 provides support for telecommunication service providers to create apps that can + perform carrier provisioning tasks on an Android device. These APIs provide a secure and flexible + way for carrier-developed apps to perform these tasks and be distributed through Google Play. Apps + that use these functions must be signed by a certificate that matches the certificate in the + device's Universal Integrated Circuit Card (UICC). +
+ ++ The carrier service APIs have been added to the {@link android.telephony.TelephonyManager} class, + the {@link android.telephony.SmsManager} class, and the new {@link + android.service.carrier.CarrierMessagingService} class. Apps can check for access to these APIs + by calling the {@link android.telephony.TelephonyManager#hasCarrierPrivileges} method. Apps that + call these APIs without access receive a {@link java.lang.SecurityException}. +
diff --git a/docs/html/about/versions/lollipop.jd b/docs/html/about/versions/lollipop.jd index 1ad5d24a18e21..8bc720027174c 100644 --- a/docs/html/about/versions/lollipop.jd +++ b/docs/html/about/versions/lollipop.jd @@ -55,6 +55,11 @@ about Android 5.0 for consumers at www.android.com. ++ Note: The Android 5.1 Lollipop MR1 update is available with additional features + and fixes. For more information, see the + Android 5.1 API Overview. +