《HarmonyOS 7 Flutter 三方插件鸿蒙化开发手记》05:从本地能跑到真正可发布的 OHOS 插件【鸿蒙心迹】

作者:李游Leo日期:2026/9/27

example 能跑,就等于插件可以发布了吗?还差得远。

前四篇我们把插件从无到有搭起来了:

  • 01:插件被 HarmonyOS 识别
  • 02:Dart 和 ArkTS 通信
  • 03:接入系统能力
  • 04:生命周期和权限

现在 example 能跑了。但能不能发布给别人用?

差得远。example 能跑只是第一步,真正发布还要处理版本兼容、错误码、测试、文档这些事。

一、先想清楚:example 能跑和可发布差在哪

先把最基础的问题想明白。

对比example 能跑可发布插件
版本只测当前 SDK要兼容多个 SDK 版本
错误能跑就行错误码要清晰
测试手动点一下单元测试、真机验证
文档没有README、示例

二、版本兼容为什么重要

插件依赖 HarmonyOS SDK 版本。用户用的 SDK 版本可能不一样。

版本问题
插件写死 SDK 版本低版本用户用不了
没有版本检查高版本 API 在低版本崩了
API 行为变化升级后行为变了

HarmonyOS 7 对应 API 26。升级应用的时候,要评估 API 行为变化,在新旧设备上做兼容验证。

这段代码解决什么问题: 版本兼容检查。
文件: ohos/src/main/ets/PluginCompat.ets
用途: 版本兼容
接入位置: 插件初始化

1import { deviceInfo } from '@kit.BasicServicesKit';
2
3class PluginCompat {
4  static checkMinSdk(minApi: number): boolean {
5    let apiVersion = deviceInfo.sdkApiVersion;
6    return apiVersion >= minApi;
7  }
8  
9  static getApiVersion(): number {
10    return deviceInfo.sdkApiVersion;
11  }
12}
13

三、错误码为什么要对用户可读

example 里出错了,打个日志就行。发布给别人用,用户不知道为什么出错。

错误码要统一、要可读。Dart 层用户拿到错误码,知道发生了什么。

错误码说明
canceled用户取消
not_found文件不存在
permission_denied权限拒绝
timeout超时
unknown未知错误

四、发布前要做什么

发布前 Checklist:

  1. 插件目录结构规范;
  2. 错误码统一;
  3. 版本兼容检查;
  4. example 跑通;
  5. 单元测试;
  6. 真机验证;
  7. README 写清楚;
  8. API 26 升级验证。

五、几个容易踩的坑

第一个坑:example 能跑就直接发布。没做版本兼容,没做错误处理。

第二个坑:HarmonyOS SDK 版本写死。低版本用户用不了。

第三个坑:依赖版本无上限。新版本出问题,老用户也受影响。

第四个坑:API 行为变化没有兼容保护。升级后行为变了。

第五个坑:错误码对 Dart 用户不可读。用户不知道为什么出错。

第六个坑:没有测试 Engine 重建和异常生命周期。线上出问题。

第七个坑:README 只写 Android/iOS。HarmonyOS 用户不知道怎么用。

这次做工程收口最大的体会是:能跑的 Demo 和可发布的插件,差了一整个工程化过程。

真正做的时候,最容易忽略的不是怎么写功能,而是怎么管好版本、错误、测试、文档。这些东西 example 里不用管,发布的时候全得补上。


参考文档


《《HarmonyOS 7 Flutter 三方插件鸿蒙化开发手记》05:从本地能跑到真正可发布的 OHOS 插件【鸿蒙心迹】》 是转载文章,点击查看原文。


相关推荐


CentOS 7 虚拟机磁盘 I/O 卡顿排查实录:从 iostat 异常到虚拟盘后端故障的完整定位
lqg_zone2026/9/20

一台运行 MySQL、ClickHouse、MongoDB、MinIO 等多套服务的 CentOS 7 虚拟机出现"磁盘读写缓慢、数据库查询卡顿"。本文完整记录了从建立观测、指标判读、双盘对照、落盘分布定位,到最终用"同文件系统重写"实现零扩容、停机 1 分钟内完成数据迁移的全过程。 关键词:CentOS 7 / VMware PVSCSI / iostat / await / LVM 落盘分布 / XFS / 无损迁移 前言:问题现象 现象描述: 数据库查询与写入明显变慢,体感"响应恢复不


还在手动配 SSL 证书?这个 75K Star 的 Web 服务器让 HTTPS 自动到起飞
Hey_AI_Coder2026/9/12

摘要: 配置 HTTPS 证书有多痛苦?申请、验证、续期、重启,每一步都可能出错。Caddy 直接把这些全自动化了 服务器部署好了,网站能访问了,但浏览器地址栏显示「不安全」。你需要配 HTTPS,于是开始折腾 Let's Encrypt,申请证书、验证域名、配置 Nginx、重启服务。好不容易搞定了,三个月后证书过期,网站又挂了。 更糟的是,你有十几个站点,每个都要配证书,每个都要续期。某天凌晨三点,运维电话打来:「证书过期了,网站打不开」。 HTTPS 是必须的,但配证书的过程太痛苦了。


从 Token 到蒸馏:一步步理解大模型如何工作
杨杨杨大侠2026/9/4

