React Native 接入鸿蒙推送:冷启动工单路由与令牌排查

项目源码 · README

开源鸿蒙跨平台开发者社区 · 鸿蒙 React Native

前言

先把工单应用彻底停掉,再发带 WO-1042 的调试 Want。第一张出现的工单就是「展厅灯箱报修」,页面标着「冷启动」。换到 Push Kit 探针,真机却回了 1000900010。这个现场很适合把问题拆开:原生入口能把参数交给 React Native,服务侧的身份校验仍要单独排查。

这篇示例的工单都是虚构记录。WO-1042 是展厅灯箱报修,WO-1043 是后门门禁复检。前者从进程退出后的路由入口打开,后者在应用已经运行时打开。最后把第二条入口重复送一次,记录本进程接收计数是否还会增加。实测把系统推送取令牌和页面路由列成两项,排障时可以知道故障发生在服务配置还是应用内部。

两条入口记录

> 先发 WO-1042,页面显示冷启动、计数 1。再发 WO-1043,详情换成门禁复检、计数 2。原样再发一次,计数仍停在 2。

条件操作真机结果
应用进程已停止调试入口发出 WO-1042详情为展厅灯箱报修,显示冷启动,计数 1
同一进程存活调试入口发出 WO-1043详情刷新为后门门禁复检,计数 2
相邻两次输入相同再发一次 WO-1043保持后门门禁复检,计数仍为 2

MatePad Edge 全屏:调试入口冷启动后打开 WO-1042

MatePad Edge 全屏:调试入口冷启动后打开 WO-1042 · 查看原件

MatePad Edge 全屏:进程在运行时切换至 WO-1043

MatePad Edge 全屏:进程在运行时切换至 WO-1043 · 查看原件

MatePad Edge 全屏:使用调试入口打开两条工单

MatePad Edge 全屏:使用调试入口打开两条工单 · 查看原件

真机调试演示:冷启动接收工单参数

MatePad Edge 真机调试演示 · 查看原件

MatePad Edge 真机调试演示

环境版本用途
MatePad Edge(QXS-W00)HarmonyOS 7.0.0.111 (SP16C00E111R6P5),API 26已安装、路由和令牌探针
DevEco Emulator 26.0.0.402,MatePad Pro 13 镜像(PADEMU-FD00)HarmonyOS 7.0.0.107 (SP8DEVC00E16R1P1),API 26页面可用,令牌探针同样返回 1000900010
构建工具和 SDKDevEco Studio 6.1.1.300,API 26 SDK 26.0.0.105HAP 构建与本地签名
框架React Native 0.84.1,RNOH 0.84.4两种 ABI 编译与 React Native 页面

API 26 模拟器全屏:页面及令牌探针

API 26 模拟器全屏:页面及令牌探针 · 查看原件

MatePad Edge 关于本机

MatePad Edge 关于本机 · 查看原件

API 26 模拟器关于本机

API 26 模拟器关于本机 · 查看原件

DevEco Studio 关于

DevEco Studio 关于 · 查看原件

调试入口通过 hdc 发原生 Want,已经覆盖应用读取入参的那一段。通知展示、后台送达、进程唤起和真实通知点击还需要在开通 Push Kit 后做实投。这里没有把手动发送的 Want 称为一条成功送达的推送。

第一轮的真机录屏来自独立调试身份。改用源码包名 com.aasd23.workorderpush 重新签名后,在 MatePad Edge 上用调试入口依次打开 WO-1042、WO-1043,再重复打开 WO-1043。第一条标为冷启动,第二条标为进程已启动,计数依次为 1、2、2。随后在真机和 API 26 平板模拟器调用 getToken(),均返回 1000900010。通知送达与点击要等核对 AppGallery Connect 权益、更新调试 Profile 并取得令牌后再验证。开通推送服务

冷启动先存工单号

VS Code 工程:校验路由参数并过滤相邻的重复工单

VS Code 工程:校验路由参数并过滤相邻的重复工单 · 查看原件

UIAbility 创建时,原生侧先把工单号留下。React Native 页面还要完成 JS Bundle 加载,此时如果直接发事件,订阅者可能还没注册。这个验证工程把一条最新的待路由记录存在原生侧,JS 就绪后尽快取出,存活期内用定时轮询接收后续消息。点第二次入口时,onNewWant 走同一个解析函数。两条入口各自带上来源,画面能给出冷启动与进程已运行两种观测。

import { hilog } from '@kit.PerformanceAnalysisKit';

interface WorkOrderRoute {
  id: string;
  source: string;
}

export class RouteInbox {
  private static pending?: WorkOrderRoute;
  private static lastId: string = '';

