Installation, Dependencies and Compatibility¶
Dependencies¶
particles support¶
numpy www.numpy.org
audio and video support by pyglet and ffmpeg¶
for Windows and Mac the simplest is ‘python -m pip install pyglet-ffmpeg2’
- for Linux you should use your package manager to get ffmpeg, version 4.x is
the one tested with pyglet.
audio support by SDL¶
in Windows, pygame http://www.pygame.org
in unix-like OSes libraries sdl 1.2 and sdl-mixer 1.2; in debian/ubuntu their packages are libsdl1.2 and libsdl-mixer1.2
in Mac, theres no confirmed info. Should be similar to unix.
What explicit dependencies are declared in the setup.py ? six and pyglet
Compatibility¶
Compatibility notes at the time of writing, January 2020
python : cocos needs python 3.6+ (2.7 should still work but is unsuported)
pyglet : pyglet >= 1.4.10, < 2.0 (prefer 1.4.x, 1.5 is unstable)
Installing¶
Have a modern setuptools or pip installed.
While:
python -m pip install cocos2d
works, you will miss the docs and code samples. Its is therefore recommended to
install six and pyglet, pay attention to the pyglet version, see above
download cocos2d-0.6.8.zip from https://pypi.python.org/pypi/cocos2d/
decompress to a convenient location, the top dir will be cocos2d-0.6.8
the html docs will be in cocos2d-0.6.8/doc/html
useful code samples will be in cocos2d-0.6.8/test, cocos2d-0.6.8/samples, cocos2d-0.6.8/utest
install by:
cd cocos2d-0.6.8 python -m pip install -e .or alternatively by pointing that directory from a .pth or PYTHONPATH
All of cocos should be usable now, with the possible exceptions
cocos particles
SDL audio backend
ffmpeg audio-video backend
If you want to add these, look at the dependencies section.
Using PYTHONPATH or .pth¶
It is safe to point a checkout of cocos from a .pth or PYTHONPATH
The same is valid for pyglet.