安装¶
小技巧
您可以在Pypi:https://pypi.python.org/pypi/pymunk上找到最新发布的版本
安装Pymunk¶
可以使用pip Install::安装Pymunk
> pip install pymunk
也可以通过Conda Install从Conda-Forge通道安装Pymunk::
> conda install -c conda-forge pymunk
安装Pymunk后,您可以通过运行以下测试来验证安装是否正常工作:
> python -m pymunk.tests -f test
有时,在更多不常见的平台上,您需要安装与GCC兼容的c编译器来安装pymunk,以防没有预置的轮子。
在OSX上,您可以使用::
> xcode-select --install
在Linux上,您可以使用包管理器安装一个包,例如在Ubuntu上使用::
> sudo apt-get install build-essential
示例和文档¶
示例包含在轮子中。请注意,有些代码需要额外的库,如pyGame或pyglet。要列出可用的示例,请运行:
> python -m pymunk.examples -l
然后运行一个示例,例如分组示例运行::
> python -m pymunk.examples.breakout
故障排除¶
检查是否没有名为pymunk.py的文件
检查Conda Install是否能正常工作https://stackoverflow.com/questions/39811929/package-installed-by-conda-python-cannot-find-it
高级-Android安装¶
Pymunk可以在安卓手机/平板电脑/电脑上运行。
Kivy¶
Kivy 是一个开源的Python库,用于快速开发利用创新用户界面的应用程序,例如多点触控应用程序,可以在Android(以及许多其他平台,如Linux、Windows、OS X、iOS和Raspberry PI)上运行。
当与Kivy一起使用时,Pymunk应该开箱即用。但是请注意,用于构建Pymunk的配方指定了可能不是最新版本的特定版本的Pymunk,请参阅此处的配方脚本: https://github.com/kivy/python-for-android/blob/master/pythonforandroid/recipes/pymunk/__init__. Py
Termux¶
Termux 是一款Android终端仿真器和Linux环境应用程序,无需启动或设置即可直接运行。
对于Termux/Android或它的依赖CFFI,没有双轮的pymunk,所以你需要首先安装几个包,然后才能安装pymunk。
安装Python和其他所需的依赖项(在Termux内部运行):
$ pkg install python python-dev clang libffi-dev
使用pip::安装PIP::
$ pip install pymunk
验证它是否正常工作::
$ python -m pymunk.tests test
高级-发展¶
对于开发,一种方便的方法是以可编辑/开发模式安装Pymunk。获取源代码(即从Github签出),然后转到源代码文件夹。然后在pip可编辑模式下安装::
> python -m pip install -e .
请注意,这需要合适的C编译器,例如Windows上的Visual Studio。安装后,您应该能够像导入任何其他已安装的库一样导入Pymunk。如果您想要将其安装在一个包含的环境中,pymunk也应该可以很好地与Virtualenv配合使用。
请记住,如果更新Chipmunk(c代码),则必须重新编译Chipmunk才能使更改生效。看见
编译Chipmunk¶
《Chipmunk》是建立在c库《Chipmunk》之上的。它使用CFFI与Chipmunk库文件进行交互。正因为如此,必须将Chipmunk作为扩展模块与Pymunk一起编译。
如果在您的平台上运行的已编译的Chipmunk二进制库没有包含在发行版中,您将需要自己编译Chipmunk。编译Chipmunk的另一个原因是,如果你想在发布模式下运行它,以消除它生成的调试打印。如果您只使用pip安装,那么只要有可用的编译器,编译就会自动进行。您还可以专门编译Chipmunk,如下所述。
要编译Chipmunk::
> python setup.py build_ext
如果您获得了源代码并且只想直接使用它,那么您可能希望就地编译Chipmunk,这样输出就会直接放到源代码文件夹中的正确位置::
> python setup.py build_ext --inplace
在Windows上,您需要使用与您的Python版本匹配的Visual Studio。
CFFI安装¶
有时需要手动安装CFFI的(非python)依赖项。通常,当pip尝试安装CFFI时,您会注意到这是一个安装失败,因为CFFI是Pymunk的依赖项。这并不是Pymunk的一部分,但为了您的方便,我们提供了简短的描述。
您需要安装两个额外的依赖项才能正确安装CFFI。这可以由包管理器处理。依赖项包括 python-dev 和 libffi-dev 。请注意,根据发行版的不同,它们的名称可能会略有不同,这是针对Debian/Ubuntu的。只需以正常方式安装它们,例如,如果您使用APT,则Pip应该能够正确安装CFFI:
> sudo apt-get install python-dev libffi-dev