  static receive(uri: string, source: string): void {
    const value = /^workorder-demo:\/\/detail\/(WO-(1042|1043))$/.exec(uri);
    if (!value || value[1] === RouteInbox.lastId || value[1] === RouteInbox.pending?.id) return;
    RouteInbox.pending = { id: value[1], source: source };
    hilog.info(0, 'WorkOrderRoute', 'accepted source=%{public}s', source);
  }

  static take(): string {
    const route = RouteInbox.pending;
    if (!route) return '';
    RouteInbox.pending = undefined;
    RouteInbox.lastId = route.id;
    return JSON.stringify(route);
  }
}

单槽在示例里很容易观察,语义也明确。它保留应用当前应该打开的最新详情。两条不同通知在页面第一次提取前一起到达时,中间那条可能被覆盖。如果产品需要逐条处理工单、写已读状态或记录通知审计,应该使用带消息标识的持久队列,并定义何时确认消费。进程内的相邻去重也无法跨进程记忆历史记录,不能把计数当作服务端投递次数。

码值探针经过单独入口。它会先查 SystemCapability,再调用 getToken,只显示成功与否或者错误码。令牌不能作为普通状态文本输出,也不应该被写到调试日志。正式服务端应把令牌和当前应用上线配置管理在一起,服务端完成发消息操作。客户端拿到令牌只说明注册路径返回,下一步仍需发送两条不同测试工单,分别检查通知点击进入的工单号。

MatePad Edge 全屏:Push Kit 探针返回应用身份校验失败

MatePad Edge 全屏:Push Kit 探针返回应用身份校验失败 · 查看原件

一条命令发一个 Want

构建后把 RNOH HAP 安装到真机。开发用包名应取当前构建配置,下面保留了示例默认包名。在模拟服务侧配置前,可执行这组三条指令核对 UIAbility 和页面之间的链路。

hdc shell aa force-stop com.aasd23.workorderpush
hdc shell aa start -a EntryAbility -b com.aasd23.workorderpush -A ohos.want.action.viewData -U workorder-demo://detail/WO-1042
hdc shell aa start -a EntryAbility -b com.aasd23.workorderpush -A ohos.want.action.viewData -U workorder-demo://detail/WO-1043
hdc shell aa start -a EntryAbility -b com.aasd23.workorderpush -A ohos.want.action.viewData -U workorder-demo://detail/WO-1043

FAQ

出现 1000900010 时先看哪里? 华为把该码定义为应用身份校验失败。先在 AppGallery Connect 核对应用类型、包名与开放能力,再确认安装包已使用开通服务后重新申请的 Profile。完成身份核对后重新测取令牌,再做通知实投。Push Kit 错误码

为什么页面进了详情,仍要测通知点击? 调试 Want 只提供已知路由参数。真实通知的点击动作、参数层级和应用标识由推送服务和应用配置共同决定。实投时从通知栏打开,核对系统实际交付的数据再检查详情。

应用已经显示 WO-1043,重复点同一个地址为什么不增加计数? 本例把相邻同一工单视作一次导航。业务需要区分新通知和旧通知时,用服务端生成的消息 ID 区分,不用工单号代替消息 ID。

总结

冷启动先接住目标,等页面就绪后消费;运行中新的 Want 沿用相同的解析入口。两条工单和一次重复输入的对照已在 MatePad Edge 上验证。服务端实投应在 Push Kit 配置完成后用同一组工单复测,并补上通知栏与实际点击链路的证据。

工程代码

冷启动与运行中的应用入口

harmony/entry/src/main/ets/entryability/EntryAbility.ets

/**
 * Copyright (c) 2025 Huawei Technologies Co., Ltd.
 *
 * This source code is licensed under the MIT license found in the
 * LICENSE file in the root directory of this source tree.
 */

import { AbilityConstant, Want } from '@kit.AbilityKit';
import { RouteInbox } from '../RouteInbox';
import {RNAbility} from '@rnoh/react-native-openharmony';

export default class EntryAbility extends RNAbility {
  onCreate(want: Want, launchParam: AbilityConstant.LaunchParam): void {
    super.onCreate(want, launchParam);
    RouteInbox.receive(want.uri ?? '', 'cold');
  }

  onNewWant(want: Want, launchParam: AbilityConstant.LaunchParam): void {
    super.onNewWant(want, launchParam);
    RouteInbox.receive(want.uri ?? '', 'running');
  }

  override getPagePath() {
    return 'pages/Index';
  }

  override getRNOHWorkerScriptUrl() {
    return "entry/ets/workers/RNOHWorker.ets"
  }
}

Push Kit 探针与页面桥接

harmony/entry/src/main/ets/WorkOrderPackage.ets

import { BusinessError } from '@kit.BasicServicesKit';
import { pushService } from '@kit.PushKit';
import { RNPackageContext, RNOHPackage, UITurboModule, UITurboModuleContext } from '@rnoh/react-native-openharmony';
import { RouteInbox } from './RouteInbox';

