『Python Kivy』API说明：kivy.app.App

App类是创建Kivy应用的基础。我们可以将其看成是Kivy运行循环当中的主入口。在绝大多数的例子中，你创建这个类的子类，然后构建你自己的应用。当你已经准备好开始应用的整个生命周期时，你可以实例化你定制的app类，然后调用这个实例的run()方法。

创建一个应用

重载build()方法

为了使用一个widget树初始化你的应用，你需要重载build()方法，并返回你已经构建的widget树。

import kivy
kivy.require('1.8.0')

from kivy.app import App
from kivy.uix.gridlayout import GridLayout

class IndexScreen(GridLayout):
    def __init__(self, **kwargs):
        super(IndexScreen, self).__init__(**kwargs)
        pass

# 这里不能直接使用App作为你自己创建的应用类的类名
class TestApp(App):
    def build(self):
        return IndexScreen()

if __name__ == '__main__':
    TestApp().run()

使用kv文件创建应用

你也可以使用kivy语言创建应用。.kv文件可以同时包含规则以及根widget定义。

#:kivy 1.8.0

Button:
    size: root.size
    text: "Hello ,World"

import kivy
kivy.require('1.8.0')

from kivy.app import App

class MyApp(App):
    pass

if __name__ == '__main__':
    MyApp.run()

应用配置

使用配置文件

Kivy支持为你的应用创建独立的配置文件，如下所示：

class MyApp(App):
    def build_config(self, config):
        config.setdefaults('section1', {
            'key1': 'value1',
            'key2': 'value2'
            })

系统将根据build_config方法中所提供的信息，自动创建名为my.ini的文件，并设置对应的配置信息。

[section1]
key2 = value2
key1 = value1

你也可以不使用build_config方法，而是直接创建my.ini文件，应用在运行的时候会自动加载这一文件。需要注意的是，配置文件的名字需要与你的应用类的前缀相匹配。

示例：应用设置面板

你可以扩展App.build_settings()方法创建你自己的设置面板。你可以参考settings找到具体创建的方法。

class MyApp(App):
    def build_settings(self, settings):
        jsondata = """
            [
                { "type": "title",
                  "title": "Test application" },

                { "type": "options",
                  "title": "My first key",
                  "desc": "Description of my first key",
                  "section": "section1",
                  "key": "key1",
                  "options": ["value1", "value2", "another value"] },

                { "type": "numeric",
                  "title": "My second key",
                  "desc": "Description of my second key",
                  "section": "section1",
                  "key": "key2" }
            ]
        """
        settings.add_json_panel('Test application', self.config, data=jsondata)

当你运行起来后，可以使用F1来启动设置面板。使用JSON的设置选项，将与之前创建的配置文件的内容相关联。你也可以在程序中调用App.open_settings()和App.close_settings()来开启或关闭你的设置面板。你在设置面板中的设置，将会自动保存到你的配置文件中。默认的，kivy的全局设置也会被加载到设置面板中，你可以使用如下声明关闭它：

class MyApp(App):
    use_kivy_settings = False
    # ...

你还可以手动的调整设置面板中的项目，具体参见settings

使用on_start 与 on_stop检测应用性能

参见cProfile

import cProfile

class MyApp(App):
    def on_start(self):
        self.profile = cProfile.Profile()
        self.profile.enable()

    def on_stop(self):
        self.profile.disable()
        self.profile.dump_stats('myapp.profile')

定制设置界面

你可以通过设置App.settings_cls来选择多种不同的设置界面样式，你还可以创建自己的设置界面。具体参考kivy.uix.settings

你可以通过重载App.display_settings()来定制设置面板的显示，这个方法将会在设置面板在屏幕上显示之前被调用。如下所示：

def display_settings(self, settings):
    try:
        p = self.settings_popup
    except AttributeError:
        self.settings_popup = Popup(content=settings,
                                    title='Settings',
                                    size_hint=(0.8, 0.8))
        p = self.settings_popup
    if p.content is not settings:
        p.content = settings
    p.open()

def close_settings(self, *args):
    try:
        p = self.settings_popup
        p.dismiss()
    except AttributeError:
        pass # Settings popup doesn't exist

最后，如果你想要替换目前的设置面板，你使用App.destroy_settings()可以移除到设置面板的内部索引。如果你已经更改App.display_settings()，你应该小心探测设置面板是否已经被替换。

暂停模式

这个模式是尝试性的，被设计用来针对手机与平板。可能会引起你的应用崩溃或者暂停。

在手机或者平板上，用户可能在任意的时候切换到另一个应用当中，这个时候，默认的，kivy会激活App.on_stop()事件。

如果你提供暂停模式，当切换到另一个应用的时候，你的应用将无限等待，直到用户切换回来。在Android上，有一个OpenGL的问题：当你暂停的时候，OpenGL ES Context不能确保被存储。存储OpenGL数据的机制并没有在Kivy中实现。

下面是一个暂停模式的示例：

class TestApp(App):

   def on_pause(self):
      # 你可以在这个存储数据
      return True

   def on_resume(self):
      # 在这里你可以检查是否有需要替换的数据
      pass

参考

• kivy.app