mirror of https://github.com/kivy/kivy.git
72 lines
1.7 KiB
ReStructuredText
72 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 :class:`kivy.app.App` class
|
|
- implementing its :meth:`kivy.app.App.build` method so it returns a
|
|
:class:`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
|
|
------------------
|
|
|