【第5章 移动端特性开发】5.4 多语言国际化（含中文拼音输入法支持）

以下是为统信UOS设计的Kivy多语言国际化完整解决方案，包含中文拼音输入法支持的具体实现方法：

统信UOS Kivy多语言国际化指南

一、基础国际化配置

1. 项目结构准备

myapp/
├── main.py
├── locales/
│   ├── zh_CN/  # 简体中文
│   │   ├── LC_MESSAGES/
│   │   │   ├── base.po
│   │   │   └── base.mo
│   ├── en_US/  # 英文
│   │   └── ... 
└── assets/
    └── fonts/
        ├── NotoSansSC-Regular.ttf  # 思源黑体
        └── DroidSansFallback.ttf   # 备用中文字体

2. 使用gettext实现翻译

main.py

import gettext
import os
from kivy.app import App
from kivy.uix.label import Label
from kivy.utils import platform

class I18NApp(App):
    def __init__(self, **kwargs):
        super().__init__(**kwargs)
        self.setup_locale()
    
    def setup_locale(self):
        # 统信UOS系统语言检测
        lang = os.getenv('LANG', 'en_US').split('.')[0]
        
        locale_dir = os.path.join(os.path.dirname(__file__), 'locales')
        self.translator = gettext.translation(
            'base', 
            locale_dir, 
            languages=[lang],
            fallback=True
        )
        self._ = self.translator.gettext

    def build(self):
        return Label(text=self._("Hello World"))  # 需要翻译的字符串

locales/zh_CN/LC_MESSAGES/base.po

msgid "Hello World"
msgstr "你好，世界"

编译PO文件：

msgfmt base.po -o base.mo

二、KV文件中的多语言支持

1. 动态文本绑定

ui.kv

<MyLabel@Label>:
    font_name: 'assets/fonts/NotoSansSC-Regular.ttf'
    text: app._('Welcome')  # 使用app的翻译方法

<MainUI>:
    Button:
        text: app._('Click Me')
        on_press: root.show_message(app._('Button clicked'))

2. 语言切换功能

main.py

from kivy.properties import StringProperty

class I18NApp(App):
    current_lang = StringProperty('en_US')
    
    def switch_language(self, lang):
        self.current_lang = lang
        self.setup_locale()
        self.rebuild()  # 需要实现界面重建逻辑

三、中文拼音输入法集成

1. 统信UOS输入法配置检测

def check_input_method():
    """检测系统输入法服务"""
    try:
        import dbus
        bus = dbus.SessionBus()
        obj = bus.get_object('com.iflytek.inputmethod', '/com/iflytek/inputmethod')
        iface = dbus.Interface(obj, 'com.iflytek.inputmethod.interface')
        return iface.GetCurrentIM() == 'pinyin'
    except:
        return False

2. Kivy文本输入组件优化

custom_textinput.py

from kivy.uix.textinput import TextInput
from kivy.core.window import Window

class PinyinTextInput(TextInput):
    def __init__(self, **kwargs):
        super().__init__(**kwargs)
        self._ensure_pinyin_support()
    
    def _ensure_pinyin_support(self):
        # 统信UOS环境下启用输入法支持
        if platform == 'linux' and 'UOS' in Window._get_gl_extensions():
            from fcitx import ime  # 需要安装fcitx-python绑定
            self._ime = ime.IMContext()
            self._ime.set_client_window(self.get_window_handle())
            
    def get_window_handle(self):
        # 获取底层窗口句柄（统信UOS专用）
        if hasattr(Window, 'x11'):
            return Window.x11.get_xwindow()
        return 0

3. 输入法状态同步

class PinyinTextInput(TextInput):
    def on_focus(self, instance, value):
        if hasattr(self, '_ime'):
            if value:
                self._ime.focus_in()
            else:
                self._ime.focus_out()

四、字体与排版处理

1. 中文字体配置

统信UOS字体优先级设置

<BaseLabel@Label>:
    font_name: [
        'Noto Sans CJK SC',  # 统信默认中文字体
        'Source Han Sans SC', 
        'WenQuanYi Micro Hei',
        'assets/fonts/NotoSansSC-Regular.ttf',  # 应用内置字体
        'DroidSansFallback.ttf'
    ]
    font_size: '14sp'