class WorkOrderModule extends UITurboModule {
  async take(): Promise<string> { return RouteInbox.take(); }

  async checkPush(): Promise<string> {
    try {
      if (!canIUse('SystemCapability.Push.PushService')) return '设备未提供 Push Kit';
      const token = await pushService.getToken();
      return token ? '已取得应用令牌' : '推送服务没有返回令牌';
    } catch (error) {
      // 只显示错误码,避免把令牌写进界面或日志。
      return '取令牌失败 · ' + String((error as BusinessError).code);
    }
  }
}

export class WorkOrderPackage extends RNOHPackage {
  constructor(ctx: RNPackageContext) { super(ctx); }
  getUITurboModuleFactoryByNameMap(): Map<string, (ctx: UITurboModuleContext) => UITurboModule | null> {
    return new Map<string, (ctx: UITurboModuleContext) => UITurboModule | null>([
      ['WorkOrderRoute', (ctx: UITurboModuleContext) => new WorkOrderModule(ctx)]
    ]);
  }
}

工单页面

App.tsx

import React, {useEffect,useState} from 'react';
import {Pressable,ScrollView,StyleSheet,Text,TurboModuleRegistry,View} from 'react-native';

type Route = {id:'WO-1042'|'WO-1043';source:'cold'|'running'};
type Bridge = {take():Promise<string>;checkPush():Promise<string>};
const orders = {'WO-1042':{title:'展厅灯箱报修',description:'复查灯箱接线与亮度。',stage:'待处理'},'WO-1043':{title:'后门门禁复检',description:'记录门禁开关状态。',stage:'待复核'}};
export default function App(){
 const [route,setRoute]=useState<Route>();
 const [received,setReceived]=useState(0);
 const [check,setCheck]=useState('尚未检查推送服务');
 const module=()=>TurboModuleRegistry.getEnforcing<any>('WorkOrderRoute') as Bridge;
 useEffect(()=>{
  let active=true; let inFlight=false;
  const receive=async()=>{if(inFlight)return;inFlight=true;try{
   const value=await module().take();
   if(active&&value){const next=JSON.parse(value) as Route;if(orders[next.id]){setRoute(next);setReceived(value=>value+1);}}
  }catch{}finally{inFlight=false;}};
  receive();const timer=setInterval(receive,350);return()=>{active=false;clearInterval(timer);};
 },[]);
 const order=route?orders[route.id]:undefined;
 return <ScrollView style={s.screen} contentContainerStyle={s.body}><View style={s.bar}><Text style={s.brand}>工单收件箱</Text><Text style={s.muted}>仅测试工单</Text></View><View style={s.card}><Text style={s.muted}>{route?.id??'工单详情'}</Text><Text style={s.title}>{order?.title??'等待打开工单'}</Text><Text style={s.desc}>{order?.description??'打开工单链接后,在这里核对加载的记录。'}</Text>{order&&<Text style={s.state}>{order.stage}</Text>}</View><View style={s.info}><Text style={s.muted}>本次进程接收 {received} 次</Text><Text style={s.muted}>{route?.source==='cold'?'冷启动':route?.source==='running'?'进程已启动':'等待启动参数'}</Text></View><Pressable style={s.action} accessibilityRole="button" onPress={async()=>{setCheck('正在检查…');try{setCheck(await module().checkPush());}catch{setCheck('原生推送模块不可用');}}}><Text style={s.button}>检查 Push Kit</Text></Pressable><Text style={s.status}>{check}</Text></ScrollView>;
}
const s=StyleSheet.create({screen:{flex:1,backgroundColor:'#171c2c'},body:{maxWidth:1040,width:'100%',alignSelf:'center',paddingHorizontal:26,paddingTop:56,paddingBottom:38},bar:{flexDirection:'row',justifyContent:'space-between',alignItems:'center',paddingBottom:16,borderBottomWidth:1,borderColor:'#3b465b'},brand:{fontSize:24,fontWeight:'800',color:'#eef2ff'},muted:{fontSize:14,color:'#bbc6e1'},card:{marginTop:24,padding:24,backgroundColor:'#242d43',borderRadius:10,borderWidth:1,borderColor:'#495672'},title:{fontSize:38,fontWeight:'800',color:'#f3f6ff',marginVertical:10},desc:{fontSize:16,color:'#cbd6f1'},state:{fontSize:15,color:'#9ff0e1',marginTop:18},info:{flexDirection:'row',gap:16,marginVertical:20},action:{alignSelf:'flex-start',backgroundColor:'#a2eddb',padding:12,borderRadius:7},button:{color:'#142e35',fontWeight:'800'},status:{marginTop:12,color:'#cad7ef'}});

相关推荐

