diff --git a/peps/pep-0738.rst b/peps/pep-0738.rst index aa47c47b1fb..ede9aeeb1d6 100644 --- a/peps/pep-0738.rst +++ b/peps/pep-0738.rst @@ -3,12 +3,14 @@ Title: Adding Android as a supported platform Author: Malcolm Smith Sponsor: Petr Viktorin 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 `__ of the device, as a string (e.g. ``"Google"``) @@ -300,6 +300,8 @@ namedtuple containing the following: * ``device`` - `device name `__ 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 =========