2. 中文排版优化

from kivy.core.text import LabelBase

# 注册中文字体（统信UOS环境下）
LabelBase.register(
    name='NotoSansSC',
    fn_regular='/usr/share/fonts/opentype/noto/NotoSansCJK-Regular.ttc',
    fn_bold='/usr/share/fonts/opentype/noto/NotoSansCJK-Bold.ttc'
)

五、完整示例：多语言登录界面

main.py

from kivy.app import App
from kivy.uix.boxlayout import BoxLayout
from kivy.properties import ObjectProperty, StringProperty

class LoginForm(BoxLayout):
    username = ObjectProperty(None)
    password = ObjectProperty(None)
    
    def do_login(self):
        print(f"Login attempted: {self.username.text}")

class I18NApp(App):
    current_lang = StringProperty('zh_CN')
    
    def build(self):
        return LoginForm()
    
    def switch_language(self, lang):
        self.current_lang = lang
        # 这里需要重新加载界面

login.kv

<LoginForm>:
    orientation: 'vertical'
    padding: [50, 20]
    spacing: 15
    
    Label:
        text: app._('User Login')
        font_size: '24sp'
        font_name: 'NotoSansSC'
    
    PinyinTextInput:
        id: username
        hint_text: app._('Username')
        size_hint_y: None
        height: '48sp'
    
    TextInput:
        id: password
        hint_text: app._('Password')
        password: True
        size_hint_y: None
        height: '48sp'
    
    BoxLayout:
        size_hint_y: None
        height: '40sp'
        spacing: '10sp'
        
        Button:
            text: app._('Login')
            on_press: root.do_login()
        
        Button:
            text: 'EN' if app.current_lang == 'zh_CN' else '中文'
            size_hint_x: None
            width: '80sp'
            on_press: 
                app.switch_language('en_US' if app.current_lang == 'zh_CN' else 'zh_CN')

六、统信UOS特定优化

1. 系统级集成

def register_dbus_service():
    """注册为统信UOS的输入法客户端"""
    try:
        import dbus.service
        from dbus.mainloop.glib import DBusGMainLoop
        
        DBusGMainLoop(set_as_default=True)
        
        class InputMethodClient(dbus.service.Object):
            def __init__(self):
                bus_name = dbus.service.BusName('com.yourcompany.inputmethod', bus=dbus.SessionBus())
                dbus.service.Object.__init__(self, bus_name, '/Client')
                
            @dbus.service.method('com.iflytek.inputmethod.client')
            def CommitString(self, text: str):
                Window.system_insert(text)
                
        return InputMethodClient()
    except Exception as e:
        print(f"D-Bus注册失败: {e}")

2. 输入法状态栏集成

class StatusBarIntegrator:
    """与统信UOS状态栏集成"""
    def set_ime_indicator(self, ime_name):
        try:
            import udisk
            status = udisk.StatusManager()
            status.set_property('InputMethod', ime_name)
        except:
            pass

七、测试与调试

1. 语言切换测试脚本

def test_language_switch():
    app = I18NApp()
    
    # 测试英文
    app.switch_language('en_US')
    assert app._("Login") == "Login"
    
    # 测试中文
    app.switch_language('zh_CN')
    assert app._("Login") == "登录"

2. 输入法调试工具

# 查看当前输入法状态
fcitx-remote

# 监控输入法事件
dbus-monitor --session "interface='com.iflytek.inputmethod.interface'"

关键问题解决方案

1. 中文显示为方框：

   • 确保使用统信UOS预装字体或打包中文字体
   • 在App初始化时注册字体：

     LabelBase.register('NotoSansSC', 'NotoSansCJK-Regular.ttc')
     

2. 输入法不弹出：

   • 检查~/.config/fcitx/config配置
   • 确保应用窗口获得焦点时触发focus_in事件

3. 翻译不生效：

   • 检查.mo文件是否生成在正确位置
   • 确认系统语言环境设置：

     echo $LANG
     locale -a
     

4. 统信UOS特定问题：

   • 需要申请com.uniontech.ime接口权限
   • 深度环境可能需要使用dde-dock的DBus接口

通过以上实现，您的Kivy应用将能在统信UOS上完美支持多语言切换和中文拼音输入，达到原生应用的体验水平。