React Native 鸿蒙长列表优化实战:用静态审计加运行时探针守住 FlatList 的四条底线

本文提出并实现了一套针对 React Native 长列表的“双层守卫”机制:静态审计(7 条反模式规则,可集成 CI)与运行时渲染探针(renderItem 采样 + rAF 帧间隔归因)。通过在 OpenHarmony 模拟器上对 400 行数据的实测对比,验证了 ScrollView+map 方案在首帧、内存、滚动上的显著劣势,而优化后的 FlatList 虚拟化方案有效降低视图常驻与维护成本。工具链已开源,支持快速定位问题、自动化拦截劣质代码,提升长列表性能与可维护性。

白天写代码,晚上追AI大模型,偶尔搞点八卦 开源动态|技术干货|实习机会|生态活动 我负责分享,你负责变强 27

Cordova 鸿蒙空间音频实战:让网页里的声音“绕着头转“

本文通过一个零原生代码的纯JS Cordova插件,实证解答了WebView中“真”空间音频的可行性:基于ArkWeb(Chromium内核)的Web Audio API,HRTF卷积空间化可原生支持,采样率48kHz,延迟仅108ms。插件以一行ArkTS未写的方式,实现跨平台空间音频合成,通过探测机制动态降级,并解决纯JS插件注入hcordova宿主的兼容难题。效果验证显示方位角拖动与理论值高度一致,揭示了前后镜像等物理边界。

白天写代码,晚上追AI大模型,偶尔搞点八卦 开源动态|技术干货|实习机会|生态活动 我负责分享,你负责变强 34

ReactNative鸿蒙实况窗实战:让订单状态“跟着JS走“

本文以 React Native 0.84 + RNOH 0.84 为基底,详解实况窗发布链路的六跳桥接机制:从 JS 侧纯 TS 构造 payload(①),经 JSON 序列化(②),通过手写 JSI 胶水(③)跨至 ArkTS,由 TurboModule 解析并注入 wantAgent(④),最终调用 liveViewManager 发布。全程依赖 hilog 逐跳验证,确保字段、序列号、耗时精准对齐。

白天写代码,晚上追AI大模型,偶尔搞点八卦 开源动态|技术干货|实习机会|生态活动 我负责分享,你负责变强 35

Cordova鸿蒙实况窗实战:让实况窗卡片“长在网页里“

在鸿蒙Cordova环境下,通过纯JS实现“零原生”实况窗预览:将payload构造层与预览器完全剥离原生依赖,利用DOM渲染实现胶囊与卡片的0.5ms级高效更新。依托esbuild打包与UMD注入,三端同构状态机精准映射HMS kits字段,probe()明确标识沙箱不支持HMS kits的边界。实测显示,外卖、打车、比分场景的动态切换与左滑分享交互均可在页面内完整模拟,验证了纯前端方案在能力边界内的可行性与高性能表现。

白天写代码,晚上追AI大模型,偶尔搞点八卦 开源动态|技术干货|实习机会|生态活动 我负责分享,你负责变强 32

Cordova 鸿蒙渲染耗时实战:给 ArkWeb 容器装上 FCP、长任务和构建期审计的三只眼

本文针对Cordova应用在OpenHarmony上的渲染性能问题,提出“三层探针”方案:通过javaScriptOnDocumentStart注入PerformanceObserver采集页面指标(FCP、LCP、longtask),ArkTS插件记录容器加载耗时(onPageStart→End),构建期审计器扫描www/识别布局抖动、同步读写几何等反模式。

白天写代码,晚上追AI大模型,偶尔搞点八卦 开源动态|技术干货|实习机会|生态活动 我负责分享,你负责变强 43

Qt 鸿蒙电脑多屏适配:拔掉外接屏,窗口怎么回到主屏?

本文介绍基于Qt的鸿蒙跨平台窗口恢复方案,针对外接屏拔插导致窗口坐标异常问题,提出“屏幕接力”机制。通过判断屏幕是否存在、计算窗口在目标屏的可见区域,实现窗口自动回主屏。核心逻辑包括:动态检测屏幕变化,优先使用同名屏或主屏作为目标,结合qBound确保窗口尺寸与位置在可用区内,并通过延迟回调避免状态冲突。实测验证了单屏环境下窗口恢复的正确性,强调需双屏环境进一步验证热拔插与重启场景下的兼容性。

白天写代码,晚上追AI大模型,偶尔搞点八卦 开源动态|技术干货|实习机会|生态活动 我负责分享,你负责变强 59

Ionic 接入鸿蒙应用 Skill:两件耗材同名时,先确认库位再查询

