摘要： uni-app 应用适配 HarmonyOS NEXT 时，直播推流页为什么不能沿用 Web UI、必须把可见操作层整体迁入原生 ArkUI 子窗口？本文以一次真实跨端适配为线索，复盘 embed 同层渲染六轮证伪实验、子窗口方案的八个运行时坑（反向事件零送达、options 下行协议、ForEach 动画失效、resfile/rawfile 白屏等），并钉死"webview 渲染 → 视频出走近窗口 → z-order 压制 → UI 原生化"的因果链。 阅读全文

摘要： uni-app 鸿蒙离线工程有三种构建形态，能力边界完全不同：CLI 只能出前端资源，出不了原生工程，更出不了 har；完整 ArkTS 工程必须由 IDE 触发；UTS 插件必须单独 assembleHar。搞混这三条线，就会出现"改了源码不生效""同步一次把原生代码覆盖没了"。本文是一套实战打法：build 产物里到底有什么（认清它能消除 90% 焦虑）、同步的三层决策（只同步 www + 原生仓独立 git + harmony-configs 的适用边界）、新增 UTS 插件的五步链与"删 oh_modules/lock"为什么是硬要求、注册绕开 ArkTS 索引签名、出包前入口从调试壳切正式壳、版本四件套配错的 00306004，以及我们把新包 /MIR 倒回旧包的那次事故。附一张"改了 X 走哪条链"的决策树 阅读全文

摘要： 系列第二篇讲设备侧。厂商 SDK 是纯 JS、蓝牙宿主靠参数注入，所以第一篇那个同名垫片可以直接复用，协议代码一行没移植。真正卡住我们的三条都不像蓝牙问题：接入标识不能复用当前 AppID，而错用时 SDK 只回一句「鉴权失败」；鸿蒙的广播数据是整段原始 ADV，不解析 AD 结构就会把 MAC 取错，而 MAC 正是签名的参与项；读数由日期、时间、数值三个包在 SDK 内部合成，适配器实例共享就会串数据。附一次测量的完整包序、各 code 的语义表、9 行「链路是否真通」的验收清单，以及 SDK 会向厂商云上传健康数据的合规提醒。 阅读全文

摘要： uni-app 的蓝牙 API 族在 HarmonyOS Next 上标注为不支持：不报错、不回调，页面卡在初始化，按钮看起来「点了没反应」。 我们的补齐方案是三层：UTS 插件封装 @kit.ConnectivityKit，前端垫片伪装成与 uni 同名同签名的蓝牙 API，再把它作为注入宿主交给纯 JS 的厂商 SDK——协议逻辑一行都没移植。 真正耗时的是三件事：同一段插件逻辑在工程里存在 4 份副本且不同步；原生事件监听注册与解注不成对，导致「连接成功了却弹连接失败」的随机幽灵失败；持久化的 deviceId 是扫描期派生的广播地址，会随设备重启失效。 附 ArkTS 编译错误对照表、跨桥 ArrayBuffer 处理、写队列、hilog 采集与上真机前的 9 项自查清单。 阅读全文

摘要： 关于本文的占位符：文中所有项目标识类信息均已脱敏，落地时请逐项替换为你自己的取值。 <你的鸿蒙 AppId>：鸿蒙原生应用的 DCloud AppId（不带 __UNI__ 前缀，形如 UNIXXXXXX） <你的包名>：鸿蒙 bundleName（形如 com.example.app） <热更新配 阅读全文

摘要： Deploy 步骤刷了好几天下载日志仍未完成的部署，根因竟然和 GitHub 半点关系没有？换 CI 平台、装面板都救不了它。本文记录 Actions + 阿里云 ECS 全链路 CI/CD 的踩坑实录：从镜像拉取地狱（含 registry-mirrors 管不到 ghcr 的机制盲区、南大 ghcr 代理站实操）到 SSH 长连接保活、端口抢占与健康检查 301 死循环，十个坑全部给出"症状→根因→处方"，配置可抄，看完少熬几个夜。 阅读全文

摘要： 做个人项目部署的时候，最烦的不是代码写不出来，而是 CI/CD 跑了一半，卡在拉镜像这一步。 最近我在给「极速PDF转换器」配 GitHub Actions 自动部署流程，后端用 Node，前端用 Vue，数据库是 Postgres，缓存用 Redis，还搭了一个 Umami 做数据统计。整个流程本 阅读全文

摘要： 脱敏说明：文中尖括号/x 占位符均为脱敏项 —— <鸿蒙应用的 DCloud AppId>、<你的腾讯地图 Key>、<原生工程绝对路径>、<HarmonyOS 包名> 等，请替换为你自己的取值。 真实取值与内部落地细节以内部档案 OPENLOCATION_MAP_KEY_HARMONY.md 为准 阅读全文

摘要： 本文记录了 uni-app (Vue3 + nvue) 适配鸿蒙 (APP-HARMONY) 时，视频全屏按钮失效及误触暂停的完整排查过程。核心痛点在于 nvue 在鸿蒙端走 ArkUI 原生渲染，JS 层无 document 对象，导致 DOM 操作失效。最终方案是通过 instance.proxy 获取正确的 createVideoContext 上下文，并配合 pointer-events 修复点击穿透。文章总结了从误判渲染方式到利用 Toast 真机调试的实战经验，为鸿蒙原生媒体组件适配提供避坑指南。 阅读全文

摘要： 场景：一个用纯 Web 技术栈写的 H5 语音助手（按住说话 → 实时语音识别 → 返回文字），被宿主 App 用 <web-view> 内嵌。iOS / 安卓一切正常，唯独鸿蒙（HarmonyOS NEXT）端「按住说话」毫无反应。本文记录从现象到根因的逐层剥茧过程，以及最终落地的最小改动方案。 阅读全文