0
代码
代码
Issues
Pull Requests
讨论
Wiki
分析
0
m0_74155949m0_74155949restore uiAbilityContext.md link
3461b249创建于 2024年9月26日历史提交

基础能力增强

介绍

本示例使用 AppManager ，dataUriUtils，WantAgent，ApplicationContext，errorManager，UIAbilityContext中的接口进行实现。

效果预览

主页面 appManager开发示例 errorManager开发示例 UIAbilityContext开发示例

使用说明

AppManager对应接口

1.点击主页面appManager开发示例按钮，跳转到'appManager开发示例'界面；

2.点击isRunningInStabilityTest callback按钮，弹出'isRunningInStabilityTest(callback) success...'信息；

3.点击isRunningInStabilityTest promise按钮，弹出提示'isRunningInStabilityTest(promise) success...'信息；

4.点击isRamConstrainedDevice callback按钮，弹出提示'isRamConstrainedDevice(callback) success...'信息；

5.点击isRamConstrainedDevice promise按钮，弹出提示'isRamConstrainedDevice(promise) success...'信息；

6.点击getAppMemorySize callback按钮，弹出提示'getAppMemorySize(callback) success...'信息；

7.点击getAppMemorySize promise按钮，弹出提示'getAppMemorySize(promise) success...'信息；

8.点击getRunningProcessInformation callback按钮，弹出提示'getRunningProcessInformation(callback) success...'信息；

9.点击getRunningProcessInformation promise按钮，弹出提示'getRunningProcessInformation(promise) success...'信息;

dataUriUtils对应接口

1.点击主页面dataUriUtils开发示例按钮，跳转到'dataUriUtils开发示例'界面；

2.点击getId按钮，弹出提示'dataUriUtils.getId() called...'信息；

3.点击attachId按钮，弹出提示'dataUriUtils.attachd() called...'信息；

4.点击deleteId按钮，弹出提示'dataUriUtils.deleteId() called...'信息；

5.点击updateId按钮，弹出提示'dataUriUtils.updateId() called...'信息；

WantAgent对应接口

1.点击主页面WantAgent开发示例按钮，跳转到'WantAgent开发示例'界面；

2.点击getBundleName callback按钮，弹出提示'getBundleName(callback) success...'信息；

3.点击getBundleName promise按钮，弹出提示'getBundleName(promise) success...'信息；

4.点击getUid callback按钮，弹出提示'getUid(callback) success...'信息；

5.点击getUid promise按钮，弹出提示'getUid(promise) success...'信息；

6.点击cancel callback按钮，弹出提示'cancel(callback) success'信息；

7.点击cancel promise按钮，弹出提示'cancel(promise) success'信息；

8.点击equal callback按钮，弹出提示'equal(callback) success...'信息；

9.点击equal promise按钮，弹出提示'equal(promise) success...'信息；

10.点击getOperationType callback按钮，弹出提示'getOperationType(callback) success...'信息；

11.点击getOperationType promise按钮，弹出提示'getOperationType(promise) success...'信息；

12.点击trigger按钮，弹出提示'trigger success...'信息；

ApplicationContext对应接口

1.点击主页面ApplicationContext开发示例按钮，跳转到'ApplicationContext开发示例'界面；

2.点击setFont按钮，弹出提示'setFont successfully'信息；

3.点击getRunningProcessInformation promise按钮，弹出提示'getRunningProcessInformation promise successfully...'信息；

4.点击getRunningProcessInformation callback按钮，弹出提示'getRunningProcessInformation callback successfully...'信息；

5.点击getCurrentAppCloneIndex按钮，弹出提示'getCurrentAppCloneIndex successfully...'信息；

errorManager对应接口

1.点击主页面errorManager开发示例按钮，跳转到'errorManager开发示例'界面；

2.点击注册LoopObserver按钮，弹出提示'loopObserver registered successfully...'信息；