本项目基于鸿蒙跨平台框架,实现Ionic应用与ArkTS查询逻辑的统一,验证“问得少、答得准”策略:同名物料先返回候选库位,用户确认后才显示数量;唯一命中则直接返回结果。通过真实设备与模拟器测试,确保状态管理正确,取消后可重查,提升交互效率。代码复用性强,适用于多端一致的库存查询场景。

白天写代码,晚上追AI大模型,偶尔搞点八卦 开源动态|技术干货|实习机会|生态活动 我负责分享,你负责变强 38

Cordova 电量插件重订阅:为什么第二轮收不到当前电量?

本文分析了OpenHarmony跨平台Cordova电量插件在MatePad Edge设备上的订阅问题:原版插件停止后重启无法接收新电量状态,原因在于JS层缓存旧值导致同值过滤失效。修复方案为在首次订阅时重置_level和_isPlugged状态,确保每轮订阅都能收到初始值。测试验证修正版在真机与模拟器上均能稳定触发每轮状态回调,且不影响原有去重机制。关键点在于区分“当前值”与“变化通知”,并明确生命周期管理,避免因状态残留影响新订阅。

白天写代码,晚上追AI大模型,偶尔搞点八卦 开源动态|技术干货|实习机会|生态活动 我负责分享,你负责变强 29

Ionic 接入鸿蒙日历:会议改期两次,系统怎么只保留一条?

本文通过真实设备测试,验证了在鸿蒙系统中跨进程重启后,应用能否正确识别并更新同一日历事件。核心在于使用固定业务标识(identifier)而非标题或时间匹配事件,确保改期、重启、删除等操作均能准确追溯同一记录。测试显示,两次改期后事件ID保持不变,重启后仍可找回原事件,证明系统未误触发新增。同时强调:仅靠回读结果判断写入是否成功,需同步核对条数、事件ID与时间,避免因状态不一致导致逻辑错误。

白天写代码,晚上追AI大模型,偶尔搞点八卦 开源动态|技术干货|实习机会|生态活动 我负责分享,你负责变强 34

React Native 在鸿蒙读取 EXIF:三张 JPEG 能读出哪些信息?

本文基于HarmonyOS跨平台开发实践,实现React Native与ArkTS间EXIF信息读取的原生桥接。通过三张预设样片(含时间、坐标、空标签)验证了在MatePad Edge真机及模拟器上对拍摄时间与GPS坐标的准确读取能力,结合Pillow独立回读校验,确认字段缺失由原生层统一归零处理。桥接层采用逐项请求策略,避免因部分字段缺失导致整体解析失败,并通过默认值收敛机制返回null,便于前端区分“无数据”与“解析异常”。

白天写代码,晚上追AI大模型,偶尔搞点八卦 开源动态|技术干货|实习机会|生态活动 我负责分享,你负责变强 35

React Native 接入鸿蒙 OCR:双栏讲义怎么读才不串行?

本文基于OpenHarmony与React Native跨平台框架,实现双栏讲义的智能OCR阅读排序。通过保留原始识别框坐标,对比“按纵坐标”与“按列阅读”两种策略,验证后者在保持语义顺序上的优势。实验表明,仅依赖纵坐标易因行框位置微小偏差导致错序,而按栏分组后按纵坐标排序可准确还原人工参考顺序(10/10匹配)。系统通过中缝判断跨栏行,结合原图像素坐标与缩放比例,确保界面高亮精准对应。代码设计强调坐标完整性与逻辑分离,支持后续版面自适应优化。

白天写代码,晚上追AI大模型,偶尔搞点八卦 开源动态|技术干货|实习机会|生态活动 我负责分享,你负责变强 23

Ionic 接入鸿蒙文档扫描:三页巡检单怎么合成一份 PDF?

「折页扫描」应用通过鸿蒙系统编辑器实现PDF文档的删页、旋转与导出。测试中,四张样张(封面、作废附件、检查表、签核页)经编辑后生成3页正向PDF,文件大小178,479字节,内容与预期一致。关键在于:系统编辑器返回的PDF由实际操作结果生成,而非重新构造原始图像;通过pdfinfo与逐页渲染验证页数与方向,确保交付成果准确可复现。插件回调机制保障流程唯一性,避免并发问题,实现端到端可信交付。

白天写代码,晚上追AI大模型,偶尔搞点八卦 开源动态|技术干货|实习机会|生态活动 我负责分享,你负责变强 23

Ionic 接入鸿蒙文搜图:应用重启后,搜索结果还能打开原图吗?

本文通过鸿蒙跨平台项目演示图像搜索与文件读取的完整链路:使用Capacitor调用原生Vision Kit进行文本搜索,结果仅传递图片ID至Ionic页面,点击时由原生侧根据沙箱路径读取文件。实测验证了重启、进程强制结束、文件移除等场景下的行为,强调索引与文件存储分离的重要性,确保“搜索可查、打开可读”。关键点包括:避免同名覆盖、持久化标识映射、点击时二次校验文件存在性,以及合理处理空结果与文件丢失的差异反馈。

