Donate to e Foundation | Murena handsets with /e/OS | Own a part of Murena! Learn more

Commit 75cdd5f6 authored by Dianne Hackborn's avatar Dianne Hackborn Committed by Android (Google) Code Review
Browse files

Merge "Fix issue #30766518: Document what targeting N does" into nyc-mr1-dev

parents e1105969 b34cbedb
Loading
Loading
Loading
Loading
+4 −3
Original line number Original line 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
     * at this point.  If you want to do work once the activity itself is
     * created, see {@link #onActivityCreated(Bundle)}.
     * created, see {@link #onActivityCreated(Bundle)}.
     *
     *
     * <p>If your app's <code>targetSdkVersion</code> is 23 or lower, child fragments
     * <p>If your app's <code>targetSdkVersion</code> is {@link android.os.Build.VERSION_CODES#M}
     * being restored from the savedInstanceState are restored after <code>onCreate</code>
     * or lower, child fragments being restored from the savedInstanceState are restored after
     * returns. When targeting N or above and running on an N or newer platform version
     * <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>
     * they are restored by <code>Fragment.onCreate</code>.</p>
     *
     *
     * @param savedInstanceState If the fragment is being re-created from
     * @param savedInstanceState If the fragment is being re-created from
+41 −1
Original line number Original line Diff line number Diff line
@@ -669,7 +669,47 @@ public class Build {
        public static final int M = 23;
        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;
        public static final int N = 24;


+2 −2
Original line number Original line 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
     * {@link android.os.Build.VERSION_CODES#N API 24} will be able to participate
     * in the drag operation and receive the dragged content.
     * 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
     * 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
    public static final int DRAG_FLAG_GLOBAL = 1 << 8;  // 256
+1 −1
Original line number Original line 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
     * 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.
     * these animations.
     *
     *
     * @return whether invalid animations for vector drawable should be ignored.
     * @return whether invalid animations for vector drawable should be ignored.