kivy/python-for-android

python-for-android

镜像概述与主要用途

python-for-android (p4a) 是一款开发工具，用于将Python应用打包为可在Android设备上运行的二进制文件。它由Kivy团队维护，支持多种输出格式和CPU架构，兼容主流Python后端框架，为Python开发者提供便捷的Android应用打包解决方案。

核心功能与特性

支持的输出格式

• Android Package (APK)：可直接在设备上安装的文件，适用于测试，被多数应用商店支持（不含Google Play Store）。
• Android App Bundle (AAB)：可在Google Play Store发布的应用 bundle 格式。
• Android Archive (AAR)：可作为其他项目复用资源包的库文件。

架构与兼容性

• 支持多种CPU架构。

后端框架支持

• 原生支持Kivy框架开发的应用。
• 通过"bootstraps"机制灵活支持其他后端库，包括PySDL2和WebView（配合Python Web服务器）。

依赖管理

• 自动支持大多数纯Python包的依赖。
• 对含C代码的依赖包，需编写特殊"recipe"支持交叉编译，内置numpy、sqlalchemy等热门库的recipe。

工作原理

通过为Android设备交叉编译Python解释器及其依赖，将其与应用的Python代码和依赖捆绑，最终在Android设备上解释执行Python代码。

使用场景与适用范围

适用于需将Python应用部署到Android平台的开发者，特别是：

• 使用Kivy、PySDL2等框架开发跨平台应用的场景。
• 需要生成APK（测试）、AAB（Google Play发布）、AAR（库复用）等不同格式的需求。
• 开发包含纯Python依赖或常见C依赖库的Python应用。

使用方法与配置说明

推荐使用方式

推荐通过Buildozer使用，Buildozer可确保预安装正确依赖并集中管理配置，但python-for-android也支持独立使用。

文档与快速入门

更多信息参见在线文档，包含快速入门指南。

支持与社区

获取支持

使用中遇到问题，可参考最新https://github.com/kivy/python-for-android/blob/master/CONTACT.md%E6%96%87%E6%A1%A3%E4%B8%AD%E7%9A%84%E6%B8%A0%E9%81%93%E8%81%94%E7%B3%BB%E5%BF%97%E6%84%BF%E8%80%85%E3%80%82

行为准则

为营造开放友好社区，参与者需遵守https://github.com/kivy/python-for-android/blob/master/CODE_OF_CONDUCT.md%EF%BC%8C%E7%A1%AE%E4%BF%9D%E4%BA%92%E5%8A%A8%E5%85%85%E6%BB%A1%E5%B0%8A%E9%87%8D%E3%80%81%E5%BC%80%E6%94%BE%E5%92%8C%E6%84%9F%E6%BF%80%E3%80%82

贡献者与支持者

贡献者

本项目得益于https://github.com/kivy/python-for-android/graphs/contributors%E3%80%82%5B%E6%88%90%E4%B8%BA%E8%B4%A1%E7%8C%AE%E8%80%85]

Backers

感谢所有backer！🙏 [成为backer]

***

特别感谢所有赞助商（含过往与现任）。[成为赞助商]

以下为当前主要赞助商，点击链接支持他们：