mirror of https://github.com/kivy/kivy.git
69 lines
1.7 KiB
ReStructuredText
69 lines
1.7 KiB
ReStructuredText
.. _basic:
|
|
|
|
Basic Kivy
|
|
==========
|
|
|
|
Installation of Kivy environment
|
|
--------------------------------
|
|
|
|
Kivy depends on multiples dependencies, such as pygame, gstreamer, PIL, cairo,
|
|
and more. All of them are not required, but depending the platform you're
|
|
working on, it can be a pain to install them. For Windows and MacOSX, we
|
|
provide a portable package that you can just unzip and use.
|
|
|
|
.. toctree::
|
|
:maxdepth: 1
|
|
|
|
/installation/installation-windows.rst
|
|
/installation/installation-macosx.rst
|
|
/installation/installation-linux.rst
|
|
|
|
If you want to install everything yourself, ensure that you have at least
|
|
`Cython <http://cython.org>`_, `Pygame <http://pygame.org>`. A typical pip
|
|
installation look like::
|
|
|
|
pip install cython
|
|
pip install hg+http://bitbucket.org/pygame/pygame
|
|
pip install kivy
|
|
|
|
The `development version <https://github.com/kivy/kivy>`_ can be installed with
|
|
git::
|
|
|
|
git clone https://github.com/kivy/kivy
|
|
make
|
|
|
|
|
|
Create an application
|
|
---------------------
|
|
|
|
Creating a kivy application is as simple as:
|
|
|
|
- subclassing the `:cls:kivy.app.App` class,
|
|
- implementing its `:meth:kivy.app.App.build` method so it returns a `:cls:kivy.uix.Widget` instance (the root of your widget tree)
|
|
- instanciating this class, and call its `:meth:kiyv.app.App.run` method.
|
|
|
|
here is an example of such a minimum application::
|
|
|
|
from kivy.app import App
|
|
from kivy.uix.label import Label
|
|
|
|
|
|
class MyApp(App):
|
|
def build(self):
|
|
return Label(text='Hello world')
|
|
|
|
|
|
if __name__ == '__main__':
|
|
MyApp().run()
|
|
|
|
|
|
Running the application
|
|
-----------------------
|
|
|
|
Customize the application
|
|
-------------------------
|
|
|
|
Platform specifics
|
|
------------------
|
|
|