tmui-cli 2.0.2 → 2.0.4

package/data/uni-app-x-docs/tutorial/app-env.md

@@ -0,0 +1,84 @@
+# app平台 uni-app x 项目云端打包环境  
+
+> uni-app 项目云端打包环境参考[这里](https://uniapp.dcloud.net.cn/tutorial/app-env.html)
+
+## Android平台云端打包环境  
+
+> 使用 gradle 脚本编译  
+
+### HBuilderX5.09及以上版本云端打包环境
+- Android 编译 SDK（compileSdk）： 36  
+- Android 构建工具（buildToolsVersion）：35.0.0  
+- Gradle：8.14.3  
+- Android Gradle 插件（com.android.tools.build:gradle）：8.12.0  
+- Kotlin Android 插件（org.jetbrains.kotlin.android）：2.2.0  
+- JDK：17 （[Amazon corretto 17.0.12.7.1](https://docs.aws.amazon.com/corretto/latest/corretto-17-ug/what-is-corretto-17.html)）  
+
+### HBuilderX4.81及以上版本云端打包环境
+- Android 编译 SDK（compileSdk）： 35  
+- Android 构建工具（buildToolsVersion）：35.0.0  
+- Gradle：8.14.3  
+- Android Gradle 插件（com.android.tools.build:gradle）：8.12.0  
+- Kotlin Android 插件（org.jetbrains.kotlin.android）：2.2.0  
+- JDK：17 （[Amazon corretto 17.0.12.7.1](https://docs.aws.amazon.com/corretto/latest/corretto-17-ug/what-is-corretto-17.html)）  
+
+### HBuilderX4.76及以下版本云端打包环境
+- Android 编译 SDK（compileSdk）： 35  
+- Android 构建工具（buildToolsVersion）：35.0.0  
+- Gradle：8.11.1  
+- Android Gradle 插件（com.android.tools.build:gradle）：8.7.3  
+- Kotlin Android 插件（org.jetbrains.kotlin.android）：1.9.10  
+- JDK：17 （[Amazon corretto 17.0.12.7.1](https://docs.aws.amazon.com/corretto/latest/corretto-17-ug/what-is-corretto-17.html)）  
+
+### HBuilderX4.57及以下版本云端打包环境
+- Android 编译 SDK（compileSdk）： 34  
+- Android 构建工具（buildToolsVersion）：34.0.0  
+- Gradle：8.5  
+- Android Gradle 插件（com.android.tools.build:gradle）：8.2.2  
+- Kotlin Android 插件（org.jetbrains.kotlin.android）：1.9.10  
+- JDK：17 （[Amazon corretto 17.0.12.7.1](https://docs.aws.amazon.com/corretto/latest/corretto-17-ug/what-is-corretto-17.html)）  
+
+### 默认仓储服务器地址@repositories  
+云端打包环境默认使用以下仓储服务器：  
+```groovy
+  repositories {
+    maven { url 'https://maven.aliyun.com/repository/google' }
+    maven { url 'https://maven.aliyun.com/repository/public' }
+
+    google()
+    mavenCentral()
+    maven { url 'https://jitpack.io' }
+    maven { url 'https://developer.huawei.com/repo/' }
+    maven { url 'https://developer.hihonor.com/repo/' }
+    maven { url 'https://mvn.getui.com/nexus/content/repositories/releases/' }
+  }
+
+```
+
+**注意**  
+HBuilderX4.36+版本开始uts插件支持添加自定义仓储服务器，详情参考：uts插件开发中的[Android原生配置](../plugin/uts-plugin.md#androidconfigjson)。  
+
+
+## iOS平台云端打包环境  
+
+> 使用 XCode 的 xcodebuild 命令编译  
+
+- **从2026年8月30号开始HBuilderX5.14及以上alpha版本云端打包环境已升级为XCode26.6**  
+- **从2026年3月22号开始HBuilderX4.66及以上release版本云端部分打包机环境升级为XCode26.3**
+
+
+### HBuilderX5.25及以上版本云端打包环境
+- XCode: 26.6  
+- iOS SDK: 26.5  
+- pod仓库：https://mirrors.tuna.tsinghua.edu.cn/git/CocoaPods/Specs.git  
+
+**更新XCode26.6后最低支持iOS15系统**
+
+
+### HBuilderX5.05及以上版本云端打包环境
+- XCode: 26.3  
+- iOS SDK: 26.2  
+- pod仓库：https://mirrors.tuna.tsinghua.edu.cn/git/CocoaPods/Specs.git  
+
+**更新XCode26.3后最低支持iOS13系统**
+

package/data/uni-app-x-docs/tutorial/app-market.md

@@ -0,0 +1,58 @@
+## 应用市场上架注意事项
+
+应用（或称“APP”）上架至应用市场时，应用市场会根据APP的行业分类以及所涉及的具体功能和服务而要求APP提供者提交相应的资质、许可、备案、授权等文件。以下是主要手机厂商应用市场的APP审核相关规则，以供开发者进行了解和准备。  
+
+开发者上架应用市场，需注意以下事项：  
+- 将应用提交到应用市场之前，先查阅相应的应用市场的APP审核规则，特别是与行业资质相关的审核要求  
+- 检查APP涉及的所有功能和服务（包括集成的第三方的服务），判断所需的经营许可并提前准备相关文件  
+- 登录应用市场官方平台查看审核规则变更情况、审核通知等，并根据应用市场要求及时提交相关文件  
+
+
+### 华为  
+- [应用审核指南](https://developer.huawei.com/consumer/cn/doc/app/50104?ha_source=Dcloud&ha_sourceId=89000448)  
+- [应用资质审核要求](https://developer.huawei.com/consumer/cn/doc/app/80301?ha_source=Dcloud&ha_sourceId=89000448)  
+- [应用审核FAQ](https://developer.huawei.com/consumer/cn/doc/app/50106?ha_source=Dcloud&ha_sourceId=89000448)  
+- [应用资质FAQ](https://developer.huawei.com/consumer/cn/doc/app/50111?ha_source=Dcloud&ha_sourceId=89000448)  
+- [APP备案FAQ](https://developer.huawei.com/consumer/cn/doc/app/50130?ha_source=Dcloud&ha_sourceId=89000448)  
+- [APP备案补充指引](https://developer.huawei.com/consumer/cn/doc/app/50130-FAQ?ha_source=Dcloud&ha_sourceId=89000448)
+
+
+### 小米  
+- [开发者生态政策](https://dev.mi.com/xiaomihyperos/documentation/detail?pId=1321)  
+- [应用商店上架要求](https://dev.mi.com/xiaomihyperos/documentation/detail?pId=1322)  
+- [特殊行业资质要求](https://dev.mi.com/xiaomihyperos/documentation/detail?pId=1139)  
+- [应用资质上传操作指南](https://dev.mi.com/xiaomihyperos/documentation/detail?pId=1261)  
+- [应用审核常见问题](https://dev.mi.com/xiaomihyperos/documentation/detail?pId=1252)  
+- [移动应用程序（APP）备案指引](https://dev.mi.com/xiaomihyperos/documentation/detail?pId=1739)  
+- [移动应用程序（APP）备案信息补充指引](https://dev.mi.com/xiaomihyperos/documentation/detail?pId=1775)  
+
+
+### OPPO  
+- [OPPO 应用从业资质规范](https://open.oppomobile.com/new/developmentDoc/info?id=12133)  
+- [OPPO 应用审核规范](https://open.oppomobile.com/new/developmentDoc/info?id=12131)  
+- [移动应用发布上架软件商店](https://open.oppomobile.com/new/developmentDoc/info?id=10035)  
+- [资质审核FAQ](https://open.oppomobile.com/new/developmentDoc/info?id=10914)  
+- [应用/游戏备案新规](https://open.oppomobile.com/new/developmentDoc/info?id=12458)  
+- [OPPO 应用处罚规范](https://open.oppomobile.com/new/developmentDoc/info?id=12134)  
+
+
+### VIVO  
+- [开放平台应用审核规范](https://dev.vivo.com.cn/documentCenter/doc/12)  
+- [特殊行业类资质要求](https://dev.vivo.com.cn/documentCenter/doc/90)  
+- [行业资质FAQ](https://dev.vivo.com.cn/documentCenter/doc/851)  
+- [移动应用程序（APP）备案指引](https://dev.vivo.com.cn/documentCenter/doc/763)  
+- [APP备案FAQ](https://dev.vivo.com.cn/documentCenter/doc/722)  
+- [应用违规处罚规则](https://dev.vivo.com.cn/documentCenter/doc/479)  
+
+
+### 荣耀  
+- [荣耀应用市场审核规范](https://developer.honor.com/cn/doc/guides/100879)  
+- [应用资质审核要求](https://developer.honor.com/cn/doc/guides/101152)  
+- [平台审核常见FAQ](https://developer.honor.com/cn/doc/guides/101269)
+- [APP备案指南](https://developer.honor.com/cn/doc/guides/101280)
+
+
+### 苹果  
+- [App 审核指南](https://developer.apple.com/cn/app-store/review/guidelines/)  
+- [App 信息](https://developer.apple.com/cn/help/app-store-connect/reference/app-information)
+

package/data/uni-app-x-docs/tutorial/app-package.md

@@ -0,0 +1,196 @@
+# 云打包
+
+::: 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/uni-app-x-docs/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" />
+
+	<!-- 通过GPS得到精确位置 -->
+	<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" />
+	<!-- 访问WiFi状态，需要WiFi信息用于网络定位 -->
+	<uses-permission android:name="android.permission.ACCESS_WIFI_STATE" />
+	<!-- 修改WiFi状态，发起WiFi扫描, 需要WiFi信息用于网络定位 -->
+	<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" />
+	<!-- 前台service权限 -->
+	<uses-permission android:name="android.permission.FOREGROUND_SERVICE" />
+	<!-- 后台定位权限 -->
+	<uses-permission android:name="android.permission.ACCESS_BACKGROUND_LOCATION" />
+	<!-- A-GPS辅助定位权限，方便GPS快速准确定位 -->
+	<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/uni-app-x-docs/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)。