利用 Python 和 Kivy 开发移动端应用实战指南

安装完成后即可开始开发。这里演示 Hello World 程序。

创建入口文件 main.py

#! -*- coding:utf-8 -*-
from kivy.app import App

class HelloApp(App):
    pass

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

创建界面定义 hello.kv

Label:
    text: 'Hello, World! I am nMask'

说明：

• main.py 是入口函数，定义了继承自 kivy.app.App 的类。
• hello.kv 文件用于定义界面风格，命名规则为类名小写且去除 "App" 后缀。

运行程序

python main.py

运行后将弹出一个包含文本标签的窗口。

安装 Buildozer 工具

为了让程序在安卓或苹果手机上运行，需要将其打包。Buildozer 可以打包 Kivy 程序，支持 Android 和 iOS。

pip install buildozer

使用 Buildozer 将 Kivy 程序打包成 APK

在 Python 项目目录下执行以下步骤：

1. 初始化配置

   buildozer init
   

   这将创建一个配置文件 buildozer.spec，可通过修改该文件更改 App 名称、权限等。

2. 打包命令

   buildozer android debug deploy run
   

   此命令会生成跨平台的安装包。如果是 Android 目标，底层利用 python-for-android 项目。

   注意： 首次运行会自动下载 Android SDK 等必要文件，过程可能需要较长时间及网络环境支持。

3. 获取 APK 成功后会在项目目录下的 bin 文件夹中生成 .apk 文件，传输至安卓手机安装测试即可。

Buildozer 使用说明

Usage:
buildozer [--profile <name>] [--verbose] [target] <command>...
buildozer --version
Available targets:
android        Android target, based on python-for-android project
ios            iOS target, based on kivy-ios project
android_old    Android target, based on python-for-android project (old toolchain)
Global commands (without target):
distclean          Clean the whole Buildozer environment.
help               Show the Buildozer help.
init               Create a initial buildozer.spec in the current directory
serve              Serve the bin directory via SimpleHTTPServer
setdefault         Set the default command to run when no arguments are given
version            Show the Buildozer version
Target commands:
clean      Clean the target environment
update     Update the target dependencies
debug      Build the application in debug mode
release    Build the application in release mode
deploy     Deploy the application on the device
run        Run the application on the device

常见报错与解决方案

1. 缺少 32 位库

报错信息： You might have missed to install 32bits libs 原因： 64 位系统缺少 32 位依赖文件。 解决方案： 在 CentOS 上安装相关库：

yum -y install --skip-broken glibc.i686 arts.i686 audiofile.i686 bzip2-libs.i686 \
cairo.i686 cyrus-sasl-lib.i686 dbus-libs.i686 directfb.i686 esound-libs.i686 \
fltk.i686 freeglut.i686 gtk2.i686 hal-libs.i686 imlib.i686 lcms-libs.i686 \
lesstif.i686 libacl.i686 libao.i686 libattr.i686 libcap.i686 libdrm.i686 \
libexif.i686 libgnomecanvas.i686 libICE.i686 libieee1284.i686 libsigc++20.i686 \
libSM.i686 libtool-ltdl.i686 libusb.i686 libwmf.i686 libwmf-lite.i686 \
libX11.i686 libXau.i686 libXaw.i686 libXcomposite.i686 libXdamage.i686 \
libXdmcp.i686 libXext.i686 libXfixes.i686 libxkbfile.i686 libxml2.i686 \
libXmu.i686 libXp.i686 libXpm.i686 libXScrnSaver.i686 libxslt.i686 \
libXt.i686 libXtst.i686 libXv.i686 libXxf86vm.i686 lzo.i686 mesa-libGL.i686 \
mesa-libGLU.i686 nas-libs.i686 nss_ldap.i686 cdk.i686 openldap.i686 pam.i686 \
popt.i686 pulseaudio-libs.i686 sane-backends-libs-gphoto2.i686 \
sane-backends-libs.i686 SDL.i686 svgalib.i686 unixODBC.i686 zlib.i686 \
compat-expat1.i686 compat-libstdc++-33.i686 openal-soft.i686 alsa-oss-libs.i686 \
redhat-lsb.i686 alsa-plugins-pulseaudio.i686 alsa-plugins-oss.i686 \
alsa-lib.i686 nspluginwrapper.i686 qt.i686 qt-x11.i686 \
pulseaudio-libs-glib2.i686 python-matplotlib.i686

2. Cython 编译错误

报错信息： Error compiling Cython file 原因： Cython 模块未安装或版本不兼容。 解决方案：

pip install cython==0.25

3. IO Error 路径不存在

报错信息： IOError: [Errno 2] No such file or directory... 原因： Buildozer 在打包最后一步复制 APK 到 bin 目录时的 Bug。 解决方案： 修改 /usr/local/lib/python2.7/dist-packages/buildozer/targets/android.py 文件。

1. 在文件开头导入：

   from distutils.version import LooseVersion
   

2. 找到第 786 行左右关于 apk name 的代码，替换为：

   __sdk_dir = self.android_sdk_dir
   build_tools_versions = os.listdir(join(__sdk_dir, 'build-tools'))
   build_tools_versions = sorted(build_tools_versions, key=LooseVersion)
   build_tools_version = build_tools_versions[-1]
   gradle_files = ["build.gradle", "gradle", "gradlew"]
   is_gradle_build = any((exists(join(dist_dir, x)) for x in gradle_files)) and build_tools_version >= '25.0'
   

使用官方虚拟机

如果本地环境依赖问题难以解决，Kivy 官方提供了预装 Buildozer 及依赖的虚拟机镜像。下载地址通常为官方仓库提供的 torrent 或 zip 包。对于无法解决依赖问题的用户，推荐使用此虚拟机进行打包测试，但开发环境仍推荐在自己的本机上进行。

Kivy 进阶：常用控件与布局

为了构建更复杂的 App，了解 Kivy 的核心控件和布局管理器至关重要。

核心控件

• Label: 显示文本。
• Button: 按钮，点击触发事件。
• TextInput: 输入框，用于接收用户文本。
• Image: 显示图片资源。
• BoxLayout: 线性布局，子控件按水平或垂直方向排列。
• GridLayout: 网格布局，子控件按行列排列。

示例：简易计算器界面

from kivy.app import App
from kivy.uix.boxlayout import BoxLayout
from kivy.uix.button import Button
from kivy.uix.label import Label

class CalculatorApp(App):
    def build(self):
        layout = BoxLayout(orientation='vertical')
        display = Label(text='0', font_size=40)
        btn_layout = BoxLayout(orientation='horizontal')
        btn = Button(text='Click Me')
        btn.bind(on_press=self.on_click)
        btn_layout.add_widget(btn)
        layout.add_widget(display)
        layout.add_widget(btn_layout)
        return layout

    def on_click(self, instance):
        print('Button Clicked')

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

总结

利用 Python 结合 Kivy 和 Buildozer，开发者可以快速实现跨平台的移动应用原型。尽管在性能优化和原生体验上与 Java/Kotlin/Swift 仍有差距，但对于快速验证想法、内部工具开发或学习跨平台编程而言，这是一套高效的技术栈。建议在正式商用前充分测试兼容性，并关注社区的最新动态以获取更好的支持。

注：本文内容基于公开技术文档整理，旨在提供技术参考。