白天写代码,晚上追AI大模型,偶尔搞点八卦 开源动态|技术干货|实习机会|生态活动 我负责分享,你负责变强 26

Cordova 接入鸿蒙主体分割:商品图怎么导出成透明 PNG?

本文记录一个 Cordova 商品图工作台在鸿蒙 MatePad Edge 上的实测:选图后调用系统主体分割,把前景编码为 PNG,网页用离屏 Canvas 重读 Alpha 校验透明度,再由系统文件选择器原样落盘。核心结论是预览与导出共用同一份字节,文件是否透明只由独立解码后的 Alpha 决定,而非棋盘格预览。

白天写代码,晚上追AI大模型,偶尔搞点八卦 开源动态|技术干货|实习机会|生态活动 我负责分享,你负责变强 27

Electron 鸿蒙媒体实战:打通小艺 Skill 与 Agent 语音指令,TCP 桥实现 Electron 跨端语音操作闭环

本文探讨了在鸿蒙系统上运行 Electron 应用时,实现小艺语音交互的“三个世界”挑战:渲染进程、主进程与宿主 UIAbility 间无共享运行时。通过回环 TCP 桥接方案,将 ArkTS 的 ASR/TTS 能力与 Electron 的媒体控制逻辑打通,实现指令路由与执行仲裁。采用统一意图目录(纯规则 NLU),支持桥在线时由 Electron 执行,离线时自动切换原生兜底。实测验证了真机闭环协议,展示了从语音输入到播报反馈的完整链路,为跨平台语音代理提供可复用架构。

白天写代码,晚上追AI大模型,偶尔搞点八卦 开源动态|技术干货|实习机会|生态活动 我负责分享,你负责变强 52

Qt 鸿蒙日历读写实战:Qt Widgets 通过 JS 桥打通 C++ 与 ArkTS CalendarKit,封装 qt-ohos-calendar 三方库,解决同步调用与异步 Promise 矛

Qt应用在鸿蒙上实现日历互通,面临Qt C++与ArkTS系统日历接口隔离问题。通过封装qt-ohos-calendar库,利用Qt for HarmonyOS自带的JS桥(QOhosJsThreadGateway),将同步调用转为异步处理:Qt侧以QObject定义接口,ArkTS侧通过串行队列收敛Promise,实现权限申请、日历创建、事件增删改查等操作,并借助快照轮询机制确保状态一致。

白天写代码,晚上追AI大模型,偶尔搞点八卦 开源动态|技术干货|实习机会|生态活动 我负责分享,你负责变强 40

KMP 鸿蒙日历:Kotlin/Native 内核 + NAPI 桥接 CalendarKit 实战

Kotlin Multiplatform 在鸿蒙上实现日历功能面临“三层世界”挑战:业务逻辑(事件归一化、RRULE处理)由Kotlin/Native负责,系统日历调用通过ArkTS的CalendarKit完成,中间依赖NAPI胶水层仅传递JSON字符串。项目通过自研KMP工具链(CPF-KMP-CMP)构建ohosArm64/x64双目标.so,并封装为HAR库,确保胶水层最小化、不感知业务字段。实测验证了权限申请、跨进程读写、周期规则转换等核心流程,日志与系统日历联动,证明方案可行。

白天写代码,晚上追AI大模型,偶尔搞点八卦 开源动态|技术干货|实习机会|生态活动 我负责分享,你负责变强 23

Qt 鸿蒙沉浸光感实战:同一份规格对接双渲染器,打通 Qt 与 ArkUI 跨运行时通道,搞定系统玻璃材质、Qt 自绘对齐

本文聚焦Qt for HarmonyOS中玻璃效果的跨运行时对齐问题,提出“单一事实来源”方案:将材质参数表(五档模糊、赋色、高光等)封装为C++17内核,供Qt与ArkTS共享。通过napi_threadsafe_function实现跨线程请求/回调,确保弹窗、菜单等系统组件使用真实材质,同时自绘玻璃与系统风格一致。实测验证参数可测量、闭环可控,关键链路如overlay.show→dismissed完整无损,最终达成“同一规格,双渲染器”的沉浸式体验统一。

白天写代码,晚上追AI大模型,偶尔搞点八卦 开源动态|技术干货|实习机会|生态活动 我负责分享,你负责变强 51

打通 CMP 与鸿蒙系统智能:三方库承载语音匹配、TTS 播报、小艺 Agent 调用与意图回调全链路

