From c198c2a9476aaade0a979fafed47c5f6a051b483 Mon Sep 17 00:00:00 2001
From: DCloud_LXH <283700113@qq.com>
Date: Tue, 19 Dec 2023 18:50:54 +0800
Subject: [PATCH] =?UTF-8?q?feat:=20uts=20=E6=8F=92=E4=BB=B6?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 docs/plugin/_sidebar.md          |   12 +-
 docs/plugin/uts-component.md     | 1666 ++++++++++++++++++++++++++++++
 docs/plugin/uts-for-android.md   | 1483 ++++++++++++++++++++++++++
 docs/plugin/uts-for-ios.md       |  844 +++++++++++++++
 docs/plugin/uts-ios-cocoapods.md |  293 ++++++
 docs/plugin/uts-plugin.md        | 1140 ++++++++++++++++++++
 docs/plugin/uts-uni-api.md       |  102 ++
 7 files changed, 5534 insertions(+), 6 deletions(-)
 create mode 100644 docs/plugin/uts-component.md
 create mode 100644 docs/plugin/uts-for-android.md
 create mode 100644 docs/plugin/uts-for-ios.md
 create mode 100644 docs/plugin/uts-ios-cocoapods.md
 create mode 100644 docs/plugin/uts-plugin.md
 create mode 100644 docs/plugin/uts-uni-api.md

