Python for Android
If you obtained this README as part of a release package, then the only applicable sections are "Prerequisites", "Testing", and "Using in your own app".
If you obtained this README as part of the CPython source tree, then you can also follow the other sections to compile Python for Android yourself.
However, most app developers should not need to do any of these things manually. Instead, use one of the tools listed here, which will provide a much easier experience.
Prerequisites
If you already have an Android SDK installed, export the ANDROID_HOME
environment variable to point at its location. Otherwise, here's how to install
it:
- Download the "Command line tools" from https://developer.android.com/studio.
- Create a directory
android-sdk/cmdline-tools, and unzip the command line tools package into it. - Rename
android-sdk/cmdline-tools/cmdline-toolstoandroid-sdk/cmdline-tools/latest. export ANDROID_HOME=/path/to/android-sdk
The android.py script will automatically use the SDK's sdkmanager to install
any packages it needs.
The script also requires the following commands to be on the PATH:
curljava(or set theJAVA_HOMEenvironment variable)
Building
Python can be built for Android on any POSIX platform supported by the Android development tools, which currently means Linux or macOS.
First we'll make a "build" Python (for your development machine), then use it to help produce a "host" Python for Android. So make sure you have all the usual tools and libraries needed to build Python for your development machine.
The easiest way to do a build is to use the android.py script. You can either
have it perform the entire build process from start to finish in one step, or
you can do it in discrete steps that mirror running configure and make for
each of the two builds of Python you end up producing.
The discrete steps for building via android.py are:
./android.py configure-build
./android.py make-build
./android.py configure-host HOST
./android.py make-host HOST
HOST identifies which architecture to build. To see the possible values, run
./android.py configure-host --help.
To do all steps in a single command, run:
./android.py build HOST
In the end you should have a build Python in cross-build/build, and a host
Python in cross-build/HOST.
You can use -- as a separator for any of the configure-related commands –
including build itself – to pass arguments to the underlying configure
call. For example, if you want a pydebug build that also caches the results from
configure, you can do:
./android.py build HOST -- -C --with-pydebug
Packaging
After building an architecture as described in the section above, you can package it for release with this command:
./android.py package HOST
HOST is defined in the section above.
This will generate a tarball in cross-build/HOST/dist, whose structure is
similar to the Android directory of the CPython source tree.
Testing
The Python test suite can be run on Linux, macOS, or Windows.
On Linux, the emulator needs access to the KVM virtualization interface. This may require adding your user to a group, or changing your udev rules. On GitHub Actions, the test script will do this automatically using the commands shown here.
The test suite can usually be run on a device with 2 GB of RAM, but this is
borderline, so you may need to increase it to 4 GB. As of Android
Studio Koala, 2 GB is the default for all emulators, although the user interface
may indicate otherwise. Locate the emulator's directory under ~/.android/avd,
and find hw.ramSize in both config.ini and hardware-qemu.ini. Either set these
manually to the same value, or use the Android Studio Device Manager, which will
update both files.
You can run the test suite either:
-
Within the CPython repository, after doing a build as described above. On Windows, you won't be able to do the build on the same machine, so you'll have to copy the
cross-build/HOST/prefixdirectory from somewhere else. -
Or by taking a release package built using the
packagecommand, extracting it wherever you want, and using its own copy ofandroid.py.
The test script supports the following modes:
-
In
--connectedmode, it runs on a device or emulator you have already connected to the build machine. List the available devices with$ANDROID_HOME/platform-tools/adb devices -l, then pass a device ID to the script like this:./android.py test --connected emulator-5554
-
In
--managedmode, it uses a temporary headless emulator defined in themanagedDevicessection of testbed/app/build.gradle.kts. This mode is slower, but more reproducible.We currently define two devices:
minVersionandmaxVersion, corresponding to our minimum and maximum supported Android versions. For example:./android.py test --managed maxVersion
By default, the only messages the script will show are Python's own stdout and
stderr. Add the -v option to also show Gradle output, and non-Python logcat
messages.
Any other arguments on the android.py test command line will be passed through
to python -m test – use -- to separate them from android.py's own options.
See the Python Developer's
Guide for common options
– most of them will work on Android, except for those that involve subprocesses,
such as -j.
Every time you run android.py test, changes in pure-Python files in the
repository's Lib directory will be picked up immediately. Changes in C files,
and architecture-specific files such as sysconfigdata, will not take effect
until you re-run android.py make-host or build.
The testbed app can also be used to test third-party packages. For more details,
run android.py test --help, paying attention to the options --site-packages,
--cwd, -c and -m.
Using in your own app
1 maintainer
Metadata
1 maintainer
Release files for goygram 0.8.21
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| goygram-0.8.21.tar.gz | 128.6 kB | Details |
Built distributions (wheels)
| File | Reset | |||
|---|---|---|---|---|
| goygram-0.8.21-cp38-abi3-win_amd64.whl | CPython 3.8 | abi3 | Windows x86-64 | Details |
| goygram-0.8.21-cp38-abi3-manylinux_2_34_x86_64.whl | CPython 3.8 | abi3 | Linux glibc 2.34+ x86-64 | Details |
| goygram-0.8.21-cp38-abi3-macosx_11_0_arm64.whl | CPython 3.8 | abi3 | macOS 11.0+ ARM64 | Details |
| goygram-0.8.21-cp38-abi3-android_24_x86_64.whl | CPython 3.8 | abi3 | Android API level 24+ x86-64 | Details |
| goygram-0.8.21-cp38-abi3-android_24_arm64_v8a.whl | CPython 3.8 | abi3 | Android API level 24+ ARM64 v8a | Details |
Total release size: 2.2 MB
Release files / goygram-0.8.21.tar.gz
| Download URL | goygram-0.8.21.tar.gz |
|---|---|
| Size | 128.6 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
b079dba2d47e72c6c09cf42ba386898dea3a0c4da0b5483a37318db20408bd92
|
|
BLAKE2b-256 checksum How to use checksums |
32a8b9a02ea1052fe6aba27fceb00188497b6fc4b6ac13b03a9730b7af13d816
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
maturin/1.15.0
|
Release files / goygram-0.8.21-cp38-abi3-win_amd64.whl
| Download URL | goygram-0.8.21-cp38-abi3-win_amd64.whl |
|---|---|
| Size | 350.0 kB |
| Tags | CPython 3.8 Windows x86-64 abi3 |
|
SHA-256 checksum How to use checksums |
f992749d8dfac21de8d4f40a75767e32b4b08c2c5cf4c6c0c5c125fadc3583cf
|
|
BLAKE2b-256 checksum How to use checksums |
d0bc0f78f7dedfe0c50c247bba4a1bb08f6de40fb187d261e7acbbc718f5468e
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
maturin/1.15.0
|
Release files / goygram-0.8.21-cp38-abi3-manylinux_2_34_x86_64.whl
| Download URL | goygram-0.8.21-cp38-abi3-manylinux_2_34_x86_64.whl |
|---|---|
| Size | 434.8 kB |
| Tags | CPython 3.8 Linux glibc 2.34+ x86-64 abi3 |
|
SHA-256 checksum How to use checksums |
c7f72a006ad9b197bbf8cff7c76165ac744e635d41aa695a56368be6b583f17a
|
|
BLAKE2b-256 checksum How to use checksums |
f86340fece6e48fbd1c3252ac9f3d0d62bebe7e7baf2da756e65459dfd754e46
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
maturin/1.15.0
|
Release files / goygram-0.8.21-cp38-abi3-macosx_11_0_arm64.whl
| Download URL | goygram-0.8.21-cp38-abi3-macosx_11_0_arm64.whl |
|---|---|
| Size | 410.2 kB |
| Tags | CPython 3.8 abi3 macOS 11.0+ ARM64 |
|
SHA-256 checksum How to use checksums |
b5f5f940962772f5438b737d14b3b2fe03bd832bde1e269d735cf23dace15358
|
|
BLAKE2b-256 checksum How to use checksums |
6898f2e74809f522492a1da46df2d16666681b010c49c7cdd1953f7b33e65a21
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
maturin/1.15.0
|
Release files / goygram-0.8.21-cp38-abi3-android_24_x86_64.whl
| Download URL | goygram-0.8.21-cp38-abi3-android_24_x86_64.whl |
|---|---|
| Size | 446.0 kB |
| Tags | Android API level 24+ x86-64 CPython 3.8 abi3 |
|
SHA-256 checksum How to use checksums |
74e29dcb1235ae6d8168d11bbf656aabde0dcbd0c1ab5241f2aa8c5744d6afdd
|
|
BLAKE2b-256 checksum How to use checksums |
5fff1dca258e95095ef3a5408ea1715d13a11b858ab97f5a6b5238bfec4bbf4e
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
maturin/1.15.0
|
Release files / goygram-0.8.21-cp38-abi3-android_24_arm64_v8a.whl
| Download URL | goygram-0.8.21-cp38-abi3-android_24_arm64_v8a.whl |
|---|---|
| Size | 425.7 kB |
| Tags | Android API level 24+ ARM64 v8a CPython 3.8 abi3 |
|
SHA-256 checksum How to use checksums |
1e845cb346c67aa6a17389a6cb3d2da47c3bb0a21d31f0c195afb3f093c795e9
|
|
BLAKE2b-256 checksum How to use checksums |
652dbc0c6808424f553724ac0a7e822ed6d20bbf75bbc4500e8d4df1c653aaef
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
maturin/1.15.0
|