本文通过 cmp_ohos_ai_agent 库,详解 Kotlin/Compose Multiplatform 如何实现鸿蒙小艺语音闭环。从技能注册、麦克风输入到 TTS 回话,再到反向接收系统意图与调起智能体组件,揭示跨端框架与 ArkTS 间双向桥接的实现机制。结合真机实测(华为 nova 14),展示能力探测、设备状态同步、指令匹配与执行回执全流程,并解析权限、组件不可渲染等关键坑点,验证了在 CMP 下完成完整语音智能交互的可行性。

白天写代码,晚上追AI大模型,偶尔搞点八卦 开源动态|技术干货|实习机会|生态活动 我负责分享,你负责变强 43

Qt for HarmonyOS 语音智能体落地:qt-ohos-ai-agent 三方库实现本地指令与小艺双向联动,拆解 NAPI 桥接

本文探讨了在鸿蒙系统上运行Qt应用时,如何实现语音指令闭环——将Qt Widgets界面与鸿蒙原生语音能力(CoreSpeechKit、textToSpeech、AgentFrameworkKit、InsightIntent)深度融合。通过构建三层架构:纯C++17核心(解析+状态机)、ArkTS HAR模块(语音/播报/小艺调用)、Qt服务类(JS桥接),实现“应用内说话”与“对小艺说话”共享同一套语义理解大脑。

白天写代码,晚上追AI大模型,偶尔搞点八卦 开源动态|技术干货|实习机会|生态活动 我负责分享,你负责变强 36

KMP 鸿蒙空间音频与智能体落地:绕开 JS 桥阻塞,OHAudio 原生渲染,小艺语音指令实现声场动态重排

本文探讨了在Kotlin Multiplatform(KMP)开发鸿蒙应用时,实现“媒体+AI”闭环的挑战与解决方案。核心难点在于音频渲染需在系统音频线程中实时执行,而小艺语音识别、合成及AgentFrameworkKit仅支持ArkTS,导致KMP难以直接调用。作者通过cinterop暴露libohaudio.so接口,将音频处理逻辑下沉至Kotlin/Native,确保低延迟;同时将意图识别、声场重构等核心算法全量移入commonMain,实现纯Kotlin闭环。

白天写代码,晚上追AI大模型,偶尔搞点八卦 开源动态|技术干货|实习机会|生态活动 我负责分享,你负责变强 75

CMP 鸿蒙日历读写实战:Compose 月历跨 Kotlin/C/ArkTS 桥接 CalendarKit,自建独立日历账户

本文详解了在鸿蒙CMP(Compose Multiplatform)环境下实现跨语言日历读写的完整链路:Kotlin通过C API头文件与ArkTS via NAPI桥接,以字符串通道传递id, op, argsJson指令,实现权限感知的本地/系统日历降级存储。核心突破在于将CalendarKit封装为CMP库,利用协程挂起-恢复机制完成异步通信,并确保日程写入自建日历账户(如“CMP日历”),最终在系统日历中可见且归属明确。

白天写代码,晚上追AI大模型,偶尔搞点八卦 开源动态|技术干货|实习机会|生态活动 我负责分享,你负责变强 95

CMP 鸿蒙沉浸光感实战:弹窗菜单复用系统材质,自绘画布按算力档位对齐,打通 CMP 与 ArkUI 双轨渲染链路

本文通过一个跨端示例工程,深入解析鸿蒙API 26中ImmersiveMaterial的底层机制:它并非普通贴图,而是仅作用于特定系统组件(如弹窗、菜单)的“系统材质”,具备档位分级、算力降级与生效范围限制。文章揭示了如何在CMP框架中封装该能力——将弹窗/菜单壳交还ArkUI实现真材质,自绘内容则通过标定参数模拟其模糊、着色、光效等特征,确保在模拟器与真机上视觉对齐。项目已开源,提供完整实现与社区支持。

白天写代码,晚上追AI大模型,偶尔搞点八卦 开源动态|技术干货|实习机会|生态活动 我负责分享,你负责变强 74

Electron 鸿蒙系统级 TTS 实战:把声音交给操作系统,把队列留给自己

本文探讨在 Electron 与 HarmonyOS 上实现“系统级 TTS”的挑战与解决方案。Electron 因主进程无渲染环境,需通过 1×1 隐藏 renderer 托管 speechSynthesis;鸿蒙则受限于 Core Speech Kit 的接口约束,如无暂停、边界事件等。二者均采用文本分块队列与请求唯一标识管理长文本播报。代码已开源,展示跨平台系统语音集成的实践路径。

白天写代码,晚上追AI大模型,偶尔搞点八卦 开源动态|技术干货|实习机会|生态活动 我负责分享,你负责变强 130

KMP 鸿蒙系统级 TTS 实战:让队列里的每一句都说完整