diff --git a/docs/plugin/_sidebar.md b/docs/plugin/_sidebar.md
index e51ec602..ada5b42b 100644
--- a/docs/plugin/_sidebar.md
+++ b/docs/plugin/_sidebar.md
@@ -2,10 +2,10 @@
 * [插件市场介绍](https://uniapp.dcloud.net.cn/plugin/plugin-ext-introduction.html)
 * [uni_modules](https://uniapp.dcloud.net.cn/plugin/uni_modules.html)
 * uts插件
-  * [uts插件开发入门](https://uniapp.dcloud.net.cn/plugin/uts-plugin.html)
-  * [uts页面组件开发入门](https://uniapp.dcloud.net.cn/plugin/uts-component.html)
-  * [uts中使用uni api](https://uniapp.dcloud.net.cn/plugin/uts-uni-api.html)
-  * [Android平台uts开发指南](https://uniapp.dcloud.net.cn/plugin/uts-for-android.html)
-  * [iOS平台uts开发指南](https://uniapp.dcloud.net.cn/plugin/uts-for-ios.html)
-  * [使用CocoaPods依赖](https://uniapp.dcloud.net.cn/plugin/uts-ios-cocoapods.html)
+  * [uts插件开发入门](uts-plugin.md)
+  * [uts页面组件开发入门](uts-component.md)
+  * [uts中使用uni api](uts-uni-api.md)
+  * [Android平台uts开发指南](uts-for-android.md)
+  * [iOS平台uts开发指南](uts-for-ios.md)
+	* [使用CocoaPods依赖](uts-ios-cocoapods.md)
 * [插件作者专区](https://uniapp.dcloud.net.cn/plugin/publish.html)
diff --git a/docs/plugin/uts-component.md b/docs/plugin/uts-component.md
new file mode 100644
index 00000000..55ab656d
--- /dev/null
+++ b/docs/plugin/uts-component.md
@@ -0,0 +1,1666 @@
+# UTS 组件开发
+
+> 需HBuilderX 3.6.18 及之后版本
+
+> app平台目前支持nvue/uvue，暂不支持vue
+
+UTS组件，是UTS插件的一个分支。UTS插件提供了原生API的扩展，而UTS组件提供了原生UI组件的开发模式。
+
+组件是一种独立，可复用的UI单元，用于单独封装和承担一定的代码逻辑。
+
+组件与插件的区别在于：前者以标签的形式，对外提供UI封装；后者则只提供API，虽然API可能涉及UI，但仍然是API，无法以标签方式在页面模板中引用。
+
+比如`<video>`是组件；`uni.showModal` 或 `uni.chooseVideo` 虽然有UI，但属于API。
+
+组件一般适用于封装非全屏的场景，即在页面中内嵌一个区域。如果需要你需要封装的UI是全屏界面，那没必要使用组件，通过UTS开发原生页面更简单。 [UTS开发原生页面示例](https://gitcode.net/dcloud/hello-uts/-/tree/master/uni_modules/uts-nativepage)
+
+当然UTS组件是多端的，一个UTS组件作为一个`uni_modules`，可同时支持app-Android、app-iOS、web、以及各家小程序组件。
+
+本文重点在于讲述如何在app-android和app-ios上，将一个原生UI封装为UTS组件，供使用者在页面template中以组件的方式调用。
+
+## 前置条件
+
+继续阅读文档前，开发者需要了解以下前置条件：
+
+- 了解 [uts语法](/uts/) 和 [uts原生插件](uts-plugin.md)
+- 了解 [Vue组件](../tutorial/vue3-components.md)
+
+
+## UTS组件简介
+
+#### 为什么使用UTS开发组件
+
+UTS组件，即：使用UTS语言在uni平台进行组件开发的技术。
+
+UTS组件的优势在于，它秉承了UTS的跨平台特性，统一的UTS语法，各终端不同的原生产出物。
+
+在Android平台会被编译渲染为Android原生View实例，IOS或其他终端平台也是如此。
+
+
+|				|uts组件					|uni原生组件				|Vue组件				|
+|:------		|:--------				|:-------- 				|:-------			|
+|开发语言		|uts					|java/object-c			|js/ts				|
+|组件载体		|App平台为系统原生View对象		|系统原生View对象		|WebView内部标签		|
+
+
+为了统一开发规范、降低使用门槛，UTS原生组件采用了Vue组件的语法，但会根据实际情况略有定制。
+
+即，您可以像写vue组件一样，使用uts语言来写一个UTS组件。
+
+## UTS组件结构解析
+
+
+#### UTS组件目录结构
+
+
+<pre v-pre="" data-lang="">
+	<code class="lang-" style="padding:0">
+┌─common                          // 可跨端公用的uts代码。推荐，不强制
+├─static                          // 静态资源
+├─utssdk
+│	├─app-android                 //Android平台目录
+│	│	├─assets                  //Android原生assets资源目录，可选
+│	│	├─libs                    //Android原生库目录，可选
+│	│	├─res                     //Android原生res资源目录，可选
+│	│	├─AndroidManifest.xml     //Android原生应用清单文件，可选
+│	│	├─config.json             //Android原生配置文件
+│	│	├─index.uts               //Android原生插件能力实现，可选
+|	|	└─index.vue               //Android原生组件能力实现，必选
+│	├─app-ios                     //iOS平台目录
+│	│	├─Frameworks              //iOS原生依赖的第三方 framework 依赖库存放目录，可选
+│	│	├─Resources               //iOS原生所依赖的资源文件存放目录，可选
+│	│	├─info.plist              //iOS原生所需要添加到主 info.plist 文件中的配置文件，可选
+│	│	├─UTS.entitlements        //iOS原生所需要添加到主工程 .entitlements 文件中的配置文件，可选
+│	│	├─config.json             //iOS原生配置文件
+│	│	├─index.uts               //iOS原生插件能力实现，可选
+|	|	└─index.vue               //iOS原生组件能力实现，必选
+│	├─web                         //web平台目录
+│	│	└─index.uts
+│	├─mp-alipay                   // 支付宝小程序平台，可选
+│	├─mp-baidu                    // 百度小程序平台，可选
+│	├─mp-jd                       // 京东小程序平台（仅限vue2），可选
+│	├─mp-kuaishou                 // 快手小程序平台，可选
+│	├─mp-lark                     // 飞书小程序平台，可选
+│	├─mp-qq                       // QQ小程序平台，可选
+│	├─mp-toutiao                  // 抖音小程序平台，可选
+│	├─mp-weixin                   // 微信小程序平台，可选
+│	├─mp-xhs                      // 小红书小程序平台（仅限vue2），可选
+│	└─index.uts                   // 跨平台插件能力实现，可选
+└─package.json                    // 插件清单文件
+</code>
+</pre>
+
+
+如上所示，UTS组件的目录结构与UTS插件基本相同
+
+唯一的差别在于，UTS组件入口文件有两个:
+
++ 必选的index.vue 组件入口
+
++ 可选的index.uts 函数能力入口
+
+
+用户如果在开发组件的同时，存在一些与组件无关的能力需要对外暴露，可以在index.uts中进行实现
+
+大多数情况下，我们只需要开发一个index.vue 即可，如果存在多个组件，可以新建多个 xxx.vue文件
+
+关于 index.vue 源码如何编写，我们会在下一个章节介绍
+
+
+
+#### index.vue源码结构
+
+
+下面是一个组件源码 index.vue 完整示例：
+
+**注意**
+
+- 目前UTS组件仅支持`export default {}`的选项式API，vue3的组合式API暂未支持。
+
+::: preview
+
+> Android
+
+```ts
+
+<template>
+	<view >
+
+	</view>
+</template>
+<script lang="uts">
+	import TextUtils from 'android.text.TextUtils'
+	import Button from 'android.widget.Button'
+	import LinearLayout from 'android.widget.LinearLayout'
+	import View from 'android.view.View'
+
+	class ButtonClickListsner extends View.OnClickListener {
+		constructor() {
+			super()
+		}
+		override onClick(v ? : View) {
+			console.log(v)
+		}
+	}
+
+	//原生提供以下属性或方法的实现
+	export default {
+		/**
+		 * 组件名称，也就是开发者使用的标签
+		 */
+		name: "uts-hello-view",
+		/**
+		 * 组件涉及的事件声明，只有声明过的事件，才能被正常发送
+		 */
+		emits: ['buttonClick'],
+		/**
+		 * 属性声明，组件的使用者会传递这些属性值到组件
+		 */
+		props: {
+			/**
+			 * 字符串类型 属性：buttonText  需要设置默认值
+			 */
+			"buttonText": {
+				type: String,
+				default: "点击触发"
+			}
+		},
+		/**
+		 * 组件内部变量声明
+		 */
+		data() {
+			return {}
+		},
+		/**
+		 * 属性变化监听器实现
+		 */
+		watch: {
+			"buttonText": {
+				/**
+				 * 这里监听属性变化，并进行组件内部更新
+				 */
+				handler(newButtonText: string) {
+					if (this.$el != null) {
+						let button = this.$el!.findViewWithTag("centerButton") as Button
+						if (!TextUtils.isEmpty(newButtonText)) {
+							button.setText(newButtonText)
+						}
+					}
+				},
+				immediate: false //创建时是否通过此方法更新属性，默认值为false
+			},
+		},
+		/**
+		 * 规则：如果没有配置expose，则methods中的方法均对外暴露，如果配置了expose，则以expose的配置为准向外暴露
+		 * ['publicMethod'] 含义为：只有 `publicMethod` 在实例上可用
+		 */
+		expose: ['doSth'],
+		methods: {
+			/**
+			 * 对外公开的组件方法
+			 */
+			doSth(paramA: string) {
+				// 这是组件的自定义方法
+				console.log("paramA",paramA)
+			},
+			/**
+			 * 内部使用的组件方法
+			 */
+			privateMethod() {
+
+			}
+		},
+
+		/**
+		 * 组件被创建，组件第一个生命周期，
+		 * 在内存中被占用的时候被调用，开发者可以在这里执行一些需要提前执行的初始化逻辑
+		 * [可选实现]
+		 */
+		created() {
+
+		},
+		/**
+		 * 对应平台的view载体即将被创建，对应前端beforeMount
+		 * [可选实现]
+		 */
+		NVBeforeLoad() {
+
+		},
+		/**
+		 * 创建原生View，必须定义返回值类型
+		 * 开发者需要重点实现这个函数，声明原生组件被创建出来的过程，以及最终生成的原生组件类型
+		 * （Android需要明确知道View类型，需特殊校验）
+		 * todo 补充IOS平台限制
+	  * [必须实现]
+		 */
+		NVLoad(): LinearLayout {
+			//必须实现
+			let contentLayout = new LinearLayout(this.$androidContext!)
+			let button = new Button(this.$androidContext!)
+			button.setText("点击触发");
+			button.setTag("centerButton");
+			contentLayout.addView(button, new LinearLayout.LayoutParams(500, 500));
+			button.setOnClickListener(new ButtonClickListsner())
+			return contentLayout
+		},
+
+		/**
+		 * 原生View已创建
+		 * [可选实现]
+		 */
+		NVLoaded() {
+
+		},
+		/**
+		 * 原生View布局完成
+		 * [可选实现]
+		 */
+		NVLayouted() {
+
+		},
+		/**
+		 * 原生View将释放
+		 * [可选实现]
+		 */
+		NVBeforeUnload() {},
+		/**
+		 * 原生View已释放，这里可以做释放View之后的操作
+		 * [可选实现]
+		 */
+		NVUnloaded() {
+
+		},
+		/**
+		 * 组件销毁
+		 * [可选实现]
+		 */
+		unmounted() {},
+		/**
+		 * 自定组件布局尺寸
+		 * [可选实现]
+		 */
+		NVMeasure(size: UTSSize): UTSSize {
+			size.width = 120.0.toFloat()
+			size.height = 800.0.toFloat()
+			return size
+		}
+	}
+</script>
+<style>
+
+</style>
+
+
+```
+
+> iOS
+
+```ts
+<template>
+	<view class="defaultStyles">
+	</view>
+</template>
+<script lang="uts">
+	import {
+		UIButton
+	} from "UIKit"
+
+	// 定义按钮点击后触发回调的类
+	class ButtonClickListsner {
+		// 按钮点击回调方法
+		@objc buttonClick() {
+			console.log("按钮被点击")
+		}
+	}
+
+	//原生提供以下属性或方法的实现
+	export default {
+		/**
+		 * 组件名称，也就是开发者使用的标签
+		 */
+		name: "uts-hello-view",
+		/**
+		 * 组件涉及的事件声明，只有声明过的事件，才能被正常发送
+		 */
+		emits: ['buttonClick'],
+		/**
+		 * 属性声明，组件的使用者会传递这些属性值到组件
+		 */
+		props: {
+			/**
+			 * 字符串类型 属性：buttonText  需要设置默认值
+			 */
+			"buttonText": {
+				type: String,
+				default: "点击触发"
+			}
+		},
+		/**
+		 * 组件内部变量声明
+		 */
+		data() {
+			return {}
+		},
+		/**
+		 * 属性变化监听器实现
+		 */
+		watch: {
+			"buttonText": {
+				/**
+				 * 这里监听属性变化，并进行组件内部更新
+				 */
+				handler(newButtonText: string, oldButtonText) {
+					this.$el.setTitle(newButtonText, for = UIControl.State.normal)
+				},
+				immediate: false //创建时是否通过此方法更新属性，默认值为false
+			},
+		},
+		/**
+		 * 规则：如果没有配置expose，则methods中的方法均对外暴露，如果配置了expose，则以expose的配置为准向外暴露
+		 * ['publicMethod'] 含义为：只有 `publicMethod` 在实例上可用
+		 */
+		expose: ['doSth'],
+		methods: {
+			/**
+			 * 对外公开的组件方法
+			 */
+			doSth(paramA: string) {
+				// 这是组件的自定义方法
+				console.log("paramA")
+			},
+			/**
+			 * 内部使用的组件方法
+			 */
+		},
+
+
+		/**
+		 * 组件被创建，组件第一个生命周期，
+		 * 在内存中被占用的时候被调用，开发者可以在这里执行一些需要提前执行的初始化逻辑
+		 * [可选实现]
+		 */
+		created() {
+
+		},
+		/**
+		 * 对应平台的view载体即将被创建，对应前端beforeMount
+		 * [可选实现]
+		 */
+		NVBeforeLoad() {
+
+		},
+		/**
+		 * 创建原生View，必须定义返回值类型
+		 * 开发者需要重点实现这个函数，声明原生组件被创建出来的过程，以及最终生成的原生组件类型
+		 * [必须实现]
+		 */
+		NVLoad(): UIButton {
+			//必须实现
+			let button = new UIButton()
+			button.setTitle(this.buttonText, for = UIControl.State.normal)
+			const target = new ButtonClickListsner()
+			const method = Selector("buttonClick")
+			button.addTarget(target, action = method, for = UIControl.Event.touchUpInside)
+			return button
+		},
+
+		/**
+		 * 原生View已创建
+		 * [可选实现]
+		 */
+		NVLoaded() {
+
+		},
+		/**
+		 * 原生View布局完成
+		 * [可选实现]
+		 */
+		NVLayouted() {
+
+		},
+		/**
+		 * 原生View将释放
+		 * [可选实现]
+		 */
+		NVBeforeUnload() {},
+		/**
+		 * 原生View已释放，这里可以做释放View之后的操作
+		 * [可选实现]
+		 */
+		NVUnloaded() {
+
+		},
+		/**
+		 * 组件销毁
+		 * [可选实现]
+		 */
+		unmounted() {}
+		/**
+		 * 自定组件布局尺寸
+		 * [可选实现]
+		 */
+		NVMeasure(size: UTSSize): UTSSize {
+			return new UTSSize(120, 45);
+		}
+	}
+</script>
+```
+
+:::
+
+index.vue 要素可以分为以下几类：
+
++ 配置：
+
+	name：组件的使用标签，可以省略，若省略则默认为组件名称
+
+	emits：组件允许的消息事件名称，如果没有组件消息，不需要配置
+
++ 属性：
+
+	props：需要由组件的使用者提供，比如一个Image组件，会需要一个path属性作为图像路径来源
+
+	watch：属性的监听实现，用来监听属性数据更新。
+
++ 数据：
+
+	data：组件内部数据定义，用于组件内部逻辑处理，不对外暴露
+
++ 方法：
+
+	methods：组件方法定义，可以通过与expose组合使用，区分对内方法和对外方法
+
+	expose：与methods 字段配合使用，用以区分组件对内方法和对外方法
+
+
++ 生命周期：
+
+	组件需要重点处理 内存创建/销毁，View载体创建/销毁 过程中的资源管理，具体参考生命周期章节
+
++ 内置对象：
+
+	为了方便组件开发者，UTS组件内置了部分变量与函数，具体参考内置对象与函数章节
+
+
+#### 生命周期
+
+组件开发者需要重点关注组件的生命周期，以便进行资源的初始化和回收
+
+```mermaid
+graph TD;
+		Create-->NVBeforeLoad;
+	subgraph View生命周期
+		NVBeforeLoad-->NVLoad;
+		NVLoad-->NVLoaded;
+		NVLoaded-->NVLayouted;
+		NVLayouted-->NVBeforeUnload;
+	end
+		NVBeforeUnload-->unmounted;
+
+```
+
+|函数名			|描述				|建议行为		|是否可选	|
+|:----			|:---				|:---			|:---		|
+|created		|组件在内存中被创建	|开发者可以在这里执行一些需要最早执行的初始化逻辑|可选|
+|NVBeforeLoad	|组件对应平台的view载体，即将被创建|开发者可以在这里执行一些需要在View创建前初始化的逻辑|可选|
+|NVLoad			|组件view载体正在被创建实现|开发者需要重点实现这个函数，声明原生组件被创建出来的过程，以及最终生成的原生组件类型|必须实现|
+|NVLayouted		|组件对应平台的view载体已布局结束	|需要在view布局结束后执行的逻辑	|可选|
+|NVBeforeUnload	|view载体即将被卸载				|View卸载前，需要回收资源的逻辑	|可选|
+|NVUnloaded		|view载体已经被卸载				|View卸载后，需要回收资源的逻辑	|可选|
+|unmounted		|组件在内存被销毁				|资源回收逻辑					|可选|
+
+
+除上述生命周期外，还存在下列可选周期函数：
+
++ NVMeasure
+
+NVMeasure 用于告诉排版系统，组件自身需要的宽高，具体的调用时机由排版系统决定。
+
+一般情况下，组件的宽高应该是由终端系统的排版引擎决定，组件开发者不需要实现此函数。
+
+但是部分场景下，组件开发者需要自己维护宽高，则需要开发者重写此函数
+
+
++ NVUpdateStyles
+
+需要HBuilder X 3.96版本
+
+NVUpdateStyles 用来监听组件的外部style 变化，通常用来写响应外部的css样式变化从而动态更新组件内部状态场景
+
+我们可以在组件内部这样实现:
+
+```uts
+NVUpdateStyles(styles: Map<String, any>){
+	console.log("NVUpdateStyles",styles)
+}
+```
+
+
+
+
+**注意：只有非容器组件生效，容器组件不应该重写此函数**
+
+[vue3 生命周期暂不支持](https://uniapp.dcloud.net.cn/tutorial/vue3-api.html#%E9%80%89%E9%A1%B9-%E7%94%9F%E5%91%BD%E5%91%A8%E6%9C%9F%E9%92%A9%E5%AD%90)
+
+
+#### 内置对象和函数
+
+为了方便组件开发者使用，UTS 组件内部内置了下列对象：
+
+|变量名			|类型		|简介				|平台限制	|方法&属性	|
+|:-------		|:--------	|:--------			|:---		|:---			|
+|$el			|对象		|当前View实例对象	|全部平台	|开发者在NVLoad返回的对象类型|
+|$androidContext|对象		|当前组件上下文(可为空)		|仅android	|android平台对应Context对象|
+|$emit("event",Any)|函数		|发送已注册的事件	|全部平台	|$emit(事件名称-必选,事件参数可选)|
+
+
+#### 通用事件
+
+对于UTS组件来说，除了通过 $emit/emits 函数来自定义组件事件外，UTS组件还内置了下列通用事件：
+
+
+|事件名称			|简介
+|:-------			|:--------
+|click				|组件点击事件响应
+|longpress			|组件长按事件响应
+
+
+通用事件，组件的使用者无需实现，直接使用
+
+```html
+<uts-hello-view buttonClick="自定义事件处理函数" click="通用点击事件处理函数" longpress="通用长按事件处理函数"/>
+```
+
+
+## 简单View的示例
+
+
+本章节以 一个极简的组件开发为例，介绍说明UTS组件开发流程
+
+
+#### 创建插件
+
+在HBuilder X 中选中Uni-App项目下 uni_modules目录,右键选择新建`uni_modules插件`
+
+![创建界面](https://native-res.dcloud.net.cn/images/uts/component/image0.png)
+
+
+这是创建后的目录结构
+
+![目录结构](https://native-res.dcloud.net.cn/images/uts/component/image1.jpg)
+
+
+#### 编写逻辑
+
+打开index.vue，键入下面的组件源码:
+
+::: preview
+
+> Android
+
+```html
+
+<template>
+	<view >
+
+	</view>
+</template>
+<script lang="uts">
+	import TextUtils from 'android.text.TextUtils'
+	import Button from 'android.widget.Button'
+	import LinearLayout from 'android.widget.LinearLayout'
+	import View from 'android.view.View'
+
+	class ButtonClickListsner extends View.OnClickListener {
+		constructor() {
+			super()
+		}
+		override onClick(v ? : View) {
+			console.log(v)
+		}
+	}
+
+	//原生提供以下属性或方法的实现  
+	export default {
+		/**
+		 * 组件名称，也就是开发者使用的标签
+		 */
+		name: "uts-hello-view",
+		/**
+		 * 组件涉及的事件声明，只有声明过的事件，才能被正常发送
+		 */
+		emits: ['buttonClick'],
+		/**
+		 * 属性声明，组件的使用者会传递这些属性值到组件
+		 */
+		props: {
+			/**
+			 * 字符串类型 属性：buttonText  需要设置默认值
+			 */
+			"buttonText": {
+				type: String,
+				default: "点击触发"
+			}
+		},
+		/**
+		 * 组件内部变量声明
+		 */
+		data() {
+			return {}
+		},
+		/**
+		 * 属性变化监听器实现
+		 */
+		watch: {
+			"buttonText": {
+				/**
+				 * 这里监听属性变化，并进行组件内部更新
+				 */
+				handler(newButtonText: string) {
+					if (this.$el != null) {
+						let button = this.$el!.findViewWithTag("centerButton") as Button
+						if (!TextUtils.isEmpty(newButtonText)) {
+							button.setText(newButtonText)
+						}
+					}
+				},
+				immediate: false //创建时是否通过此方法更新属性，默认值为false  
+			},
+		},
+		/**
+		 * 规则：如果没有配置expose，则methods中的方法均对外暴露，如果配置了expose，则以expose的配置为准向外暴露
+		 * ['publicMethod'] 含义为：只有 `publicMethod` 在实例上可用
+		 */
+		expose: ['doSth'],
+		methods: {
+			/**
+			 * 对外公开的组件方法
+			 */
+			doSth(paramA: string) {
+				// 这是组件的自定义方法
+				console.log("paramA",paramA)
+			},
+			/**
+			 * 内部使用的组件方法
+			 */
+			privateMethod() {
+
+			}
+		},
+
+		/**
+		 * 组件被创建，组件第一个生命周期，
+		 * 在内存中被占用的时候被调用，开发者可以在这里执行一些需要提前执行的初始化逻辑
+		 * [可选实现]
+		 */
+		created() {
+
+		},
+		/**
+		 * 对应平台的view载体即将被创建，对应前端beforeMount  
+		 * [可选实现]
+		 */
+		NVBeforeLoad() {
+
+		},
+		/**
+		 * 创建原生View，必须定义返回值类型
+		 * 开发者需要重点实现这个函数，声明原生组件被创建出来的过程，以及最终生成的原生组件类型
+		 * （Android需要明确知道View类型，需特殊校验） 
+		 * todo 补充IOS平台限制
+	  * [必须实现]
+		 */
+		NVLoad(): LinearLayout {
+			//必须实现  
+			let contentLayout = new LinearLayout(this.$androidContext)
+			let button = new Button(this.$androidContext)
+			button.setText("点击触发");
+			button.setTag("centerButton");
+			contentLayout.addView(button, new LinearLayout.LayoutParams(500, 500));
+			button.setOnClickListener(new ButtonClickListsner())
+			return contentLayout
+		}
+
+		
+	}
+</script>
+<style>
+	
+</style>
+
+```
+
+> iOS
+
+```html
+<template>
+	<view class="defaultStyles">
+	</view>
+</template>
+<script lang="uts">
+	import {
+		UIButton,
+		UIControl
+	} from "UIKit"
+
+	// 定义按钮点击后触发回调的类
+	class ButtonClickListsner {
+		// 按钮点击回调方法
+		@objc buttonClick() {
+			console.log("按钮被点击")
+		}
+	}
+
+	//原生提供以下属性或方法的实现
+	export default {
+		name: "uts-hello-view",
+		emits: ['buttonClick'],
+		props: {
+			"buttonText": {
+				type: String,
+				default: "点击触发"
+			}
+		},
+		watch: {
+			"buttonText": {
+				/**
+				 * 这里监听属性变化，并进行组件内部更新
+				 */
+				handler(newButtonText: string, oldButtonText) {
+					this.$el.setTitle(newButtonText, for = UIControl.State.normal)
+				},
+				immediate: false //创建时是否通过此方法更新属性，默认值为false
+			},
+		},
+		data() {
+			return {
+				buttonClickListsner : new ButtonClickListsner()
+			}
+		},
+		expose: ['doSth'],
+		methods: {
+			/**
+			 * 对外公开的组件方法
+			 */
+			doSth(paramA: string) {
+				// 这是组件的自定义方法
+				console.log("paramA")
+			}
+		},
+		/**
+		 * 创建原生View，必须定义返回值类型
+		 */
+		NVLoad(): UIButton {
+			//必须实现
+			let button = new UIButton()
+			button.setTitle(this.buttonText, for = UIControl.State.normal)
+			const method = Selector("buttonClick")
+			button.addTarget(this.buttonClickListsner, action = method, for = UIControl.Event.touchUpInside)
+			return button
+		}
+	}
+</script>
+```
+
+:::
+
+上面的代码，我们自定义了一个  名为 "uts-hello-view" 的UTS 组件，该组件对外提供了一个包含按钮的简单UI实现，并且对外暴露了一个名为 `buttonText`字符串属性，用来构建按钮上的文案
+
+接下来，我们介绍在uni-app项目中如何使用它
+
+#### 使用组件
+
+> 注意：UTS组件默认全局注册，无需使用者手动配置
+
+我们在uni-app项目中新建 helloView.nvue 页面，
+
+![](https://native-res.dcloud.net.cn/images/uts/component/helloview_use_file.jpg)
+
+直接使用`uts-hello-view`标签，并且定义`buttonText`文本内容即可看到效果。
+
+点击组件内置按钮，可以在控制台看到组件内部实现的日志输出
+
+点击`调用组件的方法`按钮，可以看到组件内置方法被调用
+
+
+```html
+<template>
+	<div>
+		<uts-hello-view ref="helloView" buttonText="点击按钮内容" style="width:375px;height: 375px;background-color: aqua;"></uts-hello-view>
+    	<button @tap="callComponentMethod">调用组件的方法</button>
+	</div>
+	
+</template>
+
+<script>
+  	export default {
+      	data() {
+			return {
+				
+			}
+		},
+		methods: {
+			// 调用组件内的方法
+			callComponentMethod: function() {
+				// nvue 页面调用方法
+				this.$refs["helloView"].doSth("param doSth");
+				// uvue 页面调用方法
+				// (this.$refs["helloView"] as UtsHelloViewElement).doSth('param doSth');
+			},
+		}
+      
+  }
+</script>
+
+<style>
+</style>
+```
+
+
+
+#### 运行和测试
+
+在当前示例中，不涉及第三方依赖，使用标准基座直接运行即可
+
+
+
+## 包含第三方SDK的示例
+
+本章节以lottie动画组件为例，介绍包含三方SDK的UTS组件开发过程
+
+#### 创建插件
+
+
+在HBuilder X 中选中Uni-App项目下 uni_modules目录,右键选择新建`uni_modules插件`
+
+![创建界面](https://native-res.dcloud.net.cn/images/uts/component/image0.png)
+
+
+这是创建后的目录结构
+
+![目录结构](https://native-res.dcloud.net.cn/images/uts/component/image3.jpg)
+
+
+#### Android 平台引入依赖
+
+打开 ~/uni_modules/uts-animation-view/utssdk/app-android/config.json
+
+键入如下代码:
+
+```
+"dependencies": [
+	"com.airbnb.android:lottie:3.4.0"
+]
+```
+
+UTS组件建议使用远程依赖的方式集成，如果需要以AAR的形式添加SDK，可以添加到
+
+~/uni_modules/uts-animation-view/utssdk/app-android/libs目录
+
+依赖的配置原则与UTS插件一致 [UTS插件依赖说明](https://uniapp.dcloud.net.cn/plugin/uts-for-android.html#_3-4-%E5%A2%9E%E5%8A%A0libs%E4%BE%9D%E8%B5%96%E8%B5%84%E6%BA%90)
+
+#### iOS 平台引入依赖库
+
+iOS 平台需要将三方依赖库放到 组件目录下 app-ios/Frameworks 中
+
+#### 编写逻辑
+
+
+打开index.vue，键入下面的组件源码:
+
+::: preview
+
+> Android
+
+```ts
+<template>
+    <view>
+
+    </view>
+</template>
+<script lang="uts">
+    import Animator from 'android.animation.Animator'
+    import TextUtils from 'android.text.TextUtils'
+    import View from 'android.view.View'
+    import LottieAnimationView from 'com.airbnb.lottie.LottieAnimationView'
+    import LottieDrawable from 'com.airbnb.lottie.LottieDrawable'
+	import FileInputStream from 'java.io.FileInputStream'
+	import { UTSAndroid } from "io.dcloud.uts";
+
+    class CustomAnimListener extends Animator.AnimatorListener {
+
+        comp: UTSComponent < LottieAnimationView >
+            constructor(com: UTSComponent < LottieAnimationView > ) {
+                super();
+                this.comp = com
+            }
+
+        override onAnimationStart(animation: Animator | null) {}
+
+        override onAnimationEnd(animation: Animator | null, isReverse: Boolean) {
+            this.comp.$emit("bindended")
+        }
+
+        override onAnimationEnd(animation: Animator | null) {}
+
+        override onAnimationCancel(animation: Animator | null) {}
+
+        override onAnimationRepeat(animation: Animator | null) {}
+    }
+
+    //原生提供以下属性或方法的实现
+    export default {
+        name: "uts-animation-view",
+        /**
+         * 当播放到末尾时触发 ended 事件（自然播放结束会触发回调，循环播放结束及手动停止动画不会触发）
+         */
+        emits: ['bindended'],
+        props: {
+            /**
+             * 动画资源地址，目前只支持绝对路径
+             */
+            "path": {
+                type: String,
+                default: ""
+            },
+            /**
+             * 动画是否循环播放
+             */
+            "autoplay": {
+                type: Boolean,
+                default: false
+            },
+            /**
+             * 动画是否自动播放
+             */
+            "loop": {
+                type: Boolean,
+                default: false
+            },
+            /**
+             * 是否隐藏动画
+             */
+            "hidden": {
+                type: Boolean,
+                default: false
+            },
+            /**
+             * 动画操作，可取值 play、pause、stop
+             */
+            "action": {
+                type: String,
+                default: "stop"
+            }
+
+        },
+        data() {
+            return {
+
+            }
+        },
+        watch: {
+            "path": {
+                handler(newPath: string) {
+
+
+					if(this.$el != null){
+						let lottieAnimationView = this.$el!
+						if (!TextUtils.isEmpty(newPath)) {
+
+
+						    if (newPath.startsWith("http://") || newPath.startsWith("https://")) {
+						        lottieAnimationView.setAnimationFromUrl(newPath)
+						    } else {
+						        // 默认是static了
+								var realJsonPath = UTSAndroid.getResourcePath(newPath)
+						        lottieAnimationView.setAnimation(new FileInputStream(realJsonPath),newPath)
+						    }
+						}
+						if (this.autoplay) {
+						    lottieAnimationView.playAnimation()
+						}
+					}
+                },
+                immediate: false //创建时是否通过此方法更新属性，默认值为false
+            },
+            "loop": {
+                handler(newLoop: Boolean) {
+					if(this.$el != null){
+						if (newLoop) {
+						    this.$el!.repeatCount = Int.MAX_VALUE
+						} else {
+						    // 不循环则设置成1次
+						    this.$el!.repeatCount = 0
+						}
+
+						if (this.autoplay) {
+						    this.$el!.playAnimation()
+						}
+					}
+
+                },
+                immediate: false //创建时是否通过此方法更新属性，默认值为false
+            },
+
+            "autoplay": {
+                handler(newValue: boolean) {
+					if(this.$el != null){
+						if (newValue) {
+						    this.$el!.playAnimation()
+						}
+					}
+
+                },
+                immediate: false //创建时是否通过此方法更新属性，默认值为false
+            },
+
+            "action": {
+                handler(newAction: string) {
+
+                    if (newAction == "play" || newAction == "pause" || newAction == "stop") {
+
+						if(this.$el != null){
+							if (this.action == "play") {
+							    this.$el!.playAnimation()
+							} else if (this.action == "pause") {
+							    this.$el!.pauseAnimation()
+							} else if (this.action == "stop") {
+							    this.$el!.cancelAnimation()
+							    this.$el!.clearAnimation()
+							}
+						}
+
+
+                    } else {
+                        // 非法入参，不管
+                    }
+                },
+                immediate: false //创建时是否通过此方法更新属性，默认值为false
+            },
+
+            "hidden": {
+                handler(newValue: boolean) {
+					if(this.$el != null){
+						if (newValue) {
+						    this.$el!.visibility = View.GONE
+						} else {
+						    this.$el!.visibility = View.VISIBLE
+						}
+					}
+                },
+                immediate: false //创建时是否通过此方法更新属性，默认值为false
+            },
+
+        },
+        methods: {
+            setRepeatMode(repeat: string) {
+				if(this.$el != null){
+					if ("RESTART" == repeat) {
+					    this.$el!.repeatMode = LottieDrawable.RESTART
+					} else if ("REVERSE" == repeat) {
+					    this.$el!.repeatMode = LottieDrawable.RESTART
+					}
+				}
+            },
+            privateMethod() { //如何定义不对外暴露的API？ 暂不支持，需在export外写
+            }
+        },
+        created() { //创建组件，替换created
+
+        },
+        NVBeforeLoad() { //组件将要创建，对应前端beforeMount
+            //可选实现，这里可以提前做一些操作
+        },
+        NVLoad(): LottieAnimationView { //创建原生View，必须定义返回值类型（Android需要明确知道View类型，需特殊校验）
+            //必须实现
+            let lottieAnimationView = new LottieAnimationView($androidContext)
+            return lottieAnimationView
+        },
+
+        NVLoaded() { //原生View已创建
+			//可选实现，这里可以做后续操作
+			if(this.$el != null){
+				this.$el!.repeatMode = LottieDrawable.RESTART;
+				this.$el!.visibility = View.GONE
+				this.$el!.repeatCount = 0
+				this.$el!.addAnimatorListener(new CustomAnimListener(this))
+			}
+
+        },
+        NVLayouted() { //原生View布局完成
+            //可选实现，这里可以做布局后续操作
+        },
+        NVBeforeUnload() { //原生View将释放
+            //可选实现，这里可以做释放View之前的操作
+        },
+        NVUnloaded() { //原生View已释放
+            //可选实现，这里可以做释放View之后的操作
+        },
+        unmounted() { //组件销毁
+            //可选实现
+        }
+    }
+</script>
+<style>
+
+</style>
+
+```
+
+> iOS
+
+```ts
+<template>
+	<view>
+
+	</view>
+</template>
+<script lang="uts">
+	import {
+		LottieAnimationView,
+		LottieAnimation,
+		LottieLoopMode
+	} from 'Lottie'
+	import {
+		URL
+	} from 'Foundation'
+	import {
+		UTSiOS
+	} from "DCloudUTSFoundation"
+
+
+	//原生提供以下属性或方法的实现
+	export default {
+		/**
+		 * 组件名称，也就是开发者使用的标签
+		 */
+		name: "uts-animation-view",
+		/**
+		 * 组件涉及的事件声明，只有声明过的事件，才能被正常发送
+		 */
+		emits: ['bindended'], // 当播放到末尾时触发 ended 事件（自然播放结束会触发回调，循环播放结束及手动停止动画不会触发）
+		/**
+		 * 属性声明，组件的使用者会传递这些属性值到组件
+		 */
+		props: {
+			/**
+			 * 动画资源地址，支持远程 URL 地址和本地绝对路径
+			 */
+			"path": {
+				type: String,
+				default: ""
+			},
+			/**
+			 * 动画是否循环播放
+			 */
+			"autoplay": {
+				type: Boolean,
+				default: false
+			},
+			/**
+			 * 动画是否自动播放
+			 */
+			"loop": {
+				type: Boolean,
+				default: false
+			},
+			/**
+			 * 是否隐藏动画
+			 */
+			"hidden": {
+				type: Boolean,
+				default: false
+			},
+			/**
+			 * 动画操作，可取值 play、pause、stop
+			 */
+			"action": {
+				type: String,
+				default: "stop"
+			}
+
+		},
+		data() {
+			return {
+
+			}
+		},
+		watch: {
+			"path": {
+				handler(newValue: string, oldValue: string) {
+					if (this.autoplay) {
+						this.playAnimation()
+					}
+				},
+				immediate: false //创建时是否通过此方法更新属性，默认值为false
+			},
+			"loop": {
+				handler(newValue: boolean, oldValue: boolean) {
+					if (newValue) {
+						this.$el.loopMode = LottieLoopMode.loop
+					} else {
+						this.$el.loopMode = LottieLoopMode.playOnce
+					}
+				},
+				immediate: false //创建时是否通过此方法更新属性，默认值为false
+			},
+			"autoplay": {
+				handler(newValue: boolean, oldValue: boolean) {
+					if (newValue) {
+						this.playAnimation()
+					}
+				},
+				immediate: false //创建时是否通过此方法更新属性，默认值为false
+			},
+			"action": {
+				handler(newValue: string, oldValue: string) {
+					const action = newValue
+					if (action == "play" || action == "pause" || action == "stop") {
+						switch (action) {
+							case "play":
+								this.playAnimation()
+								break;
+							case "pause":
+								this.$el.pause()
+								break;
+							case "stop":
+								this.$el.stop()
+								break;
+							default:
+								break;
+						}
+					} else {
+						// 非法入参，不管
+					}
+				},
+				immediate: false //创建时是否通过此方法更新属性，默认值为false
+			},
+
+			"hidden": {
+				handler(newValue: boolean, oldValue: boolean) {
+					this.$el.isHidden = this.hidden
+				},
+				immediate: false //创建时是否通过此方法更新属性，默认值为false
+			},
+
+		},
+		expose: ['setRepeatMode'],
+		methods: {
+			// 需要对外暴露的方法
+			// 设置 RepeatMode
+			setRepeatMode(repeatMode: string) {
+				if (repeatMode == "RESTART") {
+					if (this.loop) {
+						this.$el.loopMode = LottieLoopMode.loop
+					} else {
+						this.$el.loopMode = LottieLoopMode.playOnce
+					}
+				} else if (repeatMode == "REVERSE") {
+					if (this.loop) {
+						this.$el.loopMode = LottieLoopMode.autoReverse
+					} else {
+						this.$el.loopMode = LottieLoopMode.repeatBackwards(1)
+					}
+				}
+			},
+			// 不对外暴露的方法
+			// 播放动画
+			playAnimation() {
+				// 构建动画资源 url
+				var animationUrl: URL | null
+
+				if (this.path.hasPrefix("http")) {
+					animationUrl = new URL(string = this.path)
+				} else {
+					const filePath = UTSiOS.getResourcePath(this.path)
+					animationUrl = new URL(fileURLWithPath = filePath)
+				}
+
+				if (animationUrl != null) {
+					// 加载动画 LottieAnimation
+					LottieAnimation.loadedFrom(url = animationUrl!, closure = (animation: LottieAnimation | null):
+						void => {
+							if (animation != null) {
+								// 加载成功开始播放
+								this.$el.animation = animation
+								this.$el.play(completion = (isFinish: boolean): void => {
+									if (isFinish) {
+										// 播放完成回调事件
+										this.fireEvent("bindended")
+									}
+								})
+							}
+						})
+				} else {
+					console.log("url 构建失败，请检查 path 是否正确")
+				}
+			}
+		},
+		created() { //创建组件，替换created
+
+		},
+		NVBeforeLoad() { //组件将要创建，对应前端beforeMount
+			//可选实现，这里可以提前做一些操作
+		},
+		NVLoad(): LottieAnimationView { //创建原生View，必须定义返回值类型（Android需要明确知道View类型，需特殊校验）
+			// 初始化 Lottie$el
+			const animationView = new LottieAnimationView()
+			// 默认只播放一次动画
+			animationView.loopMode = LottieLoopMode.playOnce
+			return animationView
+		},
+		NVLoaded() { //原生View已创建
+
+			/// 更新 props 中定义的属性值
+
+			if (this.loop) {
+				this.$el.loopMode = LottieLoopMode.loop
+			}
+
+			this.$el.isHidden = this.hidden
+
+			if (this.autoplay) {
+				this.playAnimation()
+			}
+		},
+
+		NVLayouted() { //原生View布局完成
+			//可选实现，这里可以做布局后续操作
+		},
+
+		NVBeforeUnload() { //原生View将释放
+			//可选实现，这里可以做释放View之前的操作
+		},
+		NVUnloaded() { //原生View已释放
+			//可选实现，这里可以做释放View之后的操作
+		},
+		unmounted() { //组件销毁
+			//可选实现
+		}
+	}
+</script>
+<style>
+
+</style>
+```
+
+:::
+
+上面的代码我们实现了一个支持lottie动画播放的 UTS组件，标签名称为 `uts-animation-view`
+
+对外提供了下列属性和方法
+
+|属性		|类型	|默认值	|描述	|
+|:---		|:--	|:--	|:---	|
+|`path`		|string	||`lottie`资源路径，支持本地地址和`http`协议下的网络地址|
+|`loop`		|boolean|false	|动画是否循环播放|
+|`autoplay`	|boolean|true	|动画是否自动播放|
+|`action`	|string	|play	|动画操作，可取值 play、pause、stop|
+|`hidden`	|boolean|true	|是否隐藏动画|
+|`bindended`|event	|		|当播放到末尾时触发 ended 事件|
+|`setRepeatMode`|function|	|设置动画的重复方式，RESTART：重新开始播放，REVERSE，反向播放|
+
+
+#### 使用`uts-animation-view`组件
+
+在uni-app项目中新建 lottie/index.nvue 页面
+
+![](https://native-res.dcloud.net.cn/images/uts/component/lottie_use_file.jpg)
+
+引用自定义 `uts-animation-view` 组件，并编写测试用例
+
+```
+<template>
+    <div>
+        <button @tap="changeUrl">播放本地动画资源</button>
+		<button @tap="changeServerUrl">播放远程动画资源</button>
+
+        <button @tap="changeAutoPlay">测试AutoPlay</button>
+        <button @tap="changeLoop">测试Loop</button>
+        <button @tap="changeAction(1)">测试action play</button>
+        <button @tap="changeAction(2)">测试action pause</button>
+        <button @tap="changeAction(3)">测试action stop</button>
+        <uts-animation-view ref="animView" :path="animUrl" :autoplay="autoplay" :loop="loop" :action="action"
+            :hidden="hidden" @bindended="testAnimEnd" @click="lottieClickTest" @longpress="lottieLongpressTest"
+            :style="{width:widthNum+'rpx',height:heightNum+'px',background:yanse}">
+        </uts-animation-view>
+
+    </div>
+</template>
+
+<script>
+
+    export default {
+        data() {
+            return {
+                hidden: false,
+                autoplay: false,
+                action: "play",
+                loop: false,
+                yanse: "red",
+                widthNum: 750,
+                heightNum: 200,
+                comShow: true,
+                animUrl: "/static/anim_a.json"
+            }
+        },
+
+        methods: {
+
+            changeAutoPlay: function() {
+                this.autoplay = !this.autoplay
+            },
+            changeUrl: function() {
+                if (this.animUrl == "/static/anim_a.json") {
+                    this.animUrl = "/static/anim_b.json"
+                } else {
+                    this.animUrl = "/static/anim_a.json"
+                }
+            },
+
+			changeServerUrl: function() {
+                this.animUrl = "https://b.bdstatic.com/miniapp/images/lottie_example_one.json"
+            },
+            changeAction: function(type) {
+                if (type == 1) {
+                    this.action = "play"
+                } else if (type == 2) {
+                    this.action = "pause"
+                } else if (type == 3) {
+                    this.action = "stop"
+                }
+            },
+            changeLoop: function() {
+                this.loop = !this.loop
+            },
+            testAnimEnd: function(res) {
+                console.log("testAnimEnd");
+            },
+
+            changeRepeat: function(res) {
+                let repeatConfig = {
+                    count: 3,
+                    mode: "restart"
+                }
+                this.$refs["animView"].updateRepeatConfig(repeatConfig, function(res) {
+                    console.log(res);
+                });
+
+            },
+            lottieClickTest: function(res) {
+                console.log("lottieClickTest");
+                console.log(res);
+            },
+            lottieLongpressTest: function(res) {
+                console.log("lottieClickTest");
+                console.log(res);
+            },
+        }
+    }
+</script>
+
+```
+
+以上，我们完成了 `uts-animation-view`组件的集成和使用工作
+
+
+#### 运行和测试
+
+在当前例子中，因为配置了额外的第三方依赖，需要自定义基座方能使用
+
+
+## UTS开发容器组件
+
+## 简介
+
+组件一般有两种场景，第一种是： 单标签组件
+```html
+<uts-view style="xxxx"/>
+```
+
+我们上面介绍的 `uts-hello-view`或者`uts-animation-view`都是这种类型
+
+第二种是 作为容器使用：
+
+```html
+<uts-view >
+	<text> 文字子组件</text>
+	<image src="https://xxx">
+<uts-view >
+```
+## 声明
+
+UTS组件作为容器组件与普通View组件遵循完全相同的规范，
+
+唯一的区别在于 当组件布局中包含 `<solt>` 标签时，编译器会自动将其转换为容器组件
+
+::: preview
+
+> Android
+
+```ts
+<template>
+	<view>
+		<solt/>
+	</view>
+</template>
+<script lang="uts">
+
+	import LinearLayout from 'android.widget.LinearLayout'
+
+	//原生提供以下属性或方法的实现
+	export default {
+		name: "uts-hello-container",
+
+		NVLoad(): LinearLayout {
+			let contentLayout = new LinearLayout($androidContext)
+			return contentLayout
+		}
+
+	}
+</script>
+<style>
+
+</style>
+
+```
+
+> iOS
+
+```ts
+<template>
+	<view>
+		<slot></slot>
+	</view>
+</template>
+<script lang="uts">
+	import {
+		UIView
+	} from 'UIKit'
+	//原生提供以下属性或方法的实现
+	export default {
+		name: "uts-hello-container",
+		NVLoad(): UIView {
+			let view = new UIView()
+			return view
+		}
+
+	}
+</script>
+```
+
+:::
+
+如上，我们即可到了一个最简的UTS容器组件
+
+
+## 使用容器组件
+
+UTS容器组件的使用与Vue等常见的前端容器组件一致。唯一要注意的是，目前UTS容器组件还不支持 具名插槽。
+
+如下是一个容器组件的使用示例
+
+
+```js
+<template>
+	<uts-hello-container>
+		<text>UTS contianer组件</text>
+		<button text="点击按钮内容" style="width:375px;height: 375px;background-color: aqua;"></button>
+	</uts-hello-container>
+</template>
+
+<script>
+</script>
+
+<style>
+</style>
+```
+
+## 应用程序生命周期函数监听
+ UTS 组件同样支持对应用程序生命周期函数的监听，方式和 UTS 插件中的完全一致。具体使用方法[详见](https://uniapp.dcloud.net.cn/plugin/uts-plugin.html#hooksClass)
+
+
+## 快速体验
+
+
+开发者可以使用[Hello UTS](https://gitcode.net/dcloud/hello-uts) 快速体验UTS 组件开发
+
+
+Lottie动画示例,对应的源码实现：~/uni_modules/uts-animation-view
+
+`uts-animation-view`动画示例,对应的源码实现：~/uni_modules/uts-animation-view
+
+
+
+## 常见问题
+
+#### 1 使用者需要指定 组件宽高
+
+```
+<uts-hello-view buttonText="点击按钮内容" style="width:375px;height: 375px;background-color: aqua;"></uts-hello-view>
+```
+
+如果不通过style 指定组件宽高，会导致组件不显示
+
+
+#### 2 UTS-Android 插件涉及的像素单位说明： rpx,逻辑像素px,物理像素px
+
+|单位|说明|使用场景|
+|----|---|---|
+|逻辑像素px |逻辑像素 对应到 android中的 dp| 组件使用者 在页面css中使用 举例：`width:480px` |
+|物理像素px |真实的设备像素，与dp 直接的换算关系是 dp * 屏幕密度 = 物理像素 px| android 原生api 传入和返回的单位均为物理像素，比如 设置layoutParam 参数，获取View宽高等 |
+|rpx |屏幕宽度固定750单位前提下的逻辑像素| 组件使用者 在页面css中使用 举例：`width:750rpx`,可以使用UTSAndroid.rpx2px() 函数进行rpx 和 逻辑像素 px的转换|
+
+
+
+为了让组件使用者的有更好的体验，UTS 插件 应该以 **逻辑像素 px** 作为标准的像素单位：
+
++ 1 内置的UTS插件/组件，涉及对外交互时会自动进行单位转换，抹平相关差异。比如 `swiper`等组件监听滑动距离等场景
+
++ 2 建议 插件开发者的插件在设计对外像素单位时也进行单位的转换，以逻辑像素px 作为输出结果
+
+
+
+
+
+
diff --git a/docs/plugin/uts-for-android.md b/docs/plugin/uts-for-android.md
new file mode 100644
index 00000000..6f0712e6
--- /dev/null
+++ b/docs/plugin/uts-for-android.md
@@ -0,0 +1,1483 @@
+## uts for Android
+
+本文旨在帮助Android开发者，快速上手UTS。
+
+需要阅读者具备Android原生应用开发经验。
+
+
+## 1 了解UTS插件是什么
+
+`UTS插件`是`uni-app`新型插件形式，拥有跨平台，高效率，易调试等优点。[详情](/plugin/uts-plugin)
+
+对于Android开发者来说，我们需要了解的是：
+
+1. 编译时：当我们在保存`UTS`源码文件时，IDE会同步将其编译为对应的Kotlin代码。
+2. 运行时：在真机运行/云打包时，这些编译后的kotlin源码也会成为apk的一部分
+
+## 2 掌握UTS语法
+
+### 2.1  对于掌握kotlin语言者
+
+因为UTS语法与kotlin很类似，建议快速阅读后，在实践中掌握这UTS语法。[uts语法介绍](/uts/)。
+
+### 2.2  对于仅掌握java语言者
+
+与js相比，uts的语法和java更加类似。但是依然存在较大的差异，需要详细阅读2.3语法部分。
+
+尽管开发UTS插件，并不要求一定掌握kotlin，但是鉴于`UTS`目前在android平台上，会编译为kotlin源码。学会kotlin语言，方便排查问题和复杂功能实现。
+
+因此建议学习一下kotlin语法。
+
++ kotlin [https://kotlinlang.org/](https://kotlinlang.org/)
+
++ kotlin for android [https://developer.android.com/kotlin](https://developer.android.com/kotlin)
+
+### 2.3 数据类型差异
+
+虽然 UTS 和 koltin 在数据类型上基本保持了一致，但是在部分场景下，还是会有差异，在此特别说明
+
+原则上：  
+
+**数据类型以UTS 内置的类型为准， 各原生平台都会对其自动适配。**
+
+**但是 UTS本身是跨平台语言，当具体平台的api 有明确要求时，需要以对方明确要求的数据类型为准。**
+
+-------------------------
+
+
+#### 举例一： Int 和Number
+
+默认情况下`UTS` 开发者可以使用 `Number` 覆盖`android` 平台上使用 `Int`的场景。
+
+但是当开发者重写  `Service` 组件`onStartCommand` 方法时，`Android` API要求 明确要求后两个参数 必须为Int
+
+ 
+原生开发环境中，应该这样写：
+
+ ```kotlin
+ override fun onStartCommand(intent: Intent, flags: Int, startId: Int): Int {
+	return super.onStartCommand(intent, flags, startId);
+ }
+ ```
+
+
+ 标准的TS环境中，只有`Number`类型而没有`Int`类型
+
+ 为了适应这种情况，UTS 允许开发者使用原生平台的数据类型Int，来满足原生API对数据类型的要求：
+
+```ts
+ override onStartCommand(intent:Intent ,flags:Int ,startId:Int):Int {
+	return super.onStartCommand(intent, flags, startId);
+ }
+```
+
+
+
+
+#### 举例二：`MutableList`
+ 
+`MutableList`是`android`平台 特有的数据类型，一般场景下，可以使用UTS中内置类型 `Array` 替代
+
+但是在 调用`onAppActivityRequestPermissionsResult` 函数监听权限申请结果时，明确要求使用此类型的参数
+
+在原生环境中，应该这样写：
+
+```kotlin
+
+onAppActivityRequestPermissionsResult(fun(requestCode: Number, permissions: MutableList<String>, grantResults: MutableList<Number>){
+      
+});
+```
+
+
+标准的TS环境中，没有`MutableList`类型，与之相近的数据类型是 `Array`
+
+为了适应这种情况，UTS 允许开发者使用原生平台的数据类型`MutableList`，来满足原生平台API对数据类型的要求：
+
+```ts
+onAppActivityRequestPermissionsResult((requestCode: number,permissions: MutableList<string>,grantResults: MutableList<number>) => {
+	
+});
+
+```
+
+#### 举例三：`String[]`
+
+部分三方sdk 使用java开发，要求继承/实现的方法参数为 string[]类型，这种情况比较特殊，需要将kotlin.Array先进行别名声明，再继续使用
+
+```ts
+import KotlinArray from 'kotlin.Array';
+
+
+class XXX{
+ 	override onCaptureFinish(p0: KotlinArray<string>){
+		// do sth
+	};
+}
+
+```
+
+
+### 2.4 线程环境差异
+
+UTS环境中，默认是没有线程概念的。 代码默认执行在uts 单独的线程池中。
+
+如果需要执行异步任务，建议通过内置函数`setTimeOut`执行
+
+```ts
+console.log("这里是UTS默认线程 :"  + Thread.currentThread().getName())
+setTimeOut(function(){
+	console.log("这里是异步任务线程 :"  + Thread.currentThread().getName())
+},1000)
+```
+
+如果是android原生api 需要部分代码必须执行在UI线程，则需要通过原生api进行操作：
+
+```ts
+class AddUIRunnable extends Runnable {
+	override run():void {
+		// do something
+		console.log("这里是android平台主线程 :"  + Thread.currentThread().getName())
+    }
+};
+let uiRunable = new AddUIRunnable();
+getUniActivity()!.runOnUiThread(uiRunable)
+```
+
+
+## 3 Android原生环境配置
+
+对于Android项目来说，除了源码之外，还会涉及依赖，资源，配置等常见问题
+
+本章节将会介绍，UTS插件开发环境中如何配置这些属性
+
+**注意**：
+
++ 1 本章节内的实例代码均取自Hello UTS [项目地址](https://gitcode.net/dcloud/hello-uts)
++ 2 本章节涉及的配置，均需自定义基座后才能生效
++ 3 R文件的自动生成，已经在HBuilder X 3.6.9 版本支持，请使用最新版本开发
+
+### 3.1 配置AndroidManifest.xml
+
+以hello UTS中的native-page插件中的配置文件为例:
+
+示例文件在hello uts中的位置：
+
+~\uni_modules\uts-nativepage\utssdk\app-android\AndroidManifest.xml
+
+AndroidManifest.xml示例：
+
+```xml
+<?xml version="1.0" encoding="utf-8"?>
+<manifest xmlns:android="http://schemas.android.com/apk/res/android" xmlns:tools="http://schemas.android.com/tools" 
+  // 注意：这里是插件的包名而不是应用的包名
+  package="io.dcloud.uni_modules.utsNativepage">
+   // 配置权限
+   <!--创建前台服务权限-->
+   <uses-permission android:name="android.permission.FOREGROUND_SERVICE" />
+
+    <application>
+	   // 配置service / activity
+	   <service android:name="uts.sdk.modules.utsNativepage.ForeService"  />
+       <activity android:name="uts.sdk.modules.utsNativepage.DemoActivity"></activity>
+    </application>
+</manifest>
+
+```
+
+
+AndroidManifest.xml配置规则与android中的规则是一致的。
+
+
+特别提示：
+
+每一个UTS插件对应android项目中的一个 lib module.
+
+与你在android studio中手动输入包名不同的是，如果你没有手动包名，HX会按照下面的规则默认生成一个：
+
+```
+uts插件默认包名规则：
+
+如果是根目录utssdk下的uts插件
+	包名：uts.sdk.(插件ID转驼峰)
+如果是uni_modules目录下的uts插件
+	包名：uts.sdk.modules.(插件ID转驼峰)
+
+
+举例：
+uni-getbatteryinfo -> uts.sdk.modules.uniGetbatteryinfo;
+uts-nativepage  ->  uts.sdk.modules.utsNativepage
+```
+
+### 3.2 配置res资源
+
+![](https://native-res.dcloud.net.cn/images/uts/forAndroid/uts_android_res_folder.jpg)
+
+示例文件在hello uts中的位置：
+
+~\uni_modules\uts-nativepage\utssdk\app-android\res 
+
+除了这里列出的layout、values目录外，还支持anim等所有android标准资源目录
+
+
+**需要注意的是：如果res资源中使用了 android appcompat库内置的资源，需要在config.json中添加下面的配置：**
+
+```json
+{
+	"dependencies": [
+		"androidx.appcompat:appcompat:1.0.0"
+	]
+}
+
+
+```
+
+
+
+### 3.3 配置asset资源
+
+以hello UTS中的uts-advance插件为例。
+
+![目录结构](https://native-res.dcloud.net.cn/images/uts/forAndroid/uts_android_assets_folder.jpg)
+
+关键代码:
+
+```ts
+// 获取asset管理器
+let assetManager = getAppContext()!.getAssets();
+// 加载free.mp3 资源
+let afd = assetManager.openFd("free.mp3");
+// 使用android 自带的媒体组件进行播放
+let mediaPlayer = new MediaPlayer();
+mediaPlayer.setDataSource(afd.getFileDescriptor(),afd.getStartOffset(), afd.getLength());
+mediaPlayer.prepare();
+mediaPlayer.start();
+```
+
+完整的代码在hello uts中的位置：
+
+~\uni_modules\uts-advance\utssdk\app-android\assets
+
+### 3.4 增加libs依赖资源
+
+下面是一个`config.json`示例
+
+```json
+{
+	"dependencies": [
+		"androidx.recyclerview:recyclerview:1.0.0"
+	]
+}
+
+
+```
+
+
+------
+
+截止 HBuilder 3.8.2 版本内置了以下依赖
+
+开发者在使用列表中的依赖时，需要注意两点：
+
++  真机运行时，不需要添加列表中的依赖，即可直接引用相关类
++  请勿通过 手动添加jar/aar 等方式引入相同的依赖，否则会因依赖冲突导致云打包失败。
+
+```gradle
++--- my-imageloader.jar
++--- my-nineoldandroids-2.4.0.jar
++--- zip4j-2.8.0.jar
++--- com.github.getActivity:XXPermissions:18.0@jar
++--- android-gif-drawable-release@1.2.23.aar
++--- msa_mdid_1.0.13.aar
++--- breakpad-build-release.aar
++--- androidx.multidex:multidex:2.0.0@aar
++--- androidx.recyclerview:recyclerview:1.0.0@aar
++--- androidx.legacy:legacy-support-v4:1.0.0@aar
++--- androidx.appcompat:appcompat:1.0.0@aar
++--- com.github.bumptech.glide:glide:4.9.0@aar
++--- com.alibaba:fastjson:1.1.46.android@jar
++--- androidx.fragment:fragment:1.0.0@aar
++--- androidx.vectordrawable:vectordrawable-animated:1.0.0@aar
++--- androidx.legacy:legacy-support-core-ui:1.0.0@aar
++--- androidx.media:media:1.0.0@aar
++--- androidx.legacy:legacy-support-core-utils:1.0.0@aar
++--- androidx.vectordrawable:vectordrawable:1.0.0@aar
++--- androidx.viewpager:viewpager:1.0.0@aar
++--- androidx.coordinatorlayout:coordinatorlayout:1.0.0@aar
++--- androidx.drawerlayout:drawerlayout:1.0.0@aar
++--- androidx.slidingpanelayout:slidingpanelayout:1.0.0@aar
++--- androidx.customview:customview:1.0.0@aar
++--- androidx.swiperefreshlayout:swiperefreshlayout:1.0.0@aar
++--- androidx.asynclayoutinflater:asynclayoutinflater:1.0.0@aar
++--- androidx.loader:loader:1.0.0@aar
++--- androidx.core:core:1.0.0@aar
++--- androidx.versionedparcelable:versionedparcelable:1.0.0@aar
++--- androidx.collection:collection:1.0.0@jar
++--- androidx.cursoradapter:cursoradapter:1.0.0@aar
++--- com.github.bumptech.glide:gifdecoder:4.9.0@aar
++--- androidx.lifecycle:lifecycle-runtime:2.0.0@aar
++--- androidx.interpolator:interpolator:1.0.0@aar
++--- androidx.documentfile:documentfile:1.0.0@aar
++--- androidx.localbroadcastmanager:localbroadcastmanager:1.0.0@aar
++--- androidx.print:print:1.0.0@aar
++--- androidx.lifecycle:lifecycle-viewmodel:2.0.0@aar
++--- androidx.lifecycle:lifecycle-livedata:2.0.0@aar
++--- androidx.lifecycle:lifecycle-livedata-core:2.0.0@aar
++--- androidx.lifecycle:lifecycle-common:2.0.0@jar
++--- androidx.arch.core:core-runtime:2.0.0@aar
++--- androidx.arch.core:core-common:2.0.0@jar
++--- androidx.annotation:annotation:1.0.0@jar
++--- com.github.bumptech.glide:disklrucache:4.9.0@jar
+\--- com.github.bumptech.glide:annotations:4.9.0@jar
+
+
+```
+
+
+
+### 3.5 远程依赖仓库说明
+
+目前云打包机支持下面的仓库：
+
+```
+
+jcenter()
+google()
+// huawei
+maven {url 'https://developer.huawei.com/repo/'}
+// jitpack 远程仓库：https://jitpack.io
+maven { url 'https://jitpack.io' }
+
+```
+
+部分场景下，开发者可能需要将本地依赖，上传到远程仓库，避免wgt提交资源过大超出打包限制。
+
+这种情况，推荐开发者上传到 jitpack.io  这也是目前android 原生开发主流的远程仓库。 [使用文档](https://docs.jitpack.io/)
+
+
+
+
+
+## 4 Android内置库@iodcloudutsandroid
+
+在uts里，Android的所有api都可以访问。
+
+但Android开发中经常要复写application和activity，uni-app主引擎已经复写了相关类。所以想要操作application和activity，需要调用uni-app引擎封装的API。
+
+这些api在`io.dcloud.uts`库下 UTSAndroid对象，具体见下。
+
+### 4.1 application 上下文相关
+
+#### 4.1.1 getAppContext
+
+> HBuilderX 3.6.3+
+
+
+```ts
+import { UTSAndroid } from "io.dcloud.uts";
+```
+
+用法说明：获取当前应用Application上下文，对应android平台 Context.getApplicationContext 函数实现
+
+Android开发场景中，调用应用级别的资源/能力，需要使用此上下文。更多用法，参考[Android官方文档](https://developer.android.google.cn/docs)
+
+
+```ts
+// [示例]获取asset下的音频，并且播放
+let assetManager = UTSAndroid.getAppContext()!.getAssets();
+let afd = assetManager.openFd("free.mp3");
+let mediaPlayer = new MediaPlayer();
+mediaPlayer.setDataSource(afd.getFileDescriptor(),afd.getStartOffset(), afd.getLength());
+mediaPlayer.prepare();
+mediaPlayer.start();
+```
+
+** 与Application的转换 **
+
+UTSAndroid.getAppContext() 默认返回的是 实现了 `Context`抽象类的`Application` 对象
+
+部分场景，明确需要 `Application` 对象，那么直接强制类型转换即可
+
+```ts
+import Application from 'android.app.Application'
+
+
+let app = UTSAndroid.getAppContext() as Application
+console.log(app)
+```
+
+
+#### 4.1.2 getResourcePath(resourceName:String)
+
+> HBuilderX 3.6.3+
+
+
+```ts
+import { UTSAndroid } from "io.dcloud.uts";
+```
+
+获取指定插件资源的运行期绝对路径
+ 
+```ts
+// [示例]获取指定资源路径
+// 得到文件运行时路径: `/storage/emulated/0/Android/data/io.dcloud.HBuilder/apps/__UNI__3732623/www/uni_modules/test-uts-static/static/logo.png`
+UTSAndroid.getResourcePath("uni_modules/test-uts-static/static/logo.png")
+
+```
+
+#### 4.1.3 onAppTrimMemory / offAppTrimMemory
+
+##### onAppTrimMemory
+
+> HBuilderX 3.6.11+
+
+
+App 内存不足时，系统回调函数 对应原生的API: onTrimMemory
+
+```ts
+UTSAndroid.onAppTrimMemory((level:Number) => {
+	let eventName = "onAppTrimMemory - " + level;
+	console.log(eventName);
+});
+```
+
+##### offAppTrimMemory
+
+> HBuilderX 3.6.11+
+
+
+onAppTrimMemory 对应的反注册函数
+
+如果传入的函数可为空，如果为空，则视为移除所有监听
+
+```ts
+// 移除所有监听
+UTSAndroid.offAppTrimMemory()
+// 移除指定监听
+UTSAndroid.offAppTrimMemory((level:Number) => {
+	
+});
+```
+
+
+#### 4.1.4 onAppConfigChange / offAppConfigChange
+
+##### onAppConfigChange
+
+> HBuilderX 3.6.1+
+
+
+App 配置发生变化时触发，比如横竖屏切换 对应原生的API: onConfigurationChanged
+
+```ts
+UTSAndroid.onAppConfigChange((ret:UTSJSONObject) => {
+	let eventName = "onAppConfigChange - " + JSON.stringify(ret);
+	console.log(eventName);
+});
+```
+
+##### offAppConfigChange
+
+
+与onAppConfigChange 对应的反注册函数
+
+如果传入的函数可为空，如果为空，则视为移除所有监听
+
+```ts
+// 移除所有监听
+UTSAndroid.offAppConfigChange();
+// 移除指定监听
+UTSAndroid.offAppConfigChange(function(ret){
+
+});
+```
+
+
+--------------------------------
+
+
+特别说明：除了本章节列出的函数外，android环境下 application 其他上下文方法都可以通过 getAppContext()!.xxx()的方式实现
+
+比如获取app缓存目录：
+
+```
+UTSAndroid.getAppContext()!.getExternalCacheDir()!.getPath()
+```
+
+
+### 4.2 Activity 上下文 @activity
+
+#### 4.2.1 getUniActivity
+
+> HBuilderX 3.6.11+
+
+
+获取当前插件所属的activity实例，对应android平台 getActivity 函数实现
+
+Android开发场景中，调用活动的级别的资源/能力，需要使用此上下文。更多用法，参考[Android官方文档](https://developer.android.google.cn/docs)
+
+```ts
+// [示例]获取当前activity顶层容器
+let decorView = UTSAndroid.getUniActivity()!.window.decorView;
+let frameContent = decorView.findViewById<FrameLayout>(android.R.id.content)
+```
+
+#### 4.2.2 onAppActivityPause / offAppActivityPause
+
+##### onAppActivityPause
+
+> HBuilderX 3.6.3+
+
+
+App的activity onPause时触发
+
+```ts
+UTSAndroid.onAppActivityPause(() => {
+    let eventName = "onAppActivityPause - " + Date.now();
+    console.log(eventName);
+});
+```
+
+##### offAppActivityPause
+
+> HBuilderX 3.6.9+
+
+onAppActivityPause 对应的反注册函数
+
+如果传入的函数可为空，如果为空，则视为移除所有监听
+
+
+```ts
+// 移除全部监听
+UTSAndroid.offAppActivityPause();
+// 移除指定监听
+UTSAndroid.offAppActivityPause(() => {
+});
+```
+
+
+
+#### 4.2.3 onAppActivityResume / offAppActivityResume
+
+##### onAppActivityResume
+
+> HBuilderX 3.6.3+
+
+
+
+App的activity onResume时触发
+
+```ts
+UTSAndroid.onAppActivityResume(() => {
+     let eventName = "onAppActivityResume - " + Date.now();
+     console.log(eventName);
+});
+```
+
+##### offAppActivityResume
+
+> HBuilderX 3.6.9+
+
+onAppActivityResume 对应的反注册函数
+
+如果传入的函数可为空，如果为空，则视为移除所有监听
+
+
+```ts
+// 移除全部监听
+UTSAndroid.onAppActivityResume();
+// 移除指定监听
+UTSAndroid.onAppActivityResume(() => {
+});
+```
+
+
+
+#### 4.2.4 onAppActivityDestroy / offAppActivityDestroy
+
+##### onAppActivityDestroy
+
+> HBuilderX 3.6.3+
+
+
+App 的 activity onDestroy时触发
+
+```ts
+UTSAndroid.onAppActivityDestroy(() => {
+     let eventName = "onAppActivityDestroy- " + Date.now();
+     console.log(eventName);
+});
+```
+
+##### offAppActivityDestroy
+
+> HBuilderX 3.6.9+
+
+onAppActivityDestroy 对应的反注册函数
+
+如果传入的函数可为空，如果为空，则视为移除所有监听
+
+
+```ts
+// 移除全部监听
+UTSAndroid.offAppActivityDestroy();
+// 移除指定监听
+UTSAndroid.offAppActivityDestroy(() => {
+});
+```
+
+
+
+#### 4.2.5 onAppActivityBack / offAppActivityBack
+
+##### onAppActivityBack
+
+> HBuilderX 3.6.3+
+
+
+App 的 activity 回退物理按键点击时触发
+
+```ts
+UTSAndroid.onAppActivityBack(() => {
+     let eventName = "onAppActivityBack- " + Date.now();
+     console.log(eventName);
+});
+
+```
+
+##### offAppActivityBack
+
+> HBuilderX 3.6.9+
+
+onAppActivityBack 对应的反注册函数
+
+如果传入的函数可为空，如果为空，则视为移除所有监听
+
+
+```ts
+// 移除全部监听
+UTSAndroid.offAppActivityBack();
+// 移除指定监听
+UTSAndroid.offAppActivityBack(() => {
+});
+```
+
+
+
+#### 4.2.6 onAppActivityResult / offAppActivityResult
+
+
+
+##### onAppActivityResult
+
+> HBuilderX 3.6.8+
+
+App 的 activity 启动其他activity的回调结果监听 对应原生的  [onActivityResult](!https://developer.android.com/training/basics/intents/result)
+
+需要特别注意的是 `requestCode` 参数，这个参数用于区别 不同的请求来源,开发者应该只处理自己发起请求
+
+```ts
+let customRequestCode = 12000
+
+UTSAndroid.onAppActivityResult((requestCode: Int, resultCode: Int, data?: Intent) => {
+	if(requestCode == 12000){
+		// 我们发起的请求
+		let eventName = "onAppActivityResult  -  requestCode:" + requestCode + " -resultCode:"+resultCode + " -data:"+JSON.stringify(data);
+    	console.log(eventName);
+	}else{
+		// 别的代码发起的请求，不要处理
+	}
+	
+});
+```
+
+##### offAppActivityResult
+
+> HBuilderX 3.6.9+
+
+onAppActivityResult 对应的反注册函数
+
+如果传入的函数可为空，如果为空，则视为移除所有监听
+
+
+```ts
+// 移除全部监听
+UTSAndroid.offAppActivityResult();
+// 移除指定监听
+UTSAndroid.offAppActivityResult(() => {
+});
+```
+
+
+#### 4.2.7 onAppActivityRequestPermissionsResult / offAppActivityRequestPermissionsResult
+
+> 已废弃，请使用 4.4章节系统权限管理替代此api
+
+##### onAppActivityRequestPermissionsResult
+
+> HBuilderX 3.6.3+
+
+
+App 的 activity 获得权限请求结果的回调
+
+```ts
+UTSAndroid.onAppActivityRequestPermissionsResult((requestCode: number,
+                                                     permissions: Array<string>,
+                                                     grantResults: Array<number>) => {
+		
+		console.log(grantResults);
+		console.log(permissions);   
+		console.log(requestCode);
+	});
+
+//发起定位权限申请
+let permission = [Manifest.permission.ACCESS_COARSE_LOCATION]
+ActivityCompat.requestPermissions(getUniActivity()!,
+	    permission, 1001);
+
+```
+
+##### offAppActivityRequestPermissionsResult
+
+> HBuilderX 3.6.9+
+
+onAppActivityRequestPermissionsResult 对应的反注册函数
+
+如果传入的函数可为空，如果为空，则视为移除所有监听
+
+
+```ts
+// 移除全部监听
+UTSAndroid.offAppActivityRequestPermissionsResult();
+// 移除指定监听
+UTSAndroid.offAppActivityRequestPermissionsResult(() => {
+});
+
+-----------------------------
+
+
+特别说明：除了本章节列出的函数外，android环境下 activity 其他上下文方法都可以通过 getUniActivity()!.xxx()的方式实现
+
+比如获取当前activity的顶层View容器
+
+```ts
+UTSAndroid.getUniActivity()!.getWindow().getDecorView();
+```
+
+### 4.3 UTS插件开发中Activity生命周期注意事项
+
+即使在android原生开发中，应用的生命周期管理也是十分重要的。 [android生命周期](https://developer.android.com/guide/components/activities/activity-lifecycle?hl=zh_cn)
+
+UTS环境中对原生的生命周期进行了封装和简化，用户不需要关心 除了activity 以外的更多原生细节。
+
+只需要了解本章节中列出的 activity相关生命周期即可。即 在UTS环境中 开发者可以认为 activity 的生命周期 就是应用的生命周期。 
+
+其中最为常见的场景，要数`onAppActivityDestroy`中释放系统资源了：
+
+
+举个例子，以Hello UTS  [用户截屏插件](https://ext.dcloud.net.cn/plugin?id=9897)为例。
+
+在注册监听回调时，添加了下列代码。 
+```
+UTSAndroid.onAppActivityDestroy(function(){
+	screenOB?.stopWatching()
+	screenOB = null
+})
+```
+
+这段代码的意思是当宿主activity被销毁时，主动回收屏幕监听的FileObserver
+
+这是因为除了正常的用户注册/注册 之外，还存在一种情况：用户没有反注册，便关闭了应用。   此时FileObserver 并没有被反注册回收。就会导致应用关闭后继续持有上一个uni-app js引擎实例的引用，从而导致下一次启动时出现引擎回调找不到的情况。
+
+
+
+开发者在开发UTS插件时，如果遇到了类似使用系统组件的情况，也需要特别关注资源释放情况。
+
+
+### 4.4 系统权限管理
+
+HBuilder X 3.8.2版本之后支持
+
+系统权限管理使用了 https://github.com/getActivity/XXPermissions 工具库
+
+如果开发者使用了相同依赖，可能打包冲突。需要修改为 complileOnly 或者 修改为本章节内置API
+
+
+
+##### 4.4.1 requestSystemPermission
+
+请求系统权限,对应的两个参数：
+1  请求的权限列表
+2  请求结果回调
+
+```ts
+let permission = ["android.permission.ACCESS_FINE_LOCATION","android.permission.ACCESS_FINE_LOCATION"]
+UTSAndroid.requestSystemPermission(UTSAndroid.getUniActivity()!,permission,function(allRight:boolean,grantedList:string[]){
+		if(allRight){
+			// 用户同意了全部权限
+		}else{
+			// 用户仅同意了 grantedList中的权限
+		}
+	},function(doNotAskAgain:boolean,grantedList:string[]){
+		// 用户拒绝了部分权限，仅允许了grantedList中的权限
+		if(doNotAskAgain){
+			// 用户拒绝了权限，并且选择不再询问
+		}
+	})
+```
+
+##### 4.4.2 gotoSystemPermissionActivity
+
+跳转至系统设置权限设置界面，一般是用户选择了不再继续询问选项后
+
+```
+let permissionWifi = ["android.permission.ACCESS_FINE_LOCATION", "android.permission.ACCESS_FINE_LOCATION"]
+UTSAndroid.gotoSystemPermissionActivity(UTSAndroid.getUniActivity()!,permissionWifi)
+```
+
+
+##### 4.4.3 getSystemPermissionDenied@getSystemPermissionDenied
+
+判断权限是否已经被用户禁止
+
+```ts
+let permission = ["android.permission.ACCESS_FINE_LOCATION", "android.permission.ACCESS_FINE_LOCATION"]
+let denied = UTSAndroid.getSystemPermissionDenied(UTSAndroid.getUniActivity()!, permission)
+// 执行结果
+[android.permission.ACCESS_FINE_LOCATION, android.permission.ACCESS_FINE_LOCATION]
+```
+
+##### 4.4.4 checkSystemPermissionGranted
+
+判断权限是否已经被用户授予
+
+```ts
+let permission = ["android.permission.ACCESS_FINE_LOCATION", "android.permission.ACCESS_FINE_LOCATION"]
+let grant = UTSAndroid.checkSystemPermissionGranted (UTSAndroid.getUniActivity()!, permission)
+// 执行结果
+false
+```
+
+## 5 Kotlin与UTS差异重点介绍 (持续更新)
+
+通过上面的章节的阅读。
+
+至此我们认为你已经掌握了UTS语法，掌握了基本的Kotlin语法，掌握了UTS对于android资源的支持。
+
+但是对于一个熟悉android开发的kotlin语言者来说，有很多常用的习惯发生了改变，我们会在这个章节特别指出，便于开发者加深认识。
+
+
+### 5.1 语法差异
+
+-------------------------------
+
+#### 5.1.1 可为空的语法标识
+
+kotlin中可为空的语法统一为类型后加`?`，以下面的代码为例
+
+```ts
+// 一个可为空的字符串变量，变量名为user
+var user:String? = null
+```
+
+但是ts中分两种情况，如果是全局变量，可为空，需要这样写
+
+```ts
+let user:string | null
+```
+
+如果是成员变量，与kotlin类似，但是区别在于?写在变量后，而非类型后
+```ts
+let user?:string
+```
+
+#### 5.1.2  let和var
+
+`kotlin`中 可变变量修饰为 `var`、`val`。 区别在于 val 不可变，var可变。
+
+`uts`中对应`var`的变量类型为 `var/let`
+
+推荐使用`let` 因为只会在作用域内生效，需要慎用`var`，因为它具备有更大的作用范围
+
+
+#### 5.1.3 方法定义
+
+方法定义 `kotlin`里的方法只有一种定义方式
+
+```kotlin
+ fun startListener():void{
+	 
+ }
+```
+uts中，需要区分全局方法、成员方法
+
+```ts
+ // 成员方法
+ startListener():void{
+	 
+ }
+```
+ 
+```ts
+ // 全局方法
+ function startListener():void{
+	 
+ }
+```
+
+#### 5.1.4 extends
+
+`kotlin`中的: 继承操作符，需要用`extends`取代
+
+|语法|kotlin|uts|
+|---|-------|---|
+|继承类|:|extends|
+|实现type接口|:|extends|
+|实现接口|:|implements|
+
+
+```ts
+// 使用UTS 实现 OnClickListener接口
+class StartServiceListener extends OnClickListener{
+	
+    override onClick(v?: View):void{
+		// 执行点击逻辑
+    }
+}
+
+```
+
+
+
+
+
+#### 5.1.5 非空断言
+
+kotlin中的非空断言是`!!`，ts中是一个`!`
+
+```ts
+user!.sayHello();
+```
+
+```kotlin
+user!!.sayHello();
+```
+
+
+#### 5.1.6 快速调用父类实现
+
+
+```kotlin
+//kotlin 中快速实现super
+constructor() : super() {
+}
+	
+```
+
+```uts
+//uts 中快速实现super
+constructor (){
+	super();
+}
+```
+
+
+#### 5.1.7 匿名内部类
+
+`kotlin`中可以使用匿名内部类
+
+```kotlin
+// kotlin 新建事件监听
+user.setListener(Listener(){
+	//todo
+});
+```
+
+目前版本UTS还不支持匿名内部类，需要显性的声明再新建
+
+```ts
+// 声明一个新的类，实现Listener
+class MyListener extends Listener{
+	// todo
+}
+// 新建实例
+let myListener = new MyListener();
+user.setListener(myListener);
+```
+
+#### 5.1.8 可为空函数调用
+
+
+有一种特殊场景，我们需要定义一些可为空的函数变量，比如下面的 success,fail：
+
+```ts
+type Option = {
+	success?: (res: object) => void;
+	fail?: (res: object) => void;
+};
+
+```
+
+
+这个时候我们需要这样调用
+
+```ts
+options.success?.(res)
+```
+
+这样的调用方式在kotlin中是非法的，属于TS中的特有语法，需要特别注意。
+
+
+#### 5.1.9 一个类只能有一个构造函数
+
+在`Kotlin`/`java`中允许一个函数有多个构造器，但是UTS中是不被允许的
+
+
+
+#### 5.1.10 界面跳转写法
+
+android开发中场景的 intent跳转需要传入 目标界面的class对象，目前UTS中仅支持一种写法
+
+```ts
+let intent = new Intent(getUniActivity(),DemoActivity().javaClass);
+getUniActivity()!.startActivity(intent);
+```
+
+#### 5.1.11 指定double数据类型
+
+某些场景下开发者需要获得 指定double数据类型的数据
+
+开发者下意识的写法可能是：
+```ts
+// 这样是错误的
+let a:Int =3
+let b:Int =4
+let c:Double  = a/b
+```
+
+但是Android原生环境中，数据类型的精度是向下兼容的，如果想要获得一个double类型，必须要有一个double类型参与运算：
+
+```ts
+// 这样才是正确的
+let a:Int =3
+let b:Int =4
+let c:Double  = a * 1.0 / b
+```
+
+
+---------------------------------
+
+### 5.2 警告优化
+
+下面的内容不会影响功能使用，但是在UTS环境中，有合适的解决办法
+
+#### 5.2.1 java lang包的引入问题
+
+`kotlin` 或者`java` 中java.lang.*是被特殊处理的，可以直接使用而不需要引入。
+
+```kotlin
+// 获取当前时间戳
+System.currentTimeMillis()
+```
+
+
+UTS环境中，lang包没有被特殊对待，需要手动引入。
+
+```ts
+// 手动引入lang包下的类
+import System from 'java.lang.System';
+
+// 获取当前时间戳
+System.currentTimeMillis()
+```
+
+
+#### 5.2.2 `UTS` 不建议使用 快捷构造
+
+`kotlin`  中 支持通过()的方式，快速实现无参构造器的声明
+
+```kotlin
+// 获取当前时间戳
+class ScreenReceiver extends BroadcastReceiver(){
+  
+}
+```
+
+
+UTS环境中，不建议这样做（虽然目前这样做不会影响编译），建议使用手动声明无参构造
+
+```ts
+class ScreenReceiver extends BroadcastReceiver{
+	
+	constructor (){
+		super();
+	}
+
+}
+```
+
+#### 5.2.3 `UTS` 中下划线前缀的变量，有屏蔽未使用警告的含义
+
+```ts
+// IDE会提示 name,status,desc 变量未使用
+onStatusUpdate(name:string, status:Int, desc:string){
+	
+}
+
+// 不会警告变量未使用
+onStatusUpdate(_name:string, _status:Int, _desc:string){
+	
+}
+```
+
+
+## 6  常见问题(持续更新)
+
+### 6.1 如何在UTS环境中，新建一个`activity`？
+
+参考Hello UTS项目中的uts-nativepage插件
+
+路径:
+> ~\uni_modules\uts-nativepage
+
+
+### 6.2 如何在UTS环境中，新建一个`service`？
+
+参考Hello UTS项目中的uts-nativepage插件
+
+路径:
+> ~\uni_modules\uts-nativepage
+
+### 6.3 如何在UTS环境中，新建一个`Thread`？
+
+简单示例
+```ts
+class CustomThread extends Thread{
+	
+	constructor(){
+		super();
+	}
+	
+	override run(){
+		Thread.sleep(1000)
+		console.log("CustomThread = " + Thread.currentThread().getName())
+	}
+}
+```
+
+完整示例参考Hello UTS项目中的uts-nativepage插件
+
+路径:
+> ~\uni_modules\uts-nativepage
+
+
+### 6.4 如果我要实现一个官方已有的三方SDK功能，比如微信支付，如何处理？
+
+因为android中，每个UTS插件都对应一个gradle 子项目，所以类似的情况不能简单复用 自定义基座中的官方依赖。
+
+需要：  **不要勾选官方的依赖，然后在uts插件中，按照文档配置依赖**
+
+### 6.5 UTSCallback 和 UTSJSONObject 是什么？
+
+UTSCallback 和 UTSJSONObject 是UTS内置专门用于UTS环境和前端交互的特定类型。
+
+uni环境与UTS环境交互时，除了基本数据类型之外，涉及function的需要使用UTSCallback替代，涉及复杂对象object需要用UTSJSONObject 替代
+
+
+### 6.6 如何生成android平台Array对象
+
+UTS环境中，默认的数组写法[] / Array()  对应到 android平台的数据结构是 `UTSArray`
+
+理论上来说 `UTSArray`确实更加灵活强大，但是部分android 平台api 明确要求了 Array格式的数据(比如请求权限)
+
+类似场景下，我们就要使用 toTypedArray() 函数进行转换，以便将`MutableList` 转换为对应的`Array`
+
+```typescript
+
+// 得到一个UTSArray
+let permissionArray :String[] = []
+// 得到一个Array
+console.log(permissionArray.toArray())
+// 得到一个MutableList
+console.log(permissionArray.toMutableList())
+```
+
+另外还存在一种特殊情况，即开发者 在UTS中使用了 `kotlin`编写的依赖，这个时候情况稍微复杂些
+
+与`UTS`中只有一种 数组结构相比，`kotlin`中的数组结构要多很多，比如 `IntArray`,`Array`,`MutableList`等,
+
+对于情况，开发者需要注意两点：
+
+
+1  UTS具备类型推导功能，调用第三方依赖是不需要声明类型
+
+```
+// 建议的写法
+let a:IntArray = xxx.getInfo()
+
+// 这样是没必要的，如果一定要这样写，必须要明确了解到kotlin依赖返回的数据结构，否能可能会因为类型错误，导致编译报错
+let a:IntArray = xxx.getInfo()
+
+
+```
+
+2  各种数组类型的转换说明
+
+```
+// IntArray 转 MutableList
+val a = intArrayOf(1,2,3)
+val b = a.toMutableList()
+
+
+// MutableList 转 Array<Int>
+val c = b.toTypedArray()
+
+// Array<Int> 转 IntArray
+val d = c.toIntArray()
+
+
+```
+
+
+
+
+
+
+### 6.7 如何生成byte[]对象
+
+在java平台中，二进制操作一般采用字节数组实现。 
+
+UTS在android平台编译后的语言为Kotlin,对应的语法对象是ByteArray.
+
+使用这个类不需要额外引入包，直接运行即可
+
+下面是一个简单的示例
+
+```
+let byteTest = new ByteArray(5)
+console.log(byteTest)
+```
+
+### 6.8 如何向UTS环境中传递数组参数
+
+在 uni-app 1.0 平台，js环境与原生环境的交互都是经过js引擎桥接
+
+js引擎除了 string,number,boolean 等基本数据结构外，仅支持JSONObject,JSONArray两种。 
+
++ JSONObject 比较常见，基本所有的接口参数都会 对应一个uts中定义的 type 类
++ JSONArray 一般在uts中采用Array数组来承接
+
+下面是一个Array的使用示例：
+
+```
+// UTS插件，声明数组参数
+export function callWithoutParam(filterArray : Array<string>,success: () => void) {
+	console.log(filterArray)
+	success();
+	return { name: "doSthWithCallback" };
+}
+
+```
+
+```js
+// 前端传递数组参数
+UTSHello.callWithoutParam(
+	["system","optionB"]
+	,
+	()=>{
+		uni.showToast({
+			title:'成功调用',
+			icon:'none'
+		});
+	}
+);
+```
+
+
+### 6.9 编译报错：unresolved reference R （R资源无法识别）
+
+UTS插件支持使用android的原生资源，比如动画，布局，字符串等。 [详细说明](https://uniapp.dcloud.net.cn/plugin/uts-for-android.html#_3-1-%E9%85%8D%E7%BD%AEandroidmanifest-xml)
+
+
+如果提示 R资源无法找到:unresolved reference R
+
+1 需要排查资源是否符合android原生格式
+
+2 检查R资源引入的包名是否正确，参考hello uts nativepage插件
+
+```
+import R from 'io.dcloud.uni_modules.uts_nativepage.R';
+```
+
+### 6.10 UTSJSONObject 转 Map 
+
+```
+val extraParam = UTSJSONObject()
+val extraMap = extraParam.toMap()
+```
+
+
+### 6.11  synchronized / Lock 等线程同步概念，在UTS里怎么写?
+
+前端领域里线程安全的解决思路 与java的不同。 他们提供了 async/await 等关键字来实现异步任务处理
+
++ 如果业务代码中有需要多线程、异步任务，建议切换到 async/await 等 uts 语法
+
++ 如果是要翻译原有的java代码到 UTS，可以选择打成AAR来处理。
+
+### 6.12  UTS 如何判断对象数据类型
+
+简单类型判断，返回结果  string/number/object/function 等
+```
+
+let param = "123"
+UTSAndroid.typeOf(param) // string
+
+```
+
+复杂的对象类名判断
+```
+let aa = 12
+// 可以获取到具体的类名
+console.log(aa.javaClass.toString()) // int
+
+```
+
+### 6.13  UTS 如何进行遍历操作
+
+相比于for in / 下标计数等写法， UTS 推荐更现代化的foreach语法 实现集合的遍历。 
+
+数组：
+```
+let arrayObj = utsArrayOf("111","222","333")
+arrayObj.forEach(function(e:any){
+	console.log(e)
+})
+let arrayObj2 = [10,20,30]
+arrayObj2.forEach(function(e:any){
+	console.log(e)
+})
+```
+
+遍历Map:
+
+```
+let mapObj = new Map<string,any>()
+mapObj.put("name","zhangsan")
+mapObj.put("age",12)
+mapObj.forEach(function(value:any,key:string){
+	console.log(key)
+	console.log(value)
+})
+```
+
+遍历UTSJSONObject:(暂未公开)
+
+```
+let utsJsonObj = {
+	name:"zhangsan",
+	age:"22",
+}
+utsJsonObj['classInfo'] = "三年二班"
+utsJsonObj.forEach(function(perField:any){
+	console.log(perField)
+})
+```
+
+### 6.14  UTS 如何实现一个接口
+
+以HelloUTS nativepage插件 部分代码为例：
+ ```
+import OnClickListener from 'android.view.View.OnClickListener';
+// 实现 OnClickListener 接口
+class User {
+	name:string = "name"
+}
+
+ class StartBroadcastListener extends User implements OnClickListener{
+	
+    override onClick(v?: View):void{
+		
+		let myReceiver = new ScreenReceiver();
+		let filter = new IntentFilter();
+		filter.addAction(Intent.ACTION_SCREEN_OFF);
+		filter.addAction(Intent.ACTION_SCREEN_ON);
+		UTSAndroid.getUniActivity()!.registerReceiver(myReceiver, filter);
+		
+		// 提示屏幕状态监听已经注册
+		Toast.makeText(UTSAndroid.getAppContext(),"屏幕状态监听已注册，注意观察控制台日志",Toast.LENGTH_LONG).show();
+		
+    }
+}
+
+
+// 使用
+let btn_start_screen_listen = this.findViewById<Button>(R.id.btn_start_screen_listen);
+btn_start_screen_listen.setOnClickListener(new StartBroadcastListener());
+ ```
+
+如果要同时实现多个接口，采用的也是  implements 和 `,` 分隔来实现
+
+```ts
+class Person{
+	name:string = ""
+}
+class User extends Person implements android.view.View.OnClickListener,Cloneable{
+	constructor(){
+		
+	}
+	
+	override onClick(v?: android.view.View):void{
+		console.log(v)
+	}
+	
+	override equals(other?: any):boolean{
+		return true
+	}
+}
+
+```
+
+编译后的kotlin代码
+
+```
+open class Person {
+    open var name: String = "";
+}
+open class User : Person, android.view.View.OnClickListener, Cloneable {
+    constructor(){}
+    override fun onClick(v: android.view.View?): Unit {
+        console.log(v, " at uni_modules/uts-helloworld/utssdk/index.uts:37");
+    }
+    override fun equals(other: Any?): Boolean {
+        return true;
+    }
+}
+```
+
+其中需要注意的是
+
++ 目前暂不支持匿名声明，需要先定义一个 StartBroadcastListener 声明实现 OnClickListener 后再显性的创建
+
+
+
+
+
+## 7  已知待解决问题(持续更新)
+
+### 7.1 结构入参 boolean 参数默认为true
+
+当以type 结构体为参数时，其内部boolean字段 默认值为false，不支持指定。
+
+### 7.2 目前尚不支持 Math内置
+
+HBuilderX 3.7.1 版本已支持
+
+### 7.3 目前尚不支持 8.x 版本gradle
+
+建议先使用7.X版本，这个问题后续会处理
+
+### 7.4 android原生资源文件，暂不支持三方库依赖
+
+比如xml布局文件中暂时只支持 linearlayout等官方标签，不支持 appcompat等三方库标签。这个问题后续会被处理
+
diff --git a/docs/plugin/uts-for-ios.md b/docs/plugin/uts-for-ios.md
new file mode 100644
index 00000000..fb0d51b1
--- /dev/null
+++ b/docs/plugin/uts-for-ios.md
@@ -0,0 +1,844 @@
+## uts for iOS
+
+本文旨在帮助 iOS 开发者，快速上手 UTS。
+
+需要阅读者具备 iOS 原生应用开发经验。
+
+## 1 了解 UTS 插件是什么
+
+UTS 插件是 uni-app 新型插件形式 [详情](/plugin/uts-plugin)
+
+对于 iOS 开发者来说，我们需要了解的是：
+
+1. 编译时：当我们在保存 UTS 源码文件时，IDE 会同步将其编译为对应的 swift 代码，并且会生成一个对应的插件 Framework 工程在编译出对应的`framework`依赖库
+2. 运行时：在真机运行/云打包时，会将`framework`依赖库添加到打包工程生成最终的 ipa 包
+
+## 2 掌握UTS语法
+
+### 2.1  对于掌握 swift 语言者
+
+因为 UTS 语法与 swift 较类似，建议快速阅读后，在实践中掌握 UTS 语法。[uts语法介绍](/uts/)。
+
+### 2.2  对于仅掌握`objective-c`语言者
+
+尽管开发 UTS 插件，并不要求一定掌握 swift，但是鉴于 UTS 目前在 iOS 平台上，会编译为 swift 源码，掌握 swift 语言，方便排查问题和复杂功能实现。
+
+因此建议学习一下 swift 语法，推荐阅读
+
++ [swift 官方文档](https://docs.swift.org/swift-book/)
++ [swift 中文版](https://swiftgg.gitbook.io/swift/)
+
+### 2.3 数据类型差异
+
+UTS 和 swift 在数据类型上基本保持了一致，但是在部分场景下，还是会有差异，在此特别说明
+
+原则上：  
+
+**数据类型以 UTS 内置的类型为准， 各原生平台都会对其自动适配。**
+
+**当具体平台的 api 参数无法使用 UTS 类型兼容时，允许以对方明确要求的数据类型为准。**
+
+-------------------------
+
+
+#### 举例一： Int、Float、Double 和 Number
+
+UTS 中不存在 Int、Float、Double 类型开发者在开发过程中应该使用  Number 类型覆盖 iOS 平台上使用 Int、Float、Double 的场景
+
+但是当开发中需要重写系统方法或实现第三方依赖库的协议方法（delegate 方法）时，比如 API 明确要求参数为 Int 时，则需要写原生的类型 Int
+
+下面以一个协议方法为例，需要实现一个三方依赖库中定义的协议方法
+
+```swift
+// swift 
+// 此协议定义在其他三方 SDK 中
+protocol TestProtocol {
+   func addTwoInts(_ a: Int, _ b: Int) -> Int
+}
+```
+
+我们在 UTS 中需要实现上面三方库中的协议方法时，由于参数和返回值类型都要求是 Int 类型，为了适应这种情况，UTS 允许开发者使用原生平台的数据类型 Int，来满足原生 API 对数据类型的要求：
+
+```ts
+// UTS 中实现协议方法
+class TestClass implements TestProtocol {
+	addTwoInts(a: Int, b: Int): Int {
+		return a + b
+	}
+}
+```
+
+注意：UTS 中使用 `implements` 关键字表示遵循某个协议，下文会有详细说明
+
+## 3 iOS 原生环境配置
+
+对于 iOS 项目来说，除了源码之外，还会涉及依赖，资源，工程配置等常见问题
+
+本章节将会介绍，UTS插件开发环境中如何配置这些属性
+
+注意：
+
++ 1 本章节内的实例代码均取自Hello UTS [项目地址](https://gitcode.net/dcloud/hello-uts)
++ 2 本章节设计的配置，均需自定义基座后才能生效
+
+### 3.1 配置 Info.plist
+
+当插件需要在原生工程 Info.plist 中添加配置项时，需要在插件的 app-ios 目录中创建 Info.plist 文件
+
+以 hello uts 中的 uts-tencentgeolocation 腾讯定位插件中的配置文件为例:
+
+示例文件在 hello uts 中的位置：
+
+`~/uni_modules/uts-tencentgeolocation/utssdk/app-ios/Info.plist`
+
+此示例表示需要在 Info.plist 中配置 APIKey 及开启后台定位权限
+
+Info.plist 示例：
+
+```xml
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
+<plist version="1.0">
+  <dict>
+	<key>TencentLBSAPIKey</key>
+	<string>您申请的APIKey</string>
+	<key>UIBackgroundModes</key>
+	<array>
+		<string>location</string>
+	</array>
+  </dict>
+</plist>
+```
+
+Info.plist 格式及配置规则与 iOS 工程中是一致的，云端打包时会将配置信息合并到原生工程的 Info.plist 中
+
+### 3.2 配置 entitlements
+> HBuilder X 3.6.11+ 版本支持
+
+当插件需要开启 capabilities 中的相关服务时，需要在插件的 app-ios 目录中创建 UTS.entitlements 文件
+
+比如需要在 capabilities 中勾选 Access WiFi Information 项，对应的 UTS.entitlements 的配置示例：
+
+```xml
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
+<plist version="1.0">
+<dict>
+	<key>com.apple.developer.networking.wifi-info</key>
+	<true/>
+</dict>
+</plist>
+```
+
+UTS.entitlements 格式及配置规则与 iOS 工程中是一致的，云端打包时会将配置信息合并到原生工程的 entitlements 配置文件中
+
+### 3.3 依赖资源文件
+
+如果您的插件需要依赖资源文件比如图片，音频等，可将资源文件放到插件目录下  `~/utssdk/app-ios/Resources/`路径中
+
+云端打包时会将此目录下的所有文件添加到应用 main bundle 中，建议只保存 uts 插件内置的资源文件。
+
+### 3.4 依赖三方库
+
+uts 插件支持依赖三方库，目前支持 framework、xcframework(仅云打包支持)、.a库
+
+#### 3.4.1 framework依赖库说明
+
+需要将依赖的framework或者xcframework文件存放到插件目录下  `~/utssdk/app-ios/Frameworks/`路径中
+
+云端打包时会将此目录中所有的依赖库添加到工程中，建议只存放与插件相关的依赖库
+
+以 hello uts 中的 uts-tencentgeolocation 腾讯定位插件为例，本插件需要依赖腾讯定位库 `TencentLBS.framework`，则将依赖库存放到 `~/uni_modules/uts-tencentgeolocation/utssdk/app-ios/Framework/TencentLBS.framework` 位置即可
+
+#### 3.4.2 .a依赖库相关说明
+##### 3.4.2.1 .a库存放的目录结构
+
+<pre v-pre="" data-lang="">
+	<code class="lang-" style="padding:0">
+└─Libs                         				// .a库存放目录
+	├─MyStaticLibA                 			//A静态库（该库所有文件放在此文件夹内,OC库）
+	│	├─libMyStaticLib.a                  //.a文件，必须
+	│	├─MyStaticLib.h                    	//A.a库对应的头文件，必须
+	│	├─MyClassA.h                     	//需要暴露的头文件A，可选
+	│	└─MyClassB.h              		 	//需要暴露的头文件B，可选
+	└─TestSwiftLibrary                      //B静态库（该库所有文件放在此文件夹内,Swift库）
+		├─libTestSwiftLibrary.a             //.a文件，必须
+		└─TestSwiftLibrary.swiftmodule      //.swiftmodule文件夹，必须
+</code>
+</pre>
+
+注意：
+- 将.a库的所有文件存放在一个文件夹内，多个.a库就创建多个文件夹；
+- 未对某个.a库文件夹下的文件做递归查找，请不要将.a或.h文件嵌套在多层文件夹内，以免发生错误；
+
+##### 3.4.2.2 .a库的使用说明
+
+- OC语言创建的.a库在使用时无需import,可直接使用；
+- Swift语言创建的.a库在使用前需要在uts文件中import；
+- HBuilder X目前暂不支持.a库相关代码的语法提示；
+
+##### 3.4.2.3 .a库的使用示例
+
+- OC语言创建的.a库使用示例：
+
+```ts
+// uts
+const aResult = ToolA.toolAMethod();
+const bResult = ToolB.toolBMethod();
+const libResult = TestLib.testLib();
+
+const res = {
+	aResult: aResult,
+	bResult: bResult,
+	libResult: libResult
+};
+options.success?.(res);
+```
+
+- Swift语言创建的.a库使用示例：
+
+```ts
+// uts
+import { Tool, Manager, TestLibraryExa } from 'TestLibraryExa';
+
+Manager.testManager();
+Tool.testTool()
+let lib = TestLibraryExa();
+lib.test()
+console.log(lib.version);
+```
+
+#### 3.4.3 不包含 Modules 的 framework 使用说明@nomodules
+
+有些第三方的 SDK 使用 OC 语言开发，且产物 .framework 文件里不包含 Moudules 文件夹。这就造成该 SDK 不支持 use module 模式，不能直接在 Swift 文件中导入。
+这样的 SDK 不能直接被 uts 插件引用，需要做以下处理：
+
+##### 有源码的情况
+
+如果你有 SDK 的源码，那么有以下几种方法可以生成 Modules。
+以名称为 `TestSDK` 的 framework 为例：
+
++ 通过创建和 SDK 的 target 同名的头文件方式：
+	- 打开 XCode, 创建一个和 SDK target 同名的 `.h` 文件，如 `TestSDK.h`；
+	- 将需要暴露的 public 文件 导入到 `TestSDK.h` 中，如 `#import <TestSDK/TestA.h>`;
+	- 在 `target` -> `Build Phases` -> `Headers` 中将刚创建的 `TestSDK.h` 设置为 `public`;
+	- 重新编译 SDK, 编译后可以看到 Modules 已经生成。
+	
++ 通过自定义 Module Map 的方式：
+	- 打开 XCode, 在 `TestSDK` SDK 源码目录下创建 ` module.map.modulemap ` 文件；
+	- 在上述文件中键入下面代码中类似的内容，下述代码是以 `TestSDK` 为例，实践时需要改为自己的 SDK 和文件名；
+	- 在 `target` -> `Build Settings` -> `Module Map File` 设置 `Module Map File` 为 `$(PROJECT_DIR)/TestSDK/module.map.modulemap`;
+	- 重新编译 SDK, 编译后可以看到 Modules 已经生成。
+	
+```ts
+framework module TestSDK {
+    header "TestA.h"   //需要对外暴露的头文件，需要为 plubic 的文件
+	
+	header "TestB.h"  //需要对外暴露的头文件，需要为 plubic 的文件
+
+    export *
+}
+```
+
+##### 无源码的情况
+	
+如果使用的是第三方非开源的 SDK, 那么可以使用下面的方式来生成 Modules:
+以 `TestSDK` 为例：
+
++ 在 `TestSDK.framework` 文件夹下创建 `Modules` 文件夹；
++ 在 `Modules` 文件夹下创建 `module.modulemap` 文件；
++ 在上述文件中键入下述的代码(其中的 .h 文件都要是 TestSDK.framework -> Headers 文件夹里的头文件)。
++ 至此 TestSDK 就可以直接放在 uts 插件中使用了。
+
+> 注意： 
+> 实践时要将 `TestSDK` 改成你要操作的 SDK 名称，.h 文件也要改成你要暴露的头文件名字。
+
+```ts
+framework module TestSDK {
+	// 下面的.h 文件都要是 TestSDK.framework -> Headers 文件夹下的头文件
+    header "AClass.h"  
+    
+    header "BClass.h"
+    
+    header "CClass.h"
+    
+    header "DClass.h"
+    
+    export *
+}
+
+```
+
+
+
+## 4 iOS 平台内置库 DCloudUTSFoundation
+> HBuilder X 3.6.11+ 版本支持
+
+DCloudUTSFoundation 为框架内置库，所有 uts 插件都会依赖此基础库
+
+DCloudUTSFoundation 会封装一些常用方法便于开发者直接调用
+
+使用时需要在 uts 文件中先导入 UTSiOS 类，所有方法都通过 UTSiOS 类调用
+
+```ts
+// 从 DCloudUTSFoundation 依赖库中导入 UTSiOS 类
+import { UTSiOS } from "DCloudUTSFoundation"
+```
+
+### 4.1 getCurrentViewController(): UIViewController
+> HBuilder X 3.6.11+ 版本支持
+
+获取当前 app 显示的 UIViewController 实例
+
+以 hello uts 中的 uts-alert 为例：
+
+示例文件在 hello uts 中的位置：
+
+`~/uni_modules/uts-alert/utssdk/app-ios/index.uts`
+
+```ts
+export function showAlert(title: string|null, message: string|null, result: (index: Number) => void) {
+	// uts方法默认会在子线程中执行，涉及 UI 操作必须在主线程中运行，通过 DispatchQueue.main.async 方法可将代码在主线程中运行
+	DispatchQueue.main.async(execute=():void => {
+		
+		// 初始化 UIAlertController 实例对象 alert
+		let alert = new UIAlertController(title=title,message=message,preferredStyle=UIAlertController.Style.alert)
+		
+		// 创建 UIAlertAction 按钮
+		let okAction = new UIAlertAction(title="确认", style=UIAlertAction.Style.default, handler=(action: UIAlertAction):void => {
+			// 点击按钮的回调方法
+			result(0)
+		})
+		
+		// 创建 UIAlertAction 按钮
+		let cancelAction = new UIAlertAction(title="取消", style=UIAlertAction.Style.cancel, handler=(action: UIAlertAction):void => {
+			// 点击按钮的回调方法
+			result(1)
+		})
+		
+		// 将 UIAlertAction 添加到 alert 上
+		alert.addAction(okAction)
+		alert.addAction(cancelAction)
+		
+		// 打开 alert 弹窗
+		UTSiOS.getCurrentViewController().present(alert, animated= true)
+	})
+}
+```
+
+
+#### 4.2 colorWithString(value: string): UIColor
+> HBuilder X 3.6.11+ 版本支持
+
+将字符串色值转换为 UIColor
+
+格式支持
+
+- 精简写法的十六进制 如：#f00
+- 十六进制 如：#ff0000
+- RGB 如：rgb(255, 0, 0)
+- RGBA 如:rgba(255, 0, 0, 0.5)
+- 色值关键字，如： red
+   
+示例
+ 
+```ts
+let bgColor = UTSiOS.colorWithString("#000000")
+view.backgroundColor = bgColor
+```
+
+#### 4.3 getResourcePath(resourceName: string): string
+> HBuilder X 3.6.11+ 版本支持
+
+获取指定插件资源的运行期绝对路径
+
+插架资源路径请传该资源在工程目录下的绝对路径
+   
+示例
+ 
+```ts
+const imagePath = UTSiOS.getResourcePath("/static/logo.png")
+console.log(imagePath)
+const image = new UIImage(contentsOfFile = imagePath)
+/* imagePath: "/var/mobile/Containers/Data/Application/FA7080BA-3EF7-4C4E-B7C5-0332539B2964/Documents/Pandora/apps/__UNI__FB95CAB/www/static/logo.png" */
+
+```
+
+持续更新中
+
+## 5 swift 与 UTS 差异重点介绍 (持续更新)
+
+通过上面的章节的阅读。
+
+至此我们认为你已经掌握了UTS语法，掌握了基本的 swift 语法，掌握了 UTS 对于 iOS 资源的支持。
+
+但是对于一个熟悉 iOS 开发的 swift 语言者来说，有很多常用的习惯发生了改变，我们会在这个章节特别指出，便于开发者加深认识。
+
+
+### 5.1 语法差异
+
+-------------------------------
+
+#### 5.1.1  常量和变量
+
+swift 中用 `let` 来声明常量，用 `var` 来声明变量
+
+```swift
+// swift
+var str = "abc" // 声明一个字符串变量
+let str1 = "abc" // 声明一个字符串常量
+```
+
+`uts`中用 `const` 来声明常量，用 `let` 来声明变量
+
+```ts
+// swift
+let str = "abc" // 声明一个字符串变量
+const str1 = "abc" // 声明一个字符串常量
+```
+
+#### 5.1.2 可选类型
+
+swift 中的可选类型定义为 `类型?`
+
+```swift
+// swift
+var user: String? = nil
+```
+
+ uts 中可选类型的定义为 `类型 | null`
+
+```ts
+// uts
+let user: string | null = null
+```
+
+#### 5.1.3 调用构造方法
+
+swift 中调用构造方法创建实例对象时不需要使用 `new` 关键字
+
+```swift
+var alert = UIAlertController()
+```
+
+uts 中调用构造方法实例化对象时需要在构造方法前加上 `new` 关键字
+
+```ts
+var alert = new UIAlertController()
+```
+
+
+#### 5.1.4 函数参数
+
+在 swift 中参数名称使用 `:` 连接参数值，在 uts 中需要使用 `=` 连接
+
+示例
+
+```swift
+// swift
+var alert = UIAlertController(title: "提示", message: "提示内容", preferredStyle: .alert);
+```
+
+ 
+```ts
+// uts 中写法
+let alert = new UIAlertController(title="提示", message="提示内容", preferredStyle=UIAlertController.Style.alert)
+```
+
+#### 5.1.5 枚举值
+
+枚举在 swift 中可以忽略枚举类型直接简写 `.枚举值` ，在 uts 中不支持简写，需要完整的写出 `枚举类型.枚举值`
+上面的示例中 swift 中最后一个参数 preferredStyle 的值可以简写为
+
+```swift
+.alert
+```
+
+在 uts 中需要完整的写出 
+
+```ts
+UIAlertController.Style.alert
+```
+
+枚举在 swift 中可以定义关联类型，可在关联值中传递信息，但是在 ts 中没有这种语法，所以目前 uts 还暂不支持此种用法。
+
+```swift
+
+// 定义带关联值的枚举
+enum Barcode {
+    case upc(Int, Int, Int, Int)
+    case qrCode(String)
+}
+
+// 定义枚举值
+var productBarcode = Barcode.upc(8, 85909, 51226, 3)
+productBarcode = .qrCode("ABCDEFGHIJKLMNOP")
+
+// 匹配
+switch productBarcode {
+case let .upc(numberSystem, manufacturer, product, check):
+    print("UPC : \(numberSystem), \(manufacturer), \(product), \(check).")
+case let .qrCode(productCode):
+    print("QR code: \(productCode).")
+}
+
+```
+
+如果遇到上述类型的枚举，且在三方库中无法改动的，可以在 Swift 文件中进行调用，然后把 该 Swift 文件打包在 framework 中供 uts 插件使用；
+如果上述类型的枚举定义在有源码的 swift 中时，可以将其定义成不包含关联值的枚举，然后使用合适的数据结构来表示关联值携带的信息。
+
+
+#### 5.1.6 类继承
+
+swift 中定义子类继承父类时需要在子类名称后加上父类名称，中间以冒号`:`分隔
+
+```swift
+// swift
+class Son: Father {
+    
+}
+```
+
+uts 中需要使用`extends`关键字代替冒号`:`
+
+```ts
+// uts
+class Son extends Father {
+
+}
+```
+
+#### 5.1.7 遵循协议方法
+
+swift 中要让自定义类型遵循某个协议，在定义类型时，需要在类型名称后加上协议名称，中间以冒号`:`分隔。遵循多个协议时，各协议之间用逗号`,`分隔：
+
+```swift
+class SomeClass: FirstProtocol, AnotherProtocol {
+
+}
+```
+
+uts 中需要使用`implements`关键字代替冒号 `:`
+
+```ts
+class SomeClass implements FirstProtocol, AnotherProtocol {
+	
+}
+```
+
+#### 5.1.8 系统版本判断
+
+swift 中系统版本判断的方法
+
+```swift
+// swift
+if #available(iOS 10.0, *) {
+    
+}
+```
+
+在 uts 中不支持这种语法可使用下面方式代替
+
+```ts
+if (UTSiOS.available("iOS 10.0, *")) {
+
+}
+```
+
+#### 5.1.9 闭包
+
+swift 中闭包可以简写
+
+```swift
+// swift 中最后一个参数如果是闭包称作为尾随闭包，可以忽略参数标签类型等简写为下面的方式
+let action = UIAlertAction(title: "确认", style: .default) { action in
+            
+}
+```
+
+uts 中不支持简写语法，需要完整的写出闭包函数
+
+```ts
+// uts 中 handler 对应的闭包函数必须写完整
+let action = new UIAlertAction(title="确认", style=UIAlertAction.Style.default, handler=(action: UIAlertAction):void => {
+
+})
+```
+
+原生中有些方法的闭包参数是逃逸闭包，此时就要在闭包前面添加 `@escaping` 标记：
+
+```ts
+// 在闭包参数前添加@escaping
+function requestLocationPromise(@escaping completion: (res: boolean)=>void) {
+
+}
+```
+
+
+#### 5.1.10 target-action 方法
+
+uts 中调用原生中涉及 target-action 的方法时，比如给`UIButton`添加点击事件方法、注册通知中心事件方法时注意事项，
+
+1. 接口要求的 selector 通过 Selector("方法名字符串") 的方法构建
+2. 定义的回调方法需要添加 @objc 前缀
+
+下面以监听截屏事件为例：
+
+示例文件在 hello uts 中的位置：
+
+`~/uni_modules/uts-screenshot-listener/utssdk/app-ios/index.uts`
+
+```ts
+// 注册监听截屏事件及回调方法
+// target-action 回调方法需要通过 Selector("方法名") 构建
+const method = Selector("userDidTakeScreenshot")
+NotificationCenter.default.addObserver(this, selector = method, name = UIApplication.userDidTakeScreenshotNotification, object = null)
+
+// 捕获截屏回调的方法
+// target-action 的方法前需要添加 @objc 前缀
+@objc static userDidTakeScreenshot() {
+    const obj = new UTSJSONObject()
+    // 回调
+    this.listener?.(obj)
+}
+```
+
+#### 5.1.11 字典类型
+
+swift 中的 Dictionary 类型，在 uts 中使用 Map 类型代替
+
+```swift
+// swift
+var value: Dictionary<String,Any> = Dictionary()
+value["name"] = "uts"
+```
+
+```ts
+// uts
+let map: Map<string,any> = new Map()
+map.set("name","uts")
+```
+#### 5.1.12 参数标签的兼容问题
+> HBuilder X 3.6.11+ 版本支持
+
+当覆写系统方法，或实现三方SDK的协议方法时，一些方法可能会存在参数标签的情况
+
+以 hello uts 中腾讯定位为例，监听位置变化时需要实现协议方法：
+
+ `tencentLBSLocationManager(_ manager: TencentLBSLocationManager, didUpdate location: TencentLBSLocation)`
+ 
+ 此方法第二个参数存在 `didUpdate` 参数标签
+
+原生 swift 中的实现为
+
+```swift
+// swift
+func tencentLBSLocationManager(_ manager: TencentLBSLocationManager, didUpdate location: TencentLBSLocation) {
+        var response = LocationResponse();
+        response.name = location.name;
+        response.address = location.address;
+        response.latitude = NSNumber(location.location.coordinate.latitude);
+        response.longitude = NSNumber(location.location.coordinate.longitude);
+        self.locationOptions?.success(response);
+}
+```
+
+uts 中需要用注解语法 @argumentLabel("didUpdate") 来表示参数标签
+
+```ts
+// uts
+// 实现位置更新的 delegate 方法
+tencentLBSLocationManager(manager: TencentLBSLocationManager, @argumentLabel("didUpdate") location: TencentLBSLocation) {
+		let response = new LocationResponse();
+		response.name = location.name;
+		response.address = location.address;
+		response.latitude = Number(location.location.coordinate.latitude);
+		response.longitude = Number(location.location.coordinate.longitude);
+		this.locationOptions?.success(response)
+}
+```
+
+示例文件在 hello uts 中的位置：
+
+`~/uni_modules/uts-tencentgeolocation/utssdk/app-ios/index.uts`
+
+#### 5.1.12.1 无参数标签
+
+只写参数名称的参数，编译后会在参数前默认增加 `_` 来忽略参数标签（如上面的示例，第一个参数 manager，这种方式能兼容绝大多数方法，尤其是Swift 调用 OC 方法），但是有些参数没有参数标签，默认添加 `_` 的行为会和原生方法定义不一致，这种情况需要定义一个空的参数标签来解决 `@argumentLabel("didUpdate")` 
+
+以高德定位 SDK 的代理方法为例：第三个参数 reGeocode 只有参数名称，没有参数标签
+
+```swift
+// swift
+func amapLocationManager(_ manager: AMapLocationManager!, didUpdate location: CLLocation!, reGeocode: AMapLocationReGeocode!)
+```
+
+uts 实现此方法时，需要给 reGeocode 参数添加一个空的参数标签
+
+```ts
+// uts
+amapLocationManager(manager : AMapLocationManager, @argumentLabel("didUpdate") location : CLLocation, @argumentLabel("") reGeocode : AMapLocationReGeocode) {
+
+}
+```
+
+#### 5.1.13 异步方法
+
+swift 标记某个函数或者方法是异步的，你可以在它的声明中的参数列表后边加上 `async` 关键字
+
+```swift
+// swift 
+@available(iOS 13.0.0, *)
+func testAsync(_ opts: AsyncOptions) async -> UTSJSONObject {
+    if (opts.type == "success") {
+        opts.success("success");
+    }
+     else {
+        opts.fail("fail");
+    }
+    opts.complete("complete");
+    return UTSJSONObject([
+        "name": "testAsync"
+    ]);
+}
+```
+
+uts 中定义异步方法是在方法最前面加上 `async` 关键字
+
+```ts
+// uts
+async function testAsync(opts: AsyncOptions) {
+  if (opts.type == "success") {
+    opts.success("success");
+  } else {
+    opts.fail("fail");
+  }
+  opts.complete("complete");
+  return { name: "testAsync" };
+}
+```
+
+**需要注意：使用 async 定义异步方法只有 iOS 13+ 版本才支持，低版本调用会报错**
+
+
+#### 5.1.14 try catch @try
+
+swift中try有以下三种方式:
+
+以JSON反序列化为例
+
+1. 使用try (注意：要和do {} catch {} 一起使用，捕获可能的异常)
+
+```swift
+// swift 
+	do{
+		let dict = try JSONSerialization.jsonObject(with: d, options: [])
+		print(dict)
+	}catch{
+	   // catch 中默认提供error信息, 当序列化不成功是, 返回error
+		print(error)
+	}
+
+```
+
+2. 使用try? 如果能发序列化成功，就返回成功的值，不能成功就返回nil
+
+```swift
+// swift 
+// 注意：dict是个可选值
+	let dict = try? JSONSerialization.jsonObject(with: data, options: [])
+
+```
+
+3. 使用try! 强行try,如果不能反序列化成功，会造成应用闪退, 如果能序列化成功，就返回成功的值，注意该值是个可选值。
+
+```swift
+// swift 
+// 注意：dict是个可选值
+	let dict = try! JSONSerialization.jsonObject(with: data, options: [])
+
+```
+
+为了满足Swift上述语法，UTS使用特殊语法来支持，以上三种写法分别对应为：
+
+1. try
+
+```ts
+// uts
+try {
+	let dict = UTSiOS.try(JSONSerialization.jsonObject(with = data, options = []))
+}catch (e) {
+	console.log(e)
+}
+```
+2. try?
+
+```ts
+// uts
+UTSiOS.try(JSONSerialization.jsonObject(with = data, options = []), "?" )
+
+```
+3. try!
+
+```ts
+// uts
+UTSiOS.try(JSONSerialization.jsonObject(with = data, options = []), "!" )
+
+```
+
+## 6  常见问题(持续更新)
+
+### 6.1 如何在UTS环境中，获取当前 UIViewController 实例
+
+参考 Hello UTS 项目中的 uts-alert 插件
+
+路径:
+> ~/uni_modules/uts-alert/utssdk/app-ios/index.uts
+
+
+### 6.2 如何在UTS环境中，操作 UI 线程
+
+```
+DispatchQueue.main.async(execute=():void => {
+	// 在主线程中可操作 UI
+})
+```
+
+参考Hello UTS项目中的 uts-toast 插件
+
+路径:
+> ~/uni_modules/uts-toast/utssdk/app-ios/index.uts
+
+
+
+## 7  已知待解决问题(持续更新)
+
+### 7.1 语法提示问题
+
+HBuilderX 目前写iOS uts 插件时部分语法提示会有缺失、参数类型不准确的问题，例如：
+
+- 类的构造方法目前只会提示一个，实际上可能会存在多个；
+- 缺失可选类型标识；
+- 参数标签没有标记无法知道是否需要忽略参数标签；
+- 不支持导入包含有子模块的原生模块；
+- 暂不支持.a依赖库的代码提示；
+
+这些问题会在后续版本中优化
+
+### 7.2 语法不兼容问题
+
+#### 7.2.1 for 循环语法问题
+
+- for in  循环目前有语法兼容问题
+- for (int i = 0, i < array.length, i++)  方法目前有语法兼容问题
+
+### 7.3 类型兼容问题
+
+- 元组类型目前不支持
+
+## 8 有关Swift语言创建的Framework和.a的Swift版本兼容性问题
+
+- 由于高版本XCode编译的Swift语言Framework动态库、静态库、.a库在低版本XCode上无法编译通过，因此存在Swift版本兼容性问题;
+- 目前打包机使用的XCode版本号是14.2，对应的Swift版本是5.7.2;
+- 请在编译Swift相关Framework和.a库时选择和打包机相同或者更低版本的XCode;
+- 选择比打包机更低版本XCode编译Swift库时请在Target->buildSettings设置Buid Libraries for Distribution 为Yes。
\ No newline at end of file
diff --git a/docs/plugin/uts-ios-cocoapods.md b/docs/plugin/uts-ios-cocoapods.md
new file mode 100644
index 00000000..1f1a5ee2
--- /dev/null
+++ b/docs/plugin/uts-ios-cocoapods.md
@@ -0,0 +1,293 @@
+本文旨在帮助 uts 插件开发者和使用者，快速了解 uts 插件中配置使用 CocoaPods 依赖的问题。
+包括在Mac系统真机运行时如何配置 CocoaPods 环境，以及 CocoaPods 使用过程中常见错误处理
+
+> 此功能 HBuilder X 3.8.5+ 版本支持
+
+## 在 uts 插件中使用 CocoaPods 依赖@useCocoaPods
+
+在 uts 插件中使用 CocoaPods 依赖库，需要在 config.json 中 dependencies-pods 节点做相应配置，下面是配置示例：
+
+```json
+{
+	"deploymentTarget": "9.0",   // 可选，插件支持的最低 iOS 版本  默认：9.0"
+	"dependencies-pods": [ // 可选, 需要依赖的 CocoaPods 库, HBuilderX 3.8.5+ 版本支持
+	{
+		"name": "WechatOpenSDK",  
+		"version": "2.0.2"     
+	}, {
+		"name": "Alamofire",
+		"version": "5.7.3", //配置 repo 时可不指定 version
+		"repo": {  // 可选，配置 pod 库为指定仓库，配置repo时，应至少指定 git。 （HBuilder X 3.8.10+ 版本新增支持）
+			"git": "https://github.com/test/Alamofire.git", //指定 pod 库的仓库地址
+			"tag": "5.7.3", // 指定该 pod 库仓库的 tag
+			"branch": "dev", // 指定该 pod 库仓库的分支
+			"commit": "b309714f3aa5091f1ce8d932094b7594ed7acad9" // 指定该 pod 库仓库的某次commit
+		}
+	}]
+}
+```
+
+**配置说明：**
+- deploymentTarget：插件支持的最低 iOS 版本号，此节点为可选项，默认设置为 9.0.
+	+ 插件支持的最低版本号应该设置为所有依赖的三方库（包含 framework .a pod ）中最低支持版本号中的最高的一个。
+	+ pod 库的最低支持系统版本号可在 pod 库的 spec 文件或者 readme 中查看。
+- dependencies-pods：插件需要依赖的 pod 库,  HBuilderX3.8.5+ 版本新增支持
+	+ 把需要依赖的 pod 库相关信息配置在 dependencies-pods 节点下，需要明确指定每个 pod 库的名字 (name)。 按需指定版本号 version 或者 repo （至少应配置 version 或 repo 中的一个，repo 优先级高于 version， 配置 repo 时 version 不再生效），可同时配置多个 pod 依赖库。目前不支持通过 podfile 文件直接设置，也不支持 podfile 文件中除了 name 、 version 、pod 特定仓库之外的其他配置项。
+	+ 为了保证插件的稳定性，避免因未指定 pod 库版本，执行 pod install 之后 pod 库最新版本造成的代码不兼容问题，在未配置 repo 时需要明确指定 pod 库的具体版本。此时 version 字段不可省略，不可为空字符串。 建议将 version 配置为 `"9.7.0"` 这种明确的数字版本号，不建议使用 `~>, >, >=, <, <=` 等带符号的配置。
+	+ repo: 自定义 pod 库仓库地址信息, HBuilderX3.8.10+ 版本新增支持
+		+ 如果你需要自己指定 pod 库的仓库地址: git, tag, branch, commit 等信息，可以通过repo字段配置。请注意： repo 是一个对象，其中至少应包含 git 字段（用来指定 pod 库的仓库地址）。当你同时指定 tag、 branch、 commit 时，CocoaPods 会默认使用 commit，通常可以根据需要指定 tag / branch / commit 中的一个。当正确配置 repo 时 version 不再生效，此时可以省略 version 的配置。
+	+ 使用 CocoaPods 官方默认地址 (source 'https://cdn.cocoapods.org/'), 暂不接受 source 配置。
+
+
+## CocoaPods 环境配置@config
+
+在Mac系统上使用标准基座真机运行时才需要配置 CocoaPods 环境， 使用自定义调试基座提交云端打包则可以不配置 CocoaPods 环境。
+在Windows系统上不支持 CocoaPods 环境，只能提交云端打包使用自定义调试基座。
+
+### CocoaPods安装
+
+正常安装 CocoaPods 需要在终端执行下述命令
+
+```
+gem install cocoapods
+```
+
+#### CocoaPods 安装成功
+
+这会耗费一段时间，完成后可查看 cocoapods 的版本号
+
+```
+pod --version
+```
+如： 1.12.1
+
+也可以查看 pod 的安装位置
+
+```
+which pod
+```
+如：/Users/dcloud/.rvm/rubies/ruby-3.0.0/bin/pod
+
+至此 CocoaPods 已经安装完成，可以尝试 Search 下一 pod 库：
+
+```
+pod search Alamofire
+```
+
+如果执行 pod search 失败，说明当前网络不能正常访问 github 或者 cdn, 更多信息详见[无法访问 github ](https://uniapp.dcloud.net.cn/plugin/uts-ios-cocoapods.html#timeout), [CDN错误](https://uniapp.dcloud.net.cn/plugin/uts-ios-cocoapods.html#cnderror)。
+
+#### CocoaPods 安装失败
+
+- 如果执行 gem install cocoapods 之后报下面的错误：
+
+```
+ERROR:  Error installing cocoapods:
+        The last version of activesupport (>= 5.0, < 8) to support your Ruby & RubyGems was 6.1.7.3. Try installing it with `gem install activesupport -v 6.1.7.3` and then running the current command again
+        activesupport requires Ruby version >= 2.7.0. The current ruby version is 2.6.10.210.
+```
+说明缺少activesupport插件，在终端执行以下命令
+
+```
+sudo gem install activesupport -v 6.1.7.3
+```
+插件安装成功后再次执行 sudo gem install cocoapods 安装 CocoaPods.
+
+
+- 如果报错如下，说明需要升级 gem 和 ruby
+
+```
+Building native extensions. This could take a while...
+ERROR: Error installing cocoapods:
+ERROR: Failed to build gem native extension.
+current directory: /Library/Ruby/Gems/2.6.0/gems/ffi-1.15.5/ext/ffi c
+/System/Library/Frameworks/Ruby.framework/Versions/2.6/usr/bin/ruby-I/System/Library/Frameworks/Ruby.framework/Versions/2.6/usr/lib/ruby/2.6.0-r./siteconf20230612-9566-nht0td.rbextconf.rb
+mkmf.rb can't find header files for ruby at /System/Library/Frameworks/Ruby.framework/Versions/2.6/us/lib/ruby/include/ruby.h
+You might have to install separate package for the ruby development environment, ruby-dev or ruby-devel for example.
+extconf failed, exit code 1
+Gem files will remain installed in /Library/Ruby/Gems/2.6.0/gems/ffi-1.15.5 for inspection.
+Results logged to /Library/Ruby/Gems/2.6.0/extensions/universal-darwin-22/2.6.0/ffi-1.15.5/gem make.out
+```
+
+下面是升级 Gem 和 Ruby 的方法
+
+### 升级 Gem
+
+Gem 是管理 Ruby 标准包,如果 Gem 版本过低可能造成无法安装 CocoaPods,升级 Gem 使用下述命令
+
+```
+gem -v  //查看当前gem版本
+sudo gem update --system　  //升级gem
+```
+
+### 升级 Ruby
+
+MacOS 会自带 Ruby，但可能系统的Ruby版本过低，导致无法安装 CocoaPods, 可通过以下方式更新 Ruby
+
+- 如果没有安装 Homebrew，可以先在终端中输入以下命令安装 Homebrew：
+
+```
+/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
+```
+
+Ruby 的升级有以下两种常见的方式，可根据自己的需要任选其中一种：
+
+#### 通过 RVM 升级 Ruby
+
+- 安装 RVM：在终端中输入以下命令安装 RVM：
+
+```
+curl -sSL https://get.rvm.io | bash -s stable
+```
+
+这个命令会从 RVM 官网下载安装脚本并运行。安装完成后，需要在终端中执行以下命令以便让 RVM 生效：
+
+```
+source ~/.rvm/scripts/rvm
+```
+
+- 查看 rvm 版本
+
+```
+rvm -v
+```
+
+- 查看可安装的 ruby 版本列表
+
+```
+rvm list known
+```
+
+- 安装指定 ruby 版本（eg:安装 ruby 3.0.0版本）
+
+```
+rvm install ruby-3.0.0
+```
+
+- 切换 Ruby 使用版本（eg:指定使用3.0.0版本）
+
+```
+rvm use ruby-3.0.0
+```
+
+#### 通过 Homebrew 升级 Ruby
+
+在终端执行如下命令
+
+```
+ brew install ruby
+```
+
+安装完成后，ruby 默认使用的是系统自带的版本
+
+- 查看版本号
+
+```
+ruby -v
+```
+- 查看 ruby 安装路径
+
+```
+ which ruby
+```
+- 配置环境变量
+
+```
+ echo 'export PATH="/opt/homebrew/opt/ruby/bin:$PATH"' >> ~/.zshrc
+```
+- 配置完成后重启终端，再次查看 Ruby 版本号，校验是否为安装的 Ruby版本
+
+
+升级完 Gem 和 Ruby 后，在终端重新输入如下命令安装 CocoaPods。
+
+```
+sudo gem install cocoapods
+```
+安装完成后，可如上文所示，查看 CocoaPods 版本号。
+
+
+
+## 常见问题@questions
+
+### MAC 环境真机运行 uts 插件时未安装 CocoaPods@notInstall
+
+错误信息：uni_module [xxxx](iOS)存在pod三方依赖库，请先安装 CocoaPods！
+说明：出现此错误是因为当前环境没有安装 CocoaPods
+处理方法： 请参照上述章节描述的方式安装 CocoaPods 工具。
+
+### 找不到指定版本的 pod 库，或者找不到指定依赖@noDependency
+
+错误信息：CocoaPods could not find compatible versions for pod "xxx"  或者 None of your spec sources contain a spec satisfying the dependency:
+报错示例：
+
+```ts
+'Analyzing dependencies\n' +
+    '[!] CocoaPods could not find compatible versions for pod "HandyJSON":\n' +
+    '  In Podfile:\n' +
+    '    HandyJSON (= 2.0.2)\n' +
+    '\n' +
+    'None of your spec sources contain a spec satisfying the dependency: `HandyJSON (= 2.0.2)`.\n' +
+    '\n' +
+    'You have either:\n' +
+    ' * out-of-date source repos which you can update with `pod repo update` or with `pod install --repo-update`.\n' +
+    ' * mistyped the name or version.\n' +
+    ' * not added the source repo that hosts the Podspec to your Podfile.\n',
+```
+
+说明：出现此错误是因为执行 pod install 时找不到指定依赖。
+
+处理方法：
+
+- 请首先确保配置的 pod 库 name 正确，配置的 version 不高于 pod 库发行的最高版本号。
+- 确保未使用存放在私有仓库的 pod 库。
+- 真机运行时在确保配置正确的前提下触发重新编译。
+- 云打包时请重新打包，或者联系管理员。
+
+### 无法访问 github@timeout
+
+错误信息示例：
+
+```ts
+'[!] Error installing Alamofire\n' +
+'[!] /usr/bin/git clone https://github.com/Alamofire/Alamofire.git /var/folders/9h/2znqhy813g932mrj_c9f781w0000gn/T/d20230614-22451-49mc32 --template= --single-branch --depth 1 --branch 5.7.1\n' +
+'\n' +
+"Cloning into '/var/folders/9h/2znqhy813g932mrj_c9f781w0000gn/T/d20230614-22451-49mc32'...\n" +
+"fatal: unable to access 'https://github.com/Alamofire/Alamofire.git/': error:02FFF03C:system library:func(4095):Operation timed out\n",
+```
+
+说明： 出现此错误是因为当前网络无法正常访问 github
+
+处理方法：
+- 请检查您的网络连接，或者使用翻墙工具，确保当前网络环境可以正常访问 github
+
+### CDN 错误@cnderror
+
+错误信息示例：
+
+- 示例一 无法解析 CDN 主机名
+
+```ts
+"[!] CDN: trunk URL couldn't be downloaded: https://cdn.cocoapods.org/all_pods_versions_8_e_e.txt Response: Couldn't resolve host name\n",
+```
+
+- 示例二 trunk Repo 更新失败
+
+```ts
+'[!] CDN: trunk Repo update failed - 75 error(s):'
+```
+
+- 示例三 验证失败
+
+```ts
+"[!] CDN: trunk URL couldn't be downloaded: https://cdn.cocoapods.org/deprecated_podspecs.txt Response: SSL peer certificate or SSH remote key was not OK"
+```
+
+- 示例三 连接不到服务器
+
+```ts
+"[!] CDN: trunk URL couldn't be downloaded: https://cdn.cocoapods.org/all_pods_versions_f_2_b.txt Response: Couldn't connect to server"
+```
+
+说明： 出现此类错误是因为网络网络问题无法正常访问 [CDN 服务器](https://cdn.cocoapods.org)
+
+处理方式：
+- 真机运行：检查您的网络，确保网络连接正常，或者使用翻墙工具，使当前网络环境可以正常访问 [CDN 服务器](https://cdn.cocoapods.org)。在网络不好时，请多试几次。
diff --git a/docs/plugin/uts-plugin.md b/docs/plugin/uts-plugin.md
new file mode 100644
index 00000000..3e8a79e0
--- /dev/null
+++ b/docs/plugin/uts-plugin.md
@@ -0,0 +1,1140 @@
+# UTS插件介绍
+
+## 介绍
+
+> HBuilderX 3.6+ 支持uts插件
+
+UTS插件开发官方QQ交流群：527828934 [点此加入](https://qm.qq.com/cgi-bin/qm/qr?k=3Z-cQCXGiTyThkrqufUNNw7TaJd2xEPb&jump_from=webapi&authKey=4UQdplol3kPLwlDfuSdYleE8JUHnJChC2+8HcuBavZq2q51iAkLdzT4Bupt4ZJZu)
+
+### 什么是uts语言
+
+uts，全称 uni type script，统一、强类型、脚本语言。
+
+它可以被编译为不同平台的编程语言，如：
+
+- web平台，编译为JavaScript
+- Android平台，编译为Kotlin
+- iOS平台，编译为Swift（HX 3.6.7+ 版本支持）
+
+uts 采用了与 ts 基本一致的语法规范，支持绝大部分 ES6 API。
+
+如需详细了解uts语法，另见[uts语法介绍](/uts/)
+
+uts语言，
+- 可以用来开发独立App，即[uni-app x](https://doc.dcloud.net.cn/uni-app-x/)；
+- 也可以用来开发插件，即uts插件。
+
+### 什么是uts插件
+
+uts插件，指利用uts语法，操作原生的API（包括手机os的api或三方sdk），并封装成一个[uni_modules](https://uniapp.dcloud.net.cn/plugin/uni_modules.html)插件，供前端调用。
+
+- uni-app中，是js来调用uts插件。（HBuilderX 3.6支持vue3编译器，3.6.8支持vue2编译器）
+- uni-app x中，是uts来调用uts插件。（HBuilderX 3.9支持）
+
+也就是一个uts插件，可以同时支持uni-app和uni-app x。
+
+为了兼容全端，uts插件可以分目录写所有平台代码，也就是一个uts插件除了支持App的扩展，还可以支持web、小程序。
+
+比如这个uts插件，[电量](https://ext.dcloud.net.cn/plugin?id=9295)，其源码在[https://gitcode.net/dcloud/uni-api/-/tree/master/uni_modules/uni-getbatteryinfo](https://gitcode.net/dcloud/uni-api/-/tree/master/uni_modules/uni-getbatteryinfo)，内部有多个目录（app-android、app-ios、web、mp-weixin、mp-alipay...），在非App目录也可以写js。
+
+这个电量插件在uni-app和uni-app x中均可以使用。
+
+uts插件分api和组件。这和uni-app的组件、api的概念是一样的。
+- api插件：uts插件扩展了api能力，在script里调用
+- 组件插件：uts插件扩展了界面组件，在template里调用。它是要内嵌在页面中。
+
+api插件也可以操作界面，但更多是独立的全屏窗口或弹出窗口。而不能嵌入在template中。
+
+比如lottie动画的uts插件，就是一个组件插件。[https://ext.dcloud.net.cn/plugin?id=10674](https://ext.dcloud.net.cn/plugin?id=10674)，其源码在[https://gitcode.net/dcloud/uni-component/-/tree/master/uni_modules/uni-animation-view](https://gitcode.net/dcloud/uni-component/-/tree/master/uni_modules/uni-animation-view)
+
+![uts插件结构](https://native-res.dcloud.net.cn/images/uts/UTS%E7%BB%93%E6%9E%84%E7%A4%BA%E6%84%8F%E5%9B%BE1.png)
+
+### uts插件与uni原生语言插件的区别
+
+uts 插件编译到 app 平台时，在功能上相当于 uni-app 之前的 app 原生插件。都是给app扩展原生能力。
+
+开发 uts 插件不需要熟悉 Kotlin 和 Swift 的语法，因为使用的是 uts语法。但需要熟悉 Android 和 iOS 的系统 API，至少需要知道什么原生能力在哪个API里。
+
+在 HBuilderX 3.6 以前，uni-app 在 App 侧只有一种原生插件，即用 java 或 Objective-C 开发的插件。
+
+在 uts 推出后，原来的 “App原生插件”，更名为 “App原生语言插件”。
+
+不同的名字，代表它们需要开发者编写语言不同。但殊途同归，最后都编译为原生的二进制代码。
+
+|				|原生语言插件				|uts插件|
+|:------		|:-------					|:--------|
+|开发语言		|java/oc					|uts|
+|开发环境		|Android Studio/XCode		|HBuilderX|
+|打包方式		|外挂aar 等产出物			|编译时生成原生代码|
+|js层调用方式	|uni.requireNativePlugin()	|普通的js函数/对象，可以直接 import，支持摇树优化|
+|支持项目类型	|uni-app					|uni-app和uni-app x|
+
+相对原生语言插件，uts插件的优势：
+
+1. 统一了编程语言（uts），一种语言开发所有平台，真正大前端。
+2. 统一了开发工具（HBuilderX），免除搭建复杂的原生开发环境。
+3. 插件封装中要理解的概念更少。 传统原生语言插件需要在js和原生层处理通信，使用各种特殊转换，使用特殊语法导入，注意事项很多。**uts统一为纯前端概念，简单清晰。**
+4. uts 下前端和原生可以统一在 HBuilderX 中联调。而传统原生语言插件需要在多个开发工具间切换，联调复杂。
+5. 插件市场的uts插件支持下载后自己固定版本。而付费的原生语言插件只能使用最新版。
+6. 插件市场的uts付费插件支持源码版销售和源码版权保护机制。而付费的原生语言插件不支持源码版销售。
+7. uts插件可同时支持uni-app和uni-app x。
+
+如果您是插件作者，可以了解更多uts插件和uni原生语言插件对插件作者的区别。[详见](https://uniapp.dcloud.net.cn/plugin/publish.html#utsdiff)
+
+### uts插件和Native.js的区别
+
+- [Native.js](../tutorial/native-js.md) 运行在js上，通过反射调用os api。功能和性能都不及原生
+- uts 在 app 上不运行在 js 引擎里，是真正的原生。
+
+
+## 创建uts插件
+
+### uts 插件目录结构
+
+在 uni-app 的项目工程下，提供了独立的目录 `utssdk`，来存放 uts 插件。
+
+当然官方更推荐使用 [uni_modules](uni_modules.md) 方式，这是更好的包管理方案。
+
+首先确保项目根目录存在 uni_modules 文件夹，如果不存在，需要手动创建一个。
+
+![插件目录](https://native-res.dcloud.net.cn/images/uts/uni_modules.jpg)
+
+### 新建步骤拆解
+
+右键点击`uni_modules`目录 -> 新建插件
+
+![新建插件1](https://native-res.dcloud.net.cn/images/uts/new_uts_plugin.jpg)
+
+选择类型 **uts插件**
+
+![新建插件2](https://native-res.dcloud.net.cn/images/uts/new_uts_plugin2_1.jpg)
+
+**为了避免和插件市场的其他插件冲突，建议起一个自己的插件前缀名称。**
+
+uts插件目录结构
+
+![新建插件3](https://native-res.dcloud.net.cn/images/uts/new_uts_plugin3_1.jpg)
+
+
+### package.json
+
+package.json 为 uni_modules 插件配置清单文件，负责描述插件的基本配置。
+
+
+```json
+{
+  "id": "uts-helloworld",
+  "displayName": "uts插件示例",
+  "version": "0.1",
+  "description": "uts插件示例",
+  "uni_modules": {
+    
+  }
+}
+```
+
+上面是一个默认的清单文件示例,关于 package.json 更多描述[详见](uni_modules.md#package.json)
+
+### 插件的目录结构
+
+<pre v-pre="" data-lang="">
+	<code class="lang-" style="padding:0">
+┌─common                          // 可跨端公用的uts代码。推荐，不强制
+├─static                          // 静态资源
+├─utssdk
+│	├─app-android                 //Android平台目录
+│	│	├─assets                  //Android原生assets资源目录，可选
+│	│	├─libs                    //Android原生库目录，可选
+│	│	├─res                     //Android原生res资源目录，可选
+│	│	├─AndroidManifest.xml     //Android原生应用清单文件，可选
+│	│	├─config.json             //Android原生配置文件
+│	│	└─index.uts               //Android原生插件能力实现
+│	├─app-ios                     //iOS平台目录
+│	│	├─Frameworks              //iOS原生依赖的第三方 framework 依赖库存放目录，可选
+│	│	├─Libs              	  //iOS原生依赖的第三方 .a 依赖库存放目录，可选
+│	│	├─Resources               //iOS原生所依赖的资源文件存放目录，可选
+│	│	├─info.plist              //iOS原生所需要添加到主 info.plist 文件中的配置文件，可选
+│	│	├─UTS.entitlements        //iOS原生所需要添加到主工程 .entitlements 文件中的配置文件，可选
+│	│	├─config.json             //iOS原生配置文件
+│	│	└─index.uts               //iOS原生插件能力实现
+│	├─web                         //web平台目录
+│	│	└─index.uts
+│	├─mp-alipay                   // 支付宝小程序平台，可选
+│	├─mp-baidu                    // 百度小程序平台，可选
+│	├─mp-jd                       // 京东小程序平台（仅限vue2），可选
+│	├─mp-kuaishou                 // 快手小程序平台，可选
+│	├─mp-lark                     // 飞书小程序平台，可选
+│	├─mp-qq                       // QQ小程序平台，可选
+│	├─mp-toutiao                  // 抖音小程序平台，可选
+│	├─mp-weixin                   // 微信小程序平台，可选
+│	├─mp-xhs                      // 小红书小程序平台（仅限vue2），可选
+│	├─index.d.ts                  // 插件能力声明，可选，将废弃，推荐使用interface.uts
+│	├─interface.uts               // 声明插件对外暴露的API
+│	└─index.uts                   // 跨平台插件能力实现，可选
+└─package.json                    // 插件清单文件
+</code>
+</pre>
+
+
+根目录 index.uts 文件是程序主入口。如果插件根目录下没有 index.uts，则会在编译到不同平台时，寻找分平台的目录下的 index.uts 文件。
+
+比如编译到 app-android 平台时，如果 uts 插件根目录没有 index.uts，会寻找 utssdk/app-android/index.uts。如果也没有找到，会报错。
+
+当同时存在分平台目录的 index.uts 和根目录 index.uts 时，会优先获取具体的分平台目录。
+
+开发者有多种组织自己代码的方式：
+
+1. 在插件根目录的 index.uts 中写条件编译代码。简单的业务一个文件搞定
+2. 在插件根目录 index.uts 中写条件编译，import 分平台的文件
+3. 不写根目录的 index.uts，直接在分平台目录写 index.uts。不跨端时，比如只做一个 Android 插件，这样写比较简单
+
+index.d.ts 文件是对当前插件能力的**声明**，用于语法提示。已不推荐使用，请使用interface.uts。
+
+因为 uts 写好后，HBuilderX 可以自动识别 uts api 并进行语法提示。它更多的用于后续 uts 插件加密时给予语法提示。
+
+如果不熟悉 d.ts，可以自行网上搜索，它属于 ts 标准技术。
+
+### App原生配置
+
+#### Android平台原生配置
+
+app-android 文件夹下存在Android平台原生配置，包括以下目录或文件
+
+|目录名/文件名			|用途									|
+|---					|---									|
+|assets					|Android平台原生assets资源目录			|
+|libs					|Android平台原生引用的三方jar/aar目录		|
+|res					|Android平台原生res资源目录				|
+|AndroidManifest.xml	|Android平台原生应用清单文件				|
+|config.json			|Android平台下的配置文件					|
+|index.uts				|主入口，interface.uts/index.d.ts声明的能力在Android平台下的实现	|
+
+
+##### assets  
+Android平台原生assets资源目录，建议只保存UTS插件内置的资源文件。
+
+除了插件下有assets目录，项目下也有。注意2者的区别。
+如果需要插件使用者配置（如三方SDK的授权文件），则插件作者应该在插件文档中告诉插件使用者，配置到项目的Android原生应用资源目录，而不是配置在插件目录下。[详见](https://uniapp.dcloud.net.cn/tutorial/app-nativeresource-android)
+
+##### libs  
+Android平台原生三方库目录，支持以下类型文件：
+- jar 
+- aar
+- so库
+
+如果封装三方原生sdk为uni-app插件，可以将sdk的jar/aar文件放到此目录，但因为多个uts插件引用相同三方原生sdk时可能会产生冲突，所以如果sdk支持仓储，建议优先使用仓储配置，而不是直接把jar等文件放在libs目录。
+
+仓储配置参考config.json的[dependencies](#dependencies)。  
+
+如果使用的三方sdk包含了so库，保存到此目录时，需按Android的abi类型分目录保存。
+
+关于libs目录的使用，可以参考 [Hello UTS](https://gitcode.net/dcloud/hello-uts/-/tree/master/uni_modules)
+
+
+##### res  
+Android平台原生res资源目录，建议只保存UTS插件内置的资源文件。
+
+除了插件下有res目录，项目下也有。注意2者的区别。一般使用者的配置不放在插件下，而放在自己的项目下。项目下配置[详见](https://uniapp.dcloud.net.cn/tutorial/app-nativeresource-android)
+
+
+##### AndroidManifest.xml  
+Android原生应用清单文件，建议只保存UTS插件内置的清单文件配置。
+
+除了插件下有AndroidManifest.xml，项目下也有。注意2者的区别。一般使用者的配置不放在插件下，而放在自己的项目下。项目下配置[详见](https://uniapp.dcloud.net.cn/tutorial/app-nativeresource-android)
+
+##### config.json
+uts插件在Android平台的原生层配置文件，可以在其中配置依赖仓储等gradle相关内容。
+
+```json
+{
+	// 使用NDK时支持的CPU类型，可选（打包时不要复制注释）
+	"abis": [
+	    "使用NDK时支持的cpu类型, 可取值armeabi-v7a|arm64-v8a|x86|x86_64"
+	],
+    // 依赖的仓储配置，可选，打包时会合并到原生工程的build.gradle中（打包时不要复制注释）
+	"dependencies": [
+		"androidx.core:core-ktx:1.6.0",
+		{
+			"id": "com.xxx.richtext:richtext",
+			"source": "implementation 'com.xxx.richtext:richtext:3.0.7'"
+		}
+	],
+    // Android系统版本要求，最低Android 5.0（打包时不要复制注释）
+	"minSdkVersion": 21,
+	"project": {
+		"plugins": [
+			"com.huawei.agconnect"
+		],
+		"dependencies": [
+			"com.huawei.agconnect:agcp:1.6.0.300"
+		]
+	}
+}
+```
+
+- abis  
+当插件使用了NDK开发的so库时配置，描述插件支持CPU类型。  
+可取值：armeabi-v7a、arm64-v8a、x86、x86_64
+
+<a id="dependencies"/>
+
+- dependencies  
+配置插件依赖的仓储，云端打包时会合并到Android原生工程的build.gradle的  
+数组类型，数组中的项可以是字符串类型或JSON对象  
+对于字符串类型项，将会作为`implementation`方式依赖添加到build.gradle中，上面示例中"androidx.core:core-ktx:1.6.0"将会添加以下配置  
+```
+dependencies {
+  implementation 'androidx.core:core-ktx:1.6.0'
+}
+```
+对于JSON类型项，将会把source字段值作为gradle源码添加到build.gradle中，上面示例中"id": "com.xxx.richtext:richtext"项将会添加以下配置  
+```
+dependencies {
+  implementation 'com.xxx.richtext:richtext:3.0.7'
+}
+```
+
+- minSdkVersion  
+插件支持的Android最低版本，整数类型，取值范围为Android API Level
+
+默认uni-app最低支持版本为19，即Android4.4.2
+
+- project  
+	云端打包项目相关配置，当使用的三方SDK需要配置gradle插件时可配置此项：  
+	+ plugins  
+		此配置将会添加到云端打包工程app及build.gradle文件的“plugins”中：  
+```
+plugins {
+    id 'com.android.application'
+    // 前面config.json示例配置将会添加如下配置
+    id 'com.huawei.agconnect'
+}
+```
+	+ dependencies  
+		此配置将会添加到云端打包工程项目级build.gradle文件的“buildscript > dependencies”中  
+```
+buildscript {
+    dependencies {
+		classpath 'com.android.tools.build:gradle:7.2.0'
+		// 前面config.json示例配置将会添加如下配置
+        classpath "com.huawei.agconnect:agcp:1.6.0.300"
+	}
+}
+```
+
+
+**注意：**
+
+- Android平台原生配置（包括引入、变更三方sdk）均需提交云端打包才能生效，真机运行时需使用[自定义基座](https://uniapp.dcloud.net.cn/tutorial/run/run-app.html#customplayground)
+
+- HBuilderX 内置了android常见的依赖：内置依赖清单 ，开发者需要注意两点：
+
+    1 内置清单中涉及的依赖，无需手动添加，即可直接使用
+
+    2 请勿通过 手动添加jar/aar 等方式引入相同的依赖，否则会因依赖冲突导致云打包失败。
+
+#### iOS 平台原生配置
+
+app-ios 文件夹下存在iOS平台原生配置，包括以下目录或文件
+
+|目录名/文件名		|用途													|
+|:---				|:---													|
+|Frameworks			|iOS平台插件需要引用的三方 framework 依赖库存放目录			|
+|Libs				|iOS平台插件需要引用的三方 .a 依赖库存放目录			    |
+|Resources			|iOS平台插件需要引用的资源文件存放目录						|
+|Info.plist			|iOS平台插件需要添加到原生工程Info.plist中的配置文件			|
+|UTS.entitlements	|iOS平台插件需要添加到原生工程 entitlements 文件中的配置文件		|
+|config.json		|iOS平台原生工程的配置文件									|
+|index.uts			|主入口，interface.uts/index.d.ts声明的能力在iOS平台下的实现				|
+
+##### Frameworks 
+iOS平台插件依赖的三方framework存放目录，支持以下类型文件：
+
+- framework  
+- xcframework
+
+注意：目前支持静态库和动态库
+
+##### Libs@ios-libs 
+> HBuilder X 3.7.2+ 版本支持
+
+iOS平台插件依赖的三方.a库存放目录，支持以下类型的.a库：
+
+- 使用OC语言创建的.a库  
+- 使用Swift语言创建的.a库
+
+备注：有关OC及Swift创建的.a库的区别、.a库的使用方法和注意事项[详见](https://uniapp.dcloud.net.cn/plugin/uts-for-ios)
+
+##### Resources
+iOS平台原生资源目录，建议只保存uts插件内置的资源文件。云端打包时会将此目录下的所有文件添加到应用 main bundle 中。  
+
+除了插件下有Resources目录，项目下也有。注意2者的区别。一般使用者的配置不放在插件下，而放在自己的项目下。项目下配置[详见](https://uniapp.dcloud.net.cn/tutorial/app-nativeresource-ios.html#%E8%B5%84%E6%BA%90%E6%96%87%E4%BB%B6-bundle-resources)  
+
+##### Info.plist
+iOS平台原生 Info.plist 文件配置，云端打包时会将配置信息合并到原生工程的 Info.plist 中。
+
+除了插件下有Info.plist，项目下也有。注意2者的区别。一般使用者的配置不放在插件下，而放在自己的项目下。项目下配置[详见](https://uniapp.dcloud.net.cn/tutorial/app-nativeresource-ios.html#%E9%85%8D%E7%BD%AE%E6%96%87%E4%BB%B6-info-plist)
+
+示例： 添加自定义字段 TencentLBSAPIKey 和 开启后台定位
+
+```xml
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
+<plist version="1.0">
+  <dict>
+	<key>TencentLBSAPIKey</key>
+	<string>填写您申请的APIKey</string>
+	<key>UIBackgroundModes</key>
+	<array>
+		<string>location</string>
+	</array>
+  </dict>
+</plist>
+```
+
+##### UTS.entitlements
+iOS平台原生 entitlements 文件配置，云端打包时会将配置信息合并到原生工程的 entitlements 配置文件中
+
+插件需要开启 capabilities 中的相关服务时需要配置 UTS.entitlements 文件
+
+示例：在 capabilities 中勾选 Access WiFi Information 项后对应的 UTS.entitlements 的配置
+
+```xml
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
+<plist version="1.0">
+<dict>
+	<key>com.apple.developer.networking.wifi-info</key>
+	<true/>
+</dict>
+</plist>
+```
+
+##### config.json
+uts插件在iOS平台的其它原生配置文件，可以在其中配置依赖的系统库等信息  
+
+```json
+{
+	"frameworks": [
+		"可选，依赖的系统库(系统库有.framework和.tbd和.dylib类型)" 
+	],
+	"deploymentTarget": "9.0",   // 可选，插件支持的最低 iOS 版本  默认：9.0"
+	"validArchitectures": [    // 可选，支持的 CPU 架构类型 默认：arm64
+		"arm64"   
+	],	
+	"dependencies-pods": [ // 可选, 需要依赖的pod库, HBuilderX 3.8.5+ 版本支持
+	{
+		"name": "WechatOpenSDK",  
+		"version": "2.0.2"     
+	}]
+}
+```
+
+**配置说明：**
+- frameworks：插件需要依赖的系统库(系统库有 .framework 和 .tbd 和 .dylib 类型)，此节点为可选项。
+- deploymentTarget：插件支持的最低 iOS 版本号，此节点为可选项，默认设置为 9.0.
+	+ 插件支持的最低版本号应该设置为所有依赖的三方库（包含 framework .a pod ）中最低支持版本号中的最高的一个。
+	+ pod 库的最低支持系统版本号可在 pod 库的 spec 文件或者 readme 中查看。
+- validArchitectures：插件支持的 CPU 架构类型，此节点为可选项，默认值为：arm64。
+- dependencies-pods：插件需要依赖的 pod 库,  HBuilderX3.8.5+ 版本新增支持
+	+ 有关 dependencies-pods 配置和 CocoaPods 使用的更多细节[详见](https://uniapp.dcloud.net.cn/plugin/uts-ios-cocoapods.html)
+
+
+## 开发uts插件
+
+### 获取电量插件示例
+
+以获取电量为例，介绍`uts`插件开发步骤
+
+**首先在 `uni_modules` 目录下新建名为 uts-getbatteryinfo 的 uts 插件**
+
+#### Android平台
+
+![OSAPI示例](https://native-res.dcloud.net.cn/images/uts/uts_osapi_demo_1.jpg)
+
+在Android平台目录下，编辑index.uts，键入以下内容。
+
+
+```ts
+// index.uts
+
+// 引用android api
+import Context from "android.content.Context";
+import BatteryManager from "android.os.BatteryManager";
+import { UTSAndroid } from "io.dcloud.uts";
+
+export function getBatteryCapacity(): string {
+	// 获取android系统 application上下文
+    const context = UTSAndroid.getAppContext();
+    if (context != null) {
+        const manager = context.getSystemService(
+            Context.BATTERY_SERVICE
+        ) as BatteryManager;
+        const currentLevel: number = manager.getIntProperty(
+            BatteryManager.BATTERY_PROPERTY_CAPACITY
+        );
+        return '' + currentLevel + '%';
+    }
+    return "0%";
+}
+
+```
+
+
+至此，我们已经完成一个Android平台上获取电量的原生能力封装。
+
+我们可以在vue页面中这样使用它：
+
+```ts
+
+import { getBatteryCapacity } from "@/uni_modules/uts-getbatteryinfo";
+
+console.log(getBatteryCapacity())
+
+```
+
+
+有些场景下，我们期望 将获取电量的能力封装为 异步的接口，我们可以使用下面的代码
+
+```ts
+import Context from "android.content.Context";
+import BatteryManager from "android.os.BatteryManager";
+import { UTSAndroid } from "io.dcloud.uts";
+
+
+type GetBatteryInfoOptions = {
+    success?: (res: object) => void
+    fail?: (res: object) => void
+    complete?: (res: object) => void
+}
+
+export function getBatteryInfo(options: GetBatteryInfoOptions) {
+    const context = UTSAndroid.getAppContext();
+    if (context != null) {
+        const manager = context.getSystemService(
+            Context.BATTERY_SERVICE
+        ) as BatteryManager;
+        const level = manager.getIntProperty(
+            BatteryManager.BATTERY_PROPERTY_CAPACITY
+        );
+        const res = {
+            errCode: 0,
+            errSubject: "uts-getbatteryinfo",
+            errMsg: "getBatteryInfo:ok",
+            level,
+            isCharging: manager.isCharging()
+        }
+        options.success?.(res)
+        options.complete?.(res)
+    } else {
+        const res = {
+			errCode: 1001,
+			errSubject: "uts-getbatteryinfo",
+            errMsg: 'getBatteryInfo:fail getAppContext is null'
+        }
+        options.fail?.(res)
+        options.complete?.(res)
+    }
+}
+```
+
+
+对应的使用代码需要调整为：
+
+```ts
+import {getBatteryInfo} from "@/uni_modules/uts-getbatteryinfo";
+
+getBatteryInfo({
+	success(res) {
+		uni.showToast({
+			title: "当前电量：" + res.level + '%',
+			icon: 'none'
+		});
+	}
+})
+
+```
+
+
+在下一节，我们将更加详细地介绍 前端如何使用这个插件。
+
+注1：HBuilderX的代码提示系统，支持在uts文件中对Android的原生API进行提示
+
+注2：`io.dcloud.uts.android`库介绍文档[见下](#iodcloudutsandroid)
+
+特别提示：
+
+**有android开发经验的开发者可以参考：[Android平台uts开发指南](https://uniapp.dcloud.net.cn/plugin/uts-for-android.html)**
+
+
+#### iOS 平台
+
+![](https://native-res.dcloud.net.cn/images/uts/iOS/getbatteryinfo1.png)
+
+在 iOS 平台目录下，编辑 index.uts，键入以下内容
+
+```ts
+// index.uts
+
+// 引用 iOS 原生平台 api
+import { UIDevice } from "UIKit";
+
+/**
+ * 定义 接口参数
+ */
+type GetBatteryInfoOptions = {
+    success?: (res: UTSJSONObject) => void;
+    fail?: (res: UTSJSONObject) => void;
+    complete?: (res: UTSJSONObject) => void;
+};
+
+/**
+ * 导出 获取电量方法 
+ */
+export default function getBatteryInfo(options: GetBatteryInfoOptions) {
+	
+	// 开启电量检测
+	UIDevice.current.isBatteryMonitoringEnabled = true
+	
+	// 返回数据
+    const res = {
+        errMsg: "getBatteryInfo:ok",
+        level: Number(UIDevice.current.batteryLevel * 100),
+        isCharging: UIDevice.current.batteryState == UIDevice.BatteryState.charging,
+    };
+    options.success?.(res);
+    options.complete?.(res);
+}
+```
+
+如果你想以同步接口的方式提供电量信息，代码可调整如下：
+
+```ts
+// index.uts
+
+// 引用 iOS 原生平台 api
+import { UIDevice } from "UIKit";
+
+/**
+ * 导出 获取电量方法 
+ */
+export default function getBatteryLevel():number {
+	// 开启电量检测
+	UIDevice.current.isBatteryMonitoringEnabled = true
+	
+	let level = Number(UIDevice.current.batteryLevel * 100)
+	return level
+}
+```
+
+至此，我们已经完成一个 iOS 平台上获取电量的原生能力封装。
+
+
+### 应用程序生命周期函数监听@hooksClass
+	
+	
+> 特别注意：
+> 此功能在 HBuilderX 3.97+ 版本支持，HBuilderX 3.97 之前的版本不支持。
+
+#### iOS 平台
+
+在插件开发过程中，有时我们需要监听 APP 的生命周期函数来完成一些业务逻辑，比如在应用启动时初始化三方 SDK, 在收到推送消息时做消息的处理，在被 url scheme 唤醒时调用指定功能等等。
+
+在 iOS 平台可以通过自定义 class 遵循 `UTSiOSHookProxy` 协议的方式来实现对应用程序生命周期函数的监听。
+	
+
+> 注意：
+> 该自定义 class 需要 export, 否则不会参与编译。
+> 该自定义 class 会自动完成注册, 无需开发者进行额外注册。
+> `UTSiOSHookProxy` 协议中所有的 api 均是可选实现的，可以选择自己关心的 api 进行实现。
+> `UTSiOSHookProxy` 协议的定义[详见](https://uniapp.dcloud.net.cn/uts/UTSiOSHookProxy.html)
+
+> 监听推送相关回调特别注意：
+> 监听推送和本地通知相关的回调需要证书具备推送功能，正确配置 `aps-environment`，在打自定义基座时需要在 `manifest` 中勾选 `push` 模块，否则相关功能不会被打进基座内，对应回调也就不会触发（可以只勾选 push，而不选择具体 push 版本）。
+> 勾选 `push` 模块后，系统会自动进行推送的注册，如果不需要自动注册，请在 `manifest` 中将 `pushRegisterMode` 字段设置为 `manual`。详细配置[详见](https://uniapp.dcloud.net.cn/collocation/manifest-app.html)
+
+
+示例代码：
+
+```ts
+export class MyPluginClass implements UTSiOSHookProxy {
+	// uts 插件创建时的回调。
+	onCreate() {
+	}
+	// 应用正常启动时 (不包括已在后台转到前台的情况)的回调函数。
+	applicationDidFinishLaunchingWithOptions(application: UIApplication | null, launchOptions: Map<UIApplication.LaunchOptionsKey, any> | null = null): boolean {
+	    console.log("applicationDidFinishLaunchingWithOptions")
+	    return false
+	}
+	// 远程通知注册成功时的回调函数。（打自定义基座时需要勾选 push 模块）
+	didRegisterForRemoteNotifications(deviceToken: Data | null) {
+	        
+	}
+	// 远程通知注册失败时的回调函数。（打自定义基座时需要勾选 push 模块）
+	didFailToRegisterForRemoteNotifications(error: NSError | null) {       
+	        
+	}
+	// 应用收到远程通知时的回调函数。（打自定义基座时需要勾选 push 模块）
+	didReceiveRemoteNotification(userInfo: Map<AnyHashable, any> | null) {
+	        
+	}
+	// 应用收到本地通知时的回调函数。（打自定义基座时需要勾选 push 模块）
+	didReceiveLocalNotification(notification: UILocalNotification | null) {
+	        
+	}
+	// 通过 url scheme 方式唤起 app 时的回调函数。(iOS9 之前的系统回调此方法，iOS9 之后的系统请使用 applicationOpenURLOptions)
+	applicationHandleOpenURL(application: UIApplication | null, url: URL | null) : boolean {
+	    return true
+	}
+	// 通过 url scheme 方式唤起 app 时的回调函数。
+	applicationOpenURLOptions(app: UIApplication | null, url: URL, options: Map<UIApplication.OpenURLOptionsKey, any> | null = null) : boolean {
+	    return true
+	}
+	// 当应用从活动状态主动变为非活动状态的时的回调函数。
+	applicationWillResignActive(application: UIApplication | null) {
+	    console.log("applicationWillResignActive")
+	}
+	// 应用完全激活时的回调函数。
+	applicationDidBecomeActive(application: UIApplication | null) {
+
+	}   
+	// 应用程序进入后台时的回调函数。
+	applicationDidEnterBackground(application: UIApplication | null) {
+		console.log("did enter background")
+
+	}
+	// 当应用在后台状态，将要进入到前台运行时的回调函数。
+	applicationWillEnterForeground(application: UIApplication | null) {
+	    console.log("applicationWillEnterForeground")
+
+	}
+	// 应用程序的 main 函数。
+	applicationMain(argc: Int32, argv: UnsafeMutablePointer<UnsafeMutablePointer<CChar> | null>) {
+	    console.log("applicationMain")
+	}
+	// 当应用程序接收到与用户活动相关的数据时调用此方法，例如，当用户使用 Universal Link 唤起应用时。
+	applicationContinueUserActivityRestorationHandler(application: UIApplication | null, userActivity: NSUserActivity | null, restorationHandler: ((res: [any] | null) => void) | null = null) : boolean {
+	       
+	    return true
+	}
+}
+```
+	
+
+#### Android 平台
+
+Android平台部分三方SDK的初始化依赖Application的onCreate生命周期回调。所以UTS提供了UTSAndroidHookProxy接口。用于支持三方SDK初始化的代码实现。
+
+UTSAndroidHookProxy代码如下：
+
+```uts
+/**
+ * 安卓原应用初始化回调代理
+ * 注意：不支持调用uni api
+ */
+interface UTSAndroidHookProxy {
+    /**
+     * 安卓原生应用初始化
+     * @param application
+     */
+    fun onCreate(application: Application)
+}
+```
+
+开发者需要在插件代码中实现UTSAndroidHookProxy接口 示例如下：
+
+```uts
+export class AppHookProxy implements UTSAndroidHookProxy {
+  override onCreate(application: Application) {
+	//当前应用是否 取得用户同意隐私协议
+	android.util.Log.d("AppHookProxy", "AppHookProxy--onCreate---")
+	if(UTSAndroid.isPrivacyAgree()) {
+		//onCreate 初始化三方SDK
+		android.util.Log.d("AppHookProxy", "AppHookProxy--onCreate---isPrivacyAgree")
+	}
+  }
+}
+```
+
+以上代码，将会在`Application` 的`OnCreate`函数中被调用
+
+HelloUTS nativepage 插件增加了UTSAndroidHookProxy [源码示例](https://gitcode.net/dcloud/hello-uts/-/blob/dev/uni_modules/uts-nativepage/utssdk/app-android/index.uts)
+
+开发者使用HBuilder X 3.96 之后版本，提交云端打包自定义基座后，观察日志即可体验
+
+注意：
+
++ 由于UTSAndroidHookProxy初始化要早于uni所以不支持调用uni api
++ 一个插件只允许实现一个UTSAndroidHookProxy接口class！
++ onCreate回调后应尽可能的判断隐私合规是否同意再初始化，否则影响app上架
++ Android平台添加或修改UTSAndroidHookProxy实现代码需要重新提交云端打包才能生效
+
+
+
+
+### `uts`与`uni-app`环境数据交互说明
+
+
+UTS向uni-app传值，支持下列类型：
+
+
+1. TS基本数据类型： number,string,boolean 等
+```ts
+// 基础类型-Number
+export function getPluginVersionNum(): number{
+	return 120
+}
+// 基础类型-string
+export function getPluginVersion(): string{
+	return "1.2.0"
+}
+```
+
+2. UTSJSONObjct 
+
+```ts
+// UTSJSONObjct 示例
+export function getPluginVersion(): UTSJSONObject{
+	
+	var ret = {
+		version: "1.2.0",
+		versionNum: 120,
+		pluginArray:["core","debug","network"]
+	}
+	return ret
+}
+```
+
+
+
+uni-app向UTS环境传值，支持下列类型：
+
+1 TS基本数据类型： number,string,boolean 等
+```ts
+// 基础数据类型示例
+export function postUserInfo(name:string,age:number){
+	console.log("name == " + name);
+	console.log("age == " + age);
+}
+```
+
+```js
+// uni-app 调用代码
+postUserInfo("zhangsan",12);
+```
+
+2 type数据类型
+
+```ts
+// type 数据类型示例
+export function postUserInfo(name:string,age:number){
+	console.log("name == " + name);
+	console.log("age == " + age);
+}
+```
+
+```js
+// uni-app 调用代码
+postUserInfo({
+	name:"zhangsan",
+	age:12
+});
+```
+
+
+3 UTSJSONObjct
+
+```ts
+// UTSJSONObjct 数据类型示例
+export function postUserInfo(user:UTSJSONObject){
+	console.log(user);
+}
+```
+
+需要注意的是，在声明为`any`类型的前提下, `uni-app` 环境中的 `Object` 在UTS环境中也会被转换为 `UTSJSONObjct`. 
+
+也就是说上面的代码同样可以写作
+
+```ts
+// UTSJSONObjct 数据类型示例-2
+export function postUserInfo(user:any){
+	console.log(user);
+}
+```
+
+
+```js
+// uni-app 调用代码
+postUserInfo({
+	name:"zhangsan",
+	age:12,
+	scoreInfo:{
+		"语文":100,
+		"数学":80,
+	}
+});
+
+```
+
+
+更多UTSJSONObject的用法，[详见](../uts/data-type.md#UTSJSONObject)
+
+遗留问题：
+
+有些场景，我们需要参数对象包含对象数组，比如
+```json
+{
+	"name": "zhangsan",
+	"teacher": [{
+			"id": "1",
+			"name": "kongzi"
+		},
+		{
+			"id": "2",
+			"name": "mengzi"
+		}
+	]
+}
+```
+目前在uni-app 1.0 环境下，复杂参数的传递是存在一定的缺陷。我们不能将teacher 声明为具体的类型数组，需要声明为any数组：
+
+
+```ts
+type Param{
+	name:string,
+	// 不能声明为 Teacher[]
+	teacher: any[];
+}
+```
+访问数组元素时，通过 UTSJSONObjct 包装访问
+```ts
+// 循环遍历
+list1.forEach((item : any) => {
+    const utsItem = new UTSJSONObject(item)
+})
+```
+
+这个问题，我们稍后会改进。
+
+
+## 前端使用插件
+
+虽然uts插件由uts语法开发，但前端引用插件并不要求一定需要ts，普通js即可引用uts插件。
+
+下面介绍两种常见的引入方式
+
+ **泛型引用**
+
+> 在uni-app x上需3.91+
+
+作为一个对象全部import进来，然后通过点运算符调用这个对象的方法或属性。
+
+```js
+// 先引用，全部导入，对象起名为UTSHello
+import * as UTSHello from "../../../uni_modules/uts-osapi";
+
+// 然后使用UTSHello的方法
+UTSHello.getBatteryCapacity()
+```
+
+**特别注意**
+
+需要特别注意的是，import UTS插件时，只能到插件的根目录，不能直接引入到最终的文件
+
+```ts
+// 正确的写法
+import * as UTSHello from "../../../uni_modules/uts-osapi";
+```
+
+```ts
+// 错误的写法
+import * as UTSHello from "../../../uni_modules/uts-osapi/index.uts";
+```
+
+
+**显性引用**
+
+从可导出的选项里import 1个或多个（逗号分隔），然后直接使用导出的方法或属性。
+
+```js
+//先引用，导入指定方法或属性
+import {
+  getBatteryCapacity
+} from "../../../uni_modules/uts-osapi";
+
+// 然后使用导入的方法
+getBatteryCapacity()
+```
+
+
+关于电量这个插件，插件市场已提供现成的插件，除了Android，还同时支持了web和小程序，可以去下载体验。[详见](https://ext.dcloud.net.cn/plugin?id=9295)
+
+更多开发示例，可以参考 [HelloUTS](https://gitcode.net/dcloud/hello-uts)。
+
+## 真机运行
+
+### UTS支持真机运行
+
+**uts虽然是原生代码，但同样具有真机运行功能**
+
+若HBuilderX中没有`uts编译运行插件`，在第一次运行时会自动下载。
+
+#### Android平台
+
+- Android上，运行体验与uni-app基本无差异。一样可以热刷新，打印console.log。
+
+#### iOS平台
+
+- HBuilderX 3.6.9以下版本，uts插件不支持热刷新，真机需提交云端打包生成[自定义基座](https://uniapp.dcloud.net.cn/tutorial/run/run-app.html#customplayground)
+- HBuilderX 3.6.9+，uts插件，支持本地编译和真机运行 [详情](https://uniapp.dcloud.net.cn/tutorial/run/uts-development-ios.html)
+
+### 自定义基座
+
+自定义基座支持uts插件。
+
+#### Android平台  
+普通uts代码可以直接使用标准基座真机运行。但与原生插件一样，涉及以下场景，需要自定义基座后方能生效:
+
+- 1 集成三方sdk
+- 2 新增资源(包括res/asset 等)
+
+总结来说，就是所有 涉及新增依赖/gralde配置/androidManifest.xml/资源 等标准基座不具备的能力时，需要自定义基座
+
+#### iOS平台  
+uts插件编译需要XCode环境，因此在mac电脑安装了XCode工具时支持直接使用标准基座真机运行。
+
+在windows电脑或者mac电脑没有安装XCode工具时，需要提交云端打包生成自定义基座后才能调用uts插件。
+
+### debug断点调试
+uts插件支持debug断点调试。
+
+- [Android debug教程](/tutorial/debug/uni-uts-debug.md)
+- [iOS debug教程](/tutorial/debug/uni-uts-debug-ios.md)
+
+### 遗留问题
+
+截止到HBuilderX 3.6.9 时遗留事项：
+- Android平台不支持跨进程调试/日志打印，即 console.log 目前只能在当前进程生效，开发多进程应用时，暂时无法打印日志到控制台
+
+遗留事项后续升级完善。
+
+
+## 云端打包
+
+正常支持云端打包。但打包后uts编译为了纯原生二进制代码，不支持wgt热更新。  
+
+
+## 常见问题
+
+### 常见报错
+
+- [plugin:vite:resolve] Failed toresolve entry for package "插件路径"
+
+	HBuilderX 的最低要求为3.6.0，低于此版本无法import uts插件，编译时将报错。
+
+- 文件查找失败：'uts插件路径'
+
+    vue2项目使用 uts 插件的最低版本要求是HBuilderX 3.6.8，低于此版本，编译时将报错。
+
+- UTSCallback 
+
+	HBuilderX 3.7.7开始，不推荐使用 UTSCallback 定义函数类型，当需要定义函数类型时，应定义为更具体的类型，如：`const callback:UTSCallback` 应调整为`const callback:()=>void`
+	如果您使用的是插件市场三方uts插件，可以检查更新插件最新版本
+
+### Float类型传参
+
+android很多布局参数强制要求Float，但是ts中没有内置这种类型。可以使用下面的代码实现转换
+
+```ts
+let textSize =  30.0.toFloat();
+```
+### Long类型传参
+
+
+```ts
+let longVal =  1000.0.toLong()
+```
+
+### 异步任务
+
+目前 UTS 仅Android支持promise执行异步任务，iOS还不支持。类似场景可以使用setTimeOut。
+
+
+### 匿名内部类
+
+UTS目前还不支持匿名内部类的写法，在android中类似这样的场景
+
+```kotlin
+getUniActivity()!!.runOnUiThread(Runnable(){
+    // do something
+});
+```
+
+需要声明一个实现类，再新建实例的方式实现，代码如下
+
+```js
+class AddUIRunnable extends Runnable {
+    override run():void {
+		// do something
+    }
+};
+let uiRunable = new AddUIRunnable();
+getUniActivity()!.runOnUiThread(uiRunable)
+```
+
+### 泛型参数
+
+android中UI相关的api，很多会要求泛型，目前uts中可以使用下面的代码实现
+
+```ts
+let frameContent = decorView.findViewById<FrameLayout>(android.R.id.content)
+let layoutParam = new FrameLayout.LayoutParams(ViewGroup.LayoutParams.MATCH_PARENT,ViewGroup.LayoutParams.WRAP_CONTENT);
+```
+
+### 函数参数默认值
+
+函数参数支持设置默认值，比如下面testName
+
+```ts
+function connectWifi(option: WifiConnectOption,testName :string = "zhangsan") 
+```
+
+### 在uni-app 1.0 上的导出限制
+
+UTS插件环境会被编译为原生语言环境，在android平台是kotlin.
+
+uni-app x 运行时，本身也是原生语言环境，即kotlin。同语言直接的调用是没有限制的，可以任意导出和使用 自定义对象/原生对象/类/方法。
+
+但是在uni-app 1.0 环境，**只能导出UTS中声明的自定义对象/类/方法，不能包含原生对象**
+
+这是因为 uni-app 1.0 本质上是类浏览器的js环境中，UTS中声明的对象是经过特殊处理的，每一个对象都有一个在Js中对应的实例，这样才能正常使用。
+
+其他的原生对象没有经过特殊处理，并不能在js环境中使用。
+
+
+### 访问JSON对象属性
+
+`uts`环境中访问`JSON`对象的属性，不能用`user.age` 而要用下标 `user['age']`
+
+```ts
+
+let jsonContent = "{'username':'zhangsan','age':12}"
+let jsonObj = JSON.parse(jsonContent);
+console.log("jsonObj['age']  == " + jsonObj['age'] );
+
+```
+
+如果想使用`.操作符`，需要参考uts的[type](../uts/data-type.md#type)
+
+更多UTSJSONObject的用法，[详见](../uts/data-type.md#UTSJSONObject)
+
+## 示例项目
+
+DCloud提供了 Hello UTS示例，[详见](https://gitcode.net/dcloud/hello-uts)。
+
+插件市场提供了很多uts项目：
+- API示例，调用os api，电量插件，[详见](https://ext.dcloud.net.cn/plugin?id=9295)
+- API示例，调用三方sdk，腾讯定位插件，[详见](https://ext.dcloud.net.cn/plugin?id=14569)
+- 组件示例，调用三方sdk，lottie插件，[详见](https://ext.dcloud.net.cn/plugin?id=10674)
+
+更多uts插件见：[https://ext.dcloud.net.cn/?cat1=8&type=UpdatedDate](https://ext.dcloud.net.cn/?cat1=8&type=UpdatedDate)
diff --git a/docs/plugin/uts-uni-api.md b/docs/plugin/uts-uni-api.md
new file mode 100644
index 00000000..cb9c6fca
--- /dev/null
+++ b/docs/plugin/uts-uni-api.md
@@ -0,0 +1,102 @@
+# UTS中使用uni api  
+> 需HBuilderX 3.8.0 及以上版本  
+
+uts中经常要调用iOS和Android的api。uni对常用api进行了封装。在uni的api覆盖范围内，开发者可以简单的只调用uni的api实现对iOS、Android的能力调用。
+
+目前uts插件代码中可以直接调用部分uni api，如`uni.request`、`uni.showModel`。未来会陆续实现所有uni api在uts中的完整调用。
+
+## 示例  
+```ts
+export function myToast() {
+	uni.showToast({
+		title: 'This is toast in uts with uni API!',
+		success: function(){
+			console.log('uni.showToast success!');
+		},
+		fail: (err) => {
+			console.log('uni.showToast success: ', err);
+		}
+	});
+}
+```
+
+
+## 注意事项  
+### 异步API中complete回调函数中的参数是any类型  
+在uts中，由于不支持联合类型，complete回调函数的参数会当做any类型处理。  
+any类型对象不能直接使用“.”访问其属性，目前暂时可以使用JSON.stringify()转换为字符串处理，或者在success和fail回调中分别处理成功和失败的数据。  
+此问题仅在complete回调函数中存在，success和fail回调函数中可以使用“.”访问参数的属性。  
+如下示例：
+```ts
+export function myTest() {
+	uni.request({
+		url: 'https://www.invalidserviceaddress.com/',
+		success: (ret) => {
+			//ret为RequestSuccess类型，可以使用.访问其属性  
+			let data = ret.data;
+			console.log('uni.request successed: ', data);
+		},
+		fail: (err) => {
+			//err为RequestFail类型，可以使用.访问其属性  
+			let code = err.errCode;
+			console.log('uni.request failed: ', code);
+		},
+		complete: (res) => {
+			//res为any类型，转换为字符串处理
+			let ret = JSON.stringify(res);
+			console.log(ret);
+		}
+	});
+}
+```
+
+如果在complete回调函数中使用“.”访问属性，如下示例：  
+```ts
+	uni.request({
+		url: 'https://www.invalidserviceaddress.com/',
+		complete: (res) => {
+			console.log(res.errCode);
+		}
+	});
+
+```
+编译时会报错：  
+```
+error: Unresolved reference: errCode‌
+```
+
+
+
+## 支持的API列表  
+### 网络  
+- [uni.request(OBJECT)](https://uniapp.dcloud.net.cn/api/request/request.html#request)  
+	传输数据暂不支持ArrayBuffer类型  
+
+### 数据缓存  
+- [uni.setStorage(OBJECT)](https://uniapp.dcloud.net.cn/api/storage/storage.html#setstorage)  
+- [uni.setStorageSync(KEY,DATA)](https://uniapp.dcloud.net.cn/api/storage/storage.html#setstoragesync)  
+- [uni.getStorage(OBJECT)](https://uniapp.dcloud.net.cn/api/storage/storage.html#getstorage)  
+- [uni.getStorageSync(KEY)](https://uniapp.dcloud.net.cn/api/storage/storage.html#getstoragesync)  
+- [uni.getStorageInfo(OBJECT)](https://uniapp.dcloud.net.cn/api/storage/storage.html#getstorageinfo)  
+- [uni.getStorageInfoSync()](https://uniapp.dcloud.net.cn/api/storage/storage.html#getstorageinfosync)  
+- [uni.removeStorage(OBJECT)](https://uniapp.dcloud.net.cn/api/storage/storage.html#removestorage)  
+- [uni.removeStorageSync(KEY)](https://uniapp.dcloud.net.cn/api/storage/storage.html#removestoragesync)  
+- [uni.clearStorage()](https://uniapp.dcloud.net.cn/api/storage/storage.html#clearstorage)
+- [uni.clearStorageSync()](https://uniapp.dcloud.net.cn/api/storage/storage.html#clearstoragesync)  
+
+### 设备  
+- 系统  
+	+ [uni.getAppBaseInfo()](https://uniapp.dcloud.net.cn/api/system/getAppBaseInfo.html)  
+	+ [uni.getDeviceInfo()](https://uniapp.dcloud.net.cn/api/system/getDeviceInfo.html)  
+	+ [uni.getSystemSetting()](https://uniapp.dcloud.net.cn/api/system/getsystemsetting.html)
+
+### 界面  
+- 交互反馈  
+	+ [uni.showToast(OBJECT)](https://uniapp.dcloud.net.cn/api/ui/prompt.html#showtoast)  
+	+ [uni.hideToast()](https://uniapp.dcloud.net.cn/api/ui/prompt.html#hidetoast)  
+	+ [uni.showLoading(OBJECT)](https://uniapp.dcloud.net.cn/api/ui/prompt.html#showloading)  
+	+ [uni.hideLoading()](https://uniapp.dcloud.net.cn/api/ui/prompt.html#hideloading)  
+	+ [uni.showModal(OBJECT)](https://uniapp.dcloud.net.cn/api/ui/prompt.html#showmodal)  
+	+ [uni.showActionSheet(OBJECT)](https://uniapp.dcloud.net.cn/api/ui/prompt.html#showactionsheet)  
+
+**目前仅支持以上列出的部分uni api的调用，[uni ext api](https://uniapp.dcloud.net.cn/api/extapi.html)实现的api（如[uni.getBatteryInfo](https://ext.dcloud.net.cn/plugin?id=9295)）暂时还不支持在uts插件中调用**  
-- 
GitLab