Kivy for iOS 技术文档

1. 安装指南

在开始之前，强烈推荐使用 Python 虚拟环境来安装 Python 包。

python3 -m venv venv
. venv/bin/activate

从 PyPI 安装 Kivy for iOS：

pip3 install kivy-ios

此外，你还需要一些系统依赖和配置。

• 安装 Xcode 13 或更高版本，并安装 iOS SDK 和命令行工具：

xcode-select --install

• 使用 brew 安装以下依赖：

brew install autoconf automake libtool pkg-config
brew link libtool

2. 项目的使用说明

Kivy for iOS 工具链可以编译运行 Kivy 应用程序所需的库，并管理 Xcode 项目的创建。以下是工具链支持的系统：

• iPhone / iOS (arm64)
• iPhone Simulator (x86_64, arm64)

由于 Xcode 仅在 macOS 上运行，因此 Kivy for iOS 只在此平台上有用。

Kivy for iOS 由 Kivy 团队管理，并且可以与 Buildozer 配合使用。

3. 项目API使用文档

以下是可用的命令及其说明：

toolchain <command> [<args>]

可用命令：
    build         编译一个 recipe（为所需的 target 架构编译库）
    clean         清除指定 recipe 的构建
    distclean     清除构建和结果
    recipes       列出所有可用的 recipes
    status        列出所有 recipes 及其构建状态

Xcode:
    create        创建一个新的 xcode 项目
    update        更新现有的 xcode 项目（框架、库等）
    launchimage   为你的 xcode 项目创建启动图像
    icon          为你的 xcode 项目创建图标
    pip           将 pip 依赖项安装到发行版中
    pip3          将 pip 依赖项安装到 python 3 发行版中

4. 项目安装方式

以下是如何安装 Kivy for iOS 的步骤：

1. 克隆仓库：

git clone https://github.com/kivy/kivy-ios.git
cd kivy-ios/

2. 创建 Python 虚拟环境并激活：

python3 -m venv venv
. venv/bin/activate

3. 在虚拟环境中安装 Kivy for iOS：

pip install -e .

4. 使用 toolchain.py 脚本：

python toolchain.py --help

请按照以上步骤进行操作，以便成功安装和使用 Kivy for iOS。如果在安装或使用过程中遇到任何问题，请查阅 Kivy for iOS FAQ 以获取帮助。