本文面向刚开始了解大模型的读者,以本机运行的 Qwen2.5 0.5B 为例,解释 Token、参数、Transformer、训练、蒸馏和量化之间的关系。 先用一句话概括大模型: 大模型使用训练得到的参数,根据已有 Token,反复预测下一个 Token。 1. 一个模型里有什么 模型不只是一个权重文件。完整运行通常需要三部分: 结构配置:规定模型有多少层、每层多宽。 Tokenizer 和词表:负责文字与 Token ID 之间的转换。 参数:训练得到的大量数字,包括权重矩阵、偏置和归一


【AI大模型接入SDK】Deepseek API + Apifox
艾莉丝努力练剑2026/8/27

🎬 个人主页:艾莉丝努力练剑 ❄专栏传送门:《C语言》《数据结构与算法》《C/C++干货分享&学习过程记录》 《Linux操作系统编程详解》《笔试/面试常见算法:从基础到进阶》《Python干货分享》 ⭐️为天地立心,为生民立命,为往圣继绝学,为万世开太平 🎬 艾莉丝的简介: 文章目录 1 ~> LLM 接入体系总览1.1 两类主流接入方案1.2 工程定位1.3 技术栈映射 2 ~> 云端 API 接入方式(以 DeepSeek 为例)2.1


只面对一张表:KingbaseES 超表如何简化海量时序数据管理
一只牛博2026/8/19

设备数据最麻烦的地方,不是某一天突然写入一批数据,而是每秒都会有新数据进来。温度、压力、振动、电流、流量等指标不断产生,设备数量增加后,数据量几乎只会单向增长。业务页面通常只问两类问题:某台设备最近一小时的曲线,以及一批设备在某个时间段内的统计结果。数据库管理员面对的却是另一组问题:表拆到什么粒度,索引建在哪些表上,旧数据如何清理,新增设备是否需要发布脚本。 传统时序数据库方案经常把这些事情交给应用层。按月份、按设备或按两者组合拆表,确实能把数据分散开,但路由、建表、补索引和归档也随之进入业务代


C++ 模板深度解析:类型模板、非类型模板、特化与分离编译
在路上慢慢走2026/8/6

1. 引言 模板(Template)是 C++ 泛型编程的核心,它允许编写与类型无关的代码,极大地提高了代码的复用性和灵活性。理解模板的完整体系,包括其分类、特化机制以及编译模型,是掌握现代 C++ 高级特性的关键。本文将系统性地介绍模板的两大类别(类型模板与非类型模板)、模板特化(函数模板特化与类模板特化)以及模板分离编译的原理与实践,帮助你构建完整的模板知识框架。 2. 模板的分类 C++ 模板主要分为两大类:类型模板(Type Template)和非类型模板(Non-type Tem


写了三遍 Todo List,我终于搞懂了 React 父子组件到底怎么通信
To_OC2026/7/28

上来就踩了个最经典的坑 我上周写这个 Todo List 的时候,第一版写得特别快,二十分钟就把界面和逻辑堆完了。然后点复选框试了一下 —— 纹丝不动。 控制台没报错,代码看着也没写错,我对着 checked={todo.completed} 这行盯了十分钟,来回改了好几种写法,勾选状态就是不更新。当时我人都懵了,心想难道我学的 React 是假的? 后来随手打印了一下 todo 对象,发现值其实已经变了,但界面就是不刷新。那一刻我突然反应过来:我直接在子组件里改了 props 传过来的对象属性


拼多多笔试真题-多多的审批链(C++/Py/Java /Js/Go)
无限码力2026/7/20

多多的审批链 拼多多技术岗 4月26号笔试 第四题 题目内容 多多的部门中发起审批单有一套审批流程,审批关系可以抽象为一棵以 111 号节点为根的树,共有 nnn 个节点。对于每个 i(2≤i≤n)i(2 \le i \le n)i(2≤i≤n),给定它的直属上级 pip_ipi​,即审批树中存在一条从 pip_ipi​ 到 iii 的边。 对于任意节点 uuu,如果它发起一张审批单,那么审批单只能先提交给它的直属上级,再继续逐级上报到更高层。 现在多多最多可以选择 kkk 个节点作为“关键


图片是 Web 性能监控的重灾区:LCP 和 CLS 到底怎么测、怎么定位到具体那张图
谙忆10242026/7/12

做前端性能这几年,我踩过一个反复出现的坑:本地 Lighthouse 跑出来 95 分,一到线上真实用户那边,投诉页面"卡""跳"的却一堆。后来盯着数据看明白了——问题几乎都出在图片上,而且实验室环境根本复现不出来。 这篇就把"图片相关的 Web 性能怎么测、怎么监控、怎么定位到罪魁祸首那张图"讲清楚。重点是测量和监控这条链路,不是又一篇"图片懒加载十种写法"。 先分清两组概念:实验室数据 vs 真实用户数据 这是很多人一上来就混的地方,先掰开。 实验室数据(Lab):Lighthouse、We


别再只会 if err != nil:Go error 从错误链到工程实战详解
唐青枫2026/7/4

简介 Go 代码里最常见的错误处理大概是这样: result, err := doSomething() if err != nil { return err } 这几行代码不难,真正容易出问题的是后面的选择: 应该新建错误,还是包装原错误? 应该使用 ==,还是 errors.Is? 什么时候需要自定义错误类型? 错误应该在哪一层记录日志? 多个清理操作同时失败,应该返回哪一个错误? 普通错误、panic 和 recover 到底怎么分工? Go 没有把错误处理藏进异常机制,而是把错误当

首页编辑器站点地图

本站内容在 CC BY-SA 4.0 协议下发布

Copyright © 2026 聚合阅读