tmui-cli 2.0.3 → 2.0.4

package/data/uni-app-x-docs/api/share.md

@@ -0,0 +1,128 @@
+<!-- ## uni.share(options) @share -->
+
+<!-- UTSAPIJSON.share.name -->
+
+<!-- UTSAPIJSON.share.description -->
+
+> Android、iOS平台从 HBuilderX5.08 版本开始支持微信分享  
+
+<!-- UTSAPIJSON.share.compatibility -->
+
+<!-- UTSAPIJSON.share.param -->
+
+<!-- UTSAPIJSON.share.returnValue -->
+
+<!-- UTSAPIJSON.share.example -->
+
+<!-- UTSAPIJSON.share.tutorial -->
+
+### 分享provider对象描述 @providerdes
+
+UniShareWeixinProvider(微信分享)继承自 [UniProvider](./provider.md#uniprovider)
+
+
+| 名称           | 类型      | 必备 | 默认值  | 描述                                  |
+| -------------- | --------- | ---- | ------ | ------------------------------------- |
+| isWeChatInstalled     | boolean   | 是    | -      | 判断微信是否安装 |
+
+
+<!-- UTSAPIJSON.general_type.name -->
+
+<!-- UTSAPIJSON.general_type.param -->
+## 自定义分享provider接入到uni API @customprovider
+
+背景：目前uni-app x引擎已经内置了微信分享。但分享SDK还有很多，比如微博、抖音分享。
+
+以往这些SDK可以通过独立插件的方式集成到uni-app x中，但需要提供单独的API给开发者使用。
+
+uni-app x从4.25起，开放了provider自接入机制，让三方SDK可以以[provider](./provider.md)方式被开发者集成。
+
+开发一个UTS插件，对接uni规范化的API、错误信息描述等实现自己的分享插件，这样插件使用者就可以通过uni的标准API使用三方SDK。
+
+举个例子，开发者想使用uni.share()的方式调用XX分享，但是内置分享api不支持，
+
+那只需要按照下面四个步骤实现即可:
+
+第一步，新建一个UTS插件，在interface.uts 中定义接口，UniShareProvider，代码如下
+
+```ts
+export interface UniShareWeixinProvider extends UniShareProvider{}
+```
+
+第二步，在app-android或者app-ios的index.uts中实现接口，代码如下
+
+```ts
+import { UniShareWeixinProvider } from '../interface.uts'
+export class UniShareWeixinProviderImpl implements UniShareWeixinProvider {
+	override id : String = "XX" // id必须有插件作者前缀，避免冲突，避免不同插件作者的插件id重名
+	override description : String = "XX的描述"
+	override isAppExist : boolean | null = null
+
+	constructor(){}
+
+	override share(options : ShareOptions) {
+		//todo 具体逻辑，接收uni规范的入参，进行业务处理，返回uni规范的返回值。如遇到错误，按uni的规范返回错误码
+	}
+}
+```
+
+第三步，在manifest.json中配置
+
+```ts
+  "app": {
+    "distribute": {
+      /* android打包配置 */
+      "modules": {
+        "uni-share":{
+          "XX":{}
+        }
+      }
+    }
+  }
+```
+
+第四步，打包自定义基座然后运行
+
+### Bug&Tips @bug_tips
+
+- HarmonyOS 平台分享图片时仅支持 jpeg/png 类型的图片
+  - 分享视频，大小不能超过 64KB
+  - 分享图片，大小不支持超过 100KB
+- HarmonyOS 平台分享携带文本时
+  - title 不支持超过 512 个字节
+  - summary 不支持超过 1024 个字节
+- 鸿蒙平台，HBuilderX 4.87 及以下版本，分享时有图片大于 20 KB 会出现分享失败的问题。临时方案是下载 [har包](https://web-ext-storage.dcloud.net.cn/temp/uni_modules__uni_share_weixin_x.har)并改名为 `uni_modules__uni_share_weixin.har`，放到 `项目根目录/harmony-configs/libs/` 目录下重新编译运行到手机。高版本不存在此问题
+
+### 注意
+- App平台开发微信分享，无需自定义基座，真机运行可直接开发
+- App平台判断微信是否安装可以通过`uni.getProvider`的方式，详见[uni.getProvider](https://doc.dcloud.net.cn/uni-app-x/api/provider.html#getprovider)
+
+```ts
+   uni.getProvider({
+      service: "share",
+      success: (e) => {
+         const provider = e.providers.find((item): boolean => {
+            return item.id == 'weixin'
+         })
+
+          // #ifdef APP-ANDROID
+          if (provider != null && provider instanceof UniPaymentWxpayProvider && !((provider as UniPaymentWxpayProvider).isWeChatInstalled)) {
+            console.log('WeChat 没有安装')
+          } else {
+             console.log('WeChat 已安装')
+          }
+          // #endif
+          // #ifdef APP-IOS
+          if (provider != null && ((provider as UniPaymentWxpayProvider).isWeChatInstalled == undefined || ((provider as UniPaymentWxpayProvider).isWeChatInstalled != null && (provider as UniPaymentWxpayProvider).isWeChatInstalled == false))) {
+            console.log('WeChat 没有安装')
+          } else {
+            console.log('WeChat 已安装')
+          }
+          // #endif
+      },
+      fail: (e) => {
+         console.log("获取分享通道失败：", e);
+      }
+   })
+```
+- **app需要在根目录manifest.json文件中配置`uni-share`节点，详见 [https://doc.dcloud.net.cn/uni-app-x/collocation/manifest-modules.html#uni-share模块配置](https://doc.dcloud.net.cn/uni-app-x/collocation/manifest-modules.html#uni-share)**

package/data/uni-app-x-docs/api/show-action-sheet.md

@@ -0,0 +1,5 @@
+---
+layout: SimpleLayout
+---
+
+文档已迁移至 [actionSheet](action-sheet.md)

package/data/uni-app-x-docs/api/show-loading.md

@@ -0,0 +1,5 @@
+---
+layout: SimpleLayout
+---
+
+文档已迁移至 [loading](loading.md)

package/data/uni-app-x-docs/api/show-modal.md

@@ -0,0 +1,5 @@
+---
+layout: SimpleLayout
+---
+
+文档已迁移至 [modal](modal.md)

package/data/uni-app-x-docs/api/show-toast.md

@@ -0,0 +1,5 @@
+---
+layout: SimpleLayout
+---
+
+文档已迁移至 [toast](toast.md)

package/data/uni-app-x-docs/api/sign-in.md

@@ -0,0 +1,141 @@
+## uni.login(options) @login
+
+<!-- UTSAPIJSON.login.description -->
+
+> Android、iOS平台从 HBuilderX5.08 版本开始支持微信登录; iOS平台从 HBuilderX 5.21 版本开始支持Apple登录
+
+<!-- UTSAPIJSON.login.compatibility -->
+
+<!-- UTSAPIJSON.login.param -->
+
+<!-- UTSAPIJSON.login.returnValue -->
+
+::: warning 注意
+- HarmonyOS 平台需要额外的配置，详见[HarmonyOS平台接入微信SDK](https://developers.weixin.qq.com/doc/oplatform/Mobile_App/Access_Guide/ohos.html)
+  - 配置 queryScheme： `"querySchemes": ["weixin"]` **请勿配置 `wxopensdk`。已在 @tencent/wechat_open_sdk@1.0.15 实测配置 `wxopensdk` 后登录无法回调**
+  - 配置 actions: `"actions": [ "action.system.home", "wxentity.action.open" ]`
+- 根据apple审核要求，支持任何三方登录，必须同时支持Apple 登录功能，否则审核失败； 具体请参考[Apple App Review Guidelines - Login Services说明](https://developer.apple.com/app-store/review/guidelines/#design)
+:::
+
+<!-- UTSAPIJSON.login.example -->
+
+<!-- UTSAPIJSON.login.tutorial -->
+
+### 登录provider对象描述 @providerdes
+
+* UniOAuthWeixinProvider(微信登录)继承自 [UniProvider](./provider.md#uniprovider)
+
+| 名称           | 类型      | 必备 | 默认值  | 描述                                  |
+| -------------- | --------- | ---- | ------ | ------------------------------------- |
+| isWeChatInstalled     | boolean   | 是    | -      | 判断微信是否安装 |
+
+* UniOAuthAppleProvider(Sign in with Apple 登录)继承自 [UniProvider](./provider.md#uniprovider)
+
+## 自定义登录provider接入到uni API @customprovider
+
+背景：目前uni-app x引擎已经内置了微信登录。但登录SDK还有很多，比如苹果登录、京东、支付宝登录。
+
+以往这些SDK可以通过独立插件的方式集成到uni-app x中，但需要提供单独的API给开发者使用。
+
+uni-app x从4.25起，开放了provider自接入机制，让三方SDK可以以[provider](./provider.md)方式被开发者集成。
+
+开发一个UTS插件，对接uni规范化的API、错误信息描述等实现自己的登录插件，这样插件使用者就可以通过uni的标准API使用三方SDK。
+
+举个例子，开发者想使用uni.login()的方式调用XX登录，但是内置登录api不支持，
+
+那只需要按照下面四个步骤实现即可:
+
+第一步，新建一个UTS插件，在interface.uts 中定义接口，UniOAuthProvider，代码如下
+
+```ts
+export interface UniOAuthWeixinProvider extends UniOAuthProvider{}
+```
+
+第二步，在app-android或者app-ios的index.uts中实现接口，代码如下
+
+```ts
+import { UniOAuthProvider } from '../interface.uts'
+export class UniOAuthWeixinProviderImpl implements UniOAuthWeixinProvider {
+	override id : String = "XX" // id必须有插件作者前缀，避免冲突，避免不同插件作者的插件id重名
+	override description : String = "XX的描述"
+	override isAppExist : boolean | null = null
+
+	constructor(){}
+
+	override login(options : LoginOptions) {
+		//todo 具体逻辑，接收uni规范的入参，进行业务处理，返回uni规范的返回值。如遇到错误，按uni的规范返回错误码
+	}
+}
+```
+
+第三步，在manifest.json中配置
+
+```ts
+  "app": {
+    "distribute": {
+      /* android打包配置 */
+      "modules": {
+        "uni-oauth":{
+          "XX":{}
+        }
+      }
+    }
+  }
+```
+
+第四步，打包自定义基座然后运行
+
+### 注意
+- App平台开发微信登录，无需自定义基座，真机运行可直接开发
+- App平台判断微信是否安装可以通过`uni.getProvider`的方式，详见[uni.getProvider](https://doc.dcloud.net.cn/uni-app-x/api/provider.html#getprovider)
+
+```ts
+   uni.getProvider({
+      service: "oauth",
+      success: (e) => {
+         const provider = e.providers.find((item): boolean => {
+            return item.id == 'weixin'
+         })
+
+          // #ifdef APP-ANDROID
+          if (provider != null && provider instanceof UniPaymentWxpayProvider && !((provider as UniPaymentWxpayProvider).isWeChatInstalled)) {
+            console.log('WeChat 没有安装')
+          } else {
+             console.log('WeChat 已安装')
+          }
+          // #endif
+          // #ifdef APP-IOS
+          if (provider != null && ((provider as UniPaymentWxpayProvider).isWeChatInstalled == undefined || ((provider as UniPaymentWxpayProvider).isWeChatInstalled != null && (provider as UniPaymentWxpayProvider).isWeChatInstalled == false))) {
+            console.log('WeChat 没有安装')
+          } else {
+            console.log('WeChat 已安装')
+          }
+          // #endif
+      },
+      fail: (e) => {
+         console.log("获取微信登录通道失败：", e);
+      }
+   })
+```
+- **app需要在根目录manifest.json文件中配置`uni-oauth`节点，详见 [uni-oauth模块配置](https://doc.dcloud.net.cn/uni-app-x/collocation/manifest-modules.html#uni-oauth)**
+- iOS平台微信登录、苹果登录均需要配置在根目录manifest.json文件中配置`uni-oauth`节点，并且只要支持任何三方登录，均需要同时支持苹果登录
+
+## uni.getUserInfo(options) @getuserinfo
+
+<!-- UTSAPIJSON.getUserInfo.description -->
+
+<!-- UTSAPIJSON.getUserInfo.compatibility -->
+
+<!-- UTSAPIJSON.getUserInfo.param -->
+
+<!-- UTSAPIJSON.getUserInfo.returnValue -->
+
+<!-- UTSAPIJSON.getUserInfo.example -->
+
+<!-- UTSAPIJSON.getUserInfo.tutorial -->
+
+<!-- UTSAPIJSON.oauth.example -->
+
+<!-- UTSAPIJSON.general_type.name -->
+
+<!-- UTSAPIJSON.general_type.param -->

package/data/uni-app-x-docs/api/storage.md

@@ -0,0 +1,347 @@
+## key-value本地数据存储
+
+app、小程序、web，均提供了方便的key-value模式的本地数据存储，通过键值对的方式存取数据。
+
+uni-app的Storage在不同端的实现不同：
+- H5端为localStorage，浏览器限制5M大小，是缓存概念，可能会被清理
+- App端为原生storage，无大小限制，不是缓存，是持久化的
+	* `Android` 端采用应用内SQLite数据库储存，储存位置为：/data/data/io.dcloud.uniappx(基座包名)/databases/DCStorage。
+	* 真机运行基座下多个应用之间的storage是隔离的，同基座内的不同应用，对应一个数据库文件，但以表名区分。
+- 各个小程序端为其自带的storage api，数据存储生命周期跟小程序本身一致，即除用户主动删除或超过一定时间被自动清理，否则数据都一直可用。
+	* 微信小程序单个 key 允许存储的最大数据长度为 1MB，所有数据存储上限为 10MB。
+	* 支付宝小程序单条数据转换成字符串后，字符串长度最大200*1024。同一个支付宝用户，同一个小程序缓存总上限为10MB。
+	* 百度小程序策略[详见](https://smartprogram.baidu.com/docs/develop/api/storage/save_process/)
+	* 抖音小程序策略[详见](https://developer.open-douyin.com/docs/resource/zh-CN/mini-app/develop/api/data-caching/tt-get-storage)
+
+**注意**
+- `uni-`、`uni_`、`dcloud-`、`dcloud_`为前缀的key，为系统保留关键前缀。如`uni_deviceId`、`uni_id_token`，请开发者为key命名时避开这些前缀。
+- 非App平台清空Storage会导致 uni.getSystemInfo/getDeviceInfo 获取到的deviceId改变
+
+<!-- ## uni.setStorage(options) @setstorage -->
+
+<!-- UTSAPIJSON.setStorage.name -->
+
+<!-- UTSAPIJSON.setStorage.description -->
+
+<!-- UTSAPIJSON.setStorage.compatibility -->
+
+<!-- UTSAPIJSON.setStorage.param -->
+
+<!-- UTSAPIJSON.setStorage.returnValue -->
+
+<!-- UTSAPIJSON.setStorage.example -->
+
+<!-- UTSAPIJSON.setStorage.tutorial -->
+
+<!-- ## uni.setStorageSync(key, data) @setstoragesync -->
+
+<!-- UTSAPIJSON.setStorageSync.name -->
+
+<!-- UTSAPIJSON.setStorageSync.description -->
+
+<!-- UTSAPIJSON.setStorageSync.compatibility -->
+
+<!-- UTSAPIJSON.setStorageSync.param -->
+
+<!-- UTSAPIJSON.setStorageSync.returnValue -->
+
+<!-- UTSAPIJSON.setStorageSync.example -->
+
+<!-- UTSAPIJSON.setStorageSync.tutorial -->
+
+<!-- ## uni.getStorage(options) @getstorage -->
+
+<!-- UTSAPIJSON.getStorage.name -->
+
+<!-- UTSAPIJSON.getStorage.description -->
+
+<!-- UTSAPIJSON.getStorage.compatibility -->
+
+<!-- UTSAPIJSON.getStorage.param -->
+
+<!-- UTSAPIJSON.getStorage.returnValue -->
+
+**注意：**
+
+getStorageSync的返回值类型为any。因为set的时候任意类型都可以set进去。
+
+使用any类型的数据需要as为正确的类型，才能调用类型上的方法。
+
+对于简单类型，如string，只需要 as string。但对于复杂类型，比如 UTSJSONObject、type、class，需要参考获取复杂类型的数据章节，[见下](#gettypedata)
+
+> 注意：获取一个不存在的 key 会触发 fail 回调，返回错误信息为 "getStorage:fail data not found" 的错误。
+
+<!-- UTSAPIJSON.getStorage.example -->
+
+<!-- UTSAPIJSON.getStorage.tutorial -->
+
+<!-- ## uni.getStorageSync(key) @getstoragesync -->
+
+<!-- UTSAPIJSON.getStorageSync.name -->
+
+<!-- UTSAPIJSON.getStorageSync.description -->
+
+<!-- UTSAPIJSON.getStorageSync.compatibility -->
+
+<!-- UTSAPIJSON.getStorageSync.param -->
+
+<!-- UTSAPIJSON.getStorageSync.returnValue -->
+
+**注意：**
+
+getStorageSync的返回值类型为any。因为set的时候任意类型都可以set进去。
+
+使用any类型的数据需要as为正确的类型，才能调用类型上的方法。
+
+对于简单类型，如string，只需要 as string。但对于复杂类型，比如 UTSJSONObject、type、class，需要参考获取复杂类型的数据章节，[见下](#gettypedata)
+
+另注意，同步方法获取一个不存在的 key 会返回空字符串，而不是 null。如需准确判断是空字符串还是null，应该使用异步方法`uni.getStorage`。
+
+获取较大量的数据时，也推荐使用异步方法`uni.getStorage`，避免同步阻塞。
+
+<!-- UTSAPIJSON.getStorageSync.example -->
+
+<!-- UTSAPIJSON.getStorageSync.tutorial -->
+
+<!-- ## uni.getStorageInfo(options) @getstorageinfo -->
+
+<!-- UTSAPIJSON.getStorageInfo.name -->
+
+<!-- UTSAPIJSON.getStorageInfo.description -->
+
+<!-- UTSAPIJSON.getStorageInfo.compatibility -->
+
+<!-- UTSAPIJSON.getStorageInfo.param -->
+
+<!-- UTSAPIJSON.getStorageInfo.returnValue -->
+
+<!-- UTSAPIJSON.getStorageInfo.example -->
+
+<!-- UTSAPIJSON.getStorageInfo.tutorial -->
+
+<!-- ## uni.getStorageInfoSync() @getstorageinfosync -->
+
+<!-- UTSAPIJSON.getStorageInfoSync.name -->
+
+<!-- UTSAPIJSON.getStorageInfoSync.description -->
+
+<!-- UTSAPIJSON.getStorageInfoSync.compatibility -->
+
+<!-- UTSAPIJSON.getStorageInfoSync.param -->
+
+<!-- UTSAPIJSON.getStorageInfoSync.returnValue -->
+
+<!-- UTSAPIJSON.getStorageInfoSync.example -->
+
+<!-- UTSAPIJSON.getStorageInfoSync.tutorial -->
+
+<!-- ## uni.removeStorage(options) @removestorage -->
+
+<!-- UTSAPIJSON.removeStorage.name -->
+
+<!-- UTSAPIJSON.removeStorage.description -->
+
+<!-- UTSAPIJSON.removeStorage.compatibility -->
+
+<!-- UTSAPIJSON.removeStorage.param -->
+
+<!-- UTSAPIJSON.removeStorage.returnValue -->
+
+<!-- UTSAPIJSON.removeStorage.example -->
+
+<!-- UTSAPIJSON.removeStorage.tutorial -->
+
+<!-- ## uni.removeStorageSync(key) @removestoragesync -->
+
+<!-- UTSAPIJSON.removeStorageSync.name -->
+
+<!-- UTSAPIJSON.removeStorageSync.description -->
+
+<!-- UTSAPIJSON.removeStorageSync.compatibility -->
+
+<!-- UTSAPIJSON.removeStorageSync.param -->
+
+<!-- UTSAPIJSON.removeStorageSync.returnValue -->
+
+<!-- UTSAPIJSON.removeStorageSync.example -->
+
+<!-- UTSAPIJSON.removeStorageSync.tutorial -->
+
+<!-- ## uni.clearStorage(option?) @clearstorage -->
+
+<!-- UTSAPIJSON.clearStorage.name -->
+
+<!-- UTSAPIJSON.clearStorage.description -->
+
+<!-- UTSAPIJSON.clearStorage.compatibility -->
+
+<!-- UTSAPIJSON.clearStorage.param -->
+
+<!-- UTSAPIJSON.clearStorage.returnValue -->
+
+<!-- UTSAPIJSON.clearStorage.example -->
+
+<!-- UTSAPIJSON.clearStorage.tutorial -->
+
+<!-- ## uni.clearStorageSync() @clearstoragesync -->
+
+<!-- UTSAPIJSON.clearStorageSync.name -->
+
+<!-- UTSAPIJSON.clearStorageSync.description -->
+
+<!-- UTSAPIJSON.clearStorageSync.compatibility -->
+
+<!-- UTSAPIJSON.clearStorageSync.param -->
+
+<!-- UTSAPIJSON.clearStorageSync.returnValue -->
+
+<!-- UTSAPIJSON.clearStorageSync.example -->
+
+<!-- UTSAPIJSON.clearStorageSync.tutorial -->
+
+<!-- UTSAPIJSON.storage.example -->
+
+<!-- UTSAPIJSON.general_type.name -->
+
+<!-- UTSAPIJSON.general_type.param -->
+
+
+## 类型数据的存取说明@gettypedata
+
+首先明确一个原则，Storage实际储存到各终端文件系统的是**序列化后的数据**。
+
+也就是当我们使用setStorage/setStorageSync 储存一个带类型的数据时，插件内部会自动将其序列化为字符串后进行储存。当我们调用 getStorage/getStorageSync 插件内部也会尝试对字符串进行类型还原，分为以下几种情况：
+
+不同平台支持的数据类型略有差异。
+
+- web端支持类型：String、Number、Boolean、Object(任意对象，包括UTSJSONObject)、Array、null。
+- 微信小程序支持类型：String、Number、Boolean、Object(任意对象，包括UTSJSONObject)、Array、null、Date（取出时会反序列化为Date实例）。
+- 鸿蒙app端支持类型：String、Number、Boolean、Object(任意对象，包括UTSJSONObject)、Array、null。
+- Android app端支持类型：String、Number、Boolean、Object(UTSJSONObject/Type)、Array。
+- iOS app端支持类型：String、Number、Boolean、Object(UTSJSONObject/Type)、Array。
+
+#### UTSJSONObject
+
+如果是`UTSJSONObject` 类型，不会有类型的丢失
+
+```ts
+let json1 = {
+	id:1001,
+	name:"jack"
+}
+
+uni.setStorageSync("test-json",json1)
+let json2 = uni.getStorageSync("test-json")
+// json2 ‍[⁠UTSJSONObject⁠]‍ {id: 1001, name: "jack"}
+console.log("json2",json2)
+```
+
+#### type类型
+
+如果是type类型，可以正常写入，但是当读取时得到是UTSJSONObject类型，需要进行类型转换。
+
+
+```ts
+type User = {
+	name:string,
+	age:number
+}
+let u1 = {
+	name : "张三",
+	age:123
+}
+uni.setStorageSync("test-a",u1)
+uni.getStorage({
+	key:'test-a',
+	success:function(res:GetStorageSuccess){
+		// 此时只能得到的UTSJSONObject类型
+		let jsonObject = res.data
+		// 再次进行类型转换
+		let userObject = JSON.parse<User>(JSON.stringify(jsonObject))
+		// jsonObject ‍[⁠UTSJSONObject⁠]‍ {age: 123, name: "张三"}
+		console.log("jsonObject",jsonObject)
+		// userObject ‍[⁠User⁠]‍ {age: 123, name: "张三"}
+		console.log("userObject",userObject)
+	}
+})
+```
+
+#### 自定义class
+
+还有一种情况，如果开发者使用class而非type定义类型，默认情况下无法读写的。
+
+> 大多数情况下，我们更推荐使用type,而不是自定义class。 因为自定义class的行为在不同终端可能表现不一致。
+
+
+```ts
+class Person {
+	// 声明属性类型（必须显式初始化或在构造函数中赋值）
+	name: string;
+	age: number;
+
+	// 构造函数
+	constructor(name: string, age: number) {
+		this.name = name;
+		this.age = age;
+	}
+
+	// 方法
+	greet(): string {
+		return `Hello, I'm ${this.name} and I'm ${this.age} years old.`;
+	}
+}
+
+// 使用类
+const alice = new Person("Alice", 30);
+console.log(alice.greet()); // "Hello, I'm Alice and I'm 30 years old."
+
+uni.setStorageSync("test-class-0",alice)
+let dataObj = uni.getStorageSync("test-class-0")
+// 此时只能得到空的UTSJSONObject {}
+console.log("data",dataObj)
+```
+
+如果仅考虑Android平台，可自定义class可实现`IJSONStringify`接口来支持，仅推荐在[uts插件](https://doc.dcloud.net.cn/uni-app-x/plugin/uts-plugin.html)中使用，在uvue页面中仅支持VDOM模式，蒸汽（Vapor）模式不支持。
+关于IJSONStringify的[更多介绍](../uts/buildin-object-api/json.md)。  
+**注意：非Android平台不支持`IJSONStringify`**  
+
+```ts
+class Person implements IJSONStringify {
+	// 声明属性类型（必须显式初始化或在构造函数中赋值）
+	name: string;
+	age: number;
+
+	// 构造函数
+	constructor(name: string, age: number) {
+		this.name = name;
+		this.age = age;
+	}
+	// 自定义序列化规则
+	toJSON():any{
+		let jsonRet = UTSJSONObject()
+		jsonRet["name"] = this.name
+		jsonRet["age"] = this.age
+		return jsonRet
+	}
+
+	// 方法
+	greet(): string {
+		return `Hello, I'm ${this.name} and I'm ${this.age} years old.`;
+	}
+}
+
+// 使用类
+const alice = new Person("Alice", 30);
+console.log(alice.greet()); // "Hello, I'm Alice and I'm 30 years old."
+
+uni.setStorageSync("test-class-0",alice)
+let dataObj = uni.getStorageSync("test-class-0")
+// [⁠UTSJSONObject⁠]‍ {name: "Alice", age: 30}
+console.log("dataObj",dataObj)
+//  ‍[⁠Person⁠]‍ {age: 30, name: "Alice"}
+let personObj = JSON.parse<Person>(JSON.stringify(dataObj))
+console.log("personObj",personObj)
+
+```
+
+这样就可以在Android平台让自定义class实现类似自定义type的效果了。