适配仓库https://atomgit.com/oh-flutter/timezone_provider适配分支feat/ohos_timezone_provider_1.1.0一、最终效果与适配目标日历提醒、跨国会议和服务端时间换算需要的是Asia/Shanghai、Asia/Tokyo这样的 IANA 时区标识不只是当前的UTC8。两个地区今天偏移相同不代表历史规则或夏令时策略永远相同。timezone_provider 1.1.0的 Dart API 正好返回 IANA ID但原版本在 OHOS 上没有平台实现。我的目标很窄保留TimezoneProvider().getTimezone()每次调用都读取当前系统值不缓存、不改系统设置也不把本地化时区名称或缩写混进返回值。图 1真机宿主读取当前 IANA 时区的页面。验证点实测结果证据初始读取返回Asia/Shanghai图 1、图 6切换系统时区大阪设置下返回Asia/Tokyo图 6恢复系统设置返回Asia/Shanghai自动时区已恢复图 6自动化与构建7 项 Dart/Widget 测试、静态分析和 HAP 构建通过图 4、图 5能力边界按请求读取不主动监听变化也不修改系统时区源码与真机流程成果速览项目内容上游基线TAGv1.1.0提交ad53d1cea2a327b72ea8d3a0ec9477027f372e5fBSD-3-Clause适配分支feat/ohos_timezone_provider_1.1.0适配 TAG尚未发布真机受测提交9c7a14425b5814c820a12cdfa0999c6fabf7fa69当前分支 HEAD8b6690a1821ad5adb9b84c4fe4c300d81e658040后续仅更新验证文档新增 OHOS 能力读取系统 IANA 时区标识真机结论Asia/Shanghai - Asia/Tokyo - Asia/Shanghai通过二、本次环境项目实测版本Flutter OH3.41.10-ohos-1.0.1Dart3.11.5DevEco Studio26.0.0 ReleaseHarmonyOS SDKAPI 26示例兼容 API 18真机CHZ-AL00HarmonyOS7.0.0.105目标库timezone_provider 1.1.0工具链准备沿用 Flutter OH 环境搭建指南。截至 2026 年 9 月 12 日版本号最大的标签是预览版3.44.9ohos-0.0.1-canary1最新正式稳定标签仍是本文实测的3.41.10-ohos-1.0.1。三、同步仓库与建立分支上游标签v1.1.0对应提交ad53d1cea2a327b72ea8d3a0ec9477027f372e5f许可证为 BSD-3-Clause。适配前检查了本地清单与当日组织仓库未发现同包名 OHOS 交付。同步到 AtomGit 后保留原有历史并在基线提交上创建统一分支。gitclone https://atomgit.com/oh-flutter/timezone_provider.gitcdtimezone_providergitswitch feat/ohos_timezone_provider_1.1.0gitremote-v复现分支和平台骨架gitswitch-cfeat/ohos_timezone_provider_1.1.0 ad53d1cea2a327b72ea8d3a0ec9477027f372e5f flutter create--templateplugin--platformsohos --no-pub.模板生成后仍需改为原通道与原插件类。图 2 汇总了实际 AtomGit origin、适配分支和 HEAD可核对仓库来源与当前分支状态。图 2AtomGit origin、适配分支和当前 HEAD。四、原有 Dart 层保持不变这个库采用常见的 platform interface 结构。业务调用公共类默认实现再通过MethodChannel(timezone_provider)请求getTimezonefinaltimezoneawaitTimezoneProvider().getTimezone();// 例如 Asia/Shanghai返回类型是非空String。因此原生端如果得到空字符串不能把它当成成功返回否则业务拿到一个形式正确、语义无效的值很难定位问题。五、OHOS 侧读取系统时区pubspec.yaml新增TimezoneProviderPlugin注册后ArkTS 使用kit.LocalizationKitif(call.method!getTimezone){result.notImplemented();return;}consttimezonei18n.getTimeZone().getID();if(timezone.length0){result.error(TIMEZONE_UNAVAILABLE,The system returned an empty timezone identifier.,null,);return;}result.success(timezone);这里每次都重新调用系统 API所以用户更改时区后下一次刷新会拿到新值。插件不监听变化监听需求由另一个flutter_timezone_observer库负责。两个职责拆开后读取库保持简单业务也能按需选择。读取不需要新增权限。未知方法必须notImplemented系统异常统一返回TIMEZONE_UNAVAILABLE不能回退到硬编码UTC或设备语言因为那会制造看起来合理的错误数据。另外IANA ID 应原样交给时区数据库处理。展示层可以把它翻译成“上海”或“大阪”但不应把本地化文案重新写回业务模型名称会随语言变化Asia/Shanghai这样的标识才适合持久化和传给服务端。图 3MethodChannel 请求经 i18n.getTimeZone().getID() 返回 IANA 标识。六、交付内容本次保留原 Dart、Android、iOS、Web 代码补充pubspec.yaml的 OHOS 平台声明、HAR 入口、example/ohos/、双语 OpenHarmony 文档、Dart 通道测试、widget 测试和设备测试入口。BSD-3-Clause 许可证及上游历史未改。示例提供刷新按钮和错误重试。因为本库不订阅事件所以系统时区切换后要主动刷新这也是文章必须向读者说明的行为。七、自动化和构建flutter pub get flutter analyze fluttertestcdexample fluttertestflutter build hap--debug--no-codesign实际通过 5 项插件测试和 2 项示例 widget 测试共 7 项静态分析无问题未签名 HAP 构建成功。测试覆盖通道名、方法参数、重复读取、系统错误、界面刷新与失败重试。隔离宿主通过 AtomGit 引入代码提交9c7a14425b5814c820a12cdfa0999c6fabf7fa69并完成签名构建、安装与真机运行。远端后续 HEAD8b6690a仅更新验证文档不应说成重新受测代码。图 4Flutter 复跑与 7 项 Dart/Widget 用例统计。图 5HAP 构建产物和真机宿主锁定的 AtomGit SHA。八、真实切换时区验证Demo 依赖写法如下dependencies:timezone_provider:git:url:https://atomgit.com/oh-flutter/timezone_provider.gitref:9c7a14425b5814c820a12cdfa0999c6fabf7fa69执行flutter pub get后应在pubspec.lock中核对resolved-ref。当前没有适配 TAG所以业务示例固定到这次真正安装到设备的 commit。真机初始为Asia/Shanghai。经过用户明确授权我在系统设置中关闭自动时区并选择大阪重启增强宿主后读取到Asia/Tokyo选择大连后恢复为Asia/Shanghai。测试还与flutter_timezone_observer的当前值和真实变化事件交叉核对三处结果一致。最后恢复原时区和自动设置并保存恢复布局。选择城市只是系统设置界面的交互入口插件拿到的仍是规范 IANA ID。验收不比较界面上的中文城市名避免把本地化展示差异误判成插件错误。这里使用的是系统设置 UI不是伪造广播也没有直接写系统参数。仓库内 integration 和 Hypium 测试本轮未执行真实结果来自远程 Git 依赖的隔离宿主。图 6上海、东京与恢复上海的真机读取记录。九、提交远端gitstatus--shortgitaddpubspec.yaml ohos exampletestREADME.OpenHarmony.md README.OpenHarmony_CN.mdgitcommit-mfeat: add OHOS support for timezone_providergitpush-uorigin feat/ohos_timezone_provider_1.1.0截至 2026 年 9 月 12 日仓库公开且默认分支为适配分支匿名读取的 HEAD 是8b6690a1821ad5adb9b84c4fe4c300d81e658040。十、FAQQ1返回的是 UTC8 而不是 Asia/Shanghai 吗现象业务希望获得可用于时区数据库的标识。原因UTC 偏移量不足以表示完整时区规则。解决方法直接返回getID()的 IANA 标识不做缩写转换。验证结果真机分别读到Asia/Shanghai和Asia/Tokyo。Q2修改系统时区后页面没有自动更新现象设置页切换后原页面仍显示旧值。原因timezone_provider是按请求读取不提供事件流。解决方法回到页面后重新调用getTimezone()或接入时区观察库。验证结果主动刷新和增强宿主重启后均获得当前系统值。Q3系统调用失败时为什么不返回 UTC现象调用抛出PlatformException。原因硬编码 UTC 会把“读取失败”伪装成真实配置。解决方法捕获TIMEZONE_UNAVAILABLE并提示重试业务自行决定降级。验证结果Dart 测试已覆盖错误透传。十一、总结timezone_provider的 OHOS 适配只做一件事把当前系统 IANA 时区准确送回原 Dart API。7 项自动化、HAP 构建和真实Asia/Shanghai - Asia/Tokyo - Asia/Shanghai切换完成了从代码到设备的验证。它不会修改设置也不会主动推送变化清楚地保留这两个边界比多加几个看似方便的默认值更可靠。十二、参考链接适配仓库与分支Flutter OH 版本标签Flutter OH 环境搭建指南欢迎加入CPF-Flutter 鸿蒙社区https://atomgit.com/CPF-Flutter
