tmui-cli 2.0.3 → 2.0.5

package/data/uniappx/tutorial/app-package.md

@@ -0,0 +1,195 @@
+# 云打包
+
+::: tip 离线打包
+离线打包需在原生工程环境中进行配置
+- Android平台离线打包参考[Android平台原生工程配置](../native/use/android.md)
+- iOS平台离线打包参考[iOS平台原生工程配置](../native/use/ios.md)
+
+在HBuilderX中开发完成后，提交到云端打包生成发布安装包。
+可点击菜单 “发行” -> “App-Android/iOS-云打包” 打开 “App打包”界面：
+
+![](https://web-ext-storage.dcloud.net.cn/doc/app/cloudpackage/package.png)
+
+## Android平台
+
+云端打包需配置包名、证书以及安装包格式信息。
+
+### Android包名
+在Android中，包名（Package Name）是应用的唯一标识符。采用反写域名命名规则（如com.xxx.xxx形式），可以包含大写或小写字母、数字和下划线（“_”）。不过，各个名称部分只能以字母开头。
+
+### 证书类型
+#### 云证书 @servercert
+由DCloud服务器根据你的appid自动生成证书，生成证书后可登录[DCloud开发者中心](https://dev.dcloud.net.cn/)查看证书详情或下载证书文件。
+
+云证书的优势是开发方便。但在发布商业应用时，商业组织往往会分离开发证书和发布证书，发布证书仅少数人掌管。
+
+DCloud建议开发阶段使用云证书，开发者打包出apk后，交给掌管发布证书的人员使用发布证书自行重签，再上架应用商店。
+
+**注意**
+- DCloud不对开发者证书管理行为不规范引发的问题负责
+- 服务器生成的证书会自动填写证书信息，不支持自定义证书信息，有效期为100年
+
+#### 自选证书 @customcert
+开发者如果已经有自己的安卓签名证书，可直接使用。
+如果没有证书，使用JDK的keytool工具生成一个，不像Apple证书那样收费，制作Android证书没有费用，参考[Android平台签名证书(.keystore)生成指南](https://ask.dcloud.net.cn/article/35777)。
+
+在 “证书类型” 中勾选 “云端证书”：
+
+![](https://web-ext-storage.dcloud.net.cn/doc/app/cloudpackage/package-android.png)
+
+- 证书库文件
+	选择要使用的证书库文件
+- 证书库密码
+	输入访问证书库的密码
+- 证书别名
+	选择用于签名的证书别名
+- 证书密码
+	输入访问选择别名对应证书的密码
+
+**注意**
+- 证书别名使用英文字母或数字，避免使用中文
+- 提交云端打包后，打包机会立即删除的证书，不会保存或泄露证书，请放心使用
+
+### 打包格式
+
+> HBuilder4.31版本新增支持
+
+#### APK安装包
+生成apk格式的安装包，国内应用市场支持使用此格式。
+
+#### AAB安装包（HBuilderX4.31+支持）@aab
+生成aab格式的安装包，Google Play 应用市场要求必须使用此格式。勾选此格式固定渠道为“google”。
+
+**注意**
+- aab格式不支持通过adb命令安装到手机，可参考[本地离线打包支持Android App Bundle (AAB)](https://ask.dcloud.net.cn/article/39052#install)进行安装测试
+
+### 渠道包 @channel
+
+> HBuilder4.31版本新增支持
+
+APK格式安装包支持配置渠道信息，默认提供以下渠道配置项：
+
+| 渠道名称     | 渠道标识 |
+| ------------ | -------- |
+| 华为   |  huawei   |
+| OPPO   |  oppo     |
+| VIVO   |  vivo     |
+| 小米   |  xiaomi   |
+| 荣耀   |  honor    |
+| 应用宝 |  yyb      |
+
+**注意**
+- 应用中可通过 [uni.getAppBaseInfo](../api/get-app-base-info.md#getappbaseinfo) 返回的 channel 属性获取应用的渠道信息
+- 勾选“无”表示不使用渠道信息，[uni.getAppBaseInfo](../api/get-app-base-info.md#getappbaseinfo) 返回的 channel 属性值为空字符串
+
+#### 自定义渠道
+如果默认的渠道信息不够使，想要更多渠道，可在 [manifest.json](../collocation/manifest.md) 的 `源码视图` 配置 "__hbuilderx" -> "channel_list"，如下：
+```json
+{
+  //其它数据
+  //根节点下配置__hbuilderx如下
+  "__hbuilderx": {
+    "channel_list":[
+      {
+        "id":"lenovo",
+        "name":"联想"
+      }
+    ]
+  }
+}
+```
+
+保存后，重新打开“App打包”界面，在“APK渠道包”项中会列出新增加的自定义渠道，勾选后提交云端打包才能生效。
+
+## iOS平台
+
+云端打包需配置Bundle ID、支持的设备、证书信息。
+
+![](https://web-ext-storage.dcloud.net.cn/doc/app/cloudpackage/package-ios.png)
+
+### Bundle ID
+Bundle ID （Bundle identifier）也叫 App ID 或者应用ID，是每个 iOS 应用的唯一标识。通常以反转的域名格式命名（如：com.example.appname），只能包含字母、数字、中划线和点号（.），不能包含特殊字符或空格，Bundle ID不区分大小写，推荐使用权小写字母。
+申请 iOS 证书、打包 ipa 和在 itunesconnect 创建 App 都要用到 Bundle ID， 整个 App 上架流程就是靠这个 Bundle ID 关联在一起。
+
+### 支持的设备
+
+必须勾选支持iPhone、支持iPad中的至少一项。
+
+- 支持iPhone
+	勾选此项才能安装到iPhone设备，不勾选则无法安装到iPhone设备。
+
+- 支持iPad
+	勾选此项才能在iPad设备全屏运行，不勾选此项也可以安装到iPad设备，但运行时会有黑边。
+
+### 证书信息
+
+打包iOS安装必须使用Apple证书，需到 Apple 开发者网站申请，详情参考[Apple证书申请](https://ask.dcloud.net.cn/article/152)。
+
+- 私钥证书
+	选择在 Apple 开发者网站申请的证书
+- 证书私钥密码
+	访问私钥证书的密码
+- 证书Profile文件
+	选择与证书关联的Profile文件
+
+## 制作自定义调试基座
+
+HBuilderX中内置“使用标准基座运行”功能，是DCloud为方便开发者低门槛调试而提供的，此基座App使用的是DCloud的包名、证书和三方SDK配置。
+如果要自定义原生层能力（如三方SDK配置），则需要走一遍iOS或Android的打包流程，由XCode或Android studio编译打包生成ipa或apk安装包。但发布打包后无法方便调试，不能热重载和显示控制台日志。所以HBuilder在打包时提供了一个特殊选项，打包“自定义运行基座”。
+
+自定义调试基座可以生效的配置（主要是manifest.json的配置），包括：
+- App名称、图标、封面splash、包名、证书
+- App模块配置、三方sdk配置（如微信、推送、地图、语音识别等三方sdk配置）
+- App权限配置
+- uni原生插件
+- 其他manifest.json文档提到的需打包生效的配置
+
+生成自定义调试基座后，可参考[使用自定义调试基座真机运行](https://uniapp.dcloud.net.cn/tutorial/run/run-app.html#customplayground)
+
+**注意**
+- 自定义调试基座生成的安装包不能用于提交应用市场上架审核
+
+## 广告联盟 @uniad
+
+> HBuilder4.31版本新增支持
+
+用于配置 uni-AD 需要使用的广告，使用前需申请开通 uni-AD，详情参考[uni-AD开发文档](https://uniapp.dcloud.net.cn/uni-ad/) 。
+勾选则表示开通/集成渠道：
+
+![](https://web-ext-storage.dcloud.net.cn/doc/app/cloudpackage/package-uniad.png)
+
+### 开通DCloud快捷广告
+
+- 快捷开屏广告
+  DCloud自营开屏广告
+- uniMP激励视频广告
+
+**注意**
+开通DCloud快捷广告后需登录[uni-ad 广告联盟](https://uniad.dcloud.net.cn/)关闭。
+
+### 集成渠道SDK广告SDK
+
+勾选云打包需要使用的广告渠道，支持以下广告平台：
+
+| 广告平台名称						|Web|Android|iOS	|
+| :-										|:-	|:-			|:-		|
+| 腾讯优量汇							|x	|3.99		|4.22	|
+| 穿山甲GroMore					|x	|3.99		|4.22	|
+| 快手广告联盟						|x	|3.99		|4.22	|
+| 百度百青藤广告联盟			|x	|4.31		|4.31	|
+| 华为广告联盟						|x	|4.31		|x		|
+| Sigmob广告联盟					|x	|3.99		|4.22	|
+| Octopus章鱼移动广告		|x	|4.31		|4.31	|
+| AdScope倍孜广告				|x	|4.31		|x		|
+| 泛连									|x	|4.31		|x		|
+| 聚力阅盟								|x	|4.31		|x		|
+| Pangle(海外穿山甲)			|x	|4.31		|4.31	|
+| Google AdMob					|x	|4.31		|4.31	|
+| unity									|x	|4.31		|4.31	|
+| liftoff								|x	|4.31		|4.31	|
+| inmobi								|x	|4.31		|4.31	|
+| ironsource						|x	|4.31		|4.31	|
+| mintegral							|x	|4.31		|4.31	|
+
+**注意**
+- 勾选后需提交云端打包后才能生效

package/data/uniappx/tutorial/app-playground.md

@@ -0,0 +1,188 @@
+# app平台标准基座  
+
+在HBuilderX中，运行iOS/Android应用时，DCloud提供了运行基座的概念。
+
+运行基座的存在，可以让开发者的代码动态运行在基座之上，无需经过完整的打包流程，也无需在本地配置原生的打包环境。
+
+这样开发者就可以快捷的把代码跑起来，在手机上看效果。
+
+运行基座又分标准基座和自定义基座。
+标准基座使用的是DCloud的包名、证书和三方SDK配置。
+如果开发者要修改这些信息，则需要自定义基座。
+
+## Android平台标准基座信息  
+- 包名： io.dcloud.uniappx  
+- 签名信息：  
+    + SHA256：5975dd84fbd6648be4afdfe4cc3025b4c9f8eb6131519e44ff15511a0ab9a7d3
+    + SHA1：71544e0a6f064614e83f6ad2a4f318df349c1295
+    + MD5：957764ac1b55e0c38bae22ba2a145b98
+- 注册的Url Scheme：uniappx
+
+## iOS平台标准基座信息  
+- 包名： io.dcloud.uniappx  
+- Capabilities（苹果开发者平台开启的能力）：  
+    + Access Wi-Fi Information
+    + Associated Domains
+    + Push Notifications
+    + Sign In with Apple
+    + Time Sensitive Notifications
+- 注册的Url Scheme: uniappx  
+- 注册的通用链接：https://uniappx.dcloud.net.cn/ulink  
+
+注意：ios平台标准基座需要重签名才能使用，重签名后会改变包名信息，从而导致注册的通用链接失效。
+
+## 标准基座包含的功能模块  
+- uni-ad：[uni-ad广告联盟](https://uniad.dcloud.net.cn/)  
+    + gdt：腾讯优量汇广告联盟SDK  
+- uni-canvas：[canvas画布组件](../component/canvas.md)
+- uni-cloud-client：[uniCloud云函数/云对象](https://doc.dcloud.net.cn/uniCloud/cf-functions.html)
+- uni-createRequestPermissionListener：[Android平台监听权限申请](../api/create-request-permission-listener.md)  
+- uni-createWebviewContext：[创建 web-view 组件的上下文对象](../api/create-webview-context.md)
+- uni-facialRecognitionVerify：[uni实人认证](https://doc.dcloud.net.cn/uniCloud/frv/intro.html)
+- uni-fileSystemManager：[文件管理](../api/get-file-system-manager.md)
+- uni-location：[获取位置信息](../api/get-location.md) `HBuilderX 4.61-`之前是 `uni-getLocation` 模块名
+    + system: 系统定位
+    + tencent：腾讯定位
+- uni-getNetworkType：[获取网络类型](../api/get-network-type.md)
+- uni-getProvider: [获取服务供应商](../api/get-provider.md#getprovider)
+- uni-installApk：[Android平台安装apk](../api/install-apk.md)
+- uni-media：[多媒体相关API](../api/choose-image.md)
+- uni-network：[网络请求（文件上传/下载）](../api/request.md)
+- uni-payment：[请求支付](../api/request-payment.md)
+    + alipay：支付宝支付
+    + wxpay：微信支付
+- uni-push：[uni-push统一推送](https://uniapp.dcloud.net.cn/unipush-v2.html)
+- uni-verify：[一键登录](../api/get-univerify-manager.md)
+- uni-video：[video视频组件](../component/video.md)
+- uni-virtualPayment：[虚拟支付](../api/virtual-payment.md#requestvirtualpayment)
+- uni-websocket：[WebSocket](../api/websocket-global.md)
+
+## Android平台包含的权限
+Android平台标准基座尽量包含所有可能用到的权限，以便在开发过程中可调用所有系统API。
+包含以下权限：
+```xml
+	
+	<uses-permission android:name="android.permission.INTERNET" />
+	
+	<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" />
+
+	
+	<uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" />
+	
+	<uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION" />
+	
+	<uses-permission android:name="android.permission.INTERNET" />
+	
+	<uses-permission android:name="android.permission.ACCESS_WIFI_STATE" />
+	
+	<uses-permission android:name="android.permission.CHANGE_WIFI_STATE" />
+	
+	<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
+	
+	<uses-permission android:name="android.permission.CHANGE_NETWORK_STATE" />
+	
+	<uses-permission android:name="android.permission.BLUETOOTH" />
+	<uses-permission android:name="android.permission.BLUETOOTH_ADMIN" />
+	<uses-permission android:name="android.permission.BLUETOOTH_SCAN" android:usesPermissionFlags="neverForLocation" />
+	<uses-permission android:name="android.permission.BLUETOOTH_CONNECT" />
+	
+	<uses-permission android:name="android.permission.FOREGROUND_SERVICE" />
+	
+	<uses-permission android:name="android.permission.ACCESS_BACKGROUND_LOCATION" />
+	
+	<uses-permission android:name="android.permission.ACCESS_LOCATION_EXTRA_COMMANDS" />
+	
+	<uses-permission android:name="android.permission.REQUEST_INSTALL_PACKAGES" />
+
+	
+	<uses-permission android:name="android.permission.ACCESS_CHECKIN_PROPERTIES"/>
+	<uses-permission android:name="android.permission.ACCESS_MOCK_LOCATION"/>
+	<uses-permission android:name="android.permission.ACCESS_SURFACE_FLINGER"/>
+	<uses-permission android:name="android.permission.ADD_SYSTEM_SERVICE"/>
+	<uses-permission android:name="android.permission.BATTERY_STATS"/>
+	<uses-permission android:name="android.permission.BRICK"/>
+	<uses-permission android:name="android.permission.BROADCAST_PACKAGE_REMOVED"/>
+	<uses-permission android:name="android.permission.BROADCAST_STICKY"/>
+	<uses-permission android:name="android.permission.CALL_PHONE"/>
+	<uses-permission android:name="android.permission.CALL_PRIVILEGED"/>
+	<uses-permission android:name="android.permission.CAMERA"/>
+	<uses-permission android:name="android.permission.CHANGE_COMPONENT_ENABLED_STATE"/>
+	<uses-permission android:name="android.permission.CHANGE_CONFIGURATION"/>
+	<uses-permission android:name="android.permission.CLEAR_APP_CACHE"/>
+	<uses-permission android:name="android.permission.CLEAR_APP_USER_DATA"/>
+	<uses-permission android:name="android.permission.DELETE_CACHE_FILES"/>
+	<uses-permission android:name="android.permission.DELETE_PACKAGES"/>
+	<uses-permission android:name="android.permission.DEVICE_POWER"/>
+	<uses-permission android:name="android.permission.DIAGNOSTIC"/>
+	<uses-permission android:name="android.permission.DISABLE_KEYGUARD"/>
+	<uses-permission android:name="android.permission.DUMP"/>
+	<uses-permission android:name="android.permission.EXPAND_STATUS_BAR"/>
+	<uses-permission android:name="android.permission.FACTORY_TEST"/>
+	<uses-permission android:name="android.permission.FLASHLIGHT"/>
+	<uses-permission android:name="android.permission.FORCE_BACK"/>
+	<uses-permission android:name="android.permission.FOTA_UPDATE"/>
+	<uses-permission android:name="android.permission.GET_ACCOUNTS"/>
+	<uses-permission android:name="android.permission.GET_PACKAGE_SIZE"/>
+	<uses-permission android:name="android.permission.GET_TASKS"/>
+	<uses-permission android:name="android.permission.HARDWARE_TEST"/>
+	<uses-permission android:name="android.permission.INJECT_EVENTS"/>
+	<uses-permission android:name="android.permission.INSTALL_PACKAGES"/>
+	<uses-permission android:name="android.permission.INTERNAL_SYSTEM_WINDOW"/>
+	<uses-permission android:name="android.permission.INTERNET"/>
+	<uses-permission android:name="android.permission.MANAGE_APP_TOKENS"/>
+	<uses-permission android:name="android.permission.MASTER_CLEAR"/>
+	<uses-permission android:name="android.permission.MODIFY_AUDIO_SETTINGS"/>
+	<uses-permission android:name="android.permission.MODIFY_PHONE_STATE"/>
+	<uses-permission android:name="android.permission.MOUNT_UNMOUNT_FILESYSTEMS"/>
+	<uses-permission android:name="android.permission.NFC"/>
+	<uses-permission android:name="android.permission.PERSISTENT_ACTIVITY"/>
+	<uses-permission android:name="android.permission.PROCESS_OUTGOING_CALLS"/>
+	<uses-permission android:name="android.permission.READ_CALENDAR"/>
+	<uses-permission android:name="android.permission.READ_CONTACTS"/>
+	<uses-permission android:name="android.permission.READ_FRAME_BUFFER"/>
+	<uses-permission android:name="android.permission.READ_INPUT_STATE"/>
+	<uses-permission android:name="android.permission.READ_LOGS"/>
+	<uses-permission android:name="android.permission.READ_OWNER_DATA"/>
+	<uses-permission android:name="android.permission.READ_SMS"/>
+	<uses-permission android:name="android.permission.READ_SYNC_SETTINGS"/>
+	<uses-permission android:name="android.permission.READ_SYNC_STATS"/>
+	<uses-permission android:name="android.permission.REBOOT"/>
+	<uses-permission android:name="android.permission.RECEIVE_BOOT_COMPLETED"/>
+	<uses-permission android:name="android.permission.RECEIVE_MMS"/>
+	<uses-permission android:name="android.permission.RECEIVE_SMS"/>
+	<uses-permission android:name="android.permission.RECEIVE_WAP_PUSH"/>
+	<uses-permission android:name="android.permission.RECORD_AUDIO"/>
+	<uses-permission android:name="android.permission.REORDER_TASKS"/>
+	<uses-permission android:name="android.permission.RESTART_PACKAGES"/>
+	<uses-permission android:name="android.permission.SEND_SMS"/>
+	<uses-permission android:name="android.permission.SET_ACTIVITY_WATCHER"/>
+	<uses-permission android:name="android.permission.SET_ALWAYS_FINISH"/>
+	<uses-permission android:name="android.permission.SET_ANIMATION_SCALE"/>
+	<uses-permission android:name="android.permission.SET_DEBUG_APP"/>
+	<uses-permission android:name="android.permission.SET_ORIENTATION"/>
+	<uses-permission android:name="android.permission.SET_PREFERRED_APPLICATIONS"/>
+	<uses-permission android:name="android.permission.SET_PROCESS_FOREGROUND"/>
+	<uses-permission android:name="android.permission.SET_PROCESS_LIMIT"/>
+	<uses-permission android:name="android.permission.SET_TIME_ZONE"/>
+	<uses-permission android:name="android.permission.SET_WALLPAPER"/>
+	<uses-permission android:name="android.permission.SET_WALLPAPER_HINTS"/>
+	<uses-permission android:name="android.permission.SIGNAL_PERSISTENT_PROCESSES"/>
+	<uses-permission android:name="android.permission.STATUS_BAR"/>
+	<uses-permission android:name="android.permission.SUBSCRIBED_FEEDS_READ"/>
+	<uses-permission android:name="android.permission.SUBSCRIBED_FEEDS_WRITE"/>
+	<uses-permission android:name="android.permission.SYSTEM_ALERT_WINDOW"/>
+	<uses-permission android:name="android.permission.VIBRATE"/>
+	<uses-permission android:name="android.permission.WAKE_LOCK"/>
+	<uses-permission android:name="android.permission.WRITE_APN_SETTINGS"/>
+	<uses-permission android:name="android.permission.WRITE_CALENDAR"/>
+	<uses-permission android:name="android.permission.WRITE_CONTACTS"/>
+	<uses-permission android:name="android.permission.WRITE_GSERVICES"/>
+	<uses-permission android:name="android.permission.WRITE_OWNER_DATA"/>
+	<uses-permission android:name="android.permission.WRITE_SETTINGS"/>
+	<uses-permission android:name="android.permission.WRITE_SMS"/>
+	<uses-permission android:name="android.permission.WRITE_SYNC_SETTINGS"/>
+	<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE"/>
+	<uses-permission android:name="com.android.launcher.permission.INSTALL_SHORTCUT"/>
+	<uses-permission android:name="com.android.launcher.permission.UNINSTALL_SHORTCUT"/>
+	<uses-permission android:name="android.permission.POST_NOTIFICATIONS"/>
+```

package/data/uniappx/tutorial/app-update-wgt.md

@@ -0,0 +1,9 @@
+# 应用资源在线升级更新  
+
+> HBuilderX5.31及以上版本Android、iOS平台`蒸汽模式`支持应用资源在线升级更新  
+
+//Todo...
+
+应用资源在线升起，相对整包升级有以下优势：  
+- 无需重新提交应用市场审核更新，降低更新周期  
+- App资源相对体积更小，升级速度更快

package/data/uniappx/tutorial/bug_repair.md

@@ -0,0 +1,40 @@
+# AI 修复功能说明
+
+`AI 修复` 是 HBuilderX 提供的一项辅助能力，用于在 `uni-app` 或 `uni-app x` 项目编译、运行报错时，快速发起智能修复流程，帮助开发者定位并处理常见问题。
+
+> `HBuilderX 4.71+` 已开始支持 `AI 修复`，建议从 `4.72+` 版本开始使用，以获得更稳定的体验。
+
+## 适用场景
+
+当项目在编译或运行过程中出现错误时，控制台会提供 `AI 修复` 入口。开发者可基于当前错误信息，快速发起自动修复。
+
+## 使用流程
+
+### 1. 编译或运行报错后，打开 AI 修复入口
+
+在 `uni-app` 或 `uni-app x` 项目编译、运行出现错误时，控制台会显示可点击的 `AI 修复` 按钮。
+
+![](https://web-ext-storage.dcloud.net.cn/hx/debug/ai-repair5.png)
+
+### 2. 发起修复
+
+点击控制台中的 `AI 修复` 按钮后，会自动打开 `uni-agent`。确认内容后点击发送，即可开始自动修复当前问题。
+
+![](https://web-ext-storage.dcloud.net.cn/hx/debug/ai-repair2.png)
+
+### 3. 查看修复结果
+
+修复完成后，界面会展示本次涉及修改的文件，便于开发者快速了解变更范围。
+
+![](https://web-ext-storage.dcloud.net.cn/hx/debug/ai-repair4.png)
+
+### 4. 逐项确认是否接受修改
+
+开发者可以逐个查看具体文件内容，并根据实际情况决定是否接受本次修改。
+
+![](https://web-ext-storage.dcloud.net.cn/hx/debug/ai-repair3.png)
+
+## 补充说明
+
+- `AI 修复` 适合作为排查和处理问题的辅助工具，最终修改结果建议由开发者确认后再纳入项目。
+- 如需了解 `uni-agent` 的更多界面说明与使用技巧，可参考[官方文档](https://uniapp.dcloud.net.cn/ai/uni-agent.html#uni-agent-%E7%95%8C%E9%9D%A2%E4%B8%8E%E6%A0%B8%E5%BF%83%E5%8A%9F%E8%83%BD)。

package/data/uniappx/tutorial/codegap.md

@@ -0,0 +1,223 @@
+# uni-app x Android VDOM模式开发注意
+
+注意：**在DCloud主推蒸汽模式后，本文档已经过期。**
+
+与web开发相比，uni-app x在Android平台 VDOM模式下最大的变化是：弱类型的js改为了强类型的uts
+
+## 类型系统注意
+
+强类型语言中，变量、方法、参数、返回值、data数据，都必须有类型。
+
+基础类型包括：boolean|string|number|Array|Date|UTSJSONObject|any|null...
+
+开发者需阅读 [uts](https://uniapp.dcloud.net.cn/uts/) 文档，了解类型的定义和使用。
+
+如下代码比较典型的说明了uni-app x中uts类型的要求。
+
+可以看出template和css的代码和以前的uni-app相同，但script区域有变化。
+
+不管是data、自定义变量，甚至是组件事件参数（TouchEvent），都必须有类型。
+
+有的没有通过`:`定义类型，其实是因为编译器具备一定的自动推导能力，可以帮开发者自动补类型。
+
+data里`:`的用途是赋值，无法通过`:`定义类型，所以data的数据有2种处理方式：1、通过字面量自动推导；2、通过`as`声明
+
+```html
+<template>
+	<view @touchstart="touchstart">
+		<text class="red">{{s1}}</text>
+	</view>
+	<button @click="buttonClick" :disabled="buttonEnable">按钮</button>
+</template>
+
+<style>
+.red{
+	color:red
+}
+</style>
+```
+
+## 不同类型不能赋值、比较、运算
+在js里，可以字符串与数字相加，if() 里比较一个非bool值，这些在uts里都不行。
+```js
+//js
+let a = "abc"
+a=1 //a的类型从字符串变成了数字。但uts里不能这样
+if(a){ //a在js里作为数字，被隐式转换为了true。但uts里不能这样，如果要判断这个变量是否为null，uts里只能写 if (a!=null)
+
+}
+```
+
+## 全局属性
+
+`uni-app x` 中，`uni` 对象不支持动态绑定自定义属性，[app.config.globalProperties](../vue/README.md#app-instance) 暂时不支持。\
+如有`全局属性`的需求，可通过[全局变量与状态管理](../tutorial/store.md)实现。
+
+## 函数 event 参数的类型 @function-event-argument-type
+
+上面的例子中，touchstart事件中必须对`e`指定类型，才能使用`e.touches[0].screenX`。下面再举一个例子，加深下记忆：
+
+```vue
+<template>
+	<switch @change="switchChange" />
+</template>
+
+```
+
+那event参数的类型从哪里获取呢？
+1. 组件的文档中有介绍，比如[switch的组件](../component/switch.md)
+2. ide中有提示，比如鼠标移到switch组件的`@change`上，悬浮出现hover，会显示：`(property) 'change': (event: SwitchChangeEvent) => void`
+
+```html
+<view @click="(e: any) => foo(e)">event must has type</view>
+<view @click="foo($event as MouseEvent)">event must has type</view>
+```
+
+## 函数参数类型
+
+如果函数参数为基础数据类型，函数调用时，参数类型可以省略，编译器会自动推导。\
+如果函数参数为自定义数据类型，则必须指定类型。
+
+```ts
+// 基础数据类型
+function foo1(a: string, b: number) {
+	console.log(a, b)
+}
+foo1('hello', 1)
+
+// 自定义数据类型
+type Person = {
+	name: string
+	age: number
+}
+function foo2(p: Person) {
+	console.log(p.name, p.age)
+}
+foo2({ name: 'name', age: 18 } as Person)
+// 或者
+const person: Person = { name: 'name', age: 18 }
+foo2(person)
+```
+
+注意：uts文件或uts插件中导入的函数，如果参数为自定义数据类型，也必须指定类型。
+
+::: preview
+
+> index.uvue
+
+```html
+<template>
+  <text>index.uvue</text>
+</template>
+
+```
+
+> utils.uts
+
+```ts
+export type Person = {
+	name: string,
+	age: number
+}
+
+export function logPersonInfo(person: Person){
+	console.log('name: ' + person.name)
+	console.log('age: ' + person.age)
+}
+```
+
+## JSON的类型
+
+JSON数据在强类型语言中使用时，不能像js那样随意。
+
+js中可以这么写：
+```js
+var p ={"name": "zhangsan","age": 12}
+p.age //12
+```
+
+但是在强类型语言中，如果想要使用`p.age`，那么p必须是一个对象，而age则是这个对象的属性。然后必须为p对象、name属性、age属性，都定义类型，比如name是string，age是number。
+
+uts中有2种方式使用json数据：
+1. 把json数据转为type，自定义一个类型，声明json数据内容中每个属性的类型。然后就可以使用对象属性的方式来使用json数据。[详见](../uts/data-type.md#type)
+2. 使用UTSJSONObject，不为json定义类型，然后通过下标和方法来使用json数据。[详见](../uts/data-type.md#utsjsonobject)
+
+如果是联网获取服务器发下的json数据，那么**务必需要读教程**[request](request.md)
+
+## 编译器的类型优化
+
+- 生命周期的参数及参数类型均可省略。以 `onLoad` 为例：
+```ts
+// 省略参数
+onLoad(() => {
+	console.log('onLoad')
+})
+// 省略参数类型
+onLoad((options) => {
+	console.log('onLoad')
+})
+```
+- 模板函数的 event 参数可以省略，但如果参数存在，则必须有类型。
+```html
+<template>
+	<view @touchstart="onTouchstart" @click="onClick">
+		<text>text</text>
+	</view>
+</template>
+
+```
+- uni 及 uniCloud API, {} 字面量参数可以省略类型，success、fail 和 complete 回调函数及其参数类型也可以省略。以 `uni.navigateTo` 为例：
+```ts
+// 省略 {} 字面量参数类型
+uni.navigateTo({
+	url: 'test'
+	// 省略回调函数
+})
+
+uni.navigateTo({
+	url: 'test',
+	// 省略回调函数参数类型
+	success(res){
+		console.log(res)
+	}
+})
+```
+如需获取 API 的参数类型信息，可通过鼠标悬浮查看，
+
+比如封装 `uni.request` 时，如果参数从函数外部传入，则需要指定参数类型，否则无法获取参数类型信息。
+```ts
+// 封装
+function request(options : RequestOptions) {
+	uni.request(options)
+}
+// 调用
+request({url: 'https://www.example.com/request'} as RequestOptions)
+```
+如果需要查看更详细的参数类型信息，可通过鼠标右键点击转到定义，跳转 d.ts 文件进行查看，如下图所示：
+
+## uts不支持js的一些功能和特性
+
+- 不支持undefined。任何变量被定义后，都需要赋值
+- 函数声明方式不支持[作为值传递](../uts/function.md#作为值传递)
+- 函数表达式方式不支持[默认参数](../uts/function.md#默认参数)
+- 不存在（变量、函数等）声明提升，需要先声明，后使用，不可以访问未声明的变量或函数（包括自身）。
+- App-iOS平台的uts插件环境中支持async、await需HBuilderX 4.31+
+
+## 调用组件方法@methods
+
+js中refs拿到一个组件后，可以直接`.`出它的方法。但uts中只有easycom组件可以使用`.`操作符，非easycom组件需要使用callMethod()。[详见](../component/README.md#methods)
+
+## vue使用注意
+
+所有 `vue` 公开的 `API` 都是不需要 `import` 的, `uni-app x` 会自动引入。
+
+比如不需要写：
+```js
+import { ref } from 'vue';
+```
+
+其他[详见](../vue/README.md)
+
+## css使用注意
+
+[详见](../css/README.md)