This repository is in alpha development. forked from Py4A on GoogleCode

see Releases page, and select an installer: PythonForAndroid-debug.apk .

• Python2.7.14
• Python3.6.4

This is Python built to run on Android devices. It is made to be used together with SL4A (Scripting Layer For Android).

Nearly all the actual non-python specific documentation can be found at android-scripting

For Python specific issues and enhancements only, please use the issues tab.

• python2: an Android Device 1.6 >=
• python3: an Android Device 2.3.1 >=
• internet access
• SL4A was installed.

1. Download SL4A Application, such as sl4a-r6.1.1-arm-debug.apk
2. Download Py4A Application, such as PythonForAndroid-debug.apk
3. Enable "Unknown Sources" in your device settings.
4. Open 1. apk to install. (sl4a)
5. Open 2. apk to install. (py4a)
6. Open PythonForAndroid application
7. Click Install to download and install python binaries.
8. Launch sl4a, Select 'Menu' >> 'View' >> 'Interpreters' and Select 'Python 2.7.?'.
9. Python will be launched, have fun!

• if you device is not connected to internet, please try this way.

1. Download sl4a apk
2. Download py4a apk
3. Download py4a zips, interpreter - python_r29.zip, modules - python_extras_r29.zip, sample scripts - python_scripts_r26.zip.
4. Enable "Unknown Sources" in your device settings.
5. Open 1. apk to install. (sl4a)
6. Open 2. apk to install. (py4a)
7. Open PythonForAndroid application
8. push 3. zips to device's /sdcard/com.googlecode.pythonforandroid. (be sure /sdcard path to fit your device.)
9. Click "Local install" to check zips and install python binaries.
10. Click "Local install" to install these zips.
11. Launch sl4a, Select 'Menu' >> 'View' >> 'Interpreters' and Select 'Python 2.7.?'.
12. Python will be launched, have fun!

• Create issue(github)

Current issue form is here::

* What device(s) are you experiencing the problem on?
  * ex: Nexus ???
* What OS version are you running on the device?
  * ex: Andriod ???
* What version of the product are you using?
  * SL4A r????
  * PythonForAndroid r??
* What steps will reproduce the problem?
  1. 
  2. 
  3. 
* Provide logcat for detail.
* What is the expected output%3F What do you see instead?
  * expected: launch ???
  * see: stop running
* Please provide any additional information below.

• Examples as cookbooks.
• Modules
• Creating APKs
• fullscreenwrapper2
• Versions
• BuildingModules
• BuildingPython
• Python3
• Show all articles

• SL4A as Parent project
• Py4A Discussion
• SL4A Discussion

Please do not ask any question about below!

• No relatations: SL4A in google-source
• No relatations: Py4A python2.7
• No relatations: QPython
• No relatations: Kivy

Instruction for r16 or ealier

• In order to build Py4A you first need to build python for Android platform, make sure you have all the dependencies needed for building python 2.7 for your distro in Ubuntu run: sudo apt-get build-dep python2.7

• Android NDK >= r10e, maybe < r13 (r13 series does not contain GCC)

• Android SDK >= 21.1.2

• Gradle >= 2.0 (included in Android Studio >= 1.0.2)

• Build packages for build python

  • for openssl: apt install xutils-dev
  • for 64bit linux: apt install lib32z1 lib32stdc++6
  • (?): apt install aapt

• Check the dependencies of library (sample of Ubuntu)

$ sudo apt install libzlib-dev

• Clone this project.

for Mercurial uesr (with hg-git plugin)
$ hg clone git://github.com/kuri65536/python-for-android

for git user
$ git clone git://github.com/kuri65536/python-for-android

• Build the apk:

$ cd android/PythonForAndroid
$ echo sdk.dir=/path/to/android-sdk > local.properties
$ sh /path/to/android-stdudio/gradle/gradle-2.2.1/bin/gradle assembleDebug
Building ??% ...
$ ls build/outputs/apk/
PythonForAndroid-debug.apk

• Build the py4a binaries.

$ cd python-build
$ NDK_PATH=/path/to/android-ndk-r10d make build
$ ls python*.zip
python_r29.zip python_extra_r29.zip ... and so on...

• Confirm your binary version.

$ cd python-build
$ cat LATEST_VERSION
r29
$ cat LATEST_VERSION_EXTRA
r29
$ cat LATEST_VERSION_SCRIPTS
r28

• Make a release in github and Upload the binaries to it. Please be careful to match the release name and confirmed binary versions.

• Requirements: root is required.
• Requirements: python already install.
• Requirements: unzip is needed for extract.

How to run:

• after build, move current directory to python2: cd python-build
• run scripts

$ sd=/sdcard adb=~/install/android-sdk-linux/platform-tools/adb \
  sh ../tools/localinstall.sh