Kivy Builder与纯Python代码差异：扫码信息为何无法显示？

当使用Kivy Builder加载KV语言代码时，程序能将扫描到的二维码信息实时显示在应用下半部分的Label中；但将代码替换为纯Python实现的等效逻辑后，Label的内容不再更新，二维码信息停止输出。

使用Builder的代码（正常工作） #

from kivy.app import App
from kivy.uix.boxlayout import BoxLayout
from kivy.uix.label import Label
from kivy.lang import Builder
from kivy_garden.zbarcam import ZBarCam

DEMO_APP_KV_LANG = """

BoxLayout:
    orientation: 'vertical'
    ZBarCam:
        id: zbarcam
    Label:
        text: ', '.join([str(symbol.data) for symbol in zbarcam.symbols])
"""

class DemoApp(App):
    def build(self):
        return Builder.load_string(DEMO_APP_KV_LANG)


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

纯Python代码（无法实时更新） #

from kivy.app import App
from kivy.uix.boxlayout import BoxLayout
from kivy.uix.label import Label
from kivy.lang import Builder
from kivy_garden.zbarcam import ZBarCam


class Demo(BoxLayout):
    def __init__(self, **kwargs):
        super().__init__(**kwargs)
        self.orientation = 'vertical'
        self.zbarcam= ZBarCam()
        self.add_widget(self.zbarcam)
        self.add_widget(Label(text=', '.join([str(symbol.data) for symbol in self.zbarcam.symbols])))



class DemoApp(App):

    def build(self):
        return Demo()


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

问题原因 #

核心差异在于属性绑定机制：

• KV语言中，text: ', '.join([str(symbol.data) for symbol in zbarcam.symbols]) 是动态绑定——当zbarcam.symbols（扫描结果）变化时，Label的文本会自动重新计算并更新。
• 纯Python代码里，Label的文本是在初始化阶段一次性计算的，只会获取当时的symbols值，后续扫描到新二维码时，不会触发文本更新。

修正后的纯Python代码 #

通过手动绑定zbarcam.symbols的变化事件，实现实时更新：

from kivy.app import App
from kivy.uix.boxlayout import BoxLayout
from kivy.uix.label import Label
from kivy_garden.zbarcam import ZBarCam


class Demo(BoxLayout):
    def __init__(self, **kwargs):
        super().__init__(**kwargs)
        self.orientation = 'vertical'
        self.zbarcam = ZBarCam()
        self.add_widget(self.zbarcam)
        
        # 创建Label并添加到布局
        self.result_label = Label()
        self.add_widget(self.result_label)
        
        # 绑定zbarcam的symbols变化事件到更新方法
        self.zbarcam.bind(symbols=self.update_scan_result)

    def update_scan_result(self, instance, symbols):
        # 当扫描结果变化时，更新Label文本
        self.result_label.text = ', '.join([str(symbol.data) for symbol in symbols])


class DemoApp(App):
    def build(self):
        return Demo()


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

也可以用StringProperty实现更贴近KV语言的绑定逻辑：

from kivy.app import App
from kivy.uix.boxlayout import BoxLayout
from kivy.uix.label import Label
from kivy_garden.zbarcam import ZBarCam
from kivy.properties import StringProperty


class Demo(BoxLayout):
    # 定义可观察的字符串属性，用于存储扫描结果
    scan_result = StringProperty("")

    def __init__(self, **kwargs):
        super().__init__(**kwargs)
        self.orientation = 'vertical'
        self.zbarcam = ZBarCam()
        self.zbarcam.bind(symbols=self.update_scan_result)
        self.add_widget(self.zbarcam)
        
        # 将Label的text绑定到scan_result属性
        self.add_widget(Label(text=self.scan_result))

    def update_scan_result(self, instance, symbols):
        self.scan_result = ', '.join([str(symbol.data) for symbol in symbols])


class DemoApp(App):
    def build(self):
        return Demo()


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

以上两种方式都能实现和KV语言一致的实时更新效果，核心是通过bind方法监听扫描结果的变化，在回调中同步更新Label文本。

内容的提问来源于stack exchange，提问作者Sergey Kurchev