在 macOS 上安装¶

若要在macOS上使用``pip``安装Kivy，请遵循主要的:ref:安装指南<installation-canonical>。否则，请继续查看:ref:下方的Kivy.app说明<osx-app>。

安装组件¶

以下是主安装指南中部分步骤链接到的、针对macOS的附加信息。

安装Python¶

Homebrew¶

如果你正在使用 Homebrew，你可以通过以下方式安装 Python:

brew install python3

MacPorts¶

如果你正在使用 Macports，你可以通过以下方式安装 Python:

# Install and set e.g. Python 3.8 as the default
port install python38
port select --set python python38

# Install and set pip as the default::
port install py38-pip
port select --set pip py38-pip

框架¶

要在macOS上安装Python框架，请从主要的`Python网站 <https://www.python.org/downloads/macos/>`_下载并按照安装步骤操作。您可以在`Python指南 <https://docs.python.org/3/using/mac.html>`_中了解更多关于安装的信息。

源码安装依赖¶

要从源代码安装Kivy，请遵循安装指南直至到达 Kivy安装步骤，然后在继续之前安装以下附加依赖项。

pkg-config、cmake、meson、ninja 是从源码构建 Kivy 所必需的。如果你使用 brew 作为包管理器，可以通过以下命令安装它们:

brew install pkg-config cmake meson ninja

现在你已经拥有了Kivy的所有依赖项，你需要确保已安装命令行工具:

xcode-select --install

使用Kivy.app¶

备注

Kivy.app 是使用 MACOSX_DEPLOYMENT_TARGET=10.9 构建的。

您可以在`kivy-sdk-packager仓库 <https://github.com/kivy/kivy-sdk-packager/tree/master/osx>`_的README中找到使用Kivy.app构建和打包应用的完整说明。

要安装Kivy虚拟环境，您必须：

前往Kivy的`网站 <https://kivy.org/downloads/>`_或`GitHub <https://github.com/kivy/kivy/releases>`_，找到最新的Kivy版本并下载``Kivy.dmg``。您也可以下载`Kivy.app <https://kivy.org/downloads/ci/osx/app/Kivy.dmg>`_的夜间快照版本。

打开dmg文件。

在GUI中，通过将文件夹图标拖拽到右侧，将Kivy.app复制到/Applications。
可选地，通过运行以下命令创建符号链接：
ln -s /Applications/Kivy.app/Contents/Resources/script /usr/local/bin/kivy
这会创建``kivy``二进制文件，你可以用它代替python来运行脚本。也就是说，与其执行``python my_script.py``或``python -m pip install <module name>``，不如写``kivy my_script.py``或``kivy -m pip install <module name>``，以便使用kivy捆绑的Python解释器及kivy环境来运行它。

与下面激活虚拟环境的方式不同，使用 kivy 运行将使用虚拟环境，同时也会正确配置运行 Kivy 应用所需的脚本环境（例如设置 Kivy 的主路径等）。

使用App虚拟环境¶

底层虚拟环境的路径为 /Applications/Kivy.app/Contents/Resources/venv。要激活它以便像使用任何普通虚拟环境一样使用 python，请执行以下操作:

pushd /Applications/Kivy.app/Contents/Resources/venv/bin
source activate
source kivy_activate
popd

警告

在默认的mac（zsh）shell中，**必须**位于包含``activate``的bin目录内，才能成功``activate``虚拟环境，因此我们临时切换了目录。

kivy_activate 通过设置 Kivy 主目录及其他变量，来配置环境以运行 Kivy。

启动任何 Kivy 应用程序¶

只需将应用程序的主文件拖拽到Kivy.app图标上，即可运行任何Kivy应用程序。

Version

Quick search

目录