UTSiOS

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

静态方法

destroyInstance()

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

参数

名称	类型	必填	描述
obj	AnyObject	是	要销毁的对象。

返回值

类型
void

兼容性 ^?

uni-app x 兼容性 ^?

iOS	iOS UTS 插件
x	4.25

uni-app 兼容性 ^?

iOS UTS 插件
√

colorWithString(value)

获取指定的颜色。

参数

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

返回值

类型	描述
UIColor	UIColor 实例对象，转换失败则返回黑色

兼容性 ^?

uni-app x 兼容性 ^?

iOS	iOS UTS 插件
x	4.11

uni-app 兼容性 ^?

iOS UTS 插件
√

convert2AbsFullPath()

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

参数

名称	类型	必填	描述
inputPath	string	是	待转换的文件相对路径

返回值

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

兼容性 ^?

uni-app x 兼容性 ^?

iOS	iOS UTS 插件
x	4.11

uni-app 兼容性 ^?

iOS UTS 插件
√

getAppId()

获取当前运行的app的AppId。

返回值

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

兼容性 ^?

uni-app x 兼容性 ^?

iOS	iOS UTS 插件
x	4.11

uni-app 兼容性 ^?

iOS UTS 插件
√

getAppName()

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

返回值

类型	描述
string	应用名称。

兼容性 ^?

uni-app x 兼容性 ^?

iOS	iOS UTS 插件
x	4.11

uni-app 兼容性 ^?

iOS UTS 插件
√

getAppTheme()

获取App当前主题。

返回值

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

兼容性 ^?

uni-app x 兼容性 ^?

iOS	iOS UTS 插件
x	4.18

uni-app 兼容性 ^?

iOS UTS 插件
√

getAppVersion()

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

返回值

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

兼容性 ^?

uni-app x 兼容性 ^?

iOS	iOS UTS 插件
x	4.11

uni-app 兼容性 ^?

iOS UTS 插件
√

getAppVersionCode()

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

返回值

类型	描述
string	应用版本号。

兼容性 ^?

uni-app x 兼容性 ^?

iOS	iOS UTS 插件
x	4.11

uni-app 兼容性 ^?

iOS UTS 插件
√

getAppWgtVersion()

获取应用资源（wgt）的版本名称。

返回值

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

兼容性 ^?

uni-app x 兼容性 ^?

iOS	iOS UTS 插件
x	4.11

uni-app 兼容性 ^?

iOS UTS 插件
√

getCurrentViewController()

获取当前 app 显示的 UIViewController。

返回值

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

兼容性 ^?

uni-app x 兼容性 ^?

iOS	iOS UTS 插件
x	4.11

uni-app 兼容性 ^?

iOS UTS 插件
√

getDataPath()

获取当前运行app的dataPath

返回值

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

兼容性 ^?

uni-app x 兼容性 ^?

iOS	iOS UTS 插件
x	4.11

uni-app 兼容性 ^?

iOS UTS 插件
√

getDeviceId()

获取设备 deviceId。

返回值

类型	描述
string	当前设备的 deviceId

兼容性 ^?

uni-app x 兼容性 ^?

iOS	iOS UTS 插件
x	4.11

uni-app 兼容性 ^?

iOS UTS 插件
√

getInnerVersion()

获取引擎版本号。

返回值

类型	描述
string	引擎版本号。

兼容性 ^?

uni-app x 兼容性 ^?

iOS	iOS UTS 插件
x	4.11

uni-app 兼容性 ^?

iOS UTS 插件
√

getModel()

获取设备型号。

返回值

类型
string

兼容性 ^?

uni-app x 兼容性 ^?

iOS	iOS UTS 插件
x	4.11

uni-app 兼容性 ^?

iOS UTS 插件
√

getKeyWindow()

获取当前app的keyWindow。

返回值

类型	描述
UIWindow	当前app的keyWindow.

兼容性 ^?

uni-app x 兼容性 ^?

iOS	iOS UTS 插件
x	4.11

uni-app 兼容性 ^?

iOS UTS 插件
√

getOsLanguage()

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

返回值

类型	描述
string	os language。

兼容性 ^?

uni-app x 兼容性 ^?

iOS	iOS UTS 插件
x	4.11

uni-app 兼容性 ^?

iOS UTS 插件
√

getResourcePath(resourceName)

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

参数

名称	类型	必填	描述
resourceName	string	是	资源文件相对于项目的绝对路径, 如：“/static/logo.png”

返回值

类型	描述
string	该资源在原生平台的路径

兼容性 ^?

uni-app x 兼容性 ^?

iOS	iOS UTS 插件
x	4.11

uni-app 兼容性 ^?

iOS UTS 插件
√

getSystemSetting()

获取系统设置信息。

返回值

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

兼容性 ^?

uni-app x 兼容性 ^?

iOS	iOS UTS 插件
x	4.11

uni-app 兼容性 ^?

iOS UTS 插件
√

getUserAgent()

获取当前应用的 UserAgent。

返回值

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

兼容性 ^?

uni-app x 兼容性 ^?

iOS	iOS UTS 插件
x	4.11

uni-app 兼容性 ^?

iOS UTS 插件
√

isSimulator()

是否是模拟器。

返回值

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

兼容性 ^?

uni-app x 兼容性 ^?

iOS	iOS UTS 插件
x	4.11

uni-app 兼容性 ^?

iOS UTS 插件
√

isUniMp()

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

返回值

类型	描述
boolean	是否是unimp。

兼容性 ^?

uni-app x 兼容性 ^?

iOS	iOS UTS 插件
x	4.11

uni-app 兼容性 ^?

iOS UTS 插件
√