用Python来开发安卓程序：(1)BeeWare安卓开发环境的搭建

1. 前言

用Python来开发安卓程序不是最好的选择，但一定是一个可以偷懒的选择，我们这里采用BeeWare来完成这个工作。

2. BeeWare简介

• BeeWare是一个基于Python构建的跨平台应用开发框架，宣称是Write once. Deploy everywhere.

• 能够让 Python 编写的图形程序在 iOS, Android, Windows, MacOS, Linux, Web, 和 tvOS 上运行，看起来是很强大的。

• 官网

• toga/examples at main · beeware/toga · GitHub

3. 开发环境搭建注意事项

• 应该使用Python3.8，否则安卓编译工具可能会安装不成功
• 

• 最好可以科学上网，否则安装的速度太慢了
• 项目名称不要使用中文名，否则会报错

4. 安装BeeWare

• pip install briefcase
• 

5. 开发环境搭建

5.1 创建项目

5.1.1 创建一个新项目

• 直接在命令行中输入 briefcase new
• 
• 输入这个命令之后，会让我们继续输入应用的正式名称，应用程序名称、域名、项目名称等等相关信息。根据自己的实际需要进行选择即可，当然了，也可以像我一样图省事儿全部都使用默认值
• 

• 把所有的信息都填完之后，就会开始创建项目了
• 
• 创建完成后会看见自己的当前目录下出现一个对应的项目文件夹
• 

5.2 运行项目

• 之后进入项目根目录，输入 briefcase dev 运行项目
• 
• 

5.3 打包项目

5.3.1 打包为Windows程序

• 我们接下来将briefcase打包为Windows程序

5.3.1.1 首先briefcase create安装应用的脚手架

• 

• 

• 运行命令，将会生成一些与配置的文件，然后下载对应依赖的包

• 完成之后，项目目录下会生成一个Windows目录，如下图所示

• 

5.3.1.2 然后构建应用

• briefcase build
• 
• 

5.3.1.3 接着，运行构建的应用

• briefcase run
• 
• 如果应用可以正常运行的话，那么我们下面就可以对它进行打包了

5.3.1.3 最后，打包应用

• briefcase package
• 
• 
• 打包完成后会在Windows文件夹下生成一个.msi的二进制安装文件
• 

5.3.1.4 安装软件

• 我们双击运行它，会出现常见的Windows程序的安装界面

• 

• 

• 

• 

• 

• 安装完之后，我们甚至可以在Windows的应用列表中看到刚才安装的这个软件

• 

• 点击打开它

• 

5.3.2 打包为安卓APP

• 如果我们想将其打包为安卓APP，那么和打包为Windows程序的过程也是非常类似的

5.3.2.1 首先，创建应用的安卓脚手架

• briefcase create android
• 这个下载的时间可能会久一点
• 中间的所有过程都输入Y
• 
• 

• 之后脚手架就安装成功了
• 

5.3.2.2 接着，构建安卓应用

• briefcase build android
• 

• 
• 
• 这个过程需要下载grade，所以会持续好长一段时间，要有耐心
• 
• 最终，经过24分钟的漫长等待之后，终于下载好了
• 

5.3.2.3 运行构建好的安卓应用

• briefcase run android
• 在这里会让我们选择手机设备，可以选择提供的安卓虚拟机，或者是在电脑上连接自己的手机。
• 使用安卓手机进行运行
• 在这里，我们使用选择使用安卓虚拟机进行运行
• 
• 首先是进行安卓虚拟机的安装，需要说明的是，用自己的手机马上就可以验证向左，而如果用虚拟机的话，依然是需要漫长的下载等待
• 
• 安装完毕
• 
• 启动虚拟机过程中
• 
• 虚拟机运行安卓程序
• 

5.3.2.4 使用自己的手机设备进行运行

• 这个就很简单了，命令行直接通过数据线把对应的APP安装到手机上进行运行，也很方便
• 
• 

5.3.2.5 最后打包安卓应用

• briefcase package android
• 

• 打包完成后，我们可以在.\android\gradle\Hello World\app\build\outputs 下面找到打包好的文件
• 
• BeeWare提供了两种打包好的文件，一种是用于谷歌商店发布的.aab文件
• 
• 另一种是用于调试的.apk文件
• 
• 我们安装的话就用这个APK文件

5.3.2.6 手机端安装APP

• 
• 
• 

• 
• 这样用Python来编译开发android应用的流程就完成了。

6. 报错

编码错误

• 
• 不要使用中文路径
• briefcase build android 时Error while building project.
• 
• 可能之前自己安装过一次，所以这里依然残留有安装报错的文件，将它们删掉之后再安装就好了

就是下面这个文件

• 
• C:\Users\Lenovo\AppData\Local\BeeWare\briefcase\Cache\tools\android_sdk\ndk\21.4.7075529
• 将C:\Users\Lenovo\AppData\Local\BeeWare\briefcase\Cache
• 文件夹的所有文件都删除
• 之后再重新安装，可以发现已经不报错了
• 

Warning: Still waiting for package manifests to be fetched remotely

• 
• 简单来说就是网络不好，多等一会儿，也许就可以进行下一步了
• 
• 

Unable to install dependencies. This may be because one of your dependencies is invalid, or because pip was unable to connect to the PyPI server.

• 简单来说，就是自己的电脑连不上Python的官方服务器

给命令设置一下代理即可

• 

7. 问题

• BeeWare的缓存文件放在哪里
• 

8. 参考教程

• 参考安装教程
• 用 Python 编写安卓 APK ，简单几步搞定 - 知乎
• 官方的示例文档
• toga/examples at main · beeware/toga · GitHub
• BeeWare官方教程中文版_–吉择–的博客-CSDN博客_beeware