PEP 738: Mark as Final (#3982)

Co-authored-by: Adam Turner <[email protected]>

Author: mhsmith

peps/pep-0738.rst

@@ -3,12 +3,14 @@ Title: Adding Android as a supported platform
 Author: Malcolm Smith <[email protected]>
 Sponsor: Petr Viktorin <[email protected]>
 Discussions-To: https://discuss.python.org/t/pep-738-adding-android-as-a-supported-platform/40975
-Status: Accepted
+Status: Final
 Type: Standards Track
 Created: 12-Dec-2023
 Python-Version: 3.13
 Resolution: https://discuss.python.org/t/pep-738-adding-android-as-a-supported-platform/40975/23
 
+.. canonical-doc:: :ref:`python:using-android`
+
 
 Abstract
 ========
@@ -289,8 +291,6 @@ namedtuple containing the following:
 * ``release`` - Android version of the device, as a string (e.g. ``"14"``)
 * ``api_level`` - :ref:`API level <738-os-versions>` of the device, as an
   integer (e.g. ``34``)
-* ``min_api_level`` - Minimum API level this build of Python can run on, as
-  an integer (e.g. ``23``). This is the same as ``sys.getandroidapilevel``.
 * ``manufacturer`` - `manufacturer
   <https://developer.android.com/reference/android/os/Build#MANUFACTURER>`__ of
   the device, as a string (e.g. ``"Google"``)
@@ -300,6 +300,8 @@ namedtuple containing the following:
 * ``device`` - `device name
   <https://developer.android.com/reference/android/os/Build#DEVICE>`__ of the
   device, as a string (e.g. ``"panther"``)
+* ``is_emulator`` - ``True`` if the device is an emulator; ``False`` if it’s a
+  physical device.
 
 Which one of ``model`` and ``device`` is more likely to be unique, and which one
 is more likely to resemble the marketing name, varies between different
@@ -437,6 +439,20 @@ example of a test suite that is executed on the Android emulator using GitHub
 Actions.
 
 
+Rejected Ideas
+==============
+
+The following changes were made to the original specification of
+``platform.android_ver()``:
+
+* The ``min_api_level`` field was removed, because unlike all the other fields,
+  it isn't a property of the current device. This information is still available
+  from the pre-existing function ``sys.getandroidapilevel()``.
+
+* The ``is_emulator`` field was added, since experience during testing showed
+  that some issues were emulator-specific.
+
+
 Copyright
 =========