### 编程向导4.1 Kivy基础
#### 一、安装Kivy的运行环境
Kivy依赖许多Python库，例如pygame，gstreamer，PIL，Cario等等，它们并不总是必须的。根据你所运行的系统平台，环境的安装可能是一个痛苦。对于Windows和MacOS X平台，我们提供了一个便捷的安装包，你仅仅需要解压就可使用:
* [在Windows上安装](https://kivy.org/docs/installation/installation-windows.html#installation-windows)
* [在OS X上安装](https://kivy.org/docs/installation/installation-osx.html#installation-osx)
* [在Linux上安装](https://kivy.org/docs/installation/installation-linux.html#installation-linux)
如果每一个包库你都想自己安装，确保你有最新的Cython和Pygame。一个典型的Pip安装如下:
pip install cython
pip install hg+http://bitbucket.org/pygame/pygame
pip install kivy
开发版可以使用git安装：
git clone https://github.com/kivy/kivy
make
#### 二、创建一个应用程序
创建一个kivy应用程序步骤：
* 继承App类
* 实现它的build()方法，它能返回一个部件的实例（你的部件树的根部件）
* 实例化该类，同时调用它的run()方法
下面是一个最小化应用程序的例子：
```Python
import kivy
kivy.require('1.0.6') # 用你当前的kivy版本替换
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()
```
你可以保存上面的代码到一个诸如main.py的text文件中，并尝试运行它。
#### 三、Kivy APP的生命周期
首先，让我们熟悉一下Kivy应用程序的应用周期：
正如你上面看到的，对于所有的应用程序，我们的入口就是run()方法，在我们的例子中就是MyApp().run()。我们会面会重新回顾这里。下面我们首先看第一行代码：
from kivy.app import App
你的应用程序的基类需要继承APP类，它在kivy_installation_dir/kivy/app.py中。
>提示：如果你想进一步的研究APP类，你可以打开该文件进行深入的探讨。我们鼓励你重读它的代码。Kivy是基于Python实现的并且其文档都在实际的文件里。
第二行：
from kivy.uix.label import Label
请注意，包的路径被展示了。uix模块包含着例如布局、部件等用户接口元素。
再看第五行：
class MyApp(App):
这里定义了我们的应用程序的基类。你仅仅需要改变一下你的应用程序MyApp的名字。
第七行：
def build(self):
正如在生命周期图片显示的那样，这是你初始化并返回你的根部件的地方。我们的例子在第八行：
return Label(text='Hello Kivy')
这里我们初始化了一个标签，标签文本是：Hello Kivy，并返回了它的实例。这个标签将作为我们应用程序的根部件。
现在我们将在11行和12行运行我们的应用程序：
if __name__ == '__main__':
MyApp().run()
这里，MyAPP类被实例化并运行了它的run()方法。这样就初始化并启动了Kivy应用程序。
#### 四、运行应用程序
为了运行应用程序，根据你的操作系统，按照下面的说明：
* Linux:
```
$ python main.py
```
* Windows:
```
$python main.py
或者
c:/appdir>kivy.bat main.py
```
* Mac Os X:
```
$ kivy main.py
```
* Android:
你的应用程序需要一些补充的文件以便在安卓上运行。请参阅[为安卓程序打包](https://kivy.org/docs/guide/packaging-android.html)
运行程序后，一个诸如下面的窗口将被呈现：
#### 五、定制应用程序
下面让我们扩展一下，做一个简单的用户名/密码的输入页面。
```python
from kivy.app import App
from kivy.uix.gridlayout import GridLayout
from kivy.uix.label import Label
from kivy.uix.textinput import TextInput
class LoginScreen(GridLayout):
def __init__(self, **kwargs):
super(LoginScreen, self).__init__(**kwargs)
self.cols = 2
self.add_widget(Label(text='User Name'))
self.username = TextInput(multiline=False)
self.add_widget(self.username)
self.add_widget(Label(text='password'))
self.password = TextInput(password=True, multiline=False)
self.add_widget(self.password)
class MyApp(App):
def build(self):
return LoginScreen()
if __name__ == '__main__':
MyApp().run()
```
在第二行，我们导入了网格布局：
from kivy.uix.gridlayout import GridLayout
在第九行，这个类被用作我们根部件的作为一个基本布局：
class LoginScreen(GridLayout):
在第12行，我们重载了方法__init__()以便于我们添加部件和行为：
def __init__(self, **kwargs):
super(LoginScreen, self).__init__(**kwargs)
我们不能忘记调用父类的super方法，以实现基类的基本功能；同时也要注意在调用super时不要忽略**kwargs参数，因为它们有时在内部使用。
第15行：
self.cols = 2
self.add_widget(Label(text='User Name'))
self.username = TextInput(multiline=False)
self.add_widget(self.username)
self.add_widget(Label(text='password'))
self.password = TextInput(password=True, multiline=False)
self.add_widget(self.password)
我们使用网格布局以两列来管理它的孩子们，并且每行添加了一个标签和一个文本输入框。
运行程序如图：
试着重新改变窗口大小，你会发现部件会自动调整尺寸。
上面的代码没有处理用户的输入，没有使用各种数据验证，包括部件的尺寸、位置等等。我们将会继续深入的研究他们。
#### 六、平台细节
打开一个终端应用程序，并且设置Kivy的环境变量
* 在Windows平台上，仅仅需要双击kivy.bat，一个终端窗口会自动打开，并设置各种变量
* 在nix* 系统下，如果kivy没有全局安装，打开终端输入：
export python=$PYTHONPATH:/path/to/kivy_installation
### 下节预告 编程向导4.2 控制环境
