Harmony os router 使用详解

关于HarmonyOS NEXT中ArkTS的路由（Router）模块实现原理和使用方法，结合官方文档和开发实践，可总结如下核心要点：

一、Router模块的基础能力

Router模块是HarmonyOS页面导航的核心工具，主要提供两种跳转模式：

• router.pushUrl()：保留当前页面并跳转到新页面，可通过返回键回退到原页面。
• router.replaceUrl()：替换当前页面为目标页面，无法通过返回键回退。

示例代码片段：

// 普通跳转（保留页面栈）
router.pushUrl({ url: 'pages/Home' });

// 替换当前页面（清空页面栈）
router.replaceUrl({ url: 'pages/Login' });

二、路由参数传递与接收

1. 参数传递
   通过params字段传递键值对数据：

   router.pushUrl({
     url: 'pages/Profile',
     params: { userId: '123', userName: 'HarmonyUser' }
   });

1. 参数接收
   在目标页面通过router.getParams()获取参数：

   @State paramsFromIndex: object = router.getParams();
   @State userId: string = this.paramsFromIndex?.['userId'] ?? '';
```<span data-key="23" class="reference-num" data-pages="undefined">2</span>

---

### 三、路由模式与页面栈管理
Router支持两种路由模式：
- **Standard模式**（默认）：允许同一页面多次入栈。
- **Single模式**：确保目标页面在栈内唯一，若已存在则移动到栈顶。

示例配置：
```typescript
router.pushUrl({
  url: 'pages/Home',
}, router.RouterMode.Single); // 强制单例模式
```<span data-key="24" class="reference-num" data-pages="undefined">13</span>

---

### 四、路由生命周期与UI组件交互
1. **页面生命周期绑定**  
   通过`@Entry`装饰器声明入口组件，结合`aboutToAppear`和`aboutToDisappear`生命周期函数管理资源：
```typescript
   @Entry
   @Component
   struct Login {
     aboutToAppear() {
       // 页面显示时初始化数据
     }

     aboutToDisappear() {
       // 页面隐藏时释放资源
     }
   }
```<span data-key="25" class="reference-num" data-pages="undefined">13</span>

2. **UI事件触发路由**  
   常见于按钮点击事件：
```typescript
   Button('登录')
     .onClick(() => {
       if (authSuccess) {
         router.replaceUrl({ url: 'pages/Dashboard' });
       }
     })
```<span data-key="26" class="reference-num" data-pages="undefined">1</span>

---

### 五、源码设计解析
1. **模块化导入**  
   通过`@ohos.router`包引入功能：
```typescript
   import router from '@ohos.router';

1. 路由配置机制
   页面路径需在main_pages.json中预先注册：

   {
     "src": ["pages/Index", "pages/Login", "pages/Home"]
   }
```<span data-key="27" class="reference-num" data-pages="undefined">7</span>

3. **错误处理**  
   需捕获路由跳转异常：
```typescript
   router.pushUrl({ url: 'pages/Error' }, (err) => {
     if (err) {
       console.error(`路由失败: ${err.code} - ${err.message}`);
     }
   });
```<span data-key="28" class="reference-num" data-pages="undefined">13</span>

---

### 六、与Navigation组件的对比
虽然官方推荐逐步迁移至`Navigation`组件实现声明式路由<span data-key="29" class="reference-num" data-pages="undefined">9</span>，但当前Router仍具有以下优势：
- 更适用于命令式编程场景
- 兼容旧版本HarmonyOS应用
- 轻量级快速集成

---

### 总结
Router模块作为ArkTS的核心导航工具，其设计兼顾了灵活性与性能。开发者需注意：
1. 避免过度深层页面栈导致内存压力
2. 跨设备场景下参数序列化限制
3. 路由模式选择对用户体验的影响

建议结合官方示例工程
（[HarmonyOS Router示例](https://developer.harmonyos.com/cn/docs/documentation/doc-guides-V3/arkts-routing-0000001633697857-V3 )）进行实践验证<span data-key="30" class="reference-num" data-pages="undefined">15</span>。