如何通过USB将Kivy（Python）应用部署至安卓手机？

步骤1：确认设备连接正常 #

• 用USB数据线把手机连到电脑，手机上会弹出USB调试授权提示，勾选始终允许此计算机并确认。
• 打开VSCode终端，输入 adb devices，如果能看到你的设备序列号，说明连接成功。要是看不到，试试重启adb：先跑 adb kill-server，再跑 adb start-server；或者换一根支持数据传输的USB线。

步骤2：配置Buildozer打包工具 #

• 先在终端用 pip install buildozer 安装Buildozer。
• 到项目根目录，运行 buildozer init，生成 buildozer.spec 配置文件。
• 编辑这个配置文件：
  • 把 title 改成你的应用名，package.name 设成唯一标识（比如 com.yourname.yourapp），package.domain 填你的域名（随便填个比如 org.test 也行）。
  • android.api 设成你手机支持的API级别（手机设置-关于手机里看Android版本，比如Android 13对应API 33）。
  • 按需添加 android.permissions，比如需要网络就加 INTERNET，需要存文件加 WRITE_EXTERNAL_STORAGE。

步骤3：一键部署并运行应用 #

• 在终端输入 buildozer android debug deploy run，这个命令会自动完成：
  1. 编译你的Python代码和Kivy依赖
  2. 生成安卓调试版APK
  3. 把APK安装到连接的手机
  4. 自动启动应用
• 第一次运行会自动下载Android NDK、SDK等依赖，耗时可能较长，别中断进程。

常见问题排查 #

• 提示找不到adb：要么把adb所在路径加到系统环境变量PATH里，要么在 buildozer.spec 里指定 android.adb_path 为adb的绝对路径。
• 安装失败：检查手机是否开启了允许未知来源应用安装（安卓8.0以上需要单独给调试授权的应用开这个权限），或者看终端错误日志找原因。
• 应用闪退：在终端跑 adb logcat | grep python，查看Python相关的错误日志，定位代码里的问题。

内容的提问来源于stack exchange，提问作者confusedchair