From 8ab103c1e049c2fd1cf4e501e891a3615a74ddb2 Mon Sep 17 00:00:00 2001
From: DCloud_LXH <283700113@qq.com>
Date: Fri, 8 Dec 2023 13:39:22 +0800
Subject: [PATCH] =?UTF-8?q?chore:=20=E5=90=8C=E6=AD=A5=E6=96=87=E6=A1=A3?=
=?UTF-8?q?=E6=9B=B4=E6=96=B0?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
docs/api/filemanager.md | 21 ++++++++++++++++++++
docs/api/interceptor.md | 5 +++--
docs/api/push.md | 4 ++--
docs/api/uni-verify.md | 30 +++++++++++++++++++++++++++++
docs/component/README.md | 2 --
docs/component/unsupport.md | 2 +-
docs/css/readme.md | 10 +++++-----
docs/tutorial/store.md | 38 ++++++++++++++++++++++++++++++++++++-
docs/uts/data-type.md | 13 +++++++++++++
docs/vue/README.md | 31 ++++++++++++++++--------------
10 files changed, 129 insertions(+), 27 deletions(-)
create mode 100644 docs/api/filemanager.md
create mode 100644 docs/api/uni-verify.md
diff --git a/docs/api/filemanager.md b/docs/api/filemanager.md
new file mode 100644
index 00000000..be8ba0c1
--- /dev/null
+++ b/docs/api/filemanager.md
@@ -0,0 +1,21 @@
+## uni.getFileSystemManager() @getfilesystemmanager
+
+
+
+文件管理器对象，用于操作应用可访问的本地文件空间，在app-Android上是沙盒目录。
+
+可实现目录和文件的创建、删除、改名或改路径、遍历目录、获取文件信息、读写文件。
+
+
+
+
+
+
+
+
+
+
+
+
+
+
\ No newline at end of file
diff --git a/docs/api/interceptor.md b/docs/api/interceptor.md
index 8b045aff..8157b7fa 100644
--- a/docs/api/interceptor.md
+++ b/docs/api/interceptor.md
@@ -28,6 +28,7 @@
-## Bug & Tips@tips
+## Tips@tips
-* 目前仅以下接口支持拦截器：navigateTo、redirectTo、reLaunch、switchTab、navigateBack、loadFontFace、pageScrollTo、startPullDownRefresh、setNavigationBarColor、setNavigationBarTitle、setTabBarBadge、removeTabBarBadge、setTabBarItem、setTabBarStyle、hideTabBar、showTabBar、showTabBarRedDot、hideTabBarRedDot
\ No newline at end of file
+* 目前仅以下接口支持拦截器：navigateTo、redirectTo、reLaunch、switchTab、navigateBack、loadFontFace、pageScrollTo、startPullDownRefresh、setNavigationBarColor、setNavigationBarTitle、setTabBarBadge、removeTabBarBadge、setTabBarItem、setTabBarStyle、hideTabBar、showTabBar、showTabBarRedDot、hideTabBarRedDot
+* 如需拦截request，可在插件市场搜索[拦截器插件](https://ext.dcloud.net.cn/search?q=%E6%8B%A6%E6%88%AA%E5%99%A8&uni-appx=1)
\ No newline at end of file
diff --git a/docs/api/push.md b/docs/api/push.md
index 5a78bd36..fe1e3f25 100644
--- a/docs/api/push.md
+++ b/docs/api/push.md
@@ -1,8 +1,8 @@
# uni-push
-uni-push是DCloud与合作伙伴共同推出的统一推送服务。用于从服务器端推送消息到客户端。
+uni-push是DCloud与合作伙伴个推共同推出的统一推送服务。用于从服务器端推送消息到客户端。
-它包括在线推送、离线推送，聚合了Apple、华为、小米、OPPO、VIVO、魅族、Google等多个手机厂商的推送通道。
+它包括在线推送、离线推送，聚合了Apple、华为、小米、OPPO、VIVO、魅族、荣耀(3.99+)、Google等多个手机厂商的推送通道。
若不使用服务器推送，仅想创建手机通知栏本地消息，也需要使用本模块的API。
diff --git a/docs/api/uni-verify.md b/docs/api/uni-verify.md
new file mode 100644
index 00000000..9fd005ab
--- /dev/null
+++ b/docs/api/uni-verify.md
@@ -0,0 +1,30 @@
+## uni.getUniverifyManager() @getuniverifymanager
+
+
+
+App一键登陆，封装了个推的一键登陆sdk，其内部再次封装了中国三大电信运营商提供的sdk。通过运营商提供的服务，可以在手机sim卡信号正常的情况下，通过云端接口获取到当前用户的手机号。
+
+App一键登陆是替代短信验证码登录的更优选择：对开发者而言更便宜、对用户而言体验更好。
+
+一键登陆涉及业务开通和付费，涉及客户端和服务器交互，有较多文档：
+1. 业务介绍：介绍业务流程、开通和付费。[详见](https://uniapp.dcloud.net.cn/univerify.html)
+2. 客户端API，即本文
+3. 服务器API，[详见](https://uniapp.dcloud.net.cn/uniCloud/uni-login/dev.html)
+
+
+
+
+
+
+
+
+
+
+
+## Tips
+- 运营商对一键登陆给用户呈现的ui有强制要求。（需补充细节）
+- 目前一键登陆的UI可自定义性有限。（需补充细节）
+
+
+
+
\ No newline at end of file
diff --git a/docs/component/README.md b/docs/component/README.md
index f75d02dd..17728d21 100644
--- a/docs/component/README.md
+++ b/docs/component/README.md
@@ -46,8 +46,6 @@ uni-app x支持的组件包括：
- 仅支持直接在 `export default` 内部声明，不支持其他位置定义后，在 `export default` 中引用。
- 复杂数据类型需要通过 `PropType` 标记类型，[详见](https://cn.vuejs.org/guide/typescript/options-api.html#typing-component-props)。
```ts
-import { type PropType } from 'vue'
-
type Obj = { a: number }
export default {
diff --git a/docs/component/unsupport.md b/docs/component/unsupport.md
index 66c5d029..dfb45fef 100644
--- a/docs/component/unsupport.md
+++ b/docs/component/unsupport.md
@@ -6,7 +6,7 @@ uni-app x在App端还有一批组件未与uni-app js引擎版拉齐。有的在
- movable-view：没有ui层和逻辑层的通信阻塞，开发者可自己写代码拖动view。hello uni-app x中有[示例代码](https://gitcode.net/dcloud/hello-uni-app-x/-/blob/dev/pages/component/general-event/touch-event.uvue)
- picker：可改用[picker-view](picker-view.md)
- canvas：目前没有完整的canvas组件，但
- * 每个view，都提供了[draw API](dom/drawablecontext.md)，可以高性能的画各种形状、写字。
+ * 每个view，都提供了[draw API](../dom/drawablecontext.md)，可以高性能的画各种形状、写字。
* 关于截图，无需像webview那样通过canvas中转，view直接提供截图方案，[takesnapshot](dom/element.md#takesnapshot)。
* 使用web-view中的canvas也是一种方案，uvue页面里的web-view组件可以和uvue页面里的uts代码双向通信。比如生成二维码，可以由web-view组件来渲染，复用web生态的库。
* 当然二维码在插件市场也有现成的[插件](https://ext.dcloud.net.cn/search?q=%E4%BA%8C%E7%BB%B4%E7%A0%81&uni-appx=1)
diff --git a/docs/css/readme.md b/docs/css/readme.md
index fc0e76ce..18e71ab9 100644
--- a/docs/css/readme.md
+++ b/docs/css/readme.md
@@ -199,7 +199,7 @@ uvue中文字都是要使用text组件的。
uni-app x的css的样式不继承规则，虽然与web有差异，其实只是更严谨。
-开发者遵循仅在text组件下写文字有关的样式，就可以编译到全端而保持界面正常。
+一般情况下，开发者遵循仅在text组件下写文字有关的样式，就可以编译到全端而保持界面正常。
## 层级
@@ -217,7 +217,7 @@ uni-app x的css的样式不继承规则，虽然与web有差异，其实只是
|Block 布局 |× | |
|字体 |√ |支持ttf、otf，不支持woff和woff2和可变字体 |
|Positioned 布局 |√ | |
-|CSS Animation |√ | |
+|CSS Animation |x | |
|CSS Transition |√ | |
|CSS Variable |× | |
|媒体查询 |× | |
@@ -309,7 +309,7 @@ uni-app x的css的样式不继承规则，虽然与web有差异，其实只是
## css方法
-目前仅支持url()
+目前仅支持url()、rgb()、rgba()。
暂不支持css变量val()。--status-bar-height、--window-top、--window-bottom，也暂时无法使用，有相关需求可使用[uni.getWindowInfo()](../api/getwindowinfo.md)方式获取。
@@ -442,6 +442,6 @@ Tips：
* 页面的样式作用于当前页面及其子组件。
* 组件的样式仅作用于当前组件。
-## Bug & Tips
+## Bug
-- 动态创建的根组件，`class` 样式不生效，暂时可通过外层包裹 `view` 解决。此bug已于HBuilderX 3.97+修复
+css相关bug[详见](https://issues.dcloud.net.cn/?mid=css)
diff --git a/docs/tutorial/store.md b/docs/tutorial/store.md
index de746172..c81800f6 100644
--- a/docs/tutorial/store.md
+++ b/docs/tutorial/store.md
@@ -1,7 +1,43 @@
# 全局变量与状态管理
-`uni-app x` 不支持globaldata，目前也不支持pinia和vuex。但可通过一个专用模块组织和管理全局变量与状态。
+`uni-app x` 目前不支持 `pinia` 和 `vuex`。可通过 `globalData(3.99+)` 或一个专用模块组织和管理全局变量与状态。
+## globalData
+
+`App.uvue` 中定义 `globalData`。
+
+```ts
+
+```
+
+页面或组件中通过 `getApp().globalData` 访问。
+
+```ts
+
+```
+
+**注意：** `uni-app x` 中 `globalData` 的数据结构与类型通过 `App.uvue` 中的 `globalData` 初始值定义，后续只能读取或修改，不能新增或删除。
+
+## 专用模块
定义一个模块，编写一个单独的uts文件，比如 /store/index.uts，在里面设一个全局变量，比如globalNum。
```ts
diff --git a/docs/uts/data-type.md b/docs/uts/data-type.md
index b05d8a4f..63024e98 100644
--- a/docs/uts/data-type.md
+++ b/docs/uts/data-type.md
@@ -677,6 +677,7 @@ array1.forEach((element:string, index:number) => {
* kotlin.collections.List
* kotlin.Array
* kotlin.IntArray
+ * kotlin.FloatArray
* kotlin.ByteArray
* kotlin.LongArray
* ...
@@ -763,6 +764,18 @@ console.log("b",b[2])
let a = [[2].toKotlinList().toIntArray(),[23].toKotlinList().toIntArray(),[22].toKotlinList().toIntArray()]
let b = a.toKotlinList().toTypedArray()
+// Array 转 java float[]的示例
+let a = new Array(10)
+// b是 List
+let b = a.toKotlinList().map(function(it):Float{
+ return it.toFloat()
+})
+// c是 float[]
+let c = b.toTypedArray()
+// d 是 FloatArray
+let d = b.toFloatArray()
+
+
```
#### iOS 平台专有数组类型
diff --git a/docs/vue/README.md b/docs/vue/README.md
index 28bda415..93b55249 100644
--- a/docs/vue/README.md
+++ b/docs/vue/README.md
@@ -1,8 +1,11 @@
# vue
-uni-app x的vue规范，按照vue3规范实现，但目前不支持setup组合式写法，仅支持option选项式写法。\
+uni-app x的vue规范，按照vue3规范实现，但目前不支持setup组合式写法，仅支持option选项式写法。
+
本文暂时只包括兼容性表格，vue功能详情另见 [vue3概述](https://uniapp.dcloud.net.cn/tutorial/vue3-basics.html#)、[Vue3 API](https://uniapp.dcloud.net.cn/tutorial/vue3-api.html)。
+uni-app x中vue的用法，有单独的示例应用：[hello uvue](https://gitcode.net/dcloud/hello-uvue)。这里都是可以跑通的使用样例代码。
+
## 全局 API兼容性
### 应用实例 @app-instance
@@ -25,7 +28,7 @@ uni-app x的vue规范，按照vue3规范实现，但目前不支持setup组合
### [函数 event 参数的类型](uni-app-x/tutorial/codegap.md#function-event-argument-type)
-### 指令
+### 指令 @directives
@@ -54,31 +57,31 @@ uni-app x 新增了 [onLastPageBackPress](collocation/App.md#applifecycle) 和 [
## 组件
-- [props](uni-app-x/component/README.md#props)
-- [自定义事件](uni-app-x/component/README.md#自定义事件)
-- [计算属性和侦听器](uni-app-x/component/README.md#计算属性和侦听器)
-- [作用域插槽的类型](uni-app-x/component/README.md#作用域插槽的类型)
-- [监听页面生命周期](uni-app-x/component/README.md#监听页面生命周期)
-- [vue 与 uvue 不同文件后缀的优先级](uni-app-x/component/README.md#priority)
+- [props](../component/README.md#props)
+- [自定义事件](../component/README.md#自定义事件)
+- [计算属性和侦听器](../component/README.md#计算属性和侦听器)
+- [作用域插槽的类型](../component/README.md#作用域插槽的类型)
+- [监听页面生命周期](../component/README.md#监听页面生命周期)
+- [vue 与 uvue 不同文件后缀的优先级](../component/README.md#priority)
-### 特殊元素
+### 特殊元素 @special-elements
- App 端，如需页面级滚动，根节点必须是 `scroll-view` 标签。
-### 特殊 Attributes
+### 特殊 Attributes @special-attributes
-### 生命周期选项
+### 生命周期选项 @lifecycle-options
## 插件
-暂不支持vue插件，比如pinia、vuex、i18n、router。简单的状态管理可以参考文档[全局变量和状态管理](uni-app-x/tutorial/store.md)。
+暂不支持vue插件，比如pinia、vuex、i18n、router。简单的状态管理可以参考文档[全局变量和状态管理](../tutorial/store.md)。
## 选项式 API兼容性
@@ -86,7 +89,7 @@ uni-app x 新增了 [onLastPageBackPress](collocation/App.md#applifecycle) 和 [
-### 渲染选项
+### 渲染选项 @rendering-options
@@ -99,7 +102,7 @@ uni-app x 新增了 [onLastPageBackPress](collocation/App.md#applifecycle) 和 [
-### 组件实例
+### 组件实例 @component-instance
--
GitLab