UTSHarmony

实例方法

convert2AbsFullPath(filePath)

将文件的项目相对地址转换为 运行期对应的绝对地址

参数

名称	类型	必填	默认值	兼容性	描述
filePath	string	是	-	-

返回值

类型
string

兼容性

uni-app x 兼容性

HarmonyOS	HarmonyOS UTS 插件
4.61	4.61

uni-app 兼容性

HarmonyOS UTS 插件
4.61

devicePX2px(px)

物理像素转换为页面的px像素

参数

名称	类型	必填	默认值	兼容性	描述
px	number	是	-	-

返回值

类型
number

兼容性

uni-app x 兼容性

HarmonyOS	HarmonyOS UTS 插件
4.61	4.61

uni-app 兼容性

HarmonyOS UTS 插件
4.31

exit()

退出应用

返回值

类型
void

兼容性

uni-app x 兼容性

HarmonyOS	HarmonyOS UTS 插件
x	-

uni-app 兼容性

HarmonyOS UTS 插件
4.31

getAppTheme()

获取应用主题

返回值

类型	描述
AppTheme	应用主题

兼容性

uni-app x 兼容性

HarmonyOS	HarmonyOS UTS 插件
4.71	-

uni-app 兼容性

HarmonyOS UTS 插件
4.71

getCurrentWindow()

获取当前原生窗口对象

返回值

类型
_ohos_window.default.Window

兼容性

uni-app x 兼容性

HarmonyOS	HarmonyOS UTS 插件
4.61	4.61

uni-app 兼容性

HarmonyOS UTS 插件
4.31

getOsTheme()

获取系统主题

返回值

类型	描述
OsTheme	系统主题

兼容性

uni-app x 兼容性

HarmonyOS	HarmonyOS UTS 插件
4.71	-

uni-app 兼容性

HarmonyOS UTS 插件
4.71

getResourcePath(filePath)

获取资源文件的原生路径。

参数

名称	类型	必填	默认值	兼容性	描述
filePath	string	是	-	-

返回值

类型
string

兼容性

uni-app x 兼容性

HarmonyOS	HarmonyOS UTS 插件
4.61	4.61

uni-app 兼容性

HarmonyOS UTS 插件
4.61

getUIAbilityContext()

获取应用的UIAbilityContext

返回值

类型
common.UIAbilityContext

兼容性

uni-app x 兼容性

HarmonyOS	HarmonyOS UTS 插件
4.61	4.61

uni-app 兼容性

HarmonyOS UTS 插件
4.31

offAppThemeChange(id)

取消监听应用主题变化

参数

名称	类型	必填	默认值	兼容性	描述
id	number	是	-	-	应用主题

返回值

类型
void

兼容性

uni-app x 兼容性

HarmonyOS	HarmonyOS UTS 插件
4.71	-

uni-app 兼容性

HarmonyOS UTS 插件
4.71

offOsThemeChange(id)

取消监听系统主题变化

参数

名称	类型	必填	默认值	兼容性	描述
id	number	是	-	-	监听ID

返回值

类型
void

兼容性

uni-app x 兼容性

HarmonyOS	HarmonyOS UTS 插件
4.71	-

uni-app 兼容性

HarmonyOS UTS 插件
4.71

onAppAbilityCreate(callback)

监听应用EntryAbility生命周期onCreate

参数

名称	类型	必填	默认值	兼容性	描述
callback	(want: Want, launchParam: AbilityConstant.LaunchParam) => void	是	-	-

返回值

类型
void

兼容性

uni-app x 兼容性

HarmonyOS	HarmonyOS UTS 插件
4.61	4.61

uni-app 兼容性

HarmonyOS UTS 插件
4.31

onAppAbilityNewWant(callback)

监听应用EntryAbility生命周期onNewWant

参数

名称	类型	必填	默认值	兼容性	描述
callback	(want: Want, launchParam: AbilityConstant.LaunchParam) => void	是	-	-

返回值

类型
void

兼容性

uni-app x 兼容性

HarmonyOS	HarmonyOS UTS 插件
4.61	4.61

uni-app 兼容性

HarmonyOS UTS 插件
4.31

onAppAbilityShare(callback)

监听应用EntryAbility生命周期onShare

参数

名称	类型	必填	默认值	兼容性	描述
callback	(wantParam: Record<string, any>) => void	是	-	-

返回值

类型
void

兼容性

uni-app x 兼容性

HarmonyOS	HarmonyOS UTS 插件
4.61	4.61

uni-app 兼容性

HarmonyOS UTS 插件
4.31

onAppAbilityWindowStageCreate(callback)

监听应用EntryAbility生命周期onWindowStageCreate

参数

名称	类型	必填	默认值	兼容性	描述
callback	(windowStage: _ohos_window__default.WindowStage) => void	是	-	-

返回值

类型
void

兼容性

uni-app x 兼容性

HarmonyOS	HarmonyOS UTS 插件
4.61	4.61

uni-app 兼容性

HarmonyOS UTS 插件
4.31

onAppThemeChange(callback)

监听应用主题变化

参数

名称	类型	必填	默认值	兼容性	描述
callback	(res: OnAppThemeChangeCallbackResult) => void	是	-	-	应用主题

OnAppThemeChangeCallbackResult 的属性值

名称	类型	必备	默认值	兼容性	描述
appTheme	"dark" | "light"	是	-	-	主题名称

返回值

类型
number

兼容性

uni-app x 兼容性

HarmonyOS	HarmonyOS UTS 插件
4.71	-

uni-app 兼容性

HarmonyOS UTS 插件
4.71

onOsThemeChange(callback)

坚听系统主题变化

参数

名称	类型	必填	默认值	兼容性	描述
callback	(res: OnOsThemeChangeCallbackResult) => void	是	-	-	系统主题变化回调

OnOsThemeChangeCallbackResult 的属性值

名称	类型	必备	默认值	兼容性	描述
osTheme	"dark" | "light"	是	-	-	主题名称

返回值

类型
number

兼容性

uni-app x 兼容性

HarmonyOS	HarmonyOS UTS 插件
4.71	-

uni-app 兼容性

HarmonyOS UTS 插件
4.71

requestSystemPermission(permissions, success?, fail?)

请求系统权限

参数

名称	类型	必填	默认值	兼容性	描述
permissions	string[]	是	-	-	-
success	(allRight: boolean, grantedList: Array<string>) => void	否	-	-	-
fail	(doNotAskAgain: boolean, grantedList: Array<string>) => void	否	-	-	-

返回值

类型
void

兼容性

uni-app x 兼容性

HarmonyOS	HarmonyOS UTS 插件
4.61	4.61

uni-app 兼容性

HarmonyOS UTS 插件
4.31

setAppTheme(appTheme)

设置应用主题

参数

名称	类型	必填	默认值	兼容性	描述
appTheme	AppTheme	是	-	-	应用主题

返回值

类型
void

兼容性

uni-app x 兼容性

HarmonyOS	HarmonyOS UTS 插件
4.71	-

uni-app 兼容性

HarmonyOS UTS 插件
4.71