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 # 导入 StringProperty

# Kivy语言定义，创建一个包含一个Label和一个Button的BoxLayout
kv = '''
BoxLayout:
    orientation: 'vertical'
    Label:
        id: status_label
        text: app.status_message # 绑定到app实例的status_message属性
        font_size: 25
    Button:
        text: '开始后台任务并更新Label'
        size_hint_y: 0.2
        on_release: app.start_background_task()
'''

class KivyThreadUpdateApp(App):
    # 使用StringProperty来绑定Label的text，便于在Kivy语言中直接引用和自动更新
    status_message = StringProperty('等待开始任务...')

    def build(self):
        return Builder.load_string(kv)

    def start_background_task(self):
        """
        在点击按钮时启动一个后台线程执行耗时操作。
        """
        self.status_message = '后台任务已启动，请稍候...' # 立即更新UI表示任务开始

        # 启动一个守护线程。当主程序退出时，子线程也会随之终止。
        # target 参数指向将在新线程中执行的方法。
        threading.Thread(target=self.long_running_loop, daemon=True).start()

    def long_running_loop(self):
        """
        这是一个在子线程中运行的耗时循环，模拟后台工作。
        """
        for i in range(1, 11): # 模拟10次更新
            # 模拟一些耗时工作，例如数据处理或网络请求
            sleep(1)

            # 子线程不能直接更新UI。
            # 必须使用 Clock.schedule_once 将UI更新任务调度到主线程执行。
            # 这里使用 lambda 表达式是为了将循环变量 i 作为参数传递给 update_ui_label。
            Clock.schedule_once(lambda dt, current_count=i: self.update_ui_label(current_count), 0)

        # 任务完成后，再次调度一个更新到主线程
        Clock.schedule_once(lambda dt: self.update_ui_label("任务完成！"), 0)

    def update_ui_label(self, message, _dt=None):
        """
        这个函数在主线程中执行，用于更新Label的文本。
        _dt 参数是 Clock.schedule_once 自动传入的，表示调度发生的时间差。
        如果不需要此参数，可以将其设置为默认值 None 或在函数签名中忽略。
        """
        # 通过绑定到app实例的StringProperty更新Label。
        # 当 StringProperty 的值改变时，绑定的 Label 会自动刷新显示。
        if isinstance(message, int):
            self.status_message = f'处理中... 进度: {message}/10'
        else:
            self.status_message = message
        print(f"主线程更新: {self.status_message}")

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

import threading
from time import sleep

from kivy.app import App
from kivy.lang import Builder
from kivy.properties import StringProperty
from kivy.clock import mainthread # 导入 mainthread 装饰器

kv = '''
BoxLayout:
    orientation: 'vertical'
    Label:
        id: status_label
        text: app.status_message
        font_size: 25
    Button:
        text: '开始后台任务并更新Label (@mainthread)'
        size_hint_y: 0.2
        on_release: app.start_background_task()
'''

class KivyThreadUpdateApp(App):
    status_message = StringProperty('等待开始任务