3.点击注册UnhandledRejectionObserver按钮，弹出提示'unhandledRejection registered successfully'信息，列表中增加模拟UnhandledRejection按钮，并且原注册UnhandledRejectionObserver按钮变为注销UnhandledRejectionObserver按钮

4.点击模拟UnhandledRejection按钮，弹出提示'UnhandledRejectionObserver reason...'信息；

5.点击注销UnhandledRejection按钮，弹出提示'unhandledRejection unregistered successfully'信息，注销UnhandledRejectionObserver按钮变回注册UnhandledRejectionObserver按钮，列表中模拟UnhandledRejection按钮消失；

UIAbilityContext对应接口

1.点击主页面UIAbilityContext开发示例按钮，启动新的Ability显示'UIAbilityContext开发示例'界面；

2.点击moveAbilityToBackground按钮，将启动的Ability移动到后台，页面显示为主页面，触发AbilityLifecycleCallback中的生命周期；

3.再次点击主页面UIAbilityContext开发示例按钮，启动新的Ability显示'UIAbilityContext开发示例'界面，点击terminateSelf按钮，回到主页面；

工程目录

entry/src/main/ets/
|---abilitylifecyclecallback
|   |---AbilityLifecycleCallback.ets        //AbilityLifecycleCallback生命周期
|---abilitypages
|   |---ApplicationContext.ets              //ApplicationContext中对应接口
|   |---AppManager.ets                      //AppManager中对应接口
|   |---DataUriUtils.ets                    //DataUriUtils中对应接口
|   |---ErrorManager.ets                    //ErrorManager中对应接口
|   |---UIAbilityContext.ets                //UIAbilityContext中对应接口
|   |---WantAgent.ets                       //WantAgent中对应接口
|---entryability
|   |---EntryAbility.ets					// 首页的Ability
|---pages
|   |---Index.ets							// 首页

