【Kivy App】统信UOS开发者模式开启与依赖配置

在 统信UOS（Deepin/UOS） 上开发 Kivy 移动应用（如 Android/iOS）时，需要确保系统处于开发者模式，并正确配置依赖环境（尤其是 Android 打包工具链）。以下是详细步骤：

---

1. 开启统信UOS开发者模式

统信UOS默认限制部分系统权限，需开启开发者模式以允许安装开发工具和调试：

1. 打开“控制中心”
   • 点击桌面左下角“启动器” → 搜索“控制中心” → 进入。
2. 进入“开发者模式”选项
   • 在控制中心找到 “系统信息” → “开发者模式”。
3. 申请并激活开发者权限
   • 点击“立即启用” → 根据提示输入 UOS 账号密码（需联网验证）。
   • 若需企业授权，联系管理员获取激活码。
4. 重启系统生效
   • 重启后，终端可执行 sudo 命令安装开发依赖。

注意：开发者模式会降低部分安全限制，建议仅在开发环境启用。

---

2. 安装 Kivy 基础环境

2.1 安装 Python 和 pip

统信UOS默认预装 Python 3，但需确保 pip 可用：

sudo apt update
sudo apt install python3-pip  # 安装 pip
pip3 install --upgrade pip    # 升级 pip

2.2 安装 Kivy

pip3 install kivy[base]  # 基础版本（含核心模块）
# 或安装完整版（推荐）
pip3 install kivy[full]  # 包含音频、视频等额外依赖

验证安装：

python3 -m kivy

若看到 Kivy 版本信息和 OpenGL 支持，则安装成功。

---

3. 配置 Android 打包环境（Buildozer）

Kivy 官方推荐使用 Buildozer 打包 Android APK，需在统信UOS中配置以下依赖：

3.1 安装 Buildozer 和 Cython

pip3 install buildozer cython

3.2 安装 Android 工具链依赖

Buildozer 需要 JDK、Android SDK/NDK 等工具，统信UOS需手动安装：

sudo apt install -y \
    zip unzip git curl \
    openjdk-11-jdk \      # Java 环境
    autoconf libtool \    # 编译工具
    libffi-dev \         # Python CFFI 依赖
    python3-dev          # Python 开发头文件

3.3 初始化 Buildozer 项目

mkdir myapp && cd myapp    # 创建项目目录
buildozer init             # 生成 buildozer.spec 文件

编辑 buildozer.spec，关键配置：

[app]
title = MyApp
package.name = myapp
package.domain = org.test
source.dir = .
requirements = python3,kivy  # 添加项目依赖
android.permissions = INTERNET  # 按需添加权限

3.4 编译 Android APK

buildozer -v android debug  # 首次编译会自动下载 SDK/NDK（耗时较长）

• 输出文件：bin/myapp-0.1-debug.apk
• 常见问题：
  • 若下载 SDK/NDK 失败，需手动配置代理或替换国内镜像。
  • 统信UOS需确保 /usr/bin/python 链接到 Python 3（可通过 sudo ln -sf /usr/bin/python3 /usr/bin/python 修复）。

---

4. 其他移动端配置

iOS 打包（需 macOS 环境）

统信UOS无法直接编译 iOS 应用，需通过以下方式：

1. 在统信UOS开发代码，通过 Git 同步到 macOS。
2. 在 macOS 上安装 kivy-ios 工具链：

   pip3 install kivy-ios
   toolchain build python3 kivy  # 编译依赖
   

3. 使用 Xcode 导出 IPA 文件。

跨平台调试

• 桌面端测试：直接运行 Kivy 应用（python3 main.py）。
• Android 真机调试：

  adb devices                  # 查看连接的设备
  adb install bin/myapp.apk    # 安装 APK
  adb logcat | grep python     # 查看日志
  

---

5. 统信UOS专属问题解决

问题1：GLib/GObject 缺失

若运行 Kivy 时报错 GLib 相关错误，安装：

sudo apt install libglib2.0-dev gir1.2-glib-2.0

问题2：Wayland 显示兼容性

统信UOS默认使用 Wayland，可能导致 Kivy 窗口异常，切换为 X11：

1. 注销用户 → 登录界面点击齿轮图标 → 选择“X11 会话”。
2. 或在终端强制指定：

   export GDK_BACKEND=x11
   python3 main.py
   

---

总结

在统信UOS上开发 Kivy 移动应用的流程：

1. 开启开发者模式 → 解除权限限制。
2. 安装 Kivy 和 Buildozer → 配置 Python 环境。
3. 配置 Android 工具链 → 解决依赖问题。
4. 打包测试 → 优先桌面调试，再部署到真机。

如需进一步优化，可：

• 使用 国内镜像源 加速 SDK/NDK 下载。
• 通过 Docker 容器 隔离开发环境（避免污染主机）。