PEP 738: Mark as Final (#3982)

Co-authored-by: Adam Turner <9087854+AA-Turner@users.noreply.github.com>
This commit is contained in:
Malcolm Smith 2024-10-07 18:43:06 +01:00 committed by GitHub
parent 8f0f87e300
commit dbb5594d96
No known key found for this signature in database
GPG Key ID: B5690EEEBB952194
1 changed files with 19 additions and 3 deletions

View File

@ -3,12 +3,14 @@ Title: Adding Android as a supported platform
Author: Malcolm Smith <smith@chaquo.com>
Sponsor: Petr Viktorin <encukou@gmail.com>
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 its 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
=========