Kivy多线程UI更新指南：解决Label不刷新问题

import threading
from time import sleep

from kivy.app import App
from kivy.clock import Clock
from kivy.lang import Builder
from kivy.properties import StringProperty
from kivy.uix.screenmanager import Screen, ScreenManager

# Kivy语言构建界面
kv = '''
<MenuScreen>:
    BoxLayout:
        orientation: 'vertical'
        Label:
            id: status_label
            text: root.status_text
            font_size: '30sp'
        Button:
            text: '开始后台任务'
            on_release: root.start_background_task()
        Button:
            text: '返回主菜单 (示例)'
            on_release: app.root.current = 'menu' # 假设有其他屏幕
'''

class MenuScreen(Screen):
    # 使用Kivy属性来绑定Label的text，便于更新
    status_text = StringProperty('等待任务开始...')

    def __init__(self, **kwargs):
        super().__init__(**kwargs)
        # 初始化状态文本
        self.status_text = '等待任务开始...'

    def start_background_task(self):
        """
        在主线程中启动一个后台线程来执行耗时操作。
        """
        self.status_text = '后台任务启动中...'
        # target指向在后台线程中执行的方法
        # daemon=True 确保当主程序退出时，后台线程也会自动终止
        threading.Thread(target=self.long_running_loop, daemon=True).start()

    def long_running_loop(self):
        """
        这是一个在后台线程中执行的耗时循环。
        它会模拟一些计算，并定期更新UI。
        """
        print("后台线程：任务开始...")
        for i in range(1, 11):
            # 模拟耗时操作
            sleep(1)
            current_value = i * 10
            print(f"后台线程：计算值 {current_value}")

            # 从后台线程调度UI更新到主线程
            # 使用 lambda 表达式传递参数
            Clock.schedule_once(lambda dt, val=current_value: self.update_label_on_main_thread(val), 0)

        # 任务完成后，更新最终状态
        Clock.schedule_once(lambda dt: self.update_label_on_main_thread("任务完成！"), 0)
        print("后台线程：任务结束。")

    def update_label_on_main_thread(self, value):
        """
        这个方法在主线程中执行，负责更新Label的文本。
        """
        print(f"主线程：更新Label为 {value}")
        self.status_text = f'当前进度: {value}'
        # 如果Label是通过id直接访问，也可以这样更新：
        # self.ids.status_label.text = f'当前进度: {value}'


class TestApp(App):
    def build(self):
        # 加载KV字符串并创建屏幕管理器
        Builder.load_string(kv)
        sm = ScreenManager()
        sm.add_widget(MenuScreen(name='menu'))
        return sm

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

import threading
from time import sleep

from kivy.app import App
from kivy.clock import mainthread # 导入 mainthread 装饰器
from kivy.lang import Builder
from kivy.properties import StringProperty
from kivy.uix.screenmanager import Screen, ScreenManager

# Kivy语言构建界面
kv = '''
<MenuScreen>:
    BoxLayout:
        orientation: 'vertical'
        Label:
            id: status_label
            text: root.status_text
            font_size: '30sp'
        Button:
            text: '开始后台任务 (使用 @mainthread)'
            on_release: root.start_background_task()
        Button:
            text: '返回主菜单 (示例)'
            on_release: app.root.current = 'menu'
'''

class MenuScreen(Screen):
    status_text = StringProperty('等待任务开始...')

    def __init__(self, **kwargs):
        super().__init__(**kwargs)
        self.status_text = '等待任务开始...'

    def start_background_task(self):
        self.status_text = '后台任务启动中...'
        threading.Thread(target=self.long_running_loop, daemon=True).start()

    def long_running_loop(self):
        """
        这是一个在后台线程中执行的耗时循环。
        """
        print("后台线程：任务开始...")
        for i in range(1, 11):
            sleep(1)
            current_value = i * 10
            print(f"后台线程：计算值 {current_value}")
            # 直接调用被 @mainthread 装饰的方法
            self.update_label_on_main_thread(current_value)

        self.update_label_on_main_thread("任务完成！")
        print("后台线程：任务结束。")

    @mainthread # 装饰器确保此方法总在主线程执行
    def update_label_on_main_thread(self, value):
        """
        这个方法被 @mainthread 装饰，因此无论从哪个线程调用，
        它都将在主线程中执行。
        """
        print(f"主线程：更新Label为 {value}")
        self.status_text = f'当前进度: {value}'


class TestApp(App):
    def build(self):
        Builder.load_string(kv)
        sm = ScreenManager()
        sm.add_widget(MenuScreen(name='menu'))
        return sm

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