Fix issue #30766518: Document what targeting N does (3a585b86) · Commits · e / os / android_frameworks_base

core/java/android/app/Fragment.java

+4 −3

Original line number	Diff line number	Diff line
		@@ -1483,9 +1483,10 @@ public class Fragment implements ComponentCallbacks2, OnCreateContextMenuListene
		* at this point. If you want to do work once the activity itself is
		* created, see {@link #onActivityCreated(Bundle)}.
		*
		* <p>If your app's <code>targetSdkVersion</code> is 23 or lower, child fragments
		* being restored from the savedInstanceState are restored after <code>onCreate</code>
		* returns. When targeting N or above and running on an N or newer platform version
		* <p>If your app's <code>targetSdkVersion</code> is {@link android.os.Build.VERSION_CODES#M}
		* or lower, child fragments being restored from the savedInstanceState are restored after
		* <code>onCreate</code> returns. When targeting @link android.os.Build.VERSION_CODES#N} or
		* above and running on an N or newer platform version
		* they are restored by <code>Fragment.onCreate</code>.</p>
		*
		* @param savedInstanceState If the fragment is being re-created from

core/java/android/os/Build.java

+41 −1

Original line number	Diff line number	Diff line
		@@ -669,7 +669,47 @@ public class Build {
		public static final int M = 23;

		/**
		* N is for ¯\_(ツ)_/¯.
		* N is for Nougat.
		*
		* <p>Applications targeting this or a later release will get these
		* new changes in behavior:</p>
		* <ul>
		* <li> {@link android.app.DownloadManager.Request#setAllowedNetworkTypes
		* DownloadManager.Request.setAllowedNetworkTypes}
		* will disable "allow over metered" when specifying only
		* {@link android.app.DownloadManager.Request#NETWORK_WIFI}.
		* <li> {@link android.app.DownloadManager} no longer allows access to raw
		* file paths.
		* <li> {@link android.app.Notification.Builder#setShowWhen
		* Notification.Builder.setShowWhen}
		* must be called explicitly to have the time shown, and various other changes in
		* {@link android.app.Notification.Builder Notification.Builder} to how notifications
		* are shown.</li>
		* <li>{@link android.content.Context#MODE_WORLD_READABLE} and
		* {@link android.content.Context#MODE_WORLD_WRITEABLE} are no longer supported.</li>
		* <li>{@link android.os.FileUriExposedException} will be thrown to applications.</li>
		* <li>Applications will see global drag and drops as per
		* {@link android.view.View#DRAG_FLAG_GLOBAL}.</li>
		* <li>{@link android.webkit.WebView#evaluateJavascript WebView.evaluateJavascript}
		* will not persist state from an empty WebView.</li>
		* <li>{@link android.animation.AnimatorSet} will not ignore calls to end() before
		* start().</li>
		* <li>{@link android.app.AlarmManager#cancel(android.app.PendingIntent)
		* AlarmManager.cancel} will throw a NullPointerException if given a null operation.</li>
		* <li>{@link android.app.FragmentManager} will ensure fragments have been created
		* before being placed on the back stack.</li>
		* <li>{@link android.app.FragmentManager} restores fragments in
		* {@link android.app.Fragment#onCreate Fragment.onCreate} rather than after the
		* method returns.</li>
		* <li>{@link android.R.attr#resizeableActivity} defaults to true.</li>
		* <li>{@link android.graphics.drawable.AnimatedVectorDrawable} throws exceptions when
		* opening invalid VectorDrawable animations.</li>
		* <li>{@link android.view.ViewGroup.MarginLayoutParams} will no longer be dropped
		* when converting between some types of layout params (such as
		* {@link android.widget.LinearLayout.LayoutParams LinearLayout.LayoutParams} to
		* {@link android.widget.RelativeLayout.LayoutParams RelativeLayout.LayoutParams}).</li>
		* <li>Your application processes will not be killed when the device density changes.</li>
		* </ul>
		*/
		public static final int N = 24;

core/java/android/view/View.java

+2 −2

Original line number	Diff line number	Diff line
		@@ -3771,9 +3771,9 @@ public class View implements Drawable.Callback, KeyEvent.Callback,
		* {@link android.os.Build.VERSION_CODES#N API 24} will be able to participate
		* in the drag operation and receive the dragged content.
		*
		* If this is the only flag set, then the drag recipient will only have access to text data
		* <p>If this is the only flag set, then the drag recipient will only have access to text data
		* and intents contained in the {@link ClipData} object. Access to URIs contained in the
		* {@link ClipData} is determined by other DRAG_FLAG_GLOBAL_* flags.
		* {@link ClipData} is determined by other DRAG_FLAG_GLOBAL_* flags</p>
		*/
		public static final int DRAG_FLAG_GLOBAL = 1 << 8; // 256

graphics/java/android/graphics/drawable/AnimatedVectorDrawable.java

+1 −1

Original line number	Diff line number	Diff line
		@@ -210,7 +210,7 @@ public class AnimatedVectorDrawable extends Drawable implements Animatable2 {

		/**
		* In order to avoid breaking old apps, we only throw exception on invalid VectorDrawable
		* animations * for apps targeting N and later. For older apps, we ignore (i.e. quietly skip)
		* animations for apps targeting N and later. For older apps, we ignore (i.e. quietly skip)
		* these animations.
		*
		* @return whether invalid animations for vector drawable should be ignored.