Flutter 与开源鸿蒙（OpenHarmony）国际化、无障碍与合规开发实践：打造全球可用的可信应用

# pubspec.yaml
dependencies:
  flutter:
    sdk: flutter
  flutter_localizations:
    sdk: flutter

lib/
└── l10n/
    ├── app_en.arb
    ├── app_zh_Hans.arb
    └── app_ar.arb

{
  "deviceControl": "设备控制",
  "turnOn": "打开",
  "settings": "设置"
}

// EntryAbility.ts
import localeManager from '@ohos.app.ability.localeManager';

localeManager.on('localeChange', (locale) => {
  // 通知 Flutter 切换语言
  flutterEngine.setLocale(locale.language, locale.country);
});

void _onLocaleChanged(String languageTag) {
  final locale = Locale.fromSubtags(languageCode: languageTag.split('-').first);
  context.read<LocaleBloc>().add(LocaleChanged(locale));
}

MaterialApp(
  locale: currentLocale,
  supportedLocales: const [Locale('en'), Locale('zh'), Locale('ar')],
  localizationsDelegates: AppLocalizations.localizationsDelegates,
  builder: (context, child) {
    return Directionality(
      textDirection: TextDirection.rtl, // 自动根据 locale 切换
      child: child!,
    );
  },
)

Semantics(
  label: '客厅主灯',
  hint: '双击以打开或关闭灯光',
  button: true,
  child: Switch(
    value: isOn,
    onChanged: toggleLight,
  ),
)

FocusScope(
  child: Column(
    children: [
      FocusableActionDetector(
        focusable: true,
        child: LightCard(),
      ),
      FocusableActionDetector(
        focusable: true,
        child: ACControl(),
      ),
    ],
  ),
)

flowchart TD
  A[启动 TalkBack] --> B[焦点：'设备控制' 标题]
  B --> C[焦点：'客厅灯 - 开' 开关]
  C --> D[语音指令：“关闭客厅灯”]
  D --> E[执行 toggle 操作]
  E --> F[TalkBack 朗读：“客厅灯已关闭”]

{
  "reqPermissions": [
    {
      "name": "ohos.permission.GET_WIFI_INFO",
      "reason": "用于发现同一网络下的智能设备"
    }
  ]
}

// 使用 OpenHarmony 标准权限说明弹窗
permissionDialog.show({
  permission: 'ohos.permission.GET_WIFI_INFO',
  message: '用于发现同一网络下的智能设备'
});

// 首次启动检查
if (!await PrivacyPolicy.isAccepted()) {
  await showPrivacyPolicyDialog(context); // 调用系统 WebView 加载政策
}