Flutter-OH:平台判断有哪些方式?

0 评论 111 浏览 0 收藏 6 分钟

面对社区版与鸿蒙版 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 协议。

更多精彩内容,请关注人人都是产品经理微信公众号或下载App
评论
评论请登录
  1. 目前还没评论,等你发挥!