具体实现

  • AppManager对应接口实现，源码参考AppManager.ets

    • isRunningInStabilityTest（callback）接口实现：通过调用appManager.isRunningInStabilityTest()接口，查询当前是否处于稳定性测试场景。使用callback异步回调，并将弹出Toast信息的功能；
    • isRunningInStabilityTest（promise）接口实现：通过调用appManager.isRunningInStabilityTest()接口，查询当前是否处于稳定性测试场景。使用Promise异步回调，并将弹出Toast信息的功能；
    • isRamConstrainedDevice（callback）接口实现：通过调用appManager.isRamConstrainedDevice()接口，查询是否为ram受限设备。使用callback异步回调，并将弹出Toast信息的功能；
    • isRamConstrainedDevice（promise）接口实现：通过调用appManager.isRamConstrainedDevice()接口，查询是否为ram受限设备。使用Promise异步回调，并将弹出Toast信息的功能；
    • getAppMemorySize（callback）接口实现：通过调用appManager.getAppMemorySize()接口，获取当前应用程序可以使用的内存的值。使用callback异步回调，并将弹出Toast信息的功能；
    • getAppMemorySize（promise）接口实现：通过调用appManager.getAppMemorySize()接口，获取当前应用程序可以使用的内存的值。使用Promise异步回调，并将弹出Toast信息的功能；
    • getRunningProcessInformation（callback）接口实现：通过调用appManager.getRunningProcessInformation()接口，获取当前运行进程的有关信息。使用callback异步回调，并将弹出Toast信息的功能；
    • getRunningProcessInformation（promise）接口实现：通过调用appManager.getRunningProcessInformation()接口，获取当前运行进程的有关信息。使用Promise异步回调，并将弹出Toast信息的功能；

  • dataUriUtils对应接口实现，源码参考DataUriUtils.ets

    • getId接口实现：通过调用dataUriUtils.getId()接口，获取指定uri路径末尾的ID的功能；
    • attachId接口实现：通过调用dataUriUtils.attachId()接口，将ID附加到uri的路径末尾的功能；
    • deleteId接口实现：通过调用dataUriUtils.deleteId()接口，删除指定uri路径末尾的ID的功能；
    • updateId接口实现：通过调用dataUriUtils.updateId()接口，更新指定uri中的ID的功能；

  • WantAgent对应接口实现，源码参考WantAgent.ets

    • getBundleName（callback）接口实现：通过调用this.getBundleNameCallback()接口，获取WantAgent实例的包名；
    • getBundleName（promise）接口实现：通过调用this.getBundleNamePromise()接口，获取WantAgent实例的包名；
    • getUid（callback）接口实现：通过调用this.getUidCallback()接口，获取WantAgent实例的用户ID；
    • getUid（promise）接口实现：通过调用this.getUidPromise接口，获取WantAgent实例的用户ID；
    • cancel（callback）接口实现：通过调用this.cancelCallback()接口，取消WantAgent实例；
    • cancel（promise）接口实现：通过调用this.cancelPromise()接口，取消WantAgent实例；
    • equal（callback）接口实现：通过调用this.equalCallback()接口，以此来判断是否是来自同一应用的相同操作，判断两个WantAgent实例是否相等的回调方法。返回true表示两个WantAgent实例相等，false表示两个WantAgent实例不相等；
    • equal（promise）接口实现：通过调用this.equalPromise()接口，以此来判断是否是来自同一应用的相同操作，判断两个WantAgent实例是否相等的结果。返回true表示两个WantAgent实例相等，false表示两个WantAgent实例不相等；
    • getOperationType（callback）接口实现：通过调用this.getOperationTypeCallback()接口，获取一个WantAgent的OperationType信息；
    • getOperationType（promise）接口实现：通过调用this.getOperationTypePromise()接口，获取一个WantAgent的OperationType信息；
    • trigger接口实现：通过调用this.trigger()接口，主动激发WantAgent实例；

  • ApplicationContext对应接口实现，源码参考ApplicationContext.ets

    • setFont接口实现：通过调用applicationContext.setFont接口，设置应用的字体类型。仅支持主线程调用，设置字体类型，字体可以通过font.registerFont方法进行注册使用；
    • getRunningProcessInformation（callback）接口实现：通过调用ApplicationContext.getRunningProcessInformation接口，获取有关运行进程的信息；
    • getRunningProcessInformation（promise）接口实现：通过调用ApplicationContext.getRunningProcessInformation接口，获取有关运行进程的信息；
    • getCurrentAppCloneIndex接口实现：通过调用ApplicationContext.getCurrentAppCloneIndex接口，获取当前应用的分身索引；

  • errorManager对应接口实现，源码参考ErrorManager.ets

    • 注册on（loopObserver类型）接口实现：通过调用errorManager.on 接口，注册监听loopObserver，注册后可以捕获到应用主线程处理消息的具体执行时间，触发onLoopTimeOut，之后注销监听；
    • 注册on（unhandledRejection类型）接口实现：通过调用errorManager.on接口，注册监听unhandledRejection，注册后可以捕获到当前线程中未被捕获到的promise rejection，模拟unhandledRejection类型错误，触发监听，之后注销监听；

  • UIAbilityContext对应接口实现：源码参考UIAbilityContext.ets

    • moveAbilityToBackground接口实现：通过调用context.moveAbilityToBackground()接口，将处于前台的Ability移动到后台，调用context.terminateSelf()，停止Ability自身，触发AbilityLifecycleCallback中的生命周期；

相关权限

不涉及。

依赖

不涉及。

约束与限制

1.本示例仅支持标准系统上运行，支持设备：RK3568；

2.本示例为Stage模型，支持API12版本SDK，版本号：5.0.0.31；

3.本示例需要使用DevEco Studio NEXT Developer Beta1 (Build Version: 5.0.3.502, built on July 28, 2024)才可编译运行；

下载

git init
git config core.sparsecheckout true
echo code/BasicFeature/Ability/AbilityRuntime > .git/info/sparse-checkout
git remote add origin https://gitee.com/openharmony/applications_app_samples.git
git pull origin master