四、编程向导(4.1 Kivy基础)

编程向导4.1 Kivy基础

一、安装Kivy的运行环境

Kivy依赖许多Python库,例如pygame,gstreamer,PIL,Cario等等,它们并不总是必须的。根据你所运行的系统平台,环境的安装可能是一个痛苦。对于Windows和MacOS X平台,我们提供了一个便捷的安装包,你仅仅需要解压就可使用:

如果每一个包库你都想自己安装,确保你有最新的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()方法

下面是一个最小化应用程序的例子:

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:

    你的应用程序需要一些补充的文件以便在安卓上运行。请参阅为安卓程序打包

运行程序后,一个诸如下面的窗口将被呈现:

五、定制应用程序

下面让我们扩展一下,做一个简单的用户名/密码的输入页面。

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 控制环境

推荐阅读更多精彩内容

  • Spring Cloud为开发人员提供了快速构建分布式系统中一些常见模式的工具(例如配置管理,服务发现,断路器,智...
    卡卡罗2017阅读 74,786评论 12 116
  • 编程向导4.4架构预览 我们将要花费一些时间以软件管理的角度来解释如何设计Kivy。这将是理解每一部分如何一起工作...
    gthank阅读 297评论 0 0
  • Android 自定义View的各种姿势1 Activity的显示之ViewRootImpl详解 Activity...
    passiontim阅读 127,694评论 18 546
  • 编程向导:4.9KV语言 一、语言背后的思想 当你的应用程序变得更复杂时,构建部件树和明确的声明绑定将变得冗长和难...
    gthank阅读 1,561评论 0 8
  • 目录页:【连载】《诺言深许》目录页 上篇:诺言深许(38) 第39章:冲动的惩罚 许诺与苏畅并肩看着苏展一点点远去...
    叶初夏阅读 140评论 11 10