本文基于鸿蒙2in1平台,通过KMP工程实现一个离线TTS合成引擎,解决平台回调两次、事件乱序、资源复用等难题。核心在于:以ArkTS为入口,Kotlin负责队列与状态机,统一归一化平台回调,确保“合成完成”与“播放完成”精准区分;通过requestId管理请求生命周期,支持抢占与过期事件丢弃,保障多任务有序执行。实测24项JVM用例全通过,状态机稳定可靠,适用于无障碍朗读、订单播报等离线语音场景。

白天写代码,晚上追AI大模型,偶尔搞点八卦 开源动态|技术干货|实习机会|生态活动 我负责分享,你负责变强 186

Cordova 鸿蒙系统级 TTS 实战:让 WebView 里的文字“开口说话“

本文以鸿蒙7.0真机实测为例,剖析Cordova插件cordova-plugin-tts-ohos从JS调用到系统TTS引擎的完整链路:通过一层C++桥接实现JS与ArkTS通信,依托Core Speech Kit完成离线语音合成。重点揭示“384ms播完”截图的误导性——实际为合成完成而非播放结束,修复后耗时达9.2秒,强调onComplete.type区分合成与播放终态的重要性。同时说明事件流需保留keepCallback状态,确保Promise在真正播放结束后才resolve,避免竞态。

白天写代码,晚上追AI大模型,偶尔搞点八卦 开源动态|技术干货|实习机会|生态活动 我负责分享,你负责变强 217

Qt 鸿蒙系统级 TTS 实战:让 QML 借系统的嗓子说话

本文基于 Qt 5.12.12 与 HarmonyOS,通过一个 QML 插件(SpatialTts)实现跨平台系统级 TTS:桌面调用 Qt TextToSpeech,鸿蒙对接 Core Speech Kit。核心创新在于将队列、状态管理与音色控制统一于 Qt 侧,后端按编译期选择,鸿蒙端通过 JS 线程桥(QOhosJsThreadGateway)调用 ArkTS 接口,并完成宿主注册。

白天写代码,晚上追AI大模型,偶尔搞点八卦 开源动态|技术干货|实习机会|生态活动 我负责分享,你负责变强 202

React Native 鸿蒙系统 TTS 实战:让表面开口

本文介绍了一个基于 React Native 0.84 的鸿蒙三方库 spatial-glass-rn,实现系统离线 TTS 语音播报的全链路集成。通过拆解长文本分段、JS 侧队列管理、跨平台事件归一化与状态同步,将系统级语音引擎(鸿蒙 Core Speech Kit)与光感表面视觉组件融合,构建出无网络依赖、零额外体积、隐私安全的语音交互体验。真机实测验证了在仓储、巡检等场景下的稳定性与实时性,解决了三端语义不一致问题,实现了“状态可读、进度可视、操作可控”的沉浸式语音反馈。

白天写代码,晚上追AI大模型,偶尔搞点八卦 开源动态|技术干货|实习机会|生态活动 我负责分享,你负责变强 220

React Native 鸿蒙端侧 AI 图像超分实战:让 NPU 把细节补回来

本文详解在鸿蒙PC上基于React Native 0.84的react-native-ohos-ai-vision库,实现512px图像通过NPU进行4倍超分并返回JS的完整链路。核心突破在于:通过显式引擎标识(engine字段)与可验证校验和,区分AI(Core Vision Kit/NPU)与CPU双三次回退路径,确保结果可信。实测证明,仅当factor=4且API≥26时启用NPU,否则自动降级至确定性双三次算法,全程无网络依赖,端到端耗时约3.6秒,效果真实还原细节。

白天写代码,晚上追AI大模型,偶尔搞点八卦 开源动态|技术干货|实习机会|生态活动 我负责分享,你负责变强 181

2026开源鸿蒙大学生创新大赛赛道一和赛道三初审结果公示

2026开源鸿蒙大学生创新大赛(原OpenHarmony竞赛训练营)由开源鸿蒙项目群技术指导委员会主办、AtomGit承办,面向全国高校学生开发者,聚焦开源鸿蒙技术生态建设。大赛报名与作品提交阶段已于8日前结束,经组委会组织专家按评审细则经过多轮评审后完成初审,现将通过初审、进入决赛的作品名单予以公示。以下名单以作品名称首字母排序。

白天写代码,晚上追AI大模型,偶尔搞点八卦 开源动态|技术干货|实习机会|生态活动 我负责分享,你负责变强 55
上一篇: Ionic 接入鸿蒙应用 Skill:两件耗材同名时,先确认库位再查询
下一篇: Qt 鸿蒙电脑多屏适配:拔掉外接屏,窗口怎么回到主屏?
AtomGit 代码君
AtomGit 代码君 企业官方账号 企业官方账号
博客等级 码龄6年 2万+粉丝 986原创
评论
成就一亿技术人!
拼手气红包6.0元
还能输入1000个字符
 
 条评论被折叠 查看
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付:10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值
⌂ 换网址