Installing Kivy
This recipe will teach you how to install Kivy on a personal computer, which is the first step in starting to develop great software.
Getting ready
We will assume that you already have GNU/Linux (preferably Ubuntu/Debian/Trisquel, we recommend the last one) and Python installed on it. Usually, Python is already installed on the aforementioned GNU/Linux distributions. We will also assume that you are using Python version 2.7 or higher.
How to do it…
- Add one of the Personal Package Archives (PPAs) that you prefer; our recommendation is the following stable one:
stable builds: $ sudo add-apt-repository ppa:kivy- team/kivy nightly builds: $ sudo add-apt-repository ppa:kivy- team/kivy-daily
- Update your package list using your package manager:
$ sudo apt-get update - Install Python-kivy and, optionally, the examples that are found in Python-kivy-examples:
$ sudo apt-get install Python-kivy - Verify the installation. Call Python from the console and execute this command:
import kivy
How it works…
There are many ways to get Kivy installed on your computer. Here we are describing probably the easiest way using your distribution's package manager. In the first step, we are adding a PPA as an APT repository to provide you with two different options: the stable one, for which all the Kivy products have been well tested, and the nightly one, which are packages under active development. Actually, for Ubuntu, you can skip the first step; it was just to get the latest version of Kivy.
In the second step, we update the list of available packages to include the Kivy repository. The third step is where the installation of Kivy really happens by using the distribution's package manager. In the last step, we verify if Kivy is working with the command that imports Kivy. If everything is OK we will see the following:
[INFO ] Kivy v1.9.0
It shows the Kivy version that you installed in your system, which is v1.9.0 in this case. Remember to exit Python, for which we use the command quit().
There's more…
Now we will say something about Mac OS X and Microsoft Windows; for them, Kivy provides what is called portable packages. For an easy way to get Kivy running, just go to http://kivy.org/#download.
Mac OS X
Download the dmg file, double-click to open it, and drag the Kivy.app into your Applications folder. Ready!
You should run the make-symlinks script to make Kivy available in the shell system. Thus, you can run Kivy from the terminal.
Microsoft Windows
Download the .zip file and unzip it. There is a file named kivy.bat that must be copied as a shortcut into your SendTo folder.
See also
Well, if you are using a different operating system, you are always able to go to http://kivy.org/#download and look for the one that you are using. Also, if you want to build Kivy from the source code, refer to Chapter 8, Packaging our Apps for PC the recipe Packing for Linux.
