tmui-cli 2.0.3 → 2.0.4

package/data/uniappx/tutorial/android-memoryleak.md

@@ -0,0 +1,542 @@
+# Android平台内存泄漏排查教程
+
+> HBuilderX4.81+版本真机运行支持自动检测内存泄漏  
+
+## 内存泄漏概念
+
+内存泄漏（Memory Leak）是指应用在申请内存后，无法释放已申请的内存空间，导致系统无法再次将该内存分配给其他应用使用。在Android应用中，内存泄漏会导致：
+
+- **应用内存占用不断增长**：随着时间推移，应用占用的内存越来越多
+- **性能下降**：可用内存减少，导致频繁的垃圾回收，影响应用流畅度
+- **OOM（Out Of Memory）错误**：严重时会导致应用崩溃
+- **系统卡顿**：影响整个系统的性能表现
+
+### 内存泄漏的本质
+在Java/Kotlin中，当一个对象不再被需要时，垃圾回收器（GC）应该能够回收它占用的内存。但如果该对象仍然被其他对象持有引用，GC就无法回收它，从而造成内存泄漏。
+
+## 常见内存泄漏
+
+常见的Android内存泄漏类型包括：
+- 静态变量持有Activity/Context引用
+- 全局集合对象持有UI元素引用
+- 响应式数据（Vue data）被全局引用
+- 监听器、回调未及时注销
+- 资源（文件、网络连接）未关闭
+
+## HBuilderX 自动检测内存泄漏
+
+Android平台`标准基座`及`自定义调试基座`已集成内存泄漏检测工具 [LeakCanary](https://github.com/square/leakcanary)，通过HBuilderX真机运行时会自动检测内存泄漏。
+
+### LeakCanary介绍
+LeakCanary是Square公司开源的Android内存泄漏检测库，它能够：
+- **自动检测**：无需手动触发，自动监控Activity、Fragment等组件的生命周期
+- **详细报告**：提供完整的引用链路径，帮助定位泄漏源头
+- **实时通知**：发现泄漏时立即在控制台输出详细信息
+
+如果发现内存泄漏，在HBuilderX控制台中会显示内存泄漏信息，包括详细的引用链分析日志。
+
+![img](https://web-ext-storage.dcloud.net.cn/doc/hx/leak_hx.png)
+
+## 如何解决内存泄漏问题
+
+### 日志结构解析
+
+LeakCanary输出的内存泄漏日志包含以下关键信息：
+
+#### 头部信息
+```
+[retained bytes] bytes retained by leaking objects
+```
+- **retained bytes**：泄漏对象占用的内存大小
+
+#### 引用链分析
+```
+┬───
+│ GC Root: Input or output parameters in native code
+│
+├─ [引用链节点]
+│    Leaking: YES/NO (原因说明)
+│    ↓ 引用字段名
+╰→ [最终泄漏对象]
+     Leaking: YES (泄漏原因)
+```
+
+### 关键字段含义
+- **GC Root**：垃圾回收的根节点
+- **Leaking: YES/NO**：该对象是否泄漏
+- **↓**：引用方向，表示从上一个对象指向下一个对象
+- **Retaining X kB in Y objects**：该对象持有的内存和对象数量
+- **mDestroyed = true**：Activity已被销毁但仍被引用
+
+### 泄漏日志分析技巧
+
+在分析内存泄漏日志时，可以运用以下技巧快速定位问题：
+
+- **关注包名定位泄漏源**：
+  - **UTS插件泄漏**：如果引用链中出现 `uts.sdk.modules` 开头的包名，通常表示泄漏发生在某个UTS插件中。应重点排查该插件的静态变量、全局集合或未注销的监听器。
+  - **uvue页面泄漏**：如果引用链中出现 `uni.${appid}`（如 `uni.UNI511CEBA`）开头的类名，这通常指向一个uvue页面。泄漏很可能与该页面的全局变量、`data`中被外部引用的数据或未在 `onUnload` 生命周期中清理的资源有关。
+
+- **识别关键引用字段**：
+  - LeakCanary日志中带有下划波浪线（`~`）的变量（例如 `↓ static IndexKt.leakActivitys` 下的 `~~~~~~~~~~~~~`）是核心线索。它明确指出了是哪个字段持有了对下一个对象的引用。沿着这些带波浪线的字段追溯，就能完整地理解整个引用链，找到泄漏的根源。
+
+## 内存泄漏问题案例分析
+
+### 案例1：UTS插件静态变量持有Activity引用
+
+#### 问题代码
+```js
+//UTS插件中
+import Activity from "android.app.Activity";
+
+const leakActivitys: Activity[] = []  // 应用级全局变量
+
+export function leakActivity() {
+    const topActivity = UTSAndroid.getTopPageActivity()
+    if (topActivity != null) {
+        leakActivitys.push(topActivity)
+    }
+}
+```
+
+#### 页面调用
+```js
+import { leakActivity } from "@/uni_modules/leak-leakcanary"
+
+onReady(() => {
+    leakActivity()
+})
+```
+
+#### 泄漏日志分析
+```
+┬───
+│ GC Root: Input or output parameters in native code
+│
+├─ dalvik.system.PathClassLoader instance
+│    Leaking: NO (IndexKt↓ is not leaking and A ClassLoader is never leaking)
+│    ↓ ClassLoader.runtimeInternalObjects
+├─ java.lang.Object[] array
+│    Leaking: NO (IndexKt↓ is not leaking)
+│    ↓ Object[890]
+├─ uts.sdk.modules.leakLeakcanary.IndexKt class  // UTS插件类
+│    Leaking: NO (a class is never leaking)
+│    ↓ static IndexKt.leakActivitys               // 问题根源：静态变量
+│                     ~~~~~~~~~~~~~
+├─ io.dcloud.uts.UTSArray instance               // UTS数组
+│    Leaking: UNKNOWN
+│    Retaining 212.3 kB in 3987 objects
+│    ↓ ArrayList.elementData
+│                ~~~~~~~~~~~
+├─ java.lang.Object[] array
+│    Leaking: UNKNOWN
+│    Retaining 212.3 kB in 3986 objects
+│    ↓ Object[0]
+│            ~~~
+╰→ io.dcloud.uniapp.appframe.activity.UniPortraitPageActivity instance
+     Leaking: YES (ObjectWatcher was watching this because io.dcloud.uniapp.appframe.activity.UniPortraitPageActivity
+     received Activity#onDestroy() callback and Activity#mDestroyed is true)  // Activity已销毁但仍被引用
+     Retaining 52.9 kB in 994 objects
+     key = 2abb5312-246c-4978-8f88-fd1a4aad7403
+     watchDurationMillis = 12084
+     retainedDurationMillis = 7084
+```
+
+#### 泄漏原因分析
+1. **静态变量持有引用**：`static IndexKt.leakActivitys` 是静态变量，生命周期与应用相同
+2. **Activity已销毁**：`Activity#mDestroyed is true` 表明Activity已经调用了onDestroy()
+3. **引用链完整**：从GC Root → 类加载器 → UTS插件类 → 静态数组 → Activity
+4. **内存占用**：泄漏的Activity持有52.9 kB内存和994个对象
+
+#### 解决方案
+```js
+import Activity from "android.app.Activity";
+
+const leakActivitys: Activity[] = [] // 应用级全局变量
+
+export function leakActivity() {
+    const topActivity = UTSAndroid.getTopPageActivity()
+    if (topActivity != null) {
+        leakActivitys.push(topActivity)
+    }
+}
+
+// 添加清理方法 - 移除特定Activity
+export function removeActivity(activity: Activity) {
+    const index = leakActivitys.indexOf(activity)
+    if (index > -1) {
+        leakActivitys.splice(index, 1)
+    }
+}
+
+// 页面销毁时移除当前Activity
+export function removeCurrentActivity() {
+    const topActivity = UTSAndroid.getTopPageActivity()
+    if (topActivity != null) {
+        removeActivity(topActivity)
+    }
+}
+```
+
+**页面中正确使用：**
+```js
+import { leakActivity, removeCurrentActivity } from "@/uni_modules/leak-leakcanary"
+
+onReady(() => {
+    leakActivity()
+})
+
+onUnload(() => {
+    // 页面销毁时清理引用
+    removeCurrentActivity()
+})
+```
+
+### 案例2：全局变量持有UniElement引用
+
+#### 问题代码
+```js
+//uvue中
+let globalElement: UniElement[] = [] // 应用级全局变量
+const element = ref<UniElement | null>(null)
+
+onReady(() => {
+    element.value = uni.getElementById("xx")
+    const currentElement = element.value
+    if (currentElement != null) {
+        globalElement.push(currentElement)
+    }
+})
+```
+
+#### 泄漏日志分析
+```
+┬───
+│ GC Root: Input or output parameters in native code
+│
+├─ dalvik.system.PathClassLoader instance
+│    Leaking: NO (IndexKt↓ is not leaking and a ClassLoader is never leaking)
+│    ↓ ClassLoader.runtimeInternalObjects
+├─ java.lang.Object[] array
+│    Leaking: NO (IndexKt↓ is not leaking)
+│    ↓ Object[1658]
+├─ uni.UNI511CEBA.IndexKt class               // 页面编译后的类
+│    Leaking: NO (a class is never leaking)
+│    ↓ static IndexKt.globalElement           // 问题：全局变量持有元素
+│                     ~~~~~~~~~~~~~
+├─ io.dcloud.uts.UTSArray instance
+│    Leaking: UNKNOWN
+│    Retaining 632.6 kB in 10655 objects     // 大量内存被占用
+│    ↓ ArrayList.elementData
+│                ~~~~~~~~~~~
+├─ java.lang.Object[] array
+│    Leaking: UNKNOWN
+│    Retaining 632.5 kB in 10654 objects
+│    ↓ Object[0]
+│            ~~~
+├─ io.dcloud.uniapp.runtime.UniTextElementImpl instance  // UniElement实例
+│    Leaking: UNKNOWN
+│    Retaining 105.6 kB in 1778 objects
+│    ↓ PropsNode.pageNode                     // 元素持有页面节点
+│                ~~~~~~~~
+├─ io.dcloud.uniapp.dom.node.PageNode instance
+│    Leaking: UNKNOWN
+│    Retaining 102.9 kB in 1712 objects
+│    ↓ PageNode.frameView                     // 页面节点持有框架视图
+│               ~~~~~~~~~
+├─ io.dcloud.uniapp.appframe.ui.PageFrameView instance
+│    Leaking: YES (View.mContext references a destroyed activity)  // 视图持有已销毁的Activity
+│    Retaining 2.1 kB in 42 objects
+│    View not part of a window view hierarchy
+│    View.mAttachInfo is null (view detached)
+│    View.mID = R.id.null
+│    View.mWindowAttachCount = 1
+│    mContext instance of io.dcloud.uniapp.appframe.activity.UniPortraitPageActivity with mDestroyed = true
+│    ↓ View.mContext
+╰→ io.dcloud.uniapp.appframe.activity.UniPortraitPageActivity instance
+     Leaking: YES (ObjectWatcher was watching this because io.dcloud.uniapp.appframe.activity.UniPortraitPageActivity
+     received Activity#onDestroy() callback and Activity#mDestroyed is true)
+     Retaining 48.3 kB in 971 objects
+```
+
+#### 泄漏原因分析
+1. **全局变量持有UI元素**：`static IndexKt.globalElement` 全局数组持有UniElement
+2. **UI元素持有页面引用**：UniElement → PageNode → PageFrameView → Activity
+3. **视图与Activity绑定**：`View.mContext references a destroyed activity`
+4. **引用链路径**：全局数组 → UI元素 → 页面视图 → 已销毁的Activity
+
+#### 解决方案
+```js
+let globalElement: UniElement[] = [] // 应用级全局变量
+const element = ref<UniElement | null>(null)
+
+onReady(() => {
+    element.value = uni.getElementById("xx")
+    const currentElement = element.value
+    if (currentElement != null) {
+        globalElement.push(currentElement)
+    }
+})
+
+onUnload(() => {
+    // 页面销毁时移除特定元素引用
+    const currentElement = element.value
+    if (currentElement != null) {
+        const index = globalElement.indexOf(currentElement)
+        if (index > -1) {
+            globalElement.splice(index, 1)
+        }
+        element.value = null
+    }
+})
+```
+
+### 案例3：响应式数据（Vue data）被全局引用
+
+#### 问题代码
+```js
+let globalElement: UniElement[][] = [] // 应用级全局变量
+export default {
+    data() {
+        return {
+            elements: [] as UniElement[]  // Vue响应式数组
+        }
+    },
+    onReady(){
+        const element1 = uni.getElementById("xx")
+        const element2 = uni.getElementById("yy")
+        
+        if (element1 != null) {
+            this.elements.push(element1)
+        }
+        if (element2 != null) {
+            this.elements.push(element2)
+        }
+        globalElement.push(this.elements)  // 将响应式数组推入全局数组
+    },
+    methods: {}
+}
+```
+
+#### 泄漏日志分析
+```
+┬───
+│ GC Root: Input or output parameters in native code
+│
+├─ dalvik.system.PathClassLoader instance
+│    Leaking: NO (IndexKt↓ is not leaking and A ClassLoader is never leaking)
+│    ↓ ClassLoader.runtimeInternalObjects
+├─ java.lang.Object[] array
+│    Leaking: NO (IndexKt↓ is not leaking)
+│    ↓ Object[2146]
+├─ uni.UNI511CEBA.IndexKt class
+│    Leaking: NO (a class is never leaking)
+│    ↓ static IndexKt.globalElement           // 全局变量
+│                     ~~~~~~~~~~~~~
+├─ io.dcloud.uts.UTSArray instance
+│    Leaking: UNKNOWN
+│    Retaining 541.6 kB in 9236 objects
+│    ↓ ArrayList.elementData
+│                ~~~~~~~~~~~
+├─ java.lang.Object[] array
+│    Leaking: UNKNOWN
+│    Retaining 541.5 kB in 9235 objects
+│    ↓ Object[0]
+│            ~~~
+├─ io.dcloud.uniapp.vue.UTSReactiveArray instance  // 关键：Vue响应式数组
+│    Leaking: UNKNOWN
+│    Retaining 108.1 kB in 1844 objects
+│    ↓ UTSReactiveArray.__v_raw               // 响应式数组的原始数据
+│                       ~~~~~~~
+├─ io.dcloud.uts.UTSArray instance            // 原始数组
+│    Leaking: UNKNOWN
+│    Retaining 108.1 kB in 1843 objects
+│    ↓ ArrayList.elementData
+│                ~~~~~~~~~~~
+├─ java.lang.Object[] array
+│    Leaking: UNKNOWN
+│    Retaining 108.1 kB in 1842 objects
+│    ↓ Object[0]
+│            ~~~
+├─ io.dcloud.uniapp.runtime.UniTextElementImpl instance
+│    Leaking: UNKNOWN
+│    Retaining 2.7 kB in 66 objects
+│    ↓ PropsNode.pageNode
+│                ~~~~~~~~
+├─ io.dcloud.uniapp.dom.node.PageNode instance
+│    Leaking: UNKNOWN
+│    Retaining 102.6 kB in 1709 objects
+│    ↓ PageNode.frameView
+│               ~~~~~~~~~
+├─ io.dcloud.uniapp.appframe.ui.PageFrameView instance
+│    Leaking: YES (View.mContext references a destroyed activity)
+│    Retaining 2.0 kB in 41 objects
+│    View not part of a window view hierarchy
+│    View.mAttachInfo is null (view detached)
+│    View.mID = R.id.null
+│    View.mWindowAttachCount = 1
+│    mContext instance of io.dcloud.uniapp.appframe.activity.UniPortraitPageActivity with mDestroyed = true
+│    ↓ View.mContext
+╰→ io.dcloud.uniapp.appframe.activity.UniPortraitPageActivity instance
+     Leaking: YES (ObjectWatcher was watching this because io.dcloud.uniapp.appframe.activity.UniPortraitPageActivity
+     received Activity#onDestroy() callback and Activity#mDestroyed is true)
+     Retaining 48.1 kB in 969 objects
+```
+
+#### 泄漏原因分析
+1. **响应式数组被全局引用**：`UTSReactiveArray` 是Vue的响应式数组
+2. **双重引用结构**：响应式数组包含原始数组（`__v_raw`），形成双重持有
+3. **复杂引用链**：全局数组 → 响应式数组 → 原始数组 → UI元素 → Activity
+4. **Vue内部机制**：响应式数组内部持有原始数据的引用，增加了泄漏风险
+
+#### 解决方案
+```js
+let globalElement: UniElement[][] = [] // 应用级全局变量
+export default {
+    data() {
+        return {
+            elements: [] as UniElement[]
+        }
+    },
+    onReady(){
+        const element1 = uni.getElementById("xx")
+        const element2 = uni.getElementById("yy")
+        
+        if (element1 != null) {
+            this.elements.push(element1)
+        }
+        if (element2 != null) {
+            this.elements.push(element2)
+        }
+        // 避免直接推入响应式数组，使用副本
+        globalElement.push([...this.elements])
+    },
+    onUnload() {
+        // 找到并移除当前页面的elements数组
+        const index = globalElement.indexOf(this.elements)
+        if (index > -1) {
+            globalElement.splice(index, 1)
+        }
+        // 清空当前页面的elements数组
+        this.elements.splice(0, this.elements.length)
+    },
+    methods: {}
+}
+```
+
+### 案例4：全局监听回调持有页面`this`引用
+
+#### 问题代码
+```javascript
+//uvue中
+export default {
+    data() {
+        return {}
+    },
+    onReady() {
+        // 注册一个全局应用主题变化监听器
+        // 回调函数隐式地捕获了当前页面的`this`实例
+        uni.onAppThemeChange(()=>{
+            console.log("Theme changed, page this:", this);
+        })
+    },
+    methods: {}
+}
+```
+
+#### 泄漏日志分析
+```
+┬───
+│ GC Root: Thread object
+│
+├─ android.os.HandlerThread instance
+│    Leaking: NO (PathClassLoader↓ is not leaking)
+│    Thread name: 'LeakCanary-Heap-Dump'
+│    ↓ Thread.contextClassLoader
+├─ dalvik.system.PathClassLoader instance
+│    Leaking: NO (UniAppThemeManager↓ is not leaking and A ClassLoader is never leaking)
+│    ↓ ClassLoader.runtimeInternalObjects
+├─ java.lang.Object[] array
+│    Leaking: NO (UniAppThemeManager↓ is not leaking)
+│    ↓ Object[753]
+├─ io.dcloud.uniapp.appframe.UniAppThemeManager class
+│    Leaking: NO (a class is never leaking)
+│    ↓ static UniAppThemeManager.appThemeChangeListeners  // 问题根源：静态的监听器集合
+│                                ~~~~~~~~~~~~~~~~~~~~~~~
+├─ java.util.concurrent.ConcurrentHashMap instance
+│    Leaking: UNKNOWN
+│    Retaining 333.6 kB in 5195 objects
+│    ↓ ConcurrentHashMap[instance @322967640 of java.lang.Integer]
+│                       ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+├─ uts.sdk.modules.DCloudUniTheme.IndexKt$onAppThemeChange$1$1 instance
+│    Leaking: UNKNOWN
+│    Retaining 111.0 kB in 1727 objects
+│    Anonymous subclass of kotlin.jvm.internal.Lambda
+│    ↓ IndexKt$onAppThemeChange$1$1.$callback
+│                                   ~~~~~~~~~
+├─ uni.UNI511CEBA.GenPagesFourthFourth$1$1 instance // 页面生成的回调函数实例
+│    Leaking: UNKNOWN
+│    Retaining 111.0 kB in 1726 objects
+│    Anonymous subclass of kotlin.jvm.internal.Lambda
+│    ↓ GenPagesFourthFourth$1$1.this$0  // 关键：回调函数持有页面的`this`引用
+│                               ~~~~~~
+├─ uni.UNI511CEBA.GenPagesFourthFourth instance // 页面实例
+│    Leaking: UNKNOWN
+│    Retaining 111.0 kB in 1725 objects
+│    ↓ Page.$nativePage
+│           ~~~~~~~~~~~
+├─ io.dcloud.uniapp.appframe.UniNativePageImpl instance
+│    Leaking: UNKNOWN
+│    Retaining 764 B in 23 objects
+│    ↓ UniNativePageImpl.container
+│                        ~~~~~~~~~
+├─ io.dcloud.uniapp.appframe.ui.PageFrameView instance
+│    Leaking: YES (View.mContext references a destroyed activity)
+│    ↓ View.mContext
+╰→ io.dcloud.uniapp.appframe.activity.UniPortraitPageActivity instance
+​     Leaking: YES (ObjectWatcher was watching this because io.dcloud.uniapp.appframe.activity.UniPortraitPageActivity received Activity#onDestroy() callback and Activity#mDestroyed is true)
+```
+
+#### 泄漏原因分析
+1.  **静态监听器集合**：`uni.onAppThemeChange` 将回调函数存储在一个静态的、全局的 `UniAppThemeManager.appThemeChangeListeners` 集合中。这个集合的生命周期与整个应用相同。
+2.  **回调函数捕获`this`**：日志中的 `GenPagesFourthFourth$1$1.this$0` 字段明确指出，传递给监听器的回调函数（Lambda）捕获了其所在的页面实例的 `this` 引用。
+3.  **形成强引用链**：一条无法被打破的强引用链形成：`静态管理器` → `静态监听器集合` → `回调函数实例` → `页面实例(this)` → `Activity`。
+4.  **页面无法释放**：当页面关闭并销毁时，由于这个全局的引用链依然存在，垃圾回收器无法回收页面实例及其关联的Activity，导致内存泄漏。
+
+#### 解决方案
+对于这种基于回调的监听器，必须在页面销毁时手动注销监听，切断引用链。
+
+```javascript
+export default {
+    data() {
+        return {
+            callbackId: -1
+        }
+    },
+    onReady() {
+        // 注册监听
+        this.callbackId = uni.onAppThemeChange(() => {
+            console.log("Theme changed, page this:", this);
+        })
+    },
+    onUnload() {
+        // 页面销毁时，必须注销监听
+        uni.offAppThemeChange(this.callbackId)
+    },
+    methods: {}
+}
+```
+
+## 内存泄漏问题实践总结
+
+### 1. 识别泄漏模式
+通过日志关键信息快速识别泄漏类型：
+- 看到 `static` 字段：静态变量泄漏
+- 看到 `UTSReactiveArray`：Vue响应式数据泄漏
+
+### 2. 生命周期管理
+- **onReady** 中添加的引用在 **onUnload** 中移除
+
+### 3. 避免常见陷阱
+- 不在全局变量中直接持有UI元素或Activity
+- 注意Vue响应式数据的特殊性，避免将其推入全局集合
+- 及时清理监听器、定时器等长生命周期资源

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

@@ -0,0 +1,80 @@
+# 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/uniappx/tutorial/app-market.md

@@ -0,0 +1,51 @@
+## 应用市场上架注意事项
+
+应用（或称“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)