tmui-cli 2.0.3 → 2.0.5

package/data/uni-app-x-docs/api/open-app-authorize-setting.md

@@ -0,0 +1,23 @@
+<!-- ## uni.openAppAuthorizeSetting(options) @openappauthorizesetting -->
+
+<!-- UTSAPIJSON.openAppAuthorizeSetting.name -->
+
+<!-- UTSAPIJSON.openAppAuthorizeSetting.description -->
+
+<!-- UTSAPIJSON.openAppAuthorizeSetting.compatibility -->
+
+_注：App平台其实早期版本也可以使用_
+
+<!-- UTSAPIJSON.openAppAuthorizeSetting.param -->
+
+<!-- UTSAPIJSON.openAppAuthorizeSetting.returnValue -->
+
+<!-- UTSAPIJSON.openAppAuthorizeSetting.example -->
+
+<!-- UTSAPIJSON.openAppAuthorizeSetting.tutorial -->
+
+<!-- UTSAPIJSON.openAppAuthorizeSetting.example -->
+
+<!-- UTSAPIJSON.general_type.name -->
+
+<!-- UTSAPIJSON.general_type.param -->

package/data/uni-app-x-docs/api/open-document.md

@@ -0,0 +1,21 @@
+<!-- ## uni.openDocument(options?) @opendocument -->
+
+<!-- UTSAPIJSON.openDocument.name -->
+
+<!-- UTSAPIJSON.openDocument.description -->
+
+<!-- UTSAPIJSON.openDocument.compatibility -->
+
+<!-- UTSAPIJSON.openDocument.param -->
+
+<!-- UTSAPIJSON.openDocument.returnValue -->
+
+<!-- UTSAPIJSON.openDocument.example -->
+
+<!-- UTSAPIJSON.openDocument.tutorial -->
+
+<!-- UTSAPIJSON.openDocument.example -->
+
+<!-- UTSAPIJSON.general_type.name -->
+
+<!-- UTSAPIJSON.general_type.param -->

package/data/uni-app-x-docs/api/open-location.md

