Python for Android 使用教程

1. 项目介绍

Python for Android (p4a) 是一个开源工具，旨在将 Python 应用程序打包成可以在 Android 设备上运行的二进制文件。该项目支持生成 Android Package (APK) 文件、Android App Bundle (AAB) 文件以及 Android Archive (AAR) 文件。p4a 不仅支持 Kivy 框架，还支持 PySDL2 和基于 WebView 的 Python Web 服务器。此外，p4a 能够自动处理大多数纯 Python 包的依赖关系，对于依赖 C 代码的包，则需要编写特定的“recipe”来支持交叉编译。

2. 项目快速启动

安装

首先，确保你已经安装了 Python 和 Git。然后，通过以下命令克隆并安装 p4a：

git clone https://github.com/kuri65536/python-for-android.git
cd python-for-android
pip install .

创建一个简单的 APK

假设你有一个简单的 Python 脚本 hello.py，内容如下：

print("Hello, Android!")

你可以使用以下命令将其打包成 APK：

p4a apk --private . --package=org.example.hello --name="HelloApp" --version=0.1 --bootstrap=pygame --requirements=python3

这将生成一个名为 HelloApp-0.1-debug.apk 的 APK 文件，你可以将其安装到 Android 设备上运行。

3. 应用案例和最佳实践

案例1：使用 Kivy 开发 Android 应用

Kivy 是一个跨平台的 OpenGL 用户界面工具包，p4a 对其有良好的支持。以下是一个简单的 Kivy 应用示例：

from kivy.app import App
from kivy.uix.label import Label

class HelloApp(App):
    def build(self):
        return Label(text="Hello, Kivy!")

if __name__ == '__main__':
    HelloApp().run()

使用 p4a 打包：

p4a apk --private . --package=org.example.kivyhello --name="KivyHelloApp" --version=0.1 --bootstrap=sdl2 --requirements=kivy

案例2：集成第三方库

假设你想在应用中使用 numpy，你可以通过以下命令打包：

p4a apk --private . --package=org.example.numpyapp --name="NumpyApp" --version=0.1 --bootstrap=pygame --requirements=python3,numpy

4. 典型生态项目

Buildozer

Buildozer 是一个用于自动化 p4a 构建过程的工具。它通过一个配置文件来管理应用的构建选项，简化了打包过程。你可以通过以下命令安装 Buildozer：

pip install buildozer

然后，创建一个 buildozer.spec 文件并运行 buildozer init 来生成初始配置文件。最后，运行 buildozer android debug 来生成 APK。

Kivy

Kivy 是一个开源的 Python 库，用于快速开发多点触控应用程序。它与 p4a 紧密集成，提供了丰富的 UI 组件和跨平台支持。

PySDL2

PySDL2 是一个 Python 绑定库，用于 SDL2 多媒体库。p4a 支持 PySDL2，允许你在 Android 上运行基于 SDL2 的应用。

通过这些工具和库，你可以轻松地将 Python 应用程序移植到 Android 平台，并利用丰富的生态系统来增强应用的功能和用户体验。