python安卓开发——kivy打包安卓APK逐步教程

之前偶尔接触到了python开发app的工具kivy（也能开发windows/linux/mac应用），然后发现网上教程极少，甚至第一步打包apk就劝退了很多人，我也踩了很多坑，最后还是一一解决了，这里写个博文记录下。

我选择用buidlozer打包apk，主要参考官方文档：https://buildozer.readthedocs.io/en/latest/installation.html

从文档上看，这个工具主要是在linux和macos上用，我这边主要用windows，所以我选择用虚拟机来搭建打包环境。
整个搭建过程录频传到b站上了，供参考python安卓开发——kivy打包安卓APK逐步教学

一、准备linux环境和相关工具

这里直接VMware+Ubuntu20.04解决环境问题，这一有个坑，一定要用18以上的ubuntu，否则可能因为openssl版本导致后续步骤失败。如何安装虚拟机和在虚拟机上安装系统就不赘述了，一般按照安装引导就ok。

安装完成后为了后续方便使用，建议安装以下两个工具：

1. openssl-server（linux）+Mobaxterm（windows）。ssh登录linux，方便windows下贴命令，否则的话需要安装vmware-tools，但是感觉这个不太好用。另外也可以通过这个来在虚拟机和windows间传输文件。这个配置也简单，直接sudo apt install openssl-server即可
2. samba。linux上配置samba方便共享文件，这样windows可以直接添加网络位置，可以方便地在windows上编辑文件并在linux编译运行。可参考博文【详细步骤】Ubuntu安装Samba服务及配置共享文件夹进行配置

二、准备python环境

官方文档说的需要3.8以上版本，因此我也就直接用3.8了。
为了后续方便，还是用conda来管理python环境，我这里用的miniconda，因为文件要小一些，所需要的功能也都有。

conda create -n kivy python=3.8
source activate kivy
pip install kivy

然后把我们在windows下写的程序传到虚拟机里面，代码是一段简单的demo如下，python ./main验证ok

from kivy.app import App
from kivy.uix.button import Button
 
class TestApp(App):
    def build(self):
        return Button(text='iPaoMi')
 
TestApp().run()

三、buildozer打包apk

在工程目录下，执行以下命令

3.1 初始化

在工程目录下执行buildozer init，会生成一个.spec配置文件，内容可以自己看看，包括App名称等，这里我也没有仔细研究。

3.2 buildozer -v android debug

接下来是个巨坑，官方文档上说明是执行buildozer -v android debug，如果你是初次运行，就可以去泡一杯咖啡了。因为这个过程中会自动下载SDK/NDK等内容。

然后第一个坑就来了，如果你是ubuntu16，那么大概跑了十几分钟后会失败，提示ssl之类的错误。
其实这里并不需要魔法，可以正常下载，原因就在ubuntu的ssl版本。
SDK里面用的python3.10.10，要求openssl版本大于1.1.1
如果你愿意折腾，可以试试升级一下是否能解决这个问题，但我建议直接用ubuntu20.04，按官方文档来。

然后是第二个坑，如果下载过程中网络波动导致失败，重新尝试下载时，会提示文件已存在，或者是某某工具找不到
因为之前下载未完成但是可能文件已经存在，这将影响工具对下载状态的判断，需要删除工程目录下的.buildozer文件夹和用户目录下的.buildozer文件夹

然后是第三个坑，下了十几分钟文件后，有一个文件无法下载，看域名确实是需要魔法才能下载，但是这并不意味着我们需要这个文件
重新执行之前的命令，发现没有出现前面的问题，开始正式编译了，最终生成目录bin，并在其下能找到apk文件。

四、验证

这里没有像官方文档中建议那样直接用USB调试，而是简单的将APK文件拖入安卓模拟器验证，执行ok。

后续修改代码内容重新编译，大约只需要半分钟即可打包完成。也就是第一次使用比较困难。