@@ -0,0 +1,22 @@
+## uni.openLocation(options) @openlocation
+
+::: warning 注意
+
+- `HBuilderX 5.11` 起，`openLocation` 已内置在 `uni-app x` 框架内，无需再单独导入 `uni-openlocation` 插件；
+- `HBuilderX 5.11` 之前，如需使用，请前往插件市场导入该插件：[插件地址](https://ext.dcloud.net.cn/plugin?name=uni-openLocation)
+- 无论是内置能力还是导入 `uni-openlocation` 插件，通过 `uni.openLocation` 打开的页面都会以 `dialogPage` 的形式呈现。此时执行 `getDialogPages` 方法时，由 `openLocation` 打开的页面也会包含在返回的页面数组中，这属于正常现象。
+
+- `HarmonyOS平台` 调用此 API 需要申请定位权限 `ohos.permission.APPROXIMATELY_LOCATION`、`ohos.permission.LOCATION`，需自行在项目中配置权限。
+  :::
+
+<!-- UTSAPIJSON.openLocation.description -->
+
+<!-- UTSAPIJSON.openLocation.compatibility -->
+
+<!-- UTSAPIJSON.openLocation.param -->
+
+<!-- UTSAPIJSON.openLocation.returnValue -->
+
+<!-- UTSAPIJSON.openLocation.example -->
+
+<!-- UTSAPIJSON.openLocation.tutorial -->

package/data/uni-app-x-docs/api/page-scroll-to.md

@@ -0,0 +1,57 @@
+<!-- ## uni.pageScrollTo(options) @pagescrollto -->
+
+<!-- UTSAPIJSON.pageScrollTo.name -->
+
+<!-- UTSAPIJSON.pageScrollTo.description -->
+
+可以滚动到指定的scrollTop值处，也可以滚动到指定的目标元素处（通过css选择器selector）, 仅支持一级 class。
+
+本API滚动的是栈顶的页面。
+
+app-uvue下，其实没有页面级滚动。但本API做了一定兼容，当页面的根元素为scroll-view时，本API也会滚动该scroll-view。[详见](../css/README.md#pagescroll)
+
+<!-- UTSAPIJSON.pageScrollTo.compatibility -->
+
+<!-- UTSAPIJSON.pageScrollTo.param -->
+
+`scrollTop` 和 `selector` 必须指定其中一个属性，否者触发 `fail` 回调
+
+<!-- UTSAPIJSON.pageScrollTo.returnValue -->
+
+<!-- UTSAPIJSON.pageScrollTo.example -->
+
+<!-- UTSAPIJSON.pageScrollTo.tutorial -->
+
+**selector 语法**
+
+selector类似于 CSS 的选择器，但仅支持下列语法。
+
+- ID选择器：#the-id
+- class选择器（可以连续指定多个）：`.a-class.another-class`
+- 子元素选择器：`.the-parent > .the-child`
+- 后代选择器：`.the-ancestor .the-descendant`
+- 跨自定义组件的后代选择器：`.the-ancestor >>> .the-descendant`
+- 多选择器的并集：`#a-node, .some-other-nodes`
+
+## uni-app x 注意事项
+
+1. app-uvue支持的选择器较少，不支持ID选择器，[详见](../css/common/selector.md)
+2. app-uvue的页面滚动，是由页面最外层的scroll-view模拟的，如果页面最外层不是scroll-view，无法使用本api。[详见](../css/README.md#pagescroll)
+3. app-uvue的scroll-view滚动时，如需动画，则需要在scroll-view的属性中配置 `scroll-with-animation="true"`，[详见](../component/scroll-view.md)
+4. scroll-view的滚动，设置其scrollTop即可。[详见](../component/scroll-view.md)
+
+**示例**
+
+```javascript
+uni.pageScrollTo({
+	scrollTop: 0,
+	duration: 300
+});
+```
+
+<!-- UTSAPIJSON.general_type.name -->
+
+<!-- UTSAPIJSON.general_type.param -->
+
+## Tips
+- 本API默认处理栈顶页面，而不是代码所在页面。[详见](./README.md#toppage)

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

@@ -0,0 +1,160 @@
+## Path2D
+
+<!-- CUSTOMTYPEJSON.Path2D.description -->
+
+<!-- CUSTOMTYPEJSON.Path2D.extends -->
+
+<!-- CUSTOMTYPEJSON.Path2D.param -->
+
+
+
+<!-- CUSTOMTYPEJSON.Path2D.compatibility -->
+
+<!-- CUSTOMTYPEJSON.Path2D.example -->
+
+### Path2D 的方法 @path2d-methods
+<!-- CUSTOMTYPEJSON.Path2D.methods.closePath.name -->
+
+<!-- CUSTOMTYPEJSON.Path2D.methods.closePath.description -->
+
+<!-- CUSTOMTYPEJSON.Path2D.methods.closePath.compatibility -->
+
+<!-- CUSTOMTYPEJSON.Path2D.methods.closePath.param -->
+
+<!-- CUSTOMTYPEJSON.Path2D.methods.closePath.returnValue -->
+
+<!-- CUSTOMTYPEJSON.Path2D.methods.closePath.tutorial -->
+
+<!-- CUSTOMTYPEJSON.Path2D.methods.moveTo.name -->
+
+<!-- CUSTOMTYPEJSON.Path2D.methods.moveTo.description -->
+
+<!-- CUSTOMTYPEJSON.Path2D.methods.moveTo.compatibility -->
+
+<!-- CUSTOMTYPEJSON.Path2D.methods.moveTo.param -->
+
+<!-- CUSTOMTYPEJSON.Path2D.methods.moveTo.returnValue -->
+
+<!-- CUSTOMTYPEJSON.Path2D.methods.moveTo.tutorial -->
+
+<!-- CUSTOMTYPEJSON.Path2D.methods.lineTo.name -->
+
+<!-- CUSTOMTYPEJSON.Path2D.methods.lineTo.description -->
+
+<!-- CUSTOMTYPEJSON.Path2D.methods.lineTo.compatibility -->
+
+<!-- CUSTOMTYPEJSON.Path2D.methods.lineTo.param -->
+
+<!-- CUSTOMTYPEJSON.Path2D.methods.lineTo.returnValue -->
+
+<!-- CUSTOMTYPEJSON.Path2D.methods.lineTo.tutorial -->
+
+<!-- CUSTOMTYPEJSON.Path2D.methods.bezierCurveTo.name -->
+
+<!-- CUSTOMTYPEJSON.Path2D.methods.bezierCurveTo.description -->
+
+<!-- CUSTOMTYPEJSON.Path2D.methods.bezierCurveTo.compatibility -->
+
+<!-- CUSTOMTYPEJSON.Path2D.methods.bezierCurveTo.param -->
+
+<!-- CUSTOMTYPEJSON.Path2D.methods.bezierCurveTo.returnValue -->
+
+<!-- CUSTOMTYPEJSON.Path2D.methods.bezierCurveTo.tutorial -->
+
+<!-- CUSTOMTYPEJSON.Path2D.methods.quadraticCurveTo.name -->
+
+<!-- CUSTOMTYPEJSON.Path2D.methods.quadraticCurveTo.description -->
+
+<!-- CUSTOMTYPEJSON.Path2D.methods.quadraticCurveTo.compatibility -->
+
+<!-- CUSTOMTYPEJSON.Path2D.methods.quadraticCurveTo.param -->
+
+<!-- CUSTOMTYPEJSON.Path2D.methods.quadraticCurveTo.returnValue -->
+
+<!-- CUSTOMTYPEJSON.Path2D.methods.quadraticCurveTo.tutorial -->
+
+<!-- CUSTOMTYPEJSON.Path2D.methods.arc.name -->
+
+<!-- CUSTOMTYPEJSON.Path2D.methods.arc.description -->
+
+<!-- CUSTOMTYPEJSON.Path2D.methods.arc.compatibility -->
+
+<!-- CUSTOMTYPEJSON.Path2D.methods.arc.param -->
+
+<!-- CUSTOMTYPEJSON.Path2D.methods.arc.returnValue -->
+
+<!-- CUSTOMTYPEJSON.Path2D.methods.arc.tutorial -->
+
+<!-- CUSTOMTYPEJSON.Path2D.methods.arcTo.name -->
+
+<!-- CUSTOMTYPEJSON.Path2D.methods.arcTo.description -->
+
+<!-- CUSTOMTYPEJSON.Path2D.methods.arcTo.compatibility -->
+
+<!-- CUSTOMTYPEJSON.Path2D.methods.arcTo.param -->
+
+<!-- CUSTOMTYPEJSON.Path2D.methods.arcTo.returnValue -->
+
+<!-- CUSTOMTYPEJSON.Path2D.methods.arcTo.tutorial -->
+
+<!-- CUSTOMTYPEJSON.Path2D.methods.ellipse.name -->
+
+<!-- CUSTOMTYPEJSON.Path2D.methods.ellipse.description -->
+
+<!-- CUSTOMTYPEJSON.Path2D.methods.ellipse.compatibility -->
+
+<!-- CUSTOMTYPEJSON.Path2D.methods.ellipse.param -->
+
+<!-- CUSTOMTYPEJSON.Path2D.methods.ellipse.returnValue -->
+
+<!-- CUSTOMTYPEJSON.Path2D.methods.ellipse.tutorial -->
+
+<!-- CUSTOMTYPEJSON.Path2D.methods.rect.name -->
+
+<!-- CUSTOMTYPEJSON.Path2D.methods.rect.description -->
+
+<!-- CUSTOMTYPEJSON.Path2D.methods.rect.compatibility -->
+
+<!-- CUSTOMTYPEJSON.Path2D.methods.rect.param -->
+
+<!-- CUSTOMTYPEJSON.Path2D.methods.rect.returnValue -->
+
+<!-- CUSTOMTYPEJSON.Path2D.methods.rect.tutorial -->
+
+**注意事项**
+
+## uni-app-x harmony
+
+draw(path2D) 不受 context 的 moveTo 影响，如果需要指定位置需要调用 path2D的moveTo方法，示例如下：
+
+```js
+uni.createCanvasContextAsync({
+  id: 'canvas',
+  component: this, // setup 模式使用 getCurrentInstance()
+  success: (canvasContext : CanvasContext) => {
+    const context = canvasContext.getContext('2d')!;
+    const canvas = context.canvas;
+
+    const dpr = uni.getWindowInfo().pixelRatio;
+    context.scale(dpr, dpr);
+
+    context.beginPath()
+    const path2D = canvasContext!.createPath2D();
+    const amplitude = 64;
+    const wavelength = 64;
+    for (let i = 0; i < 5; i++) {
+      const x1 = 0 + (i * wavelength);
+      const y1 = 128;
+      const x2 = x1 + wavelength / 4;
+      const y2 = y1 - amplitude;
+      const x3 = x1 + 3 * wavelength / 4;
+      const y3 = y1 + amplitude;
+      const x4 = x1 + wavelength;
+      const y4 = y1;
+      // context.moveTo(x1, y1); 这里调用moveTo无效，需要使用path2D.moveTo(x1, y1);
+      path2D.bezierCurveTo(x2, y2, x3, y3, x4, y4);
+    }
+    context.stroke(path2D);
+  }
+})
+```

package/data/uni-app-x-docs/api/preview-image.md

@@ -0,0 +1,44 @@
+<!-- ## uni.previewImage(options) @previewimage -->
+
+<!-- UTSAPIJSON.previewImage.name -->
+
+<!-- UTSAPIJSON.previewImage.description -->
+
+<!-- UTSAPIJSON.previewImage.compatibility -->
+
+<!-- UTSAPIJSON.previewImage.param -->
+
+<!-- UTSAPIJSON.previewImage.returnValue -->
+
+<!-- UTSAPIJSON.previewImage.example -->
+
+<!-- UTSAPIJSON.previewImage.tutorial -->
+
+### 开源自定义@custom
+内置的previewImage弹出的界面，无法充分自定义。所以uni-app x提供了开源的previewImage页面，开发者可以自己定义UI。
+
+开源插件地址：[https://ext.dcloud.net.cn/plugin?id=21314](https://ext.dcloud.net.cn/plugin?id=21314)
+
+这个插件是[ext api](https://uniapp.dcloud.net.cn/api/extapi.html)，下载到项目下会覆盖uni.previewImage的实现。
+
+单独下载开源插件后，调用uni.previewImage，会在栈顶页面打开一个dialogPage，在父页面的getDialogPages中可以看到。使用内置的uni.previewImage看不到。
+
+<!-- ## uni.closePreviewImage(options) @closepreviewimage -->
+
+<!-- UTSAPIJSON.closePreviewImage.name -->
+
+<!-- UTSAPIJSON.closePreviewImage.description -->
+
+<!-- UTSAPIJSON.closePreviewImage.compatibility -->
+
+<!-- UTSAPIJSON.closePreviewImage.param -->
+
+<!-- UTSAPIJSON.closePreviewImage.returnValue -->
+
+<!-- UTSAPIJSON.closePreviewImage.example -->
+
+<!-- UTSAPIJSON.closePreviewImage.tutorial -->
+
+<!-- UTSAPIJSON.general_type.name -->
+
+<!-- UTSAPIJSON.general_type.param -->

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

@@ -0,0 +1,84 @@
+## 隐私API
+因为uni-app下开发者的js代码执行较晚，所以框架提供了原生隐私协议框，但自定义性较差。
+
+uni-app x并不需要这套机制，开发者的代码就是原生代码，执行时机很早，可以自己弹出隐私协议政策。（如在app launch生命周期中弹出dialogPage的协议框）
+
+但应用开发者和插件开发者，需要监听和共享隐私协议是否同意。所以提供了如下一批能力。
+
+- `uni.getPrivacySetting`：获取用户是否同意了隐私协议
+- `uni.resetPrivacyAuthorization`：重置隐私协议状态。适用于隐私协议变更，需要重新同意的场景
+- `uni.onPrivacyAuthorizationChange`、`uni.offPrivacyAuthorizationChange`：监听和取消监听用户是否同意隐私协议
+- 在 [button组件](../component/button.md)中，提供了属性open-type="agreePrivacyAuthorization"。之所以同意隐私协议是按钮，而不是API，是因为需要用户真实的同意。避免插件作者通过API非正常设置隐私协议为同意。所以开发者务必在隐私协议的同意按钮处使用 open-type="agreePrivacyAuthorization" 的 button组件。
+- `manifest.json`中， `app` 节点下`initPrivacyAuthorization` 为 `auto` 时，安卓、鸿蒙平台隐私状态初始值为 `disagree`，iOS平台隐私状态初始值为 `agree`
+
+<!-- ## uni.getPrivacySetting(options) @getprivacysetting -->
+
+<!-- UTSAPIJSON.getPrivacySetting.name -->
+
+<!-- UTSAPIJSON.getPrivacySetting.description -->
+
+<!-- UTSAPIJSON.getPrivacySetting.compatibility -->
+
+<!-- UTSAPIJSON.getPrivacySetting.param -->
+
+<!-- UTSAPIJSON.getPrivacySetting.returnValue -->
+
+<!-- UTSAPIJSON.getPrivacySetting.example -->
+
+<!-- UTSAPIJSON.getPrivacySetting.tutorial -->
+
+<!-- ## uni.resetPrivacyAuthorization() @resetprivacyauthorization -->
+
+<!-- UTSAPIJSON.resetPrivacyAuthorization.name -->
+
+<!-- UTSAPIJSON.resetPrivacyAuthorization.description -->
+
+适用于隐私协议变更，需要重新同意的场景。
+
+<!-- UTSAPIJSON.resetPrivacyAuthorization.compatibility -->
+
+<!-- UTSAPIJSON.resetPrivacyAuthorization.param -->
+
+<!-- UTSAPIJSON.resetPrivacyAuthorization.returnValue -->
+
+<!-- UTSAPIJSON.resetPrivacyAuthorization.example -->
+
+<!-- UTSAPIJSON.resetPrivacyAuthorization.tutorial -->
+
+<!-- ## uni.onPrivacyAuthorizationChange(callback) @onprivacyauthorizationchange -->
+
+<!-- UTSAPIJSON.onPrivacyAuthorizationChange.name -->
+
+<!-- UTSAPIJSON.onPrivacyAuthorizationChange.description -->
+
+<!-- UTSAPIJSON.onPrivacyAuthorizationChange.compatibility -->
+
+<!-- UTSAPIJSON.onPrivacyAuthorizationChange.param -->
+
+<!-- UTSAPIJSON.onPrivacyAuthorizationChange.returnValue -->
+
+<!-- UTSAPIJSON.onPrivacyAuthorizationChange.example -->
+
+<!-- UTSAPIJSON.onPrivacyAuthorizationChange.tutorial -->
+
+<!-- ## uni.offPrivacyAuthorizationChange(id) @offprivacyauthorizationchange -->
+
+<!-- UTSAPIJSON.offPrivacyAuthorizationChange.name -->
+
+<!-- UTSAPIJSON.offPrivacyAuthorizationChange.description -->
+
+<!-- UTSAPIJSON.offPrivacyAuthorizationChange.compatibility -->
+
+<!-- UTSAPIJSON.offPrivacyAuthorizationChange.param -->
+
+<!-- UTSAPIJSON.offPrivacyAuthorizationChange.returnValue -->
+
+<!-- UTSAPIJSON.offPrivacyAuthorizationChange.example -->
+
+<!-- UTSAPIJSON.offPrivacyAuthorizationChange.tutorial -->
+
+<!-- UTSAPIJSON.privacy.example -->
+
+<!-- UTSAPIJSON.general_type.name -->
+
+<!-- UTSAPIJSON.general_type.param -->

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

@@ -0,0 +1,123 @@
+## provider机制介绍
+
+uni-app的API，统一了多平台的差异。但某个API，可以由很多三方SDK来支撑，所以提供了provider机制用于抹平SDK之间的差异。
+
+比如
+- 支付API：有支付宝支持、微信支付
+- 定位API：有系统定位、腾讯定位
+- 登录API：微信登录、Apple登录
+- 分享API： 微信分享
+
+不同的SDK，本身的API是完全不同的，甚至同一个SDK的Android和iOS的API也不一样。
+
+uni-app 通过 provider 机制来统一不同的SDK，屏蔽他们的差异。
+
+同一个功能的不同的SDK，都被称为该功能的 provider，即供应商。
+
+比如对于支付模块，有 支付宝 和 微信 这2个 provider 供应商。
+
+由于这些[模块和SDK](../collocation/manifest-modules.md)在打包时是可选的，那么在运行时可以通过 `uni.getProvider`，来获取到本App包中包含的provider清单。
+
+**注意**
+
+我们要把SDK和App的概念区分清楚。对于支付的2个provider，支付宝和微信，它们除了有SDK外，也有各自的主App。
+
+`uni.getProviders`，只是动态获取开发者的App包中的provider清单，即打包了哪些SDK。但本API不负责判断这些provider的主App是否安装在同一台手机上。
+
+但微信比较特殊，如果没有微信App，微信支付无法完成。并且Appstore审核要求本机未安装微信时，不能显示微信的登录支付。这就要求开发者必须判断本机是否安装了微信。
+
+所以微信的SDK，自身提供了获取微信主App是否安装的API，那么这个API也被封装到了provider返回的对象里。
+
+除微信外，其他SDK无此特殊情况。
+
+### 自注册provider
+
+除了官方提供的provider，uni-app x 于 `4.24版`开放了provider自注册机制，允许三方插件注册provider。
+
+- [自定义支付provider](request-payment.md#customprovider)
+
+- [自定义定位provider](get-location.md#customprovider)
+
+- [自定义分享provider](share.md#customprovider)
+
+- [自定义登录provider](sign-in.md#customprovider)
+
+**注意**
+
+- 标准基座android需要在manifest.json中配置才能获取到对应的provider，ios不需要。自定义基座都需要配置
+- 自定义的provider不要在构造函数中写逻辑，因为现在provider会预先实例化，如果在构造函数中写逻辑，会导致代码在应用启动的时候就被执行
+
+<!-- UTSAPIJSON.getProviderSync.name -->
+
+<!-- UTSAPIJSON.getProviderSync.description -->
+
+<!-- UTSAPIJSON.getProviderSync.compatibility -->
+
+<!-- UTSAPIJSON.getProviderSync.param -->
+
+<!-- UTSAPIJSON.getProviderSync.returnValue -->
+
+<!-- UTSAPIJSON.getProviderSync.tutorial -->
+
+<!-- UTSAPIJSON.getProvider.example -->
+
+
+### UniProvider说明文档链接
+
+- 支付Provider：[UniPaymentAlipayProvider](./request-payment.md#providerdes),[UniPaymentWxpayProvider](./request-payment.md#providerdes)
+
+- 定位Provider：[UniLocationSystemProvider](./get-location.md#providerdes),[UniLocationTencentProvider](./get-location.md#providerdes)
+
+- 分享Provider：[UniShareWeixinProvider](./share.md#providerdes)
+
+- 登录Provider：[UniOAuthWeixinProvider](./sign-in.md#providerdes)
+
+## UniProvider
+
+<!-- CUSTOMTYPEJSON.UniProvider.description -->
+
+<!-- CUSTOMTYPEJSON.UniProvider.extends -->
+
+<!-- CUSTOMTYPEJSON.UniProvider.param -->
+
+<!-- CUSTOMTYPEJSON.UniProvider.compatibility -->
+
+<!-- CUSTOMTYPEJSON.UniProvider.example -->
+
+<!-- UTSAPIJSON.provider.example -->
+
+<!-- UTSAPIJSON.general_type.name -->
+
+<!-- UTSAPIJSON.general_type.param -->
+
+
+<!-- UTSAPIJSON.getProvider.name -->
+
+<!-- UTSAPIJSON.getProvider.description -->
+
+<!-- UTSAPIJSON.getProvider.compatibility -->
+
+<!-- UTSAPIJSON.getProvider.param -->
+
+<!-- UTSAPIJSON.getProvider.returnValue -->
+
+::: warning uni.getProvider 返回顺序说明：
+1. 目前标准基座中注册的 provider 返回顺序如下：
+    支付： 微信支付、支付宝；
+    定位： 系统定位、腾讯定位
+    分享： 微信分享
+    登录： 微信登录、Apple登录
+
+2. 相同 service 下，其他的自注册 provider，返回顺序在官方预置的 provider 之后
+
+3. 自注册的 provider 无法保障顺序， 请不要依赖自注册 provider 的顺序
+
+4. 如果自定义的 service 与 provider 配置与内置的一样，优先采用自定义的
+
+5. 如果自定义的 service 下存在多个同名的 provider，编译器会报错
+
+:::
+
+<!-- UTSAPIJSON.getProvider.tutorial -->
+
+<!-- UTSAPIJSON.provider.example -->

package/data/uni-app-x-docs/api/pull-down-refresh.md

@@ -0,0 +1,46 @@
+<!-- ## uni.startPullDownRefresh(options?) @startpulldownrefresh -->
+
+<!-- UTSAPIJSON.startPullDownRefresh.name -->
+
+<!-- UTSAPIJSON.startPullDownRefresh.description -->
+
+<!-- UTSAPIJSON.startPullDownRefresh.compatibility -->
+
+<!-- UTSAPIJSON.startPullDownRefresh.param -->
+
+<!-- UTSAPIJSON.startPullDownRefresh.returnValue -->
+
+<!-- UTSAPIJSON.startPullDownRefresh.tutorial -->
+
+<!-- ## uni.stopPullDownRefresh() @stoppulldownrefresh -->
+
+<!-- UTSAPIJSON.stopPullDownRefresh.name -->
+
+<!-- UTSAPIJSON.stopPullDownRefresh.description -->
+
+<!-- UTSAPIJSON.stopPullDownRefresh.compatibility -->
+
+使用：
+1. 首先pages.json里配置了页面可下拉刷新`"enablePullDownRefresh": true`
+2. 当用户下拉页面时触发页面生命周期`onPullDownRefresh`，iOS平台触发时机：当下拉到一定阀值就会触发`onPullDownRefresh`，并不是当手势拖拽结束时触发
+3. 在合适的时机（如联网刷新数据结束），调用本API`uni.stopPullDownRefresh()`，结束下拉刷新状态
+
+本API仅负责页面下拉刷新。如使用组件下拉刷新，另见scroll-view、list-view等组件的文档。
+
+<!-- UTSAPIJSON.stopPullDownRefresh.param -->
+
+<!-- UTSAPIJSON.stopPullDownRefresh.returnValue -->
+
+<!-- UTSAPIJSON.stopPullDownRefresh.example -->
+
+<!-- UTSAPIJSON.stopPullDownRefresh.tutorial -->
+
+<!-- UTSAPIJSON.pullDownRefresh.example -->
+
+<!-- UTSAPIJSON.general_type.name -->
+
+<!-- UTSAPIJSON.general_type.param -->
+
+## Tips
+- 本API默认处理栈顶页面，而不是代码所在页面。[详见](./README.md#toppage)
+- iOS 平台蒸汽模式开启下拉刷新会触发页面 `onPageScroll` 生命周期，此时 `scrollTop` 为负值。

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

@@ -0,0 +1 @@
+文档已迁移，请前往[uni-push](uni-push.md)查看最新文档

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

@@ -0,0 +1,44 @@
+<!-- ## uni.report(options) @report -->
+
+<!-- UTSAPIJSON.report.name -->
+
+<!-- UTSAPIJSON.report.description -->
+
+### 注意事项
+`uni.report` 需要依赖 [`uni统计`](https://ext.dcloud.net.cn?name=uni-stat)，集成方式请查看[文档](https://uniapp.dcloud.net.cn/uni-stat-uniappx)。
+
+<!-- UTSAPIJSON.report.compatibility -->
+
+<!-- UTSAPIJSON.report.param -->
+
+<!-- UTSAPIJSON.report.returnValue -->
+
+### 如何使用自定义上报@custom-report
+
+```js
+// 参数支持字符串
+uni.report({
+ name:'购买',
+ options:'购买成功'
+})
+
+// 参数支持对象
+uni.report({
+ name:'购买',
+ options:{
+  id:'1000',
+  name:'上衣',
+  price:'998',
+  msg:'购买成功'
+  // ...
+ }
+})
+```
+
+<!-- UTSAPIJSON.report.example -->
+
+<!-- UTSAPIJSON.report.tutorial -->
+
+<!-- UTSAPIJSON.general_type.name -->
+
+<!-- UTSAPIJSON.general_type.param -->

package/data/uni-app-x-docs/api/request-merchant-transfer.md

@@ -0,0 +1,31 @@
+<!-- ## uni.requestMerchantTransfer(options) @requestmerchanttransfer -->
+
+<!-- UTSAPIJSON.requestMerchantTransfer.name -->
+
+<!-- UTSAPIJSON.requestMerchantTransfer.description -->
+
+::: info
+uni.requestMerchantTransfer 是​商家转账到用户零钱的API，适用于需要向用户直接发放资金（如提现、奖励发放、活动返现）的场景。
+
+注意：
+  - [APP调起用户确认收款] 和 [APP调起用户免确认收款授权] 是用一个 API，参数一致
+  - 开发者需在[微信支付商户平台/合作伙伴平台-产品中心](https://pay.weixin.qq.com/)，申请开通商家转账
+  - 具体流程请参考[微信商家转账文档](https://pay.weixin.qq.com/doc/v3/merchant/4012711988)
+  - app-ios 需要在可视化界面配置scheme、universalLink 参数，详见 [iOS配置/uni-payment(支付)/微信支付](https://doc.dcloud.net.cn/uni-app-x/collocation/manifest-ios.html#paymentweixin)
+  - 该功能支持 uniapp 项目，请使用插件[uni-requestMerchantTransfer](https://ext.dcloud.net.cn/plugin?id=22283)
+  - uniapp x 的iOS端和安卓端已内置此插件，但鸿蒙端需要下载插件[uni-requestMerchantTransfer](https://ext.dcloud.net.cn/plugin?id=22283)
+:::
+
+<!-- UTSAPIJSON.requestMerchantTransfer.compatibility -->
+
+<!-- UTSAPIJSON.requestMerchantTransfer.param -->
+
+<!-- UTSAPIJSON.requestMerchantTransfer.returnValue -->
+
+<!-- UTSAPIJSON.requestMerchantTransfer.tutorial -->
+
+<!-- UTSAPIJSON.requestMerchantTransfer.example -->
+
+<!-- UTSAPIJSON.general_type.name -->
+
+<!-- UTSAPIJSON.general_type.param -->