Skip to content

Commit 8e89d15

Browse files
Clarify the Android schema definition
Co-authored-by: Malcolm Smith <[email protected]>
1 parent ac29cb8 commit 8e89d15

File tree

1 file changed

+9
-7
lines changed

1 file changed

+9
-7
lines changed

source/specifications/platform-compatibility-tags.rst

Lines changed: 9 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -216,18 +216,20 @@ toolchain when building a ``universal2`` binary.
216216
android
217217
-------
218218

219-
Android uses the schema ``android_<sdk>_<arch>``, indicating compatibility with
220-
Android SDK ``sdk`` or later, on the architecture ``arch``. Android makes no
219+
Android uses the schema ``android_<api_level>_<abi>``, indicating compatibility
220+
with the given Android API level or later, on the given ABI. Android makes no
221221
distinction between physical devices and emulated devices.
222222

223-
Note that this tag schema uses the *SDK* version, not the Android OS version
224-
number. The Android release known publicly as Android 12 (code named "Snow
225-
Cone") uses SDK 31 or 32, depending on the specific Android version in use.
223+
Note that this tag schema uses the API level, which is a positive integer, not
224+
the user-facing Android version. The release known as Android 12 (code named "Snow
225+
Cone") uses API level 31 or 32, depending on the specific Android version in use.
226226
Android's release documentation contains the `full list of Android versions and
227-
their corresponding SDK versions
227+
their corresponding API levels
228228
<https://developer.android.com/tools/releases/platforms>`__.
229229

230-
There are 4 supported architectures:
230+
There are 4 `supported ABIs <https://developer.android.com/ndk/guides/abis>`__.
231+
Normalized according to the rules above, they are:
232+
231233
* ``armeabi_v7a``
232234
* ``arm64_v8a``
233235
* ``x86``

0 commit comments

Comments
 (0)