aboutsummaryrefslogtreecommitdiff
path: root/en/compatibility/cts/setup.html
diff options
context:
space:
mode:
Diffstat (limited to 'en/compatibility/cts/setup.html')
-rw-r--r--en/compatibility/cts/setup.html30
1 files changed, 22 insertions, 8 deletions
diff --git a/en/compatibility/cts/setup.html b/en/compatibility/cts/setup.html
index 6efc82df..7961778a 100644
--- a/en/compatibility/cts/setup.html
+++ b/en/compatibility/cts/setup.html
@@ -171,18 +171,32 @@ property is the first API level the device was commercially launched with.</p>
this property, as shown in the following example: </p>
<pre class="devsite-click-to-copy">
-#ro.product.first_api_level indicates the first api level, device has been commercially launched on.
+#ro.product.first_api_level indicates the first api level that the device has
+been commercially launched on.
PRODUCT_PROPERTY_OVERRIDES +=\
ro.product.first_api_level=21
</pre>
-<aside class="note">
- <b>Note:</b> The property <code>ro.product.first_api_level</code> should be unset (removed)
- for the first build of a product, and set to the correct API level value for all subsequent
- builds. This way the property can correctly identify a new product, and we have lost no
- information about the first API level of the product. If the flag is unset, Android will assign
- <code>Build.VERSION.SDK_INT</code> to <code>ro.product.first_api_level</code>.
-</aside>
+<h4 id="android-9-higher">First API level for Android 9 and higher</h4>
+
+ <p>
+ For devices launched with Android 9 or higher, set the property
+ <code>ro.product.first_api_level</code> to a valid value found on
+ <a href="/setup/start/build-numbers">Codenames, Tags, and Build Numbers</a>.
+ </p>
+
+<h4 id="android-8x-lower">First API level for Android 8.x and lower</h4>
+
+ <p>
+ For devices launched on Android 8.x or lower, unset (remove) the property
+ <code>ro.product.first_api_level</code> for the first build of the
+ product. For all subsequent builds, set
+ <code>ro.product.first_api_level</code> to the correct API level value.
+ This allows the property to correctly identify a new product and preserves
+ information about the first API level of the product. If the flag is
+ unset, Android assigns <code>Build.VERSION.SDK_INT</code> to
+ <code>ro.product.first_api_level</code>.
+ </p>
<h3 id=cts-shim-apps>CTS Shim apps</h3>