Kivy多文件项目中的屏幕管理与OOP实践

my_kivy_app/
├── main.py
├── screen_one.py
└── screen_two.py

from kivy.app import App
from kivy.lang import Builder
from kivy.uix.screenmanager import ScreenManager

# 导入独立的屏幕类。
# 这些导入操作会执行 screen_one.py 和 screen_two.py 中
# Builder.load_string() 语句，从而预加载了每个屏幕的KV规则。
from screen_one import ScreenOne
from screen_two import ScreenTwo

# 定义 ScreenManager 的KV结构，并声明所有屏幕。
# ScreenManager 作为应用的根部件，管理着 ScreenOne 和 ScreenTwo。
kv = """
ScreenManager:  # 这是根部件，负责管理所有屏幕
    ScreenOne:
        name: 'one' # 为 ScreenOne 实例指定唯一的名称
    ScreenTwo:
        name: 'two' # 为 ScreenTwo 实例指定唯一的名称
"""

class MyScreensApp(App):
    def build(self):
        # 加载主 KV 字符串。
        # Kivy 会根据 'ScreenManager:' 下的声明，
        # 自动创建 ScreenOne 和 ScreenTwo 的实例，并将其添加到 ScreenManager 中。
        return Builder.load_string(kv)

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

from kivy.lang import Builder
from kivy.uix.screenmanager import Screen
from kivy.metrics import dp # 用于单位转换，保持UI一致性

# 定义 ScreenOne 的KV布局。
# 注意 <ScreenOne>: 语法，它将这些KV规则与 ScreenOne 类关联起来。
kv = """
<ScreenOne>:
    BoxLayout:
        orientation: 'vertical'
        padding: dp(20)
        spacing: dp(10)
        Label:
            text: '这是屏幕一'
            font_size: dp(24)
            color: 0, 0, 0, 1 # 黑色文本
        Button:
            size_hint_y: None
            height: dp(48)
            text: '切换到屏幕二'
            # 屏幕切换逻辑：
            # root 指向当前的 ScreenOne 实例。
            # root.manager 指向管理 ScreenOne 的 ScreenManager 实例。
            # current 属性设置为目标屏幕的名称 ('two')。
            on_release: root.manager.current = 'two'
            # 可选：设置切换动画方向
            on_release: root.manager.transition.direction = 'left'
"""
# 加载此屏幕的KV字符串。
# 当 screen_one.py 被导入时，此语句会执行，将 <ScreenOne> 的KV规则注册到 Kivy 的 Builder 中。
Builder.load_string(kv)

class ScreenOne(Screen):
    # 屏幕特定的 Python 逻辑可以在这里添加。
    # 例如，处理按钮点击、数据加载等。
    pass

# 可选：为独立测试此屏幕提供一个 App 实例。
# 这允许开发者在不运行整个应用的情况下，单独调试 ScreenOne。
if __name__ == '__main__':
    from kivy.app import App
    from kivy.uix.screenmanager import ScreenManager
    class TestThisScreen(App):
        def build(self):
            sm = ScreenManager()
            sm.add_widget(ScreenOne(name='one'))
            return sm
    TestThisScreen().run()

from kivy.lang import Builder
from kivy.uix.screenmanager import Screen
from kivy.metrics import dp

# 定义 ScreenTwo 的KV布局。
kv = """
<ScreenTwo>:
    BoxLayout:
        orientation: 'vertical'
        padding: dp(20)
        spacing: dp(10)
        canvas: # 为屏幕背景添加颜色
            Color:
                rgb: .5, .7, .5 # 浅绿色
            Rectangle:
                size: self.size
                pos:self.pos
        Label:
            text: '这是屏幕二'
            font_size: dp(24)
            color: 0, 0, 0, 1 # 黑色文本
        Button:
            size_hint_y: None
            height: dp(48)
            text: '返回屏幕一'
            on_release: root.manager.current = 'one'
            on_release: root.manager.transition.direction = 'right'
"""
# 加载此屏幕的KV字符串。
Builder.load_string(kv)

class ScreenTwo(Screen):
    # 屏幕特定的 Python 逻辑可以在这里添加。
    pass