基于 API11，开发的程序示例，适用于 NEXT 及以上版本运行。
项目包含如下：
- 静态库+动态包+多模块设计
- 状态管理
- 统一路由管理（router+navPathStack）
- 网络请求、Loading、Toast、数据持久化 等工具库封装
- 自定义组件、自定义弹窗（解耦）
- EventBus 事件通知
- 扩展修饰器，实现 节流、防抖、权限申请
- 动态路由 （navPathStack + 动态import + WrappedBuilder）
- UI动态节点操作 (BuilderNode + NodeController)
- 折叠屏适配示例
项目结构描述
| 模块名称 | 描述 | 备注 |
|---|---|---|
| fast_util | 工具类 | FastLog（日志打印） EventBus（消息通知） FastRouter（路由管理） ThrottleTool(节流、防抖) FastPermission(修饰器实现权限申请) PreferencesUtil(数据持久化封装) |
| fast_ui | 提供 UI 封装、样式、toast 等 | CommonText（统一文本） CommonButton（统一按键） FastToast FastLoading |
| global_constant | 记录全局常量配置 | PagePathConstants(路由路径管理) |
| 模块名称 | 描述 | 备注 |
|---|---|---|
| feature_home | 主要存放代码示例 | 静态包（har） |
| feature_hsp_page | 存放动态包交互示例 | 动态包（hsp/share） |
├──entry // ets代码区
│ └──src/main/ets
│ ├──entryability
│ │ ├──FoldStatusObserver.ets // 折叠屏幕变化监听
│ │ └──EntryAbility.ets
│ ├──pages
│ │ └──MainPage.ets // 首页
├──business // 放置静态包的文件夹（业务模块）
│ ├──feature_home // 放置首页Tab里的一些示例页面
│ │ └──/src/main/ets/pages
│ │ ├──HomePage.ets //首页的第一个Tab
│ │ ├──BuilderNodeExample.ets //动态节点操作示例
│ │ ├──CustomDialogExample.ets //自定义弹窗解耦
│ │ ├──EventBusExample.ets //消息通知
│ │ ├──HttpRequestExample.ets //网络请求示例
│ │ ├──PermissionExample.ets //使用注解请求权限
│ │ ├──RouterCallbackExample.ets //两种方式router回调示例
│ │ ├──FixFoldUiExample.ets //折叠屏适配示例
│ │ └──ThrottleExample.ets //使用注解防抖
│ ├──feature_setting
│ │ └──/src/main/ets/pages
│ │ ├──SettingPages.ets //首页的第二个Tab
│ │ └──TestDynamicNavPage.ets //测试动态路由示例
├──features //放置动态包的文件夹
│ ├──feature_has_page
│ │ └──/src/main/ets/pages
│ │ └──TestHspHomePage.ets //测试动态包router回调示例
├──base
│ ├──fast_ui //封装公共UI
│ │ ├──/src/main/ets/compnents
│ │ │ ├──FoldStatusContainer.ets // 折叠屏变化响应组件封装
│ │ │ ├──FastLoading.ets // loading工具
│ │ │ └──FastToast.ets // toast工具
│ │ └──/src/main/ets/styles // 公共样式
│ ├──fast_util // 通用工具
│ │ ├──/src/main/ets
│ │ ├──EventBus.ets // 消息通知+监听
│ │ ├──FastLog.ets // 日志打印
│ │ ├──FastNavRouter.ets // 用于动态路由
│ │ ├──FastPermission.ets // 请求权限注解器
│ │ ├──FastRouter.ets // 基于 router 库封装，为了实现页面回调
│ │ ├──FastTool.ets
│ │ ├──PreferencesUtil.ets // 数据持久化工具
│ │ └──ThrottleTool.ets //防抖注解器
│ ├──global_constant
│ │
├──entry/src/main/resources // 应用资源目录
└──module.json5 // 添加卡片拓展能力 class GetRequest extends HttpRequest<CommonResponseModel<ResponseModel>> {
...省略入参
}
// 发送请求
let request = new GetRequest()
request.excute().then((data)=>{
// 这里获取的 data 类型为 CommonResponseModel<BusinessModel>
})// 修饰器实现节流，示例如下，2秒内多次点击只会触发第一次
@Throttle(2000)
onClickTap(name: string) {
// consolve.log(name)
this.count++
}// 修饰器实现权限申请，示例如下
@Permission(
getContext(this) as common.UIAbilityContext,
['ohos.permission.LOCATION', 'ohos.permission.APPROXIMATELY_LOCATION']
)
onClickTap(name: string) {
// 授权成功后，才会进入方法内执行 count++
this.count++
}// 示例请看 FastNavRouter，下面为关键代码
// 路由管理
static builderMap: Map<string, WrappedBuilder<[object]>> = new Map<string, WrappedBuilder<[object]>>();
// 注册页面组件到路由表，builderName是路由名字，builder参数是包裹了页面组件的WrappedBuilder对象
public static registerBuilder(
builderName: string,
builder: WrappedBuilder<[object]>
): void {
builderMap.set(builderName, builder);
}
// 动态路由对应的页面
@Builder
export function TestDynamicNavPageBuilder(params: object) {}
// 在页面首次加载时触发执行
const builderName: string = '@ohos/feature_setting*./src/main/ets/TestDynamicNavPage';
// 判断表中是否已存在路由信息，避免重复注册
if (!FastNavRouter.getBuilder(builderName)) {
// 通过系统提供的wrapBuilder接口封装@Builder装饰的方法
let builder: WrappedBuilder<[object]> = wrapBuilder(TestDynamicNavPageBuilder);
// 注册页面到全局路由表
FastNavRouter.registerBuilder(builderName, builder);
}
// 跟页面路由管理中转
@Builder
PageMap(name: string, params?: RouterModel) {
if (FastNavRouter.getBuilder(name) !== undefined) {
// 测试动态路由 (TestDynamicNavPage)
FastNavRouter.getBuilder(name).builder(params)
}
}