React Native 接入鸿蒙推送:冷启动工单路由与令牌排查
开源鸿蒙跨平台开发者社区 · 鸿蒙 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-1043 · 查看原件

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 |
| 构建工具和 SDK | DevEco Studio 6.1.1.300,API 26 SDK 26.0.0.105 | HAP 构建与本地签名 |
| 框架 | React Native 0.84.1,RNOH 0.84.4 | 两种 ABI 编译与 React Native 页面 |

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

MatePad Edge 关于本机 · 查看原件

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

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 工程:校验路由参数并过滤相邻的重复工单 · 查看原件
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 探针返回应用身份校验失败 · 查看原件
一条命令发一个 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'}});
AtomGit 是由开放原子开源基金会联合 CSDN 等生态伙伴共同推出的新一代开源与人工智能协作平台。平台坚持“开放、中立、公益”的理念,把代码托管、模型共享、数据集托管、智能体开发体验和算力服务整合在一起,为开发者提供从开发、训练到部署的一站式体验。
更多推荐

所有评论(0)