tmui-cli 2.0.3 → 2.0.4

package/data/uniappx/api/provider.md

@@ -0,0 +1,329 @@
+## 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会预先实例化，如果在构造函数中写逻辑，会导致代码在应用启动的时候就被执行
+
+::: sourceCode
+## uni.getProviderSync(options) @getprovidersync
+
+> GitCode: https://gitcode.com/dcloud/uni-api/tree/alpha/uni_modules/uni-getProvider
+
+> GitHub: https://github.com/dcloudio/uni-api/tree/alpha/uni_modules/uni-getProvider
+
+getProvider的同步方法
+
+### getProviderSync 兼容性  
+| Web | 微信小程序 | Android | iOS | HarmonyOS |
+| :- | :- | :- | :- | :- |
+| <a style="color:unset;" href="https://vote.dcloud.net.cn/#/?name=uni-app%20x">x</a> | <a style="color:unset;" href="https://vote.dcloud.net.cn/#/?name=uni-app%20x">x</a> | 4.25 | 4.25 | 4.61 |
+
+### 参数 
+
+| 名称 | 类型 | 必填 | 兼容性 |
+| :- | :- | :- |  :-: |
+| options | **GetProviderSyncOptions** | 是 | Web x / 微信小程序 x（部分支持，见上） |
+| 名称 | 类型 | 必备 | 兼容性 | 描述 |
+| :- | :- | :- |  :-: | :- |
+| service | string | 是 | Web x / 微信小程序 x / Android 4.25 / iOS 4.25（部分支持，见上） | 服务类型<br/> |
+@@| 合法值 | 兼容性 | 描述 |
+@@| :- |  :-: | :- |
+@@| payment | Web x / 微信小程序 x / Android 4.25 / iOS 4.25（部分支持，见上） | 支付 (alipay、wxpay) |
+@@| location | Web x / 微信小程序 x / Android 4.25 / iOS 4.25（部分支持，见上） | 定位 (system、tencent) |
+@@| oauth | Web x / 微信小程序 x / Android 5.08 / iOS 5.08 / HarmonyOS 4.61（部分支持，见上） | 授权登录 (weixin、apple(iOS HBuilderX 5.21+支持)) |
+@@| share | Web x / 微信小程序 x / Android 5.08 / iOS 5.08 / HarmonyOS 4.81（部分支持，见上） | 分享 (weixin) |
+
+### 返回值 
+
+| 类型 |
+| :- |
+| **GetProviderSyncSuccess** |
+| 名称 | 类型 | 必备 | 兼容性 | 描述 |
+| :- | :- | :- |  :-: | :- |
+| service | string | 是 | Web x / 微信小程序 x / Android 4.25 / iOS 4.25（部分支持，见上） | 服务类型<br/> |
+@@| 合法值 | 兼容性 | 描述 |
+@@| :- |  :-: | :- |
+@@| payment | Web x / 微信小程序 x / Android 4.25 / iOS 4.25 / HarmonyOS 4.61（部分支持，见上） | 支付 (alipay、wxpay) |
+@@| location | Web x / 微信小程序 x / Android 4.25 / iOS 4.25 / HarmonyOS 4.61（部分支持，见上） | 定位 (system、tencent) |
+@@| oauth | Web x / 微信小程序 x / Android 5.08 / iOS 5.08 / HarmonyOS 4.61（部分支持，见上） | 授权登录 （weixin、apple(iOS HBuilderX 5.21+支持)） |
+@@| share | Web x / 微信小程序 x / Android 5.08 / iOS 5.08 / HarmonyOS 4.61（部分支持，见上） | 分享（weixin） |
+| providerIds | Array&lt;string&gt; | 是 | Web x / 微信小程序 x / Android 4.25 / iOS 4.25 / HarmonyOS 4.61（部分支持，见上） | 得到的服务供应商 |
+| providerObjects | Array&lt;UniProvider&gt; | 是 | Web x / 微信小程序 x / Android 4.25 / iOS 4.25 / HarmonyOS 4.61（部分支持，见上） | 得到的服务供应商服务对象 |
+
+### 参见
+- [相关 Bug](https://issues.dcloud.net.cn/?mid=api.base.getProvider)
+- [参见uni-app相关文档](https://uniapp.dcloud.net.cn/api/plugins/provider.html#getprovider)
+
+### 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
+
+服务供应商
+
+### UniProvider 的属性值 @uniprovider-values
+| 名称 | 类型 | 必备 | 描述 |
+| :- | :- | :- | :- |
+| id | string | 是 | 服务供应商标识 |
+| description | string | 是 | 服务供应商描述 |
+| ~~isAppExist~~ | boolean | 是 | 判断服务供应商依赖的App是否安装（仅支持微信支付） |
+
+### UniProvider 兼容性  
+ | Android | iOS |
+| :- | :- |
+| 4.18 | 4.18 |
+
+## 示例
+
+示例为[hello uni-app x alpha分支](https://gitcode.com/dcloud/hello-uni-app-x/blob/prod_alpha/pages/API/provider/provider.uvue)，与最新HBuilderX Alpha版同步。与最新正式版同步的master分支示例[另见](https://gitcode.com/dcloud/hello-uni-app-x/blob/master//pages/API/provider/provider.uvue) 
+>
+> 该 API 不支持 Web，请运行 hello uni-app x 到 App 平台体验 
+
+::: preview
+> appRedirect https://hellouniappx.dcloud.net.cn/appredirect.html?path=pages/API/provider/provider
+```uvue
+<template>
+  
+  <scroll-view class="page-scroll-view">
+  
+    <view class="page">
+      <page-head :title="data.title"></page-head>
+      <view class="service-item" v-for="(item, index) in data.serviceList" :key="index">
+        <text class="service-name">{{item.name}}:</text>
+        <view class="provider-list">
+          <text class="provider-item" v-for="(item2, index2) in item.provider" :key="index2">
+            {{item2}}
+            {{item.providerObj.length > 0 ? ':' + JSON.stringify(item.providerObj[index2]) : '' }}
+          </text>
+        </view>
+      </view>
+      <button class="btn-get-provider" type="primary" @click="getProvider">getProviderSync</button>
+    </view>
+  
+  </scroll-view>
+  
+</template>
+
+
+
+<style>
+  .page {
+    padding: 15px;
+  }
+
+  .service-item {
+    margin-top: 10px;
+  }
+
+  .service-name {
+    font-weight: bold;
+  }
+
+  .provider-list {
+    margin-left: 32px;
+  }
+
+  .provider-item {
+    line-height: 1.5;
+  }
+
+  .btn-get-provider {
+    margin-top: 30px;
+  }
+</style>
+
+```
+
+## 通用类型
+
+### GeneralCallbackResult @generalcallbackresult-values 
+
+| 名称 | 类型 | 必备 | 描述 |
+| :- | :- | :- | :- |
+| errMsg | string | 是 | 错误信息 |
+
+::: sourceCode
+## uni.~~getProvider(options)~~ @getprovider
+
+> GitCode: https://gitcode.com/dcloud/uni-api/tree/alpha/uni_modules/uni-getProvider
+
+> GitHub: https://github.com/dcloudio/uni-api/tree/alpha/uni_modules/uni-getProvider
+
+获取服务供应商  **已废弃，4.25及以后版本请使用getProviderSync()方法代替**
+
+### getProvider 兼容性  
+| Web | 微信小程序 | Android | iOS | HarmonyOS |
+| :- | :- | :- | :- | :- |
+| <a style="color:unset;" href="https://vote.dcloud.net.cn/#/?name=uni-app%20x">x</a> | <a style="color:unset;" href="https://vote.dcloud.net.cn/#/?name=uni-app%20x">x</a> | 4.11 | 4.18 | 4.61 |
+
+### 参数 
+
+| 名称 | 类型 | 必填 | 兼容性 |
+| :- | :- | :- |  :-: |
+| options | **GetProviderOptions** | 是 | Web x / 微信小程序 x（部分支持，见上） |
+| 名称 | 类型 | 必备 | 兼容性 | 描述 |
+| :- | :- | :- |  :-: | :- |
+| service | string | 是 | Web x / 微信小程序 x / Android 4.18 / iOS 4.18（部分支持，见上） | 服务类型：支付 (payment)<br/> |
+@@| 合法值 | 兼容性 | 描述 |
+@@| :- |  :-: | :- |
+@@| payment | Web x / 微信小程序 x / Android 4.11 / iOS 4.18（部分支持，见上） | 支付 (alipay、wxpay) |
+@@| location | Web x / 微信小程序 x / Android 4.11 / iOS 4.18（部分支持，见上） | 定位 (system、tencent) |
+@@| oauth | Web x / 微信小程序 x / Android 5.08 / iOS 5.08 / HarmonyOS 4.61（部分支持，见上） | 授权登录 (weixin、apple(iOS HBuilderX 5.21+支持)) |
+@@| share | Web x / 微信小程序 x / Android 5.08 / iOS 5.08 / HarmonyOS 4.61（部分支持，见上） | 分享 (weixin) |
+| success | (result: [GetProviderSuccess](#getprovidersuccess-values)) => void | 否 | Web x / 微信小程序 x / Android 4.18 / iOS 4.18（部分支持，见上） | 接口调用成功的回调 |
+| fail | (result: [GetProviderFail](#getproviderfail-values)) => void | 否 | Web x / 微信小程序 x / Android 4.18 / iOS 4.18（部分支持，见上） | 接口调用失败的回调函数 |
+| complete | (result: any) => void | 否 | Web x / 微信小程序 x / Android 4.18 / iOS 4.18（部分支持，见上） | 接口调用结束的回调函数（调用成功、失败都会执行） | 
+
+#### GetProviderSuccess 的属性值 @getprovidersuccess-values 
+
+| 名称 | 类型 | 必备 | 兼容性 | 描述 |
+| :- | :- | :- |  :-: | :- |
+| service | string | 是 | Web x / 微信小程序 x / Android 4.18 / iOS 4.18（部分支持，见上） | 服务类型：支付 (payment)<br/> |
+| 合法值 | 兼容性 | 描述 |
+| :- |  :-: | :- |
+| payment | Web x / 微信小程序 x / Android 4.11 / iOS 4.18 / HarmonyOS 4.61（部分支持，见上） | 支付 (alipay、wxpay) |
+| location | Web x / 微信小程序 x / Android 4.11 / iOS 4.18 / HarmonyOS 4.61（部分支持，见上） | 定位 (system、tencent) |
+| oauth | Web x / 微信小程序 x / Android x / iOS 5.08 / HarmonyOS 4.61（部分支持，见上） | 授权登录 |
+| share | Web x / 微信小程序 x / Android 5.08 / iOS 5.08 / HarmonyOS 4.66（部分支持，见上） | 分享 |
+| provider | Array&lt;string&gt; | 是 | Web x / 微信小程序 x / Android 4.18 / iOS 4.18（部分支持，见上） | 得到的服务供应商 |
+| providers | Array&lt;UniProvider&gt; | 是 | Web x / 微信小程序 x / Android 4.18 / iOS 4.18（部分支持，见上） | 得到的服务供应商服务对象 |
+
+#### GetProviderFail 的属性值 @getproviderfail-values 
+
+| 名称 | 类型 | 必备 | 兼容性 | 描述 |
+| :- | :- | :- |  :-: | :- |
+| errCode | number | 是 | Web x / 微信小程序 x（部分支持，见上） | 错误码：<br/>110600：服务类型参数无效。 |
+| errSubject | string | 是 | Web x / 微信小程序 x（部分支持，见上） | 统一错误主题（模块）名称 |
+| data | any | 否 | Web x / 微信小程序 x（部分支持，见上） | 错误信息中包含的数据 |
+| cause | Error | 否 |   | 源错误信息，可以包含多个错误，详见SourceError |
+| errMsg | string | 是 | Web x / 微信小程序 x（部分支持，见上） |  |
+
+::: warning uni.getProvider 返回顺序说明：
+1. 目前标准基座中注册的 provider 返回顺序如下：
+    支付： 微信支付、支付宝；
+    定位： 系统定位、腾讯定位
+    分享： 微信分享
+    登录： 微信登录、Apple登录
+
+2. 相同 service 下，其他的自注册 provider，返回顺序在官方预置的 provider 之后
+
+3. 自注册的 provider 无法保障顺序， 请不要依赖自注册 provider 的顺序
+
+4. 如果自定义的 service 与 provider 配置与内置的一样，优先采用自定义的
+
+5. 如果自定义的 service 下存在多个同名的 provider，编译器会报错
+
+### 参见
+- [相关 Bug](https://issues.dcloud.net.cn/?mid=api.base.getProviderSync)
+- [参见uni-app相关文档](https://uniapp.dcloud.net.cn/api/plugins/provider.html#getprovider)
+
+## 示例
+
+示例为[hello uni-app x alpha分支](https://gitcode.com/dcloud/hello-uni-app-x/blob/prod_alpha/pages/API/provider/provider.uvue)，与最新HBuilderX Alpha版同步。与最新正式版同步的master分支示例[另见](https://gitcode.com/dcloud/hello-uni-app-x/blob/master//pages/API/provider/provider.uvue) 
+>
+> 该 API 不支持 Web，请运行 hello uni-app x 到 App 平台体验 
+
+::: preview
+> appRedirect https://hellouniappx.dcloud.net.cn/appredirect.html?path=pages/API/provider/provider
+```uvue
+<template>
+  
+  <scroll-view class="page-scroll-view">
+  
+    <view class="page">
+      <page-head :title="data.title"></page-head>
+      <view class="service-item" v-for="(item, index) in data.serviceList" :key="index">
+        <text class="service-name">{{item.name}}:</text>
+        <view class="provider-list">
+          <text class="provider-item" v-for="(item2, index2) in item.provider" :key="index2">
+            {{item2}}
+            {{item.providerObj.length > 0 ? ':' + JSON.stringify(item.providerObj[index2]) : '' }}
+          </text>
+        </view>
+      </view>
+      <button class="btn-get-provider" type="primary" @click="getProvider">getProviderSync</button>
+    </view>
+  
+  </scroll-view>
+  
+</template>
+
+
+
+<style>
+  .page {
+    padding: 15px;
+  }
+
+  .service-item {
+    margin-top: 10px;
+  }
+
+  .service-name {
+    font-weight: bold;
+  }
+
+  .provider-list {
+    margin-left: 32px;
+  }
+
+  .provider-item {
+    line-height: 1.5;
+  }
+
+  .btn-get-provider {
+    margin-top: 30px;
+  }
+</style>
+
+```

package/data/uniappx/api/pull-down-refresh.md

@@ -0,0 +1,154 @@
+::: sourceCode
+## uni.startPullDownRefresh(options?) @startpulldownrefresh
+
+> GitCode: https://gitcode.com/dcloud/uni-api/tree/alpha/uni_modules/uni-pullDownRefresh
+
+> GitHub: https://github.com/dcloudio/uni-api/tree/alpha/uni_modules/uni-pullDownRefresh
+
+开始下拉刷新
+
+### startPullDownRefresh 兼容性  
+| Web | 微信小程序 | Android | iOS | HarmonyOS |
+| :- | :- | :- | :- | :- |
+| 4.0 | 4.41 | 3.91 | 4.11 | 4.61 |
+
+### 参数 
+
+| 名称 | 类型 | 必填 |
+| :- | :- | :- |
+| options | **StartPullDownRefreshOptions** | 否 |
+| 名称 | 类型 | 必备 | 描述 |
+| :- | :- | :- | :- |
+| success | (result: [StartPullDownRefreshSuccess](#startpulldownrefreshsuccess-values)) => void | 否 | 接口调用成功的回调函数 |
+| fail | (result: [StartPullDownRefreshFail](#startpulldownrefreshfail-values)) => void | 否 | 接口调用失败的回调函数 |
+| complete | (result: any) => void | 否 | 接口调用结束的回调函数（调用成功、失败都会执行） | 
+
+#### StartPullDownRefreshSuccess 的属性值 @startpulldownrefreshsuccess-values 
+
+| 名称 | 类型 | 必备 |
+| :- | :- | :- |
+| errMsg | string | 是 |
+
+#### StartPullDownRefreshFail 的属性值 @startpulldownrefreshfail-values 
+
+| 名称 | 类型 | 必备 | 描述 |
+| :- | :- | :- | :- |
+| errCode | number | 是 | 下拉刷新错误码<br/>- 4: 框架内部异常 |
+| errSubject | string | 是 | 统一错误主题（模块）名称 |
+| data | any | 否 | 错误信息中包含的数据 |
+| cause | Error | 否 | 源错误信息，可以包含多个错误，详见SourceError |
+| errMsg | string | 是 |  |
+
+### 返回值 
+
+| 类型 | 必备 |
+| :- | :- |
+| Promise\<**StartPullDownRefreshSuccess**> | 否 |
+| 名称 | 类型 | 必备 |
+| :- | :- | :- |
+| errMsg | string | 是 |
+
+### 参见
+- [相关 Bug](https://issues.dcloud.net.cn/?mid=api.page.pullDownRefresh.startPullDownRefresh)
+- [参见uni-app相关文档](https://uniapp.dcloud.net.cn/api/ui/pulldown.html#startpulldownrefresh)
+- [微信小程序文档](https://developers.weixin.qq.com/miniprogram/dev/api/ui/pull-down-refresh/wx.startPullDownRefresh.html)
+- [支付宝小程序文档](https://open.alipay.com/portal/zhichi/search?keyword=startPullDownRefresh&pageIndex=1&pageSize=10&source=doc_top&type=all)
+- [百度小程序文档](https://smartprogram.baidu.com/forum/search?query=startPullDownRefresh&scope=devdocs&source=docs)
+- [抖音小程序文档](https://developer.open-douyin.com/search-page?keyword=startPullDownRefresh&secondType=all&type=1)
+- [飞书小程序文档](https://open.feishu.cn/search?from=header&page=1&pageSize=10&q=startPullDownRefresh&topicFilter=)
+- [钉钉小程序文档](https://open.dingtalk.com/search?keyword=startPullDownRefresh)
+- [QQ小程序文档](https://q.qq.com/wiki/develop/miniprogram/frame/)
+- [快手小程序文档](https://developers.kuaishou.com/page?keyword=startPullDownRefresh&from=docs)
+- [京东小程序文档](https://mp-docs.jd.com/doc/dev/framework/-1)
+- [华为快应用文档](https://developer.huawei.com/consumer/cn/doc/quickApp-References/webview-frame-overview-0000001124793625)
+- [360小程序文档](https://mp.360.cn/doc/miniprogram/dev/#/b770a184ff1f06c6b3393a0fd1132380)
+
+::: sourceCode
+## uni.stopPullDownRefresh() @stoppulldownrefresh
+
+> GitCode: https://gitcode.com/dcloud/uni-api/tree/alpha/uni_modules/uni-pullDownRefresh
+
+> GitHub: https://github.com/dcloudio/uni-api/tree/alpha/uni_modules/uni-pullDownRefresh
+
+停止当前页面下拉刷新
+
+### stopPullDownRefresh 兼容性  
+| Web | 微信小程序 | Android | iOS | HarmonyOS |
+| :- | :- | :- | :- | :- |
+| 4.0 | 4.41 | 3.91 | 4.11 | 4.61 |
+
+使用：
+1. 首先pages.json里配置了页面可下拉刷新`"enablePullDownRefresh": true`
+2. 当用户下拉页面时触发页面生命周期`onPullDownRefresh`，iOS平台触发时机：当下拉到一定阀值就会触发`onPullDownRefresh`，并不是当手势拖拽结束时触发
+3. 在合适的时机（如联网刷新数据结束），调用本API`uni.stopPullDownRefresh()`，结束下拉刷新状态
+
+本API仅负责页面下拉刷新。如使用组件下拉刷新，另见scroll-view、list-view等组件的文档。
+
+### 参见
+- [相关 Bug](https://issues.dcloud.net.cn/?mid=api.page.pullDownRefresh.stopPullDownRefresh)
+- [参见uni-app相关文档](https://uniapp.dcloud.net.cn/api/ui/pulldown.html#stoppulldownrefresh)
+- [微信小程序文档](https://developers.weixin.qq.com/miniprogram/dev/api/ui/pull-down-refresh/wx.stopPullDownRefresh.html)
+- [支付宝小程序文档](https://open.alipay.com/portal/zhichi/search?keyword=stopPullDownRefresh&pageIndex=1&pageSize=10&source=doc_top&type=all)
+- [百度小程序文档](https://smartprogram.baidu.com/forum/search?query=stopPullDownRefresh&scope=devdocs&source=docs)
+- [抖音小程序文档](https://developer.open-douyin.com/search-page?keyword=stopPullDownRefresh&secondType=all&type=1)
+- [飞书小程序文档](https://open.feishu.cn/search?from=header&page=1&pageSize=10&q=stopPullDownRefresh&topicFilter=)
+- [钉钉小程序文档](https://open.dingtalk.com/search?keyword=stopPullDownRefresh)
+- [QQ小程序文档](https://q.qq.com/wiki/develop/miniprogram/frame/)
+- [快手小程序文档](https://developers.kuaishou.com/page?keyword=stopPullDownRefresh&from=docs)
+- [京东小程序文档](https://mp-docs.jd.com/doc/dev/framework/-1)
+- [华为快应用文档](https://developer.huawei.com/consumer/cn/doc/quickApp-References/webview-frame-overview-0000001124793625)
+- [360小程序文档](https://mp.360.cn/doc/miniprogram/dev/#/b770a184ff1f06c6b3393a0fd1132380)
+
+## 示例
+
+示例为[hello uni-app x alpha分支](https://gitcode.com/dcloud/hello-uni-app-x/blob/prod_alpha/pages/API/pull-down-refresh/pull-down-refresh.uvue)，与最新HBuilderX Alpha版同步。与最新正式版同步的master分支示例[另见](https://gitcode.com/dcloud/hello-uni-app-x/blob/master//pages/API/pull-down-refresh/pull-down-refresh.uvue) 
+::: preview https://hellouniappx.dcloud.net.cn/web/#/pages/API/pull-down-refresh/pull-down-refresh
+
+> appRedirect https://hellouniappx.dcloud.net.cn/appredirect.html?path=pages/API/pull-down-refresh/pull-down-refresh
+
+>示例
+```vue
+<template>
+  
+  <scroll-view class="uni-theme-root" style="flex: 1;">
+  
+    
+    <view class="refresh-page uni-padding-wrap uni-common-mt uni-theme-root">
+      <text class="text" v-for="(num,index) in listData" :key="index">list - {{num}}</text>
+      <view v-if="showLoadMore" class="load-more-text">{{loadMoreText}}</view>
+    </view>
+  
+  </scroll-view>
+  
+</template>
+
+<style>
+  .text {
+    margin: 6px 0;
+    width: 100%;
+    background-color: var(--list-background-color, #ffffff);
+    height: 52px;
+    line-height: 52px;
+    text-align: center;
+    color: var(--text-color, #555555);
+    border-radius: 4px;
+  }
+
+  .load-more-text {
+    color: var(--text-color, #333333);
+  }
+</style>
+
+```
+
+## 通用类型
+
+### GeneralCallbackResult @generalcallbackresult-values 
+
+| 名称 | 类型 | 必备 | 描述 |
+| :- | :- | :- | :- |
+| errMsg | string | 是 | 错误信息 |
+
+## Tips
+- 本API默认处理栈顶页面，而不是代码所在页面。[详见](./README.md#toppage)
+- iOS 平台蒸汽模式开启下拉刷新会触发页面 `onPageScroll` 生命周期，此时 `scrollTop` 为负值。

package/data/uniappx/api/push.md

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

package/data/uniappx/api/report.md

@@ -0,0 +1,150 @@
+::: sourceCode
+## uni.report(eventKey, param?) @report
+
+> GitCode: https://gitcode.net/dcloud/uni-api
+
+> GitHub: https://github.com/dcloudio/uni-api/tree/alpha/uni_modules/uni-stat
+
+自定义统计上报
+
+`param` 为对象时会序列化为 JSON 字符串，其他类型会转换为字符串。`eventKey` 为 `title` 时，`param` 仅支持字符串，用于设置页面标题。
+
+### 注意事项
+`uni.report` 需要依赖 [`uni统计`](https://ext.dcloud.net.cn?name=uni-stat)，集成方式请查看[文档](https://uniapp.dcloud.net.cn/uni-stat-uniappx)。
+
+### report 兼容性  
+| Web | 微信小程序 | Android(VDOM) | Android(Vapor) | iOS(VDOM) | iOS(Vapor) | HarmonyOS(VDOM) | HarmonyOS(Vapor) |
+| :- | :- | :- | :- | :- | :- | :- | :- |
+| 5.25 | 5.25 | <a style="color:unset;" href="https://vote.dcloud.net.cn/#/?name=uni-app%20x">x</a> | 5.25 | <a style="color:unset;" href="https://vote.dcloud.net.cn/#/?name=uni-app%20x">x</a> | 5.25 | <a style="color:unset;" href="https://vote.dcloud.net.cn/#/?name=uni-app%20x">x</a> | 5.25 |
+
+### 参数 
+
+| 名称 | 类型 | 必填 | 描述 |
+| :- | :- | :- | :- |
+| eventKey | string | 是 | 自定义事件名称 |
+| param | any | 否 | 自定义事件参数 |
+
+### 如何使用自定义上报@custom-report
+
+```js
+// 参数支持字符串
+uni.report({
+ name:'购买',
+ options:'购买成功'
+})
+
+// 参数支持对象
+uni.report({
+ name:'购买',
+ options:{
+  id:'1000',
+  name:'上衣',
+  price:'998',
+  msg:'购买成功'
+  // ...
+ }
+})
+```
+
+### 示例
+
+示例为[hello uni-app x alpha分支](https://gitcode.com/dcloud/hello-uni-app-x/blob/prod_alpha/pages/API/report/report.uvue)，与最新HBuilderX Alpha版同步。与最新正式版同步的master分支示例[另见](https://gitcode.com/dcloud/hello-uni-app-x/blob/master//pages/API/report/report.uvue) 
+::: preview https://hellouniappx.dcloud.net.cn/web/#/pages/API/report/report
+
+> appRedirect https://hellouniappx.dcloud.net.cn/appredirect.html?path=pages/API/report/report
+
+>示例
+```vue
+<template>
+  <scroll-view class="page uni-theme-root">
+    <page-head title="uni统计 2.0"></page-head>
+    <view class="status-panel">
+      <text class="status-title">最近操作</text>
+      <text class="status-content">{{ state.message }}</text>
+    </view>
+
+    <view class="section">
+      <text class="section-title">自定义事件</text>
+      <button class="normal-button" @click="reportObject">对象参数事件</button>
+      <button class="normal-button" @click="reportString">字符串参数事件</button>
+      <button class="normal-button" @click="reportEmpty">空参数事件</button>
+      <button class="normal-button" @click="reportPair">连续上报两个同名事件</button>
+    </view>
+
+    <view class="section">
+      <text class="section-title">上下文与参数</text>
+      <button class="normal-button" @click="reportTitle">标题上下文</button>
+      <button class="normal-button" @click="reportBaseInfo">基础信息快照</button>
+      <button class="normal-button" @click="goBack">返回上一页</button>
+    </view>
+  </scroll-view>
+</template>
+
+<style>
+  .page {
+    --report-surface-background: #ffffff;
+    --report-title-color: #202124;
+    --report-content-color: #5f6673;
+    flex: 1;
+  }
+
+  @media (prefers-color-scheme: dark) {
+    .page {
+      --report-surface-background: #2d2d2d;
+      --report-title-color: #ffffff;
+      --report-content-color: #a0a0a0;
+    }
+  }
+
+  .status-panel,
+  .section {
+    margin: 12px 16px;
+    padding: 16px;
+    background-color: var(--report-surface-background, #ffffff);
+    border-radius: 8px;
+  }
+
+  .status-title,
+  .section-title {
+    display: flex;
+    margin-bottom: 12px;
+    color: var(--report-title-color, #202124);
+    font-size: 17px;
+    font-weight: 600;
+  }
+
+  .status-content {
+    color: var(--report-content-color, #5f6673);
+    font-size: 14px;
+  }
+
+  .normal-button {
+    width: 100%;
+    margin-top: 10px;
+  }
+</style>
+
+```
+
+### 参见
+- [相关 Bug](https://issues.dcloud.net.cn/?mid=api.stat.report)
+- [参见uni-app相关文档](https://uniapp.dcloud.net.cn/api/other/report.html)
+- [微信小程序文档](https://developers.weixin.qq.com/doc/search.html?source=enter&query=report&doc_type=miniprogram)
+- [支付宝小程序文档](https://open.alipay.com/portal/zhichi/search?keyword=report&pageIndex=1&pageSize=10&source=doc_top&type=all)
+- [百度小程序文档](https://smartprogram.baidu.com/forum/search?query=report&scope=devdocs&source=docs)
+- [抖音小程序文档](https://developer.open-douyin.com/search-page?keyword=report&secondType=all&type=1)
+- [飞书小程序文档](https://open.feishu.cn/search?from=header&page=1&pageSize=10&q=report&topicFilter=)
+- [钉钉小程序文档](https://open.dingtalk.com/search?keyword=report)
+- [QQ小程序文档](https://q.qq.com/wiki/develop/miniprogram/frame/)
+- [快手小程序文档](https://developers.kuaishou.com/page?keyword=report&from=docs)
+- [京东小程序文档](https://mp-docs.jd.com/doc/dev/framework/-1)
+- [华为快应用文档](https://developer.huawei.com/consumer/cn/doc/quickApp-References/webview-frame-overview-0000001124793625)
+- [360小程序文档](https://mp.360.cn/doc/miniprogram/dev/#/b770a184ff1f06c6b3393a0fd1132380)
+
+## 通用类型
+
+### GeneralCallbackResult @generalcallbackresult-values 
+
+| 名称 | 类型 | 必备 | 描述 |
+| :- | :- | :- | :- |
+| errMsg | string | 是 | 错误信息 |