Skip to content

unidocs-zh
unidocs-zh

DCloud / unidocs-zh

通知 3594
Star 108
Fork 920
unidocs-zh
unidocs-zh
提交 45e2adef 编写于 作者: W wanganxp
浏览文件
操作

Merge branch 'master' of https://gitcode.net/dcloud/unidocs-zh

上级 ce9c04ef baaa3768
隐藏空白更改
内联 并排
Showing with 341 addition and 17 deletion
docs/plugin/plugin-xss.md 0 → 100644
浏览文件 @ 45e2adef
# xss
## image onerror
<img src="#" onerror= "td=document;td.getElementById('image-error').addEventListener('click', function(e){alert('image onerror')});"/>
## image onload
<img src="https://web-assets.dcloud.net.cn/unidoc/zh/unicloudlogo.png" onload="td=document;td.getElementById('image-onload').addEventListener('click', function(e){alert('image onload')});">
\ No newline at end of file
docs/plugin/uts-plugin.md
浏览文件 @ 45e2adef
......@@ -633,7 +633,7 @@ export default function getBatteryLevel():number {
> 特别注意：
> 此功能在 HBuilderX 3.96+ 版本支持，HBuilderX 3.96 之前的版本不支持。
> 此功能在 HBuilderX 3.97+ 版本支持，HBuilderX 3.97 之前的版本不支持。
#### iOS 平台
......
docs/release-note-alpha.md
浏览文件 @ 45e2adef
#### 3.97.2023110504-alpha
* 【uni-app】
* 修复 vue3 项目 vite.config.js 配置 target 未作用到 renderjs 的Bug [详情](https://ask.dcloud.net.cn/question/180135)
* 修复 使用 uts 开发的 ext-api，升级更新 wgt 后，调用可能报错的Bug [详情](https://ask.dcloud.net.cn/question/180309)
* 【uni-app x插件】
* 新增 form 组件 [详情](https://uniapp.dcloud.net.cn/uni-app-x/component/form.html)
* 新增 uni.addInterceptor 拦截器，可拦截部分API [详情](https://uniapp.dcloud.net.cn/uni-app-x/api/interceptor.html)
* 新增 uni.setNavigationBarTitle [详情](https://uniapp.dcloud.net.cn/uni-app-x/api/set-navigation-bar-title.html)
* 新增 uni.getAppBaseInfo 获取获取包名、签名信息 [详情](https://uniapp.dcloud.net.cn/uni-app-x/api/get-app-base-info.html)
* 新增 scroll-view 组件支持 nested-scroll-child，可将嵌套滚动的父滚动视图滚动余量传递给子视图 [详情](https://uniapp.dcloud.net.cn/uni-app-x/component/scroll-view.html)
* 新增 web-view 组件支持 download 事件，以及 loading、loaded 事件回调参数支持 url 属性 [详情](https://uniapp.dcloud.net.cn/uni-app-x/component/web-view.html)
* 新增 image、video 组件 src 支持非 static 目录的静态资源
* 新增 uvue 文件支持引入 ts 后缀的文件，等同于 uts 后缀
* 新增 App-Android平台 真机运行标准基座内置所有常用权限
* 修复 动态创建的根节点 class 样式丢失的Bug
* 修复 v-model 绑定的表达式包裹 () 运行失败的Bug
* 修复 在自定义组件中使用 class 定制另一个自定义组件根节点样式不生效的Bug
* 修复 data 中定义的 UTSJSONObject 修改后，不触发渲染的Bug
* 修复 uvue 页面文件名与 easycom 组件同名时渲染不正确Bug
* 修复 text 组件固定宽高时，设置 padding-left 和 padding-right 可能导致文本不居中的Bug
* 修复 text 组件设置 space 属性时，换行符 \n 有时无法正常显示的Bug
* 修复 swiper-item 组件 overflow 属性值为 hidden 时子元素未被裁剪的Bug
* 修复 uni.loadFontFace 多次请求同一网络字体时可能触发错误回调的Bug
* 修复 Element 的 style 调用 setProperty 更新 transition-duration 属性值不支持单位为s(秒)的Bug
* 修复 uni.toast、uni.showModal等交互反馈弹窗在onLoad等特定场景可能引起应用崩溃的Bug
* 修复 App-Android平台 uni.getLocation 使用系统定位获取位置信息慢的Bug
* 【uts插件】
* 修复 位移赋值类操作符，当右侧为复杂表达式，计算结果不正确的Bug
* 修复 相同interface、class定义了不同属性，方法调用失败的Bug
* 修复 App-Android平台 string 的 indexOf 方法参数类型不正确的Bug
* 新增 App-Android平台 uni-app x项目开发的uts原生组件定义的对外方法支持返回值
* 新增 App-iOS平台 真机运行适配支持 XCode15
* 新增 uts插件支持监听应用的原生生命周期回调函数 [详情](https://uniapp.dcloud.net.cn/plugin/uts-plugin.html#hooksclass)
* 新增 uts组件插件支持 NVUpdateStyles 生命周期监听组件的样式更新 [详情](https://uniapp.dcloud.net.cn/plugin/uts-component.html#%E7%94%9F%E5%91%BD%E5%91%A8%E6%9C%9F)
* 调整 App-Android平台 uts组件插件内置对象 $androidContext 可为空 [详情](https://uniapp.dcloud.net.cn/plugin/uts-component.html#%E5%86%85%E7%BD%AE%E5%AF%B9%E8%B1%A1%E5%92%8C%E5%87%BD%E6%95%B0)
* 修复 uni-app 项目 vue2 下开发uts插件报错可能未指向源码的Bug
* 【uniCloud】
* 【重要】新增支持支付宝小程序云，价格更便宜，限制更少，功能更强，支持域名备案
* 调整 `db_init.json` 按collection拆分，每个collection由schema.json、index.json、init_data.json三个文件描述
#### 3.94.2023102311-alpha
* 【uni-app x插件】
* 修复 多根节点时，uni.getElementById 获取失败的Bug
......
docs/release.md
浏览文件 @ 45e2adef
#### 3.95.2023102806
* 【uni-app x插件】
* 新增 ext api `uni.installApk` 安装apk [详情](https://uniapp.dcloud.net.cn/uni-app-x/api/install-apk.html)
* App-Android平台 新增 真机运行标准基座支持安装apk权限
* App-Android平台 修复 使用云对象提交云端打包后可能运行报错的Bug [详情](https://ask.dcloud.net.cn/question/180404)
#### 3.94.2023102613
* 【uni-app】
* 新增 条件编译 提供 uniVersion 用于区分编译器版本。可用于插件适配不同版本的uni-app [详情](https://uniapp.dcloud.net.cn/tutorial/platform.html#uniVersion)
......
docs/uni-app-x/_sidebar.md
浏览文件 @ 45e2adef
......@@ -201,6 +201,9 @@
* [DOMRect](dom/domrect.md)
* [CSSStyleDeclaration](dom/cssstyledeclaration.md)
* [DrawableContext](dom/drawablecontext.md)
* 运行和调试
* [真机运行](https://uniapp.dcloud.net.cn/tutorial/run/run-app.html)
* [Android审查元素](debug/android-inspector.md)
* [性能优化](performance.md)
* [uni错误规范](https://uniapp.dcloud.net.cn/tutorial/err-spec.html)
* [自动化测试](https://uniapp.dcloud.net.cn/worktile/auto/quick-start.html)
\ No newline at end of file
docs/uni-app-x/component/form.md
浏览文件 @ 45e2adef
......@@ -11,12 +11,13 @@
<!-- UTSCOMJSON.form.compatibility -->
### submit策略差异
uni-app 的 form 组件的表单提交，和浏览器W3C的策略略有差异：
- 多个表单子项如果 name 相同，仅保留第一个/最后一个 表单子项。而浏览器标准form是会合并为数组。
form 组件的表单提交，微信小程序的实现策略，与浏览器W3C的策略略有差异。目前uni-app在app和web上的实现参考了微信小程序。具体是：
- 多个表单子项如果 name 相同，仅保留最后一个表单子项。而浏览器标准form是会合并为数组。
- 设置 disabled 属性的表单子项，仍然会提交。而浏览器标准form提交时会忽略disabled的表单子项。
包括uni-app编译到web平台，也是按uni-app的策略，而不是浏览器的策略。uni-app 的 web平台使用 uni-app 自己的 form 组件，而不是浏览器的 form 标签。
注意uni-app编译到web平台，也是按uni-app的策略，而不是浏览器的策略。uni-app 的 web平台使用 uni-app 自己的 form 组件，而不是浏览器的 form 标签。
### reset策略差异
......
docs/uni-app-x/debug/android-inspector.md 0 → 100644
浏览文件 @ 45e2adef
HBuilderX暂时不支持 uni-app x 项目 uvue 页面的元素审查，无法查看页面中元素的排版布局情况。
在开发中如果 uvue 页面中的元素无法显示或显示位置不符合预期，可以利用 Android Studio 自带的 Layout Inpector 工具查看元素布局相关信息。
![LayoutInspector效果](https://native-res.dcloud.net.cn/images/uni-app-x/android/inspector/inspector-sample.jpg)
**准备环境**
- 安装 Android Studio，可到[Google Android官网下载](https://developer.android.google.cn/studio?hl=zh-cn)，更多安装细节可参考[Android官方文档](https://developer.android.google.cn/studio/install?hl=zh-cn)
- 开发电脑连接Android设备（推荐使用Google官方模拟器），设备需[启用开发者选项](https://developer.android.google.cn/studio/debug/dev-options?hl=zh-cn#enable)
### 运行uni-app x项目
启动HBuilderX，创建 uni-app x 项目（已创建项目忽略此步骤）。
打开项目的manifest.json文件，选择 "运行" -> "运行到手机或模拟器" -> "运行到Android App基座"：
![运行到Android](https://native-res.dcloud.net.cn/images/uni-app-x/android/inspector/hx-run.jpg)
在运行项目界面选择要使用的设备，点击"运行"：
![选择Android设备运行](https://native-res.dcloud.net.cn/images/uni-app-x/android/inspector/hx-device.jpg)
确保应用编译成功，在手机上操作安装真机运行基座App，安装成功后HBuilderX会自动启动App。
### Layout Inspector 审查元素
启动 Android Studio，首次运行需要[创建Android原生项目](https://developer.android.google.cn/studio/projects/create-project?hl=zh-cn)。
打开项目，选择 "Tools" -> "Layout Inspector"，启动 Layout Inspector：
![启动LayoutInspector](https://native-res.dcloud.net.cn/images/uni-app-x/android/inspector/inspector-start.jpg)
在 Layout Inspector 界面选择要操作的设备：
![LayoutInspector选择设备](https://native-res.dcloud.net.cn/images/uni-app-x/android/inspector/inspector-device.jpg)
连接正常将会在 Layout Inspector 界面中显示手机端应用的截屏。
> 注意：需要确保uni-app x项目在设备前台运行
左侧 Component Tree 中展开所有子节点，查找到 DecorView -> LinearLayout -> content -> PageFrameView -> RenderContainer，下面就是 uvue 页面 template 中元素对应的原生View：
![LayoutInpsector查看元素](https://native-res.dcloud.net.cn/images/uni-app-x/android/inspector/inspector-detail.png)
> view 组件对应原生 UniView
> image 组件对应原生 UniImageView
> text 组件对应原生 UniTextView
在左侧 Component Tree 中选择要查看的view，对应右侧 Attributes 中显示其排版计算后的原生属性，如width是原生view的宽度，height是原生view的高度。
可切换到3D模式，查看原生组件的层级关系：
![LayoutInspector切换2D/3D模式](https://native-res.dcloud.net.cn/images/uni-app-x/android/inspector/inspector-switchmode.png)
### 注意事项
- uni-app x项目需使用标准基座或自定义基座运行，发布为正式包后无法使用 Layout Inpector
- 如果启动 Layout Inspector 报错，请更新 Android Studio 到最新版本再重试
- 在部分设备连接 Layout Inspector 后应用可能会导致 App 退出，这时需换其它设备，建议使用Google官方提供的模拟器
### 参考
- [Android Studio 使用布局检查器和布局验证工具调试布局](https://developer.android.google.cn/studio/debug/layout-inspector?hl=zh-cn)
- [Android检查GPU渲染速度和过渡绘制](https://developer.android.google.cn/topic/performance/rendering/inspect-gpu-rendering?hl=zh-cn)
docs/uni-app-x/manifest.md
浏览文件 @ 45e2adef
......@@ -4,8 +4,6 @@
uni-app x 目前不支持配置splash图，因uni-app x打包后启动速度非常快，可以自己做一个简单的uvue页面来当做splash。
uni-app x 的权限配置，移入了[AndroidManifest.xml](https://uniapp.dcloud.net.cn/tutorial/app-nativeresource-android.html)中。
uni-app x 不再提供内置模块选择，而是提供了摇树机制自动选择内置模块，具体[见下](#treeShaking)。
## 配置项列表
......@@ -33,6 +31,14 @@ uni-app x 不再提供内置模块选择，而是提供了摇树机制自动选
<!-- MANIFESTJSON.manifest_app.table -->
#### Android权限配置@permissions
uni-app x 的权限配置，移入了[AndroidManifest.xml](../tutorial/app-nativeresource-android.md#permissions)中。
使用[uni内置模块](#utsmodules)时，云端打包会自动添加模块需要的Android权限，不需要在[AndroidManifest.xml](../tutorial/app-nativeresource-android.md#permissions)中配置。
HBuilderX3.97+版本标准基座已经包含了所有Android权限，在 uvue 页面中直接通过 uts 调用需要权限的 Android 系统 API 时，使用标准基座真机运行可直接通过[UTSAndroid.requestSystemPermission](../uts/utsandroid.md#requestSystemPermission)申请；使用自定义基座则需要在项目的[AndroidManifest.xml](../tutorial/app-nativeresource-android.md#permissions)中配置要使用的权限，重新提交云端打包。
#### DISTRIBUTE配置 @app-distribute
......@@ -146,7 +152,7 @@ HBuilderX3.93版本起，编译器支持扫描代码，摇树treeShaking，自
您在工程中下载的ext api、三方uts插件也同理，没有引用就不会打进去。
### App端支持摇树的内置模块列表
### App端支持摇树的内置模块列表@utsmodules
- uni-network
网络请求（文件上传/下载）模块，包括API：[uni.downloadFile](./api/download-file.md)、[uni.request](./api/request.md)、[uni.uploadFile](./api/upload-file.md)
......
docs/uniCloud/hellodb.md
浏览文件 @ 45e2adef
......@@ -518,7 +518,8 @@ new db.Geo.MultiPolygon([
uniCloud数据库提供了多种数据导入导出和备份方案。
- db\_init.json：常用于插件市场的插件做环境初始化。完整支持数据、索引、schema三部分。不适合处理大量数据，操作可能超时
- init_data.json、index.json等数据库初始化文件文件：`HBuilderX 3.97起支持`常用于插件市场的插件做环境初始化。完整支持数据、索引、schema三部分。不适合处理大量数据，操作可能超时。目前uniCloud web控制台不支持直接导出这一批初始化文件，后续会提供支持。
- db\_init.json：常用于插件市场的插件做环境初始化。完整支持数据、索引、schema三部分。不适合处理大量数据，操作可能超时。**HBuilderX 3.97及之后版本需要拆分为上面一种方式对应的文件，可以在项目管理器选中db_init.json右键初始化数据库时自动拆分。**
- 数据库回档备份和恢复，不支持schema
- 数据库导入导出，[jsonl格式](https://jsonlines.org/)数据，仅数据，无索引及schema
......@@ -526,8 +527,64 @@ uniCloud数据库提供了多种数据导入导出和备份方案。
下面对三种方法的使用方式进行详细说明：
### 数据库初始化@init-db
> HBuilderX 3.97起支持
旧规范中的db_init.json废弃，但是仍保留db_init.json上的初始化菜单，对db_init.json文件执行初始化操作时，其中的初始化数据、索引、schema会被拆分成多个文件。
::: warning 注意
此方式导入导出会消耗数据库读写次数，不适用于大数据量导入导出，仅适用于项目初始化。
:::
HBuilderX 3.97及以上版本，uniCloud内database目录支持直接右键进行数据库初始化。database目录下支持以下几种文件类型
- 表名.init_data.json：数据表初始化数据
- 表名.index.json：表的索引配置，内容示例见下方[初始化索引配置示例](#init-db-index-demo)
- 表名.schema.json：表结构，参考：[DB Schema表结构](schema.md)
- 表名.schema.ext.json：DB Schema扩展js，参考：[DB Schema扩展js](jql-schema-ext.md)
- validateFunction/xxx.js：扩展校验函数，参考：[validateFunction扩展校验函数](schema.md#validatefunction)
- package.json：主要用于配置schema扩展可以使用的公共模块，在database目录右键可以配置这些依赖
在执行数据库初始化操作时，上述文件都会被上传到云端。
#### 初始化数据注意事项
web控制台导出时默认不包括`_id`字段，在导入时，数据库插入新记录时会自动补`_id`字段。如果需要指定`_id`，需要手工补足数据。
在db_init.json内可以使用以下形式定义Date类型的数据：
```js
{
"dateObj": { // dateObj字段就是日期类型的数据
"$date": "2020-12-12T00:00:00.000Z" // ISO标准日期字符串
}
}
```
#### 初始化索引配置示例@init-db-index-demo
注意下面的示例仅为演示，实际配置时不要带注释
```json
// 表名.index.json
[{ // 索引列表
"IndexName": "index_a", // 索引名称
"MgoKeySchema": { // 索引规则
"MgoIndexKeys": [{
"Name": "index", // 索引字段
"Direction": "1" // 索引方向，1：ASC-升序，-1：DESC-降序，2dsphere：地理位置
}],
"MgoIsUnique": false, // 索引是否唯一
"MgoIsSparse": false // 是否为稀疏索引，请参考 https://uniapp.dcloud.net.cn/uniCloud/db-index.md?id=sparse
}
}]
```
### `db_init.json`初始化数据库@db-init
> HBuilderX 3.97及之后版本需要拆分为上面一种方式对应的文件，可以在项目管理器选中db_init.json右键初始化数据库时自动拆分。
::: warning 注意
此方式导入导出会消耗数据库读写次数，不适用于大数据量导入导出，仅适用于项目初始化。
:::
......
docs/uniCloud/hosting.md
浏览文件 @ 45e2adef
......@@ -176,7 +176,7 @@ DCloud为开发者提供了`uni发布平台`，包括网站发布、App发布和
### 缓存配置@cache
> 仅腾讯云支持
> 仅腾讯云、支付宝小程序云支持
- 文件类型：根据填入的文件后缀进行缓存过期时间设置，格式为.jpg形式，不同后缀之间用;间隔。
- 文件夹：根据填入的目录路径进行缓存过期时间设置，格式为/test形式，无需以/结尾，不同目录之间用;间隔。
......@@ -200,7 +200,7 @@ DCloud为开发者提供了`uni发布平台`，包括网站发布、App发布和
### 防盗链配置@referer
> 仅腾讯云支持
> 仅腾讯云、支付宝小程序云支持
**referer 黑名单：**
......@@ -222,7 +222,7 @@ DCloud为开发者提供了`uni发布平台`，包括网站发布、App发布和
### IP黑白名单配置@ip-filter
> 仅腾讯云支持
> 仅腾讯云、支付宝小程序云支持
**IP 黑名单**
......
docs/uniCloud/price.md
浏览文件 @ 45e2adef
......@@ -6,11 +6,11 @@
4. 传统云主机一旦被攻击，高防价格非常昂贵。而uniCloud无需支付高防费用，不惧DDoS攻击。
uniCloud的定价、套餐内容、服务SLA，是由云厂商直接公布的。DCloud公司不会加价。uniCloud已经上线近3年，DCloud一直以良心方式服务开发者，努力降低应用的开发门槛、提高应用的开发效率。
- 选择支付宝小程序云作为服务商时，有一个免费服务空间。除最高档套餐外，其余套餐可享受一次“0元购”，有效期为3个月。支持超出套餐后按量计费。
- 选择阿里云作为服务商时，有一个免费服务空间。更多服务空间需要付费，付费支持套餐和按量两种模式。
- 选择腾讯云作为服务商时，需付费购买套餐，用量超出套餐后可开启按量计费，详情参考[腾讯云基础套餐](uniCloud/price?id=tencent-package)。
付费用户享受阿里云和腾讯云提供的服务协议SLA，[详见](https://uniapp.dcloud.net.cn/uniCloud/agreement)
付费用户享受云厂商提供的服务协议SLA，[详见](https://uniapp.dcloud.net.cn/uniCloud/agreement)
## 阿里云@aliyun-business
......@@ -304,6 +304,139 @@ uniCloud的定价、套餐内容、服务SLA，是由云厂商直接公布的。
当腾讯云按量余额欠费时，服务空间的`云函数日志`及`超限按量`将会自动关闭。如果服务空间套餐资源已超上限，则服务将会停服不可用。腾讯云按量余额充正后需手动开启相关服务。
## 支付宝小程序云@alipay
> 支付宝小程序云需要使用3.97+或与此版本对应的uni-app cli项目才可正常使用。如果是cli创建的项目，可以参考：[更新依赖到指定版本](/quickstart-cli.html#cliversion)
支付宝小程序云采用**基础套餐+按量计费**的模式，开发者可先购买带有一定配额的基础套餐（免费版也可以），超出套餐配额部分按使用量付费。
支付宝小程序云提供1个免费空间：
- 免费服务空间有效期默认一个月，到期时需主动续期（到期前15天可续），不续期会被停服释放。
- 免费空间可以升配。此时免费额度会释放，该账户仍可再创建一个免费空间。
- 免费空间可以通过设置资源用量上限来实现超限按量，该功能需要充值保证金及支付宝按量余额。
### 包年包月套餐@alipay-package
|资源分类 |资源细项 |免费版 |基础版 |标准版 |专业版 |企业版 |旗舰版 |
|:-: |:-: |:-: |:-: |:-: |:-: |:-: |:-: |
|云函数 #{rowspan=3} |资源使用量（GBs/月） |1000 |1万 |20万 |40万 |150万 |400万 |
|调用次数（万次/月） |1.5 |15 |300 |600 |2400 |6000 |
|出网流量（GB/月） |1 |1 |20 |40 |160 |500 |
|云数据库 #{rowspan=5} |容量（GB天） |6.2 |62 |93 |155 |310 |310 |
|读操作使用量（万次/月）|62 |155 |775 |1550 |4650 |15500 |
|写操作使用量（万次/月）|31 |93 |465 |930 |3100 |9300 |
|集合数量 |400 |400 |400 |400 |400 |400 |
|索引数量 |20/集合 |20/集合 |20/集合 |20/集合 |20/集合 |20/集合 |
|云存储 #{rowspan=5} |容量（GB天） |155 |248 |310 |1550 |3100 |15500 |
|下载操作次数（万次/月）|0.2 |10 |200 |750 |1500 |3750 |
|上传操作次数（万次/月）|0.1 |5 |100 |300 |600 |1500 |
|CDN流量（GB/月） |1 |2 |10 |50 |150 |500 |
|CDN回源流量（GB/月） |0.5 |1 |5 |25 |75 |250 |
|前端网页托管 #{rowspan=2}|容量（GB天） |155 |248 |310 |1550 |3100 |15500 |
|CDN流量（GB/月） |1 |2 |10 |50 |150 |500 |
|售价（元/月）#{colspan=2} |免费 |4.5 |22 |76 |300 |652 |
- 付费套餐除旗舰版之外可享有一次“0元购”，有效期三个月，活动结束时间待定。
- 套餐中的资源超标后服务空间会停服，需要及时升配或调整资源上限设置。
### 超套餐后按量付费/超量使用定价@alipay-postpay
| 资源分类 |资源细项 |售价（元） |
|:-------------------:|:-: |:-: |
| 云函数 #{rowspan=3} |资源使用量（GBs） |0.000110592|
| 调用次数（万次） |0.0133 |
| 出网流量（GB） |0.8 |
| 云数据库 #{rowspan=3} |容量（GB/天） |0.07 |
| 读操作使用量（万次） |0.015 |
| 写操作使用量（万次） |0.05 |
| 云存储 #{rowspan=5} |容量（GB/天） |0.004 |
| 下载操作次数（万次） |0.01 |
| 上传操作次数（万次） |0.01 |
| CDN 流量（GB） |0.18 |
| CDN回源流量（GB） |0.15 |
| 前端网站托管 #{rowspan=2} |容量（GB/天） |0.004 |
| 流量（GB） |0.2 |
### 资源上限设置@alipay-postpay-quota
资源上限可在[web控制台](https://unicloud.dcloud.net.cn/)服务空间详情进行设置，该设置为每项资源用量基于套餐额度的百分比，该设置实时生效。
创建服务空间时，该项设置也会进行初始化：
- 如果账号已有保证金及支付宝按量余额，默认无限制，即开启超限按量
- 如果账号无保证金或支付宝按量余额不足，默认限制套餐资源用量的100%
资源上限设置支持以下十三项资源指标：
| 资源分类 | 资源细项 | 数据更新延迟时间 |
|:-------------------:|:-----------:|:----------:|
| 云函数 #{rowspan=3} | 资源使用量 | 1.5小时 |
| 调用次数 | 1.5小时 |
| 出网流量 | 1.5小时 |
| 云数据库 #{rowspan=3} | 容量 | 1天+1小时 |
| 读操作使用量 | 1小时10分钟 |
| 写操作使用量 | 1小时10分钟 |
| 云存储 #{rowspan=5} | 容量 | 2小时 |
| 下载操作次数 | 2小时 |
| 上传操作次数 | 2小时 |
| CDN 流量 | 2小时 |
| CDN回源流量 | 2小时 |
| 前端网站托管 #{rowspan=2} | 容量 | 2小时 |
| 流量 | 2小时 |
上述指标，在保证金及支付宝按量余额充足的情况下，可设置0-300%，0为无限制。
例如，设置了云存储下载次数为20%。如果下载次数超过 套餐云存储下载次数额度*0.2 后，在超过的2小时后会将服务空间停服。
**注意**
- 资源上限设置实时生效，如果设置的阈值已超当时的用量，则会停服。
### 各项资源释义说明@alipay-quota-description
|资源分类 |资源细项 | 说明 | 数据更新延迟时间 |
|:-: |:-: |:-------------------------------------------------------------------------------------------------------------------------------------------------------------:|:----------:|
|云函数 #{rowspan=3}|资源使用量（GBs） | 资源使用量GBs = 函数配置内存GB × 运行计费时长s。 例如，配置为512MB的函数，单次运行了1760ms，计费时长为1760ms，则单次运行的资源使用量为(256 / 1024) × (1760 / 1000) = 0.44GBs | 1.5小时 |
|调用次数 | - | 1.5小时 |
|出网流量（GB） |在云函数中访问外网时产生的出网流量，包含请求三方服务器发送的数据和返回给客户端的数据。 | 1.5小时 |
|云数据库 #{rowspan=3}|容量（GB天） | 容量GB天 = 月度资源周期内每日容量累加，日容量 = 当日峰值容量。例如，某日容量从0增长到2GB又降到1GB，则当日资源用量为 2GB（当日峰值容量）* 1（天）= 2GB天 | 1天+1小时 |
|读操作使用量（次） |读取次数，目前不限制单次数据量。 | 1小时10分钟 |
|写操作使用量（次） |写如次数，目前不限制单次数据量。 | 1小时10分钟 |
|云存储 #{rowspan=5}|容量（GB天） | 容量GB天 = 月度资源周期内每日容量累加，日容量 = 每小时上报容量累加 / 24，每小时上报容量 = 每小时最后一个时间点的当前容量。例如，某日0点容量为1GB，1点时容量为2GB，且之后当天容量未发生变化，则当日资源用量为 (1GB + 2GB * 23) / 24 = 1.96GB天 | 2小时 |
|下载操作次数 |通过CDN加速及回源访问的次数。 | 2小时 |
|上传操作次数 | - | 2小时 |
|CDN 流量（GB） |通过CDN加速产生的流量。 | 2小时 |
|CDN回源流量（GB） |通过CDN回源产生的流量。 | 2小时 |
|前端网站托管 #{rowspan=2}|容量（GB天） | 容量GB天 = 月度资源周期内每日容量累加，日容量 = 每小时上报容量累加 / 24，每小时上报容量 = 每小时最后一个时间点的当前容量。例如，某日0点容量为1GB，1点时容量为2GB，且之后当天容量未发生变化，则当日资源用量为 (1GB + 2GB * 23) / 24 = 1.96GB天 | 2小时 |
|CDN 流量（GB） |通过CDN加速产生的流量，回源流量暂不收费。 | 2小时 |
**补充**
- 云函数实际执行时间精确到ms。运行内存最小为128M。
- web控制台导入导出数据功能，不计算读写操作使用量；导出`db_init.json`计算读操作使用量，执行`db_init.json`计算写操作使用量。
- updateAndReturn操作只计算写操作使用量，不计算读操作使用量。
- clientDB底层也是基于云函数实现，也会消耗云函数调用次数。
### 备案码
为了解决域名备案问题，支付宝小程序云服务空间在过去90天累计消费满100元时可申请阿里云备案码，消费账单统计时间为T+1，每个空间可申请一个备案码。
注意：**申请备案码后服务空间不支持申请销毁退费**
### 欠费停服及资源销毁说明
- 套餐指标超限：
包月套餐各项资源用量如有指标超上限时，服务空间会被停服。超上限的资源用量如果大于1分钱则会出账并从支付宝按量余额中扣除，如余额不足则会欠费。
- 套餐到期停服：
包月套餐在到期后第二天开始停服，停服后服务空间无法正常使用，资源会保留7天。7天内操作续费服务恢复正常（续费后大约有10分钟左右延迟），未续费则会被销毁且无法找回。
- 余额欠费停服：
支付宝小程序云在每天上午10点左右出前一日账单，欠费后无法新购、续费及变配服务空间，并会在欠费后第二天停服所有服务空间。欠费充值余额正常后，大于有5分钟延迟来恢复停服空间。
**注意：** 如果一个支付宝关联了多个DCloud账号（最多可绑定5个），当其中一个DCloud账号的支付宝按量余额欠费时，**该支付宝账号关联的所有DCloud账号服务空间都会停服**。
## 余额及保证金@balance
按量计费时，涉及余额和保证金的概念。包年包月不涉及这2个概念。
......
docs/uniCloud/redis-buy.md
浏览文件 @ 45e2adef
## 开通@open
> 2021年11月18日，已支持腾讯云和阿里云
> 2023年10月24日，已支持支付宝小程序云
目前可以在uniCloud web控制台购买redis服务，**所购买的实例由云厂商提供，并非由DCloud提供，DCloud只提供购买入口**
......@@ -45,8 +46,20 @@
|32GB内存版 |1 |10,000 |10,000 |32 |80,000 |
|64GB内存版 |1 |10,000 |10,000 |64 |80,000 |
### 支付宝小程序云
|规格 |CPU核数|每秒新建连接数上限 |连接数上限 |带宽（MB/s） |QPS参考值|
|-- |-- |-- |-- |-- |-- |
|1GB集群版-单副本|1 |6,000 |6,000 |10 |50,000 |
|4GB集群版-单副本|1 |6,000 |6,000 |10 |100,000 |
|1GB集群版-双副本|2 |6,000 |6,000 |10 |50,000 |
|4GB集群版-双副本|2 |6,000 |6,000 |10 |100,000 |
## 费用说明@fee
- 阿里云及腾讯云为包年包月套餐，需付费开通，支持续费、变配
- 支付宝小程序云为按量计费，开通不收费，但是需要账号充值保证金及支付宝按量余额，费用在第二天出账并从余额扣除。不支持变配。
### 续费@renew
在uniCloud web控制台redis详情页面点击续费按钮可以对redis实例进行续费操作。
......
docs/uniCloud/release.md
浏览文件 @ 45e2adef
#### 4--
* 【重要】新增支持支付宝小程序云，价格更便宜，限制更少，功能更强，支持域名备案
* 调整 `db_init.json` 按collection拆分，每个collection由schema.json、index.json、init_data.json三个文件描述
#### 2023-10-19
* 优化 阿里云 callFunction、url化方式调用云函数最大超时时间由60秒调整为120秒
* 新增 uni-app x项目 支持uniCloud调试
......
docs/uniCloud/trigger.md
浏览文件 @ 45e2adef
......@@ -6,7 +6,7 @@
在uniCloud web控制台点击需要添加触发器的云函数详情，创建云函数触发器，格式如下：
**腾讯云**
**腾讯云&支付宝小程序云**
```js
// 参数是触发器数组，目前仅支持一个触发器，即数组只能填写一个，不可添加多个
......@@ -29,7 +29,7 @@
["cron:0 0 * * * *"]
```
**在package.json内配置定时触发时统一了腾讯阿里的写法，请参考：[云函数package.json](cf-functions.md#packagejson)**
**在package.json内配置定时触发时统一了云厂商的写法，请参考：[云函数package.json](cf-functions.md#packagejson)**
::: warning 注意
- 阿里云正式版最低触发间隔为1分钟，腾讯云最低触发间隔为1秒
......@@ -55,7 +55,7 @@ Cron 表达式有七个**必需**字段，按空格分隔。其中，每个字
|第四位| 日 | 1 - 31的整数（需要考虑月的天数） | , - * / |
|第五位| 月 | 1 - 12的整数 | , - * / |
|第六位| 星期 | 0 - 6的整数，其中0指星期日，1指星期一，以此类推 | , - * / |
|第七位| 年 | 1970 - 2099的整数（阿里云不支持第七位） | , - * / |
|第七位| 年 | 1970 - 2099的整数（阿里云和支付宝小程序云不支持第七位） | , - * / |
### 通配符@cron-wildcard
......
docs/uniCloud/upgrade-center.md
浏览文件 @ 45e2adef
......@@ -10,7 +10,7 @@ App升级中心 uni-upgrade-center，提供了 App 的版本更新服务。包
本产品具有如下特征：
- 开源、免费。由于uniCloud阿里云版目前免费，包括服务器和cdn均免费。
- 开源、免费。uniCloud阿里云版和支付宝云版都有免费空间。
- 云端基于 [uniCloud](https://uniapp.dcloud.net.cn/uniCloud/) 实现。后台管理是 [uni-admin](https://uniapp.dcloud.net.cn/uniCloud/admin.html) 框架的插件。
......
Markdown is supported
0% 或 .
You are about to add 0 people to the discussion. Proceed with caution.
先完成此消息的编辑！
想要评论请 注册 或