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

Commit e960030f authored by Adam Powell's avatar Adam Powell
Browse files

Add Build.VERSION.PREVIEW_SDK_INT 

Add a constant to the SDK that apps may use to detect incremental API
changes across prerelease preview builds. APIs newer than the latest
official API level are not guaranteed to be stable or even present
across preview revisions.

Change-Id: I14341e55a3ebc3d872977970b9440c400e71f588
parent 6402dc7e

api/current.txt

+1 −0
Original line number Diff line number Diff line
@@ -22906,6 +22906,7 @@ package android.os { 
    ctor public Build.VERSION();

    field public static final java.lang.String CODENAME;

    field public static final java.lang.String INCREMENTAL;

    field public static final int PREVIEW_SDK_INT;

    field public static final java.lang.String RELEASE;

    field public static final deprecated java.lang.String SDK;

    field public static final int SDK_INT;

api/system-current.txt

+1 −0
Original line number Diff line number Diff line
@@ -24805,6 +24805,7 @@ package android.os { 
    ctor public Build.VERSION();

    field public static final java.lang.String CODENAME;

    field public static final java.lang.String INCREMENTAL;

    field public static final int PREVIEW_SDK_INT;

    field public static final java.lang.String RELEASE;

    field public static final deprecated java.lang.String SDK;

    field public static final int SDK_INT;

core/java/android/os/Build.java

+21 −0
Original line number Diff line number Diff line
@@ -172,6 +172,27 @@ public class Build { 
        public static final int SDK_INT = SystemProperties.getInt(

                "ro.build.version.sdk", 0);



        /**

         * The developer preview revision of a prerelease SDK. This value will always

         * be <code>0</code> on production platform builds/devices.

         *

         * <p>When this value is nonzero, any new API added since the last

         * officially published {@link #SDK_INT API level} is only guaranteed to be present

         * on that specific preview revision. For example, an API <code>Activity.fooBar()</code>

         * might be present in preview revision 1 but renamed or removed entirely in

         * preview revision 2, which may cause an app attempting to call it to crash

         * at runtime.</p>

         *

         * <p>Experimental apps targeting preview APIs should check this value for

         * equality (<code>==</code>) with the preview SDK revision they were built for

         * before using any prerelease platform APIs. Apps that detect a preview SDK revision

         * other than the specific one they expect should fall back to using APIs from

         * the previously published API level only to avoid unwanted runtime exceptions.

         * </p>

         */

        public static final int PREVIEW_SDK_INT = SystemProperties.getInt(

                "ro.build.version.preview_sdk", 0);



        /**

         * The current development codename, or the string "REL" if this is

         * a release build.