Flutter-OH:平台判断有哪些方式?
面对社区版与鸿蒙版 Flutter SDK 的差异,开发者常困惑于该选用 Platform.isOhos、defaultTargetPlatform 还是字符串判断?本文汇总了五种主流判断写法,深度解析其适用场景、兼容性及潜在风险,并针对“纯鸿蒙逻辑”与“安卓鸿蒙共用逻辑”提供最佳实践代码示例,助你在多平台混合开发中避开编译陷阱,实现稳健的平台分支控制。

在 Flutter 鸿蒙适配中,经常需要根据当前运行平台(Android / iOS / OHOS)走不同逻辑,例如加载不同平台的原生 so、使用不同的 API 或 UI。
本文汇总 判断是否为 OHOS 的常见写法,并说明适用场景与注意点。
一、判断方式汇总
1. defaultTargetPlatform == TargetPlatform.ohos(推荐)
使用 Flutter 的 foundation 层枚举,与编译目标一致,推荐优先使用,可避免在非鸿蒙 Flutter 环境下因缺少 Platform.isOhos 等导致的编译/运行问题。
import ‘package:flutter/foundation.dart’;
if (defaultTargetPlatform == TargetPlatform.ohos) {
// 仅 OHOS 平台
}
适用:纯 Dart 层、UI 或业务分支;需兼容「未适配鸿蒙的 Flutter SDK」时也可用(非 OH 的 Flutter 可能没有 TargetPlatform.ohos,需做兼容判断或条件编译)。
2. Platform.operatingSystem == ‘ohos’
通过 dart:io 的 Platform.operatingSystem 字符串判断,与 Android / iOS 的 android、ios 并列。
import ‘dart:io’;
if (Platform.operatingSystem == ‘ohos’) {
// 仅 OHOS 平台
}
适用:需要与 Platform.isAndroid、Platform.operatingSystem 等已有写法统一时;部分 FFI、原生通道相关代码在鸿蒙版 Flutter 中常用。
3. Platform.isOhos
鸿蒙版 Flutter SDK 在 dart:io 的 Platform 上扩展了 isOhos 布尔 getter,与 Platform.isAndroid、Platform.isIOS 用法一致。
import ‘dart:io’;
if (Platform.isOhos) {
// 仅 OHOS 平台
}
注意:仅在已适配鸿蒙的 Flutter SDK 中存在;若在未适配鸿蒙的 Flutter 工程中直接使用,可能导致编译或 flutter run / flutter build 失败。若工程需在「社区版 Flutter + 鸿蒙版 Flutter」间切换,更建议用 方式 1 或 方式 2。
4. Android 与鸿蒙共用逻辑
当 Android 与鸿蒙 使用同一套实现(如 so 加载、同一套原生 API)时,可写在一起:
import ‘dart:io’;
// 写法 A:使用 Platform(鸿蒙版 Flutter 下可用)
if (Platform.isAndroid || Platform.isOhos) {
return ExternalLibrary.open(‘lib$stem.so’);
}
若希望在不带 Platform.isOhos 的 Flutter 环境下也能编译,可改用 defaultTargetPlatform:
import ‘dart:io’;
import ‘package:flutter/foundation.dart’;
// 写法 B:Android + OHOS,兼容性更好
if (Platform.isAndroid || defaultTargetPlatform == TargetPlatform.ohos) {
return ExternalLibrary.open(‘lib$stem.so’);
}
5. 使用三方库(如 flutter_platform_utils)
通过封装好的工具包统一判断,避免直接依赖各 Flutter 版本的 Platform 差异。
import ‘package:flutter_platform_utils/flutter_platform_utils.dart’;
if (PlatformUtils.isOhos) {
// 仅 OHOS 平台
}
适用:多平台项目、希望接口统一且减少对 dart:io / Flutter 版本差异敏感时;需在 pubspec.yaml 中增加对应依赖。
二、对比小结

三、典型用法示例:按平台加载 so
仅鸿蒙加载 so:
if (Platform.operatingSystem == ‘ohos’) {
return ExternalLibrary.open(‘lib$stem.so’);
}
Android 与鸿蒙共用 so:
if (Platform.isAndroid || Platform.isOhos) {
return ExternalLibrary.open(‘lib$stem.so’);
}
本文由人人都是产品经理作者【null】,微信公众号:【nutpi】,原创/授权 发布于人人都是产品经理,未经许可,禁止转载。
题图来自Unsplash,基于 CC0 协议。
- 目前还没评论,等你发挥!

起点课堂会员权益



