# UTSiOS

app-iOS平台专有内置对象。在uni-app和uni-app x的uts环境中均可使用。

# 静态方法

# getCurrentViewController()

获取当前 app 显示的 UIViewController。

返回值

类型 描述
UIViewController 当前 app 显示的 UIViewController

兼容性

iOS uni-app x iOS uni-app
4.11

# getKeyWindow()

获取当前app的keyWindow。

返回值

类型 描述
UIWindow 当前app的keyWindow.

兼容性

iOS uni-app x iOS uni-app
4.11

# colorWithString(value)

获取指定的颜色。

参数

名称 类型 必填 默认值 兼容性 描述
value string - - 需要转换的代表色值的字符串,支持一下格式:精简写法的十六进制 如:#f00,十六进制 如:#ff0000,RGB 如:rgb(255, 0, 0),RGBA 如:rgba(255, 0, 0, 0.5),色值关键字,如: red

返回值

类型 描述
UIColor UIColor 实例对象 注:如转换失败 默认会返回 黑色

兼容性

iOS uni-app x iOS uni-app
4.11

# getResourcePath(resourceName)

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

参数

名称 类型 必填 默认值 兼容性 描述
resourceName string - - H5资源文件相对于工程的绝对路径, 如:“/static/logo.png”

返回值

类型 描述
string 该资源在原生目录下的路径

兼容性

iOS uni-app x iOS uni-app
4.11

# getUserAgent()

获取当前应用的 UserAgent。

返回值

类型 描述
string 当前应用的 UserAgent。

兼容性

iOS uni-app x iOS uni-app
4.11

# getDataPath()

获取当前运行app的dataPath

返回值

类型 描述
string 当前运行app的dataPath。

兼容性

iOS uni-app x iOS uni-app
4.11

# convert2AbsFullPath()

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

参数

名称 类型 必填 默认值 兼容性 描述
inputPath string - - 待转换的文件相对路径

返回值

类型 描述
string 转换后文件绝对路径

兼容性

iOS uni-app x iOS uni-app
4.11 4.11

# destroyInstance()

销毁指定的原生实例对象。

参数

名称 类型 必填 默认值 兼容性 描述
obj AnyObject - - 要销毁的对象。

返回值

类型
void

兼容性

iOS uni-app x iOS uni-app
4.25 4.25

# isSimulator()

是否是模拟器。

返回值

类型 描述
boolean 当前是模拟器 true, 当前是真机:false

兼容性

iOS uni-app x iOS uni-app
4.11

# getDeviceId()

获取设备 deviceId。

返回值

类型 描述
string 当前设备的 deviceId

兼容性

iOS uni-app x iOS uni-app
4.11

# getModel()

获取设备型号。

返回值

类型
string

兼容性

iOS uni-app x iOS uni-app
4.11

# getAppId()

获取当前运行的app的AppId。

返回值

类型 描述
string 当前运行的app的AppId。

兼容性

iOS uni-app x iOS uni-app
4.11

# isUniMp()

获取当前运行环境是否是unimp。

返回值

类型 描述
boolean 是否是unimp。

兼容性

iOS uni-app x iOS uni-app
4.11

# getAppName()

获取manifest.json 中配置的应用名称

返回值

类型 描述
string 应用名称。

兼容性

iOS uni-app x iOS uni-app
4.11

# getAppVersion()

获取manifest.json 中配置的应用版本名称。

返回值

类型 描述
string 应用版本名称。

兼容性

iOS uni-app x iOS uni-app
4.11

# getAppVersionCode()

获取manifest.json 中配置的应用版本号。

返回值

类型 描述
string 应用版本号。

兼容性

iOS uni-app x iOS uni-app
4.11

# getOsLanguage()

获取操作系统设置的语言。

返回值

类型 描述
string os language。

兼容性

iOS uni-app x iOS uni-app
4.11

# getAppWgtVersion()

获取应用资源(wgt)的版本名称。

返回值

类型 描述
string 应用资源(wgt)的版本名称。

兼容性

iOS uni-app x iOS uni-app
4.11

# getInnerVersion()

获取引擎版本号。

返回值

类型 描述
string 引擎版本号。

兼容性

iOS uni-app x iOS uni-app
4.11

# getSystemSetting()

获取系统设置信息。

返回值

类型 描述
Map<string, any> 系统设置信息。

兼容性

iOS uni-app x iOS uni-app
4.11

# getOsTheme()

获取系统当前主题。

返回值

类型 描述
string 系统当前主题信息。

兼容性

iOS uni-app x iOS uni-app
4.18

# onOsThemeChange(callback)

监听系统主题变化(需要调用取消监听避免内存泄露)。

参数

名称 类型 必填 默认值 兼容性 描述
callback (theme: string) => void - - 监听函数

返回值

类型 描述
number 监听id。

兼容性

iOS uni-app x iOS uni-app
4.18

# offOsThemeChange(callbackId)

取消监听系统主题变化。

参数

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

返回值

类型
void

兼容性

iOS uni-app x iOS uni-app
4.18

# getAppTheme()

获取App当前主题。

返回值

类型 描述
string App当前主题信息。

兼容性

iOS uni-app x iOS uni-app
4.18

# setAppTheme(theme)

设置App当前主题。

参数

名称 类型 必填 默认值 兼容性 描述
theme string - - 要设置的主题信息

返回值

类型 描述
void App当前主题信息。

兼容性

iOS uni-app x iOS uni-app
4.18

# onAppThemeChange(callback)

监听app theme变化(需要调用取消监听避免内存泄露)。

参数

名称 类型 必填 默认值 兼容性 描述
callback (theme: string) => void - - 监听函数

返回值

类型 描述
number 监听id。

兼容性

iOS uni-app x iOS uni-app
4.18

# offAppThemeChange(callbackId)

取消监听app theme变化。

参数

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

返回值

类型
void

兼容性

iOS uni-app x iOS uni-app
4.18