写点什么

harmony-utils 之 CrashUtil,异常相关工具类

  • 2025-06-25
    安徽
  • 本文字数:1373 字

    阅读完需:约 5 分钟

harmony-utils 之 CrashUtil,异常相关工具类

harmony-utils 简介与说明



harmony-utils 一款功能丰富且极易上手的 HarmonyOS 工具库,借助众多实用工具类,致力于助力开发者迅速构建鸿蒙应用。其封装的工具涵盖了 APP、设备、屏幕、授权、通知、线程间通信、弹框、吐司、生物认证、用户首选项、拍照、相册、扫码、文件、日志,异常捕获、字符、字符串、数字、集合、日期、随机、base64、加密、解密、JSON 等一系列的功能和操作,能够满足各种不同的开发需求。


picker_utils 是 harmony-utils 拆分出来的一个子库,包含 PickerUtil、PhotoHelper、ScanUtil。


下载安装


ohpm i @pura/harmony-utils


ohpm i @pura/picker_utils


  //全局初始化方法,在UIAbility的onCreate方法中初始化 AppUtil.init()  onCreate(want: Want, launchParam: AbilityConstant.LaunchParam): void {    AppUtil.init(this.context);  }
复制代码

API 方法与使用


onHandled 注册错误观测器(该方法建议在 Ability 里调用) 。注册后可以捕获到应用产生的 js crash,应用崩溃时进程不会退出。将异常信息写入本地文件
CrashUtil.onHandled((exceptionInfo)=>{  LogUtil.error(JSON.stringify(exceptionInfo, null, 2));});
复制代码
onDestroy 注销错误观测器
CrashUtil.onDestroy(); //注销错误观测器ToastUtil.showToast("注销误观测器,成功!");
复制代码
isHandled 判断错误观测器是否存在
let isHandled = CrashUtil.isHandled();ToastUtil.showToast(`误观测器是否存在:${isHandled}`);
复制代码
getFilePath 获取日志文件路径(用于读取异常文件、导出异常文件)
let path = CrashUtil.getFilePath();LogUtil.error(`异常日志文件路径:${path}`);
复制代码
access 判断日志文件是否存在
let access = CrashUtil.access();ToastUtil.showToast(`日志文件是否存在:${access}`);
复制代码
delete 删除日志文件
CrashUtil.delete();ToastUtil.showToast(`日志文件删除成功!`);
复制代码
getExceptionJson 获取异常日志的 JSON 字符串
if (CrashUtil.access()) {  let jsonStr = await CrashUtil.getExceptionJson(); //读取JSON  Utils.showSheetText(jsonStr);} else {  ToastUtil.showToast("暂无日志文件");}
复制代码
getExceptionList 获取异常日志的集合
if (CrashUtil.access()) {  let list = await CrashUtil.getExceptionList();  DialogHelper.showToast(`异常个数:${list.length}`);} else {  ToastUtil.showToast("暂无日志文件");}
复制代码
enableAppRecovery 启用应用恢复功能,参数按顺序填入。该接口调用后,应用从启动器启动时第一个 Ability 支持恢复
CrashUtil.enableAppRecovery();
复制代码
restartApp 重启 APP,并拉起应用启动时第一个 Ability,可以配合 errorManager 相关接口使用
CrashUtil.restartApp();
复制代码
saveAppState 保存当前 App 状态 或 主动保存 Ability 的状态,这个状态将在下次恢复启动时使用。可以配合 errorManager 相关接口使用
CrashUtil.saveAppState(this.context);
复制代码
setRestartWant 设置下次恢复主动拉起场景下的 Ability。该 Ability 必须为当前包下的 UIAbility
let want: Want = {  bundleName: 'com.harmony.utils',  abilityName: 'EntryAbility'};CrashUtil.setRestartWant(want);
复制代码

创作不易,请给童长老点赞👍



https://github.com/787107497/harmony-utils


https://gitee.com/tongyuyan/harmony-utils


OpenHarmony三方库


童长老CSDN博客

用户头像

还未添加个人签名 2025-05-14 加入

还未添加个人简介

评论

发布
暂无评论
harmony-utils之CrashUtil,异常相关工具类_HarmonyOS_桃花镇童长老_InfoQ写作社区