# API概述

uni-app x项目的uts代码中可以使用很多API。包括:

  • uts的api 详见

  • 全局api,前面不需要加uni.。如getApp

  • uni.xxx的内置api。见左侧

  • uniCloud.xxx的内置api。见左侧

  • dom的api 详见

  • vue的api 详见

  • 原生api

    由于uts可以直接调用Android和iOS的api,所以os和三方sdk的能力都可以在uts中调用。如下:

<script>
	import Build from 'android.os.Build';
	export default {
		onLoad() {
			console.log(Build.MODEL); //调用原生对象,返回手机型号
			console.log(uni.getSystemInfoSync().deviceModel); //调用uni API,返回手机型号。与上一行返回值相同
		}
	}
</script>

上面的示例,在页面启动时打印了2行日志,显示手机型号。

  • uni.getSystemInfoSync,是uni的api
  • import的Build,是Android os的api

可以看出,在uni-app x里,可以直接调用os的能力,不受限制,语法是uts的语法,但需要了解什么功能在原生里是哪个api。

使用uni.getSystemInfoSync则比较简单,看uni的文档即可,且可跨平台。

其实,uni.getSystemInfoSync 的内部实现就是一个uts模块,底层使用了一样的代码,也是import了android.os.Build。

大多数uni.的api,都是uts开发的,它们会陆续开源在uni-api

插件市场也有很多做好的uts插件,方便开发者拿来即用。uts插件

虽然上述页面可以直接调用原生能力,但一般原生能力建议封装为uni_modules形式的uts插件。这样方便共享、方便跨平台。

uni-app x 中不再支持plus和weex的API。过于plus api中一些常用的api,在uni-app x中进行了替换增补。

  • plus.runtime.quit => uni.exit
  • plus.runtime.install => uni.installApk
  • plus.runtime.openURL 暂未封装API,但可以直接使用如下代码调用。
<template>
	<view>
		<button @click="openSchema('https://uniapp.dcloud.io/uni-app-x')">使用浏览器打开指定URL</button>
		<button @click="openSchema('market://details?id=com.tencent.mm')">使用应用商店打开指定App</button>
	</view>
</template>
<script>
	import Intent from 'android.content.Intent';
	import Uri from 'android.net.Uri';
	export default {
		data() {
			return {}
		},
		methods: {
			openSchema(url : string) {
				const context = UTSAndroid.getUniActivity()!;
				const uri = Uri.parse(url)
				const intent = new Intent(Intent.ACTION_VIEW, uri)
				intent.setData(uri);
				context.startActivity(intent);
			}
		}
	}
</script>
On This Page