Merge "Docs: Standardizing on "Android N" language in Preview docs." into mnc-mr-docs (6aed9862) · Commits · e / os / android_frameworks_base

docs/html/preview/behavior-changes.jd

+20 −21

Original line number	Diff line number	Diff line
		@@ -33,7 +33,7 @@ page.image=images/cards/card-n-changes_2x.png
		<h2>See Also</h2>
		<ol>
		<li><a href="{@docRoot}preview/api-overview.html">
		N Developer Preview API Overview</a></li>
		Android N API Overview</a></li>
		</ol>

		</div>
		@@ -41,7 +41,7 @@ page.image=images/cards/card-n-changes_2x.png


		<p>
		Along with new features and capabilities, the Android N Developer Preview
		Along with new features and capabilities, Android N
		includes a variety of system and API behavior changes. This document
		highlights some of the key changes that you should understand and account for
		in your apps.
		@@ -56,7 +56,7 @@ page.image=images/cards/card-n-changes_2x.png
		<h2 id="perf">Performance Improvements</h2>

		<p>
		The Preview contains system behavior changes aimed at improving the battery
		Android N contains system behavior changes aimed at improving the battery
		life of devices, RAM usage, and app performance. These changes can impact the
		availability of system resources and system notifications to your app. You
		should review these changes and evaluate how your app may need to adjust to
		@@ -68,7 +68,7 @@ page.image=images/cards/card-n-changes_2x.png
		<p>
		Introduced in Android 6.0 (API level 23), Doze improves battery life by
		deferring CPU and network activities when a user leaves a device unplugged,
		stationary, and with the screen turned off. This Preview brings further
		stationary, and with the screen turned off. Android N brings further
		enhancements to Doze by applying a subset of CPU and network restrictions
		while the device is unplugged with the screen turned off, but not necessarily
		stationary, for example, when a handset is traveling in a user’s pocket.
		@@ -118,7 +118,7 @@ page.image=images/cards/card-n-changes_2x.png
		<h3 id="bg-opt">Project Svelte: Background Optimizations</h3>

		<p>
		The Preview removes three implicit broadcasts in order to help optimize both
		Android N removes three implicit broadcasts in order to help optimize both
		memory use and power consumption. This change is necessary because implicit
		broadcasts frequently start apps that have registered to listen for them in
		the background. Removing these broadcasts can substantially benefit device
		@@ -143,12 +143,12 @@ page.image=images/cards/card-n-changes_2x.png
		</p>

		<p>
		To alleviate these issues, the Preview applies the following
		To alleviate these issues, Android N applies the following
		optimizations:
		</p>

		<ul>
		<li>Apps targeting the Preview do not receive {@link
		<li>Apps targeting Android N do not receive {@link
		android.net.ConnectivityManager#CONNECTIVITY_ACTION} broadcasts, even if they
		have manifest entries to request notification of these events. Apps running
		in the foreground can still listen for {@code CONNECTIVITY_CHANGE} on their
		@@ -158,7 +158,7 @@ page.image=images/cards/card-n-changes_2x.png

		<li>Apps cannot send or receive {@code NEW_PICTURE} or {@code NEW_VIDEO}
		broadcasts. This optimization affects all apps, not only those
		targeting the Preview.
		targeting Android N.
		</li>
		</ul>

		@@ -189,7 +189,7 @@ page.image=images/cards/card-n-changes_2x.png
		<h2 id="perm">Permissions Changes</h2>

		<p>
		The Preview includes changes to permissions that may affect your app,
		Android N includes changes to permissions that may affect your app,
		including user accounts permissions and a new permission for writing to
		external storage. Here is a summary of the permissions that have changed in
		the preview:
		@@ -199,7 +199,7 @@ page.image=images/cards/card-n-changes_2x.png
		<li>{@code GET_ACCOUNTS} (Deprecated)
		<p>
		The GET_ACCOUNTS permission is now deprecated. The system ignores this
		permission for apps that target the N Developer Preview.
		permission for apps that target Android N.
		</p>
		</li>

		@@ -227,7 +227,7 @@ page.image=images/cards/card-n-changes_2x.png
		<h2 id="accessibility">Accessibility Improvements</h2>

		<p>
		This Preview includes changes intended to improve the usability of the
		Android N includes changes intended to improve the usability of the
		platform for users with low or impaired vision. These changes should
		generally not require code changes in your app, however you should review
		these feature and test them with your app to assess potential impacts to user
		@@ -238,7 +238,7 @@ page.image=images/cards/card-n-changes_2x.png
		<h3 id="screen-zoom">Screen Zoom</h3>

		<p>
		The Preview enables users to set <strong>Display size</strong>which magnifies
		Android N enables users to set <strong>Display size</strong>which magnifies
		or shrinks all elements on the screen, thereby improving device accessibility
		for users with low vision. Users cannot zoom the screen past a minimum screen
		width of <a href=
		@@ -258,7 +258,7 @@ page.image=images/cards/card-n-changes_2x.png
		</div> <!-- end cols -->
		<p class="img-caption">
		<strong>Figure 3.</strong> The screen on the right shows the effect of
		increasing the Display size of a device running an N Preview system image.
		increasing the Display size of a device running an Android N system image.
		</p>


		@@ -278,7 +278,7 @@ page.image=images/cards/card-n-changes_2x.png
		Runtime Changes</a>, just as if the device's orientation had changed.
		</li>

		<li>If an app targets the N Developer Preview, all of its processes
		<li>If an app targets Android N, all of its processes
		(foreground and background) are notified of the configuration change as
		described in <a href=
		"{@docRoot}guide/topics/resources/runtime-changes.html">Handling
		@@ -296,7 +296,7 @@ page.image=images/cards/card-n-changes_2x.png
		<h3 id="vision-settings">Vision Settings in Setup Wizard</h3>

		<p>
		The Preview includes Vision Settings on the Welcome screen, where users can
		Android N includes Vision Settings on the Welcome screen, where users can
		set up the following accessibility settings on a new device:
		<strong>Magnification gesture</strong>, <strong>Font size</strong>,
		<strong>Display size</strong> and <strong>TalkBack</strong>. This change
		@@ -310,7 +310,7 @@ page.image=images/cards/card-n-changes_2x.png
		<h2 id="open-jdk">Platform Migration toward OpenJDK 8</h2>

		<p>
		The Preview moves Android’s Java language libraries to an OpenJDK-based
		Android N moves Android’s Java language libraries to an OpenJDK-based
		approach, creating a common code base for developers to build apps and
		services. If your app depends on a private implementation of Java or
		unspecified behavior, you should be aware of these known issues:
		@@ -357,14 +357,14 @@ java.lang.NoSuchFieldException: No field array in class Ljava/util/ArrayList;
		<h2 id="ndk">NDK Apps Linking to Platform Libraries</h2>

		<p>
		The Preview includes namespace changes to prevent loading of non-public APIs.
		Android N includes namespace changes to prevent loading of non-public APIs.
		If you use the NDK, you should only be using public APIs from the Android
		platform. Using non-public APIs in the next official release of Android
		can cause your app to crash.
		</p>

		<p>
		In order to alert you to use of non-public APIs, apps running on a Preview
		In order to alert you to use of non-public APIs, apps running on an Android N
		device generate an error in logcat output when an app calls a non-public API.
		This error is also displayed on the device screen as a message to help
		raise awareness of this situation. You should review your app code to
		@@ -399,8 +399,7 @@ java.lang.NoSuchFieldException: No field array in class Ljava/util/ArrayList;

		<p>
		To help you diagnose these types problems here are some example Java and NDK
		errors you might encounter when attempting to build your app with the N
		Developer Preview:
		errors you might encounter when attempting to build your app with Android N:
		</p>

		<p>Example Java error:</p>
		@@ -445,7 +444,7 @@ JavaVM::AttachCurrentThread from <jni.h>.

		<h2 id="afw">Android for Work</h2>
		<p>
		The Preview contains changes for apps that target Android for Work, including
		Android N contains changes for apps that target Android for Work, including
		changes to certificate installation, password resetting, secondary user
		management, and access to device identifiers. If you are building apps for
		Android for Work environments, you should review these changes and modify

docs/html/preview/download.jd

+12 −12

Original line number	Diff line number	Diff line
		@@ -170,7 +170,7 @@ This is the Android SDK Preview License Agreement (the “License Agreement”).
		<div id="qv">
		<h2>In this document</h2>
		<ol>
		<li><a href="#device-preview">Getting Preview on Devices</a>
		<li><a href="#device-preview">Getting Android N on Devices</a>
		<ol>
		<li><a href="#ota">Over the air updates</a></li>
		<li><a href="#flash">Installing system images</a></li>
		@@ -185,19 +185,19 @@ This is the Android SDK Preview License Agreement (the “License Agreement”).
		<p>
		The Android N Developer Preview includes device system images to help you
		test your app and the new APIs coming in the next release of the platform.
		This document describes how to get Preview system images on a device for
		This document describes how to get Android N system images on a device for
		testing.
		</p>

		<h2 id="device-preview">Getting Preview on Devices</h2>
		<h2 id="device-preview">Getting Android N on Devices</h2>

		<p>
		In order to effectively test your apps with the Preview, use
		a Preview emulator provided with the Preview SDK or configure a device
		with a Preview system image. The N Developer Preview allows you to update
		devices for use in testing the functionality of the Preview APIs and system
		behaviors with your apps. You can get the Preview on a device by opting a
		device into the Android Beta Program or by downloading a preview system
		In order to effectively test your apps with Android N, use
		an Android N emulator provided with the N Preview SDK or configure a device
		with an Android N system image. Android N allows you to update
		devices for use in testing the functionality of the Android N APIs and system
		behaviors with your apps. You can get Android N on a device by opting a
		device into the Android Beta Program or by downloading an Android N system
		image and installing it on a device.
		</p>

		@@ -212,7 +212,7 @@ This is the Android SDK Preview License Agreement (the “License Agreement”).
		</p>

		<p>
		You can create emulators containing the Preview within the Preview SDK.
		You can create emulators containing Android N within the Preview SDK.
		For more information about getting the Preview SDK, see
		<a href="{@docRoot}preview/setup-sdk.html">Set Up the SDK</a>.
		</p>
		@@ -221,9 +221,9 @@ This is the Android SDK Preview License Agreement (the “License Agreement”).
		<h3 id="ota">Over the air updates</h3>

		<p>
		You can receive Preview versions of Android on compatible devices by
		You can receive preview versions of Android on compatible devices by
		enrolling them in the Android Beta Program. Once you enroll a device in
		this program, it receives Preview versions of Android over-the-air (OTA).
		this program, it receives preview versions of Android over-the-air (OTA).
		These updates are automatically downloaded and can installed just like
		official updates.
		</p>

docs/html/preview/features/afw.jd

+4 −4

Original line number	Diff line number	Diff line
		page.title=Android for Work Updates
		page.metaDescription=New Android for Work APIs and features in the N Developer Preview.
		page.metaDescription=New Android for Work APIs and features in Android N.
		page.keywords="android for work", "android N", "enterprise", "QR code"

		@jd:body
		@@ -84,8 +84,8 @@ page.keywords="android for work", "android N", "enterprise", "QR code"
		</div>
		</div>

		<p>This document describes the new Android for Work features provided in the
		N Developer Preview.</p>
		<p>This document describes the new Android for Work features provided in
		Android N.</p>

		<h2 id="qr">QR Code Provisioning</h2>

		@@ -310,7 +310,7 @@ N Developer Preview.</p>
		</p>

		<p>
		The Preview includes the following API additions to support this feature. For
		Android N includes the following API additions to support this feature. For
		details, see the <a href="{@docRoot}preview/download.html#docs">N Preview SDK
		Reference</a>.
		</p>

docs/html/preview/features/background-optimization.jd

+10 −10

Original line number	Diff line number	Diff line
		@@ -57,12 +57,12 @@ page.keywords="android N", "implicit broadcasts", "job scheduler"
		</p>

		<p>
		To alleviate this issue, the N Developer Preview applies the following
		To alleviate this issue, Android N applies the following
		restrictions:
		</p>

		<ul>
		<li>Apps targeting the N Developer Preview will not receive {@link
		<li>Apps targeting Android N will not receive {@link
		android.net.ConnectivityManager#CONNECTIVITY_ACTION} broadcasts if they
		register to receive them in their manifest. Apps running in the foreground
		can still listen for {@code CONNECTIVITY_CHANGE} on their main thread with a
		@@ -100,7 +100,7 @@ page.keywords="android N", "implicit broadcasts", "job scheduler"
		</h2>

		<p>
		Apps targeting the N Developer Preview do not receive {@link
		Apps targeting Android N do not receive {@link
		android.net.ConnectivityManager#CONNECTIVITY_ACTION} broadcasts, even if they
		register to receive them in their manifest. This could pose a problem for
		apps that want to listen for network changes or perform bulk network
		@@ -225,10 +225,10 @@ GcmNetworkManager</a> and specify {@code Task.NETWORK_STATE_UNMETERED}.
		</h2>

		<p>
		In the N Developer Preview, apps are not able to send or receive {@code
		In Android N, apps are not able to send or receive {@code
		NEW_PICTURE} or {@code NEW_VIDEO} broadcasts. This restriction helps
		alleviate the performance and user experience impacts when several apps must
		wake up in order to process them. The N Developer Preview extends {@link
		wake up in order to process them. Android N extends {@link
		android.app.job.JobInfo} and {@link android.app.job.JobParameters} to provide
		an alternative solution.
		</p>
		@@ -238,7 +238,7 @@ GcmNetworkManager</a> and specify {@code Task.NETWORK_STATE_UNMETERED}.
		</h3>

		<p>
		To help trigger jobs on content URI changes, the N Developer Preview extends
		To help trigger jobs on content URI changes, Android N extends
		the {@link android.app.job.JobInfo} API with the following methods:
		</p>

		@@ -313,7 +313,7 @@ public static void scheduleJob(Context context) {
		</h3>

		<p>
		The N Developer Preview also extends {@link android.app.job.JobParameters} to
		Android N also extends {@link android.app.job.JobParameters} to
		allow your app to receive useful information about what content authorities
		and URIs triggered the job:
		</p>
		@@ -386,14 +386,14 @@ public boolean onStartJob(JobParameters params) {
		Optimizing your apps to run on low-memory devices, or in low-memory
		conditions, can improve performance and user experience. Eliminating the use
		of implicit broadcasts and background services is a great way to make sure
		your app runs well on such devices. Although the N Developer Preview takes
		your app runs well on such devices. Although Android N takes
		steps to limit the use of certain implicit broadcasts, consider optimizing
		your app to run without the use of implicit broadcasts and background
		services, entirely.</p>

		<p>
		To help you test how your app behaves without those background processes, The
		N Developer Preview introduces some additional <a href=
		To help you test how your app behaves without those background processes,
		Android N introduces some additional <a href=
		"{@docRoot}tools/help/adb.html">Android Debug Bridge (ADB)</a> commands:
		</p>

docs/html/preview/features/data-saver.jd

+3 −3

Original line number	Diff line number	Diff line
		@@ -24,7 +24,7 @@ page.keywords="android N", "data usage", "metered network"

		<p>
		Over the life of a smartphone, the cost of a cellular data plan can easily
		exceed the cost of the device itself. In the N Developer Preview, users can
		exceed the cost of the device itself. In Android N, users can
		enable Data Saver in order to use less data, whether roaming, near the end of
		the billing cycle, or on a small prepaid data pack.
		</p>
		@@ -38,7 +38,7 @@ page.keywords="android N", "data usage", "metered network"
		</p>

		<p>
		The N Developer Preview extends the {@link android.net.ConnectivityManager}
		Android N extends the {@link android.net.ConnectivityManager}
		API to provide apps a way to <a href="#status">retrieve the user’s Data Saver
		preferences</a> and <a href="#monitor-changes">monitor preference
		changes</a>. It is considered good practice for apps to check whether the
		@@ -51,7 +51,7 @@ page.keywords="android N", "data usage", "metered network"
		</h1>

		<p>
		In the N Developer Preview, apps can use the {@link
		In Android N, apps can use the {@link
		android.net.ConnectivityManager} API to determine what data usage
		restrictions are being applied. The {@code getRestrictBackgroundStatus()}
		method returns one of the following values: