tmui-cli 2.0.3 → 2.0.5

package/data/uniappx/native/permission/android_permission_adapter.md

@@ -0,0 +1,62 @@
+## Android端权限适配
+
+由于历史原因，Android端在不同版本下权限的配置较为复杂，所以归纳出常用的权限以示说明。附：[Android端权限配置](https://uniapp.dcloud.net.cn/tutorial/app-nativeresource-android.html#permissions)
+
+### 相册权限
+
+- 19-23版本（指API Level，下同）
+  - 只需要`AndroidManifest.xml`内注册`READ_EXTERNAL_STORAGE`权限，就可以访问相册。
+- 23-29 
+  - `READ_EXTERNAL_STORAGE`为敏感权限，所以需要动态申请权限。
+- 29-33 
+  - 通过`Media Store Api`访问相册
+    - 访问自己App添加的相册不需要任何权限，
+    - 访问其他App的照片需要动态申请`READ_EXTERNAL_STORAGE`权限
+- 33
+  - 细化相册权限，废弃`READ_EXTERNAL_STORAGE`，新增`READ_MEDIA_IMAGES`、`READ_MEDIA_VIDEO`、`READ_MEDIA_AUDIO`
+- 34
+  - 新增`READ_MEDIA_VISUAL_USER_SELECTED`
+
+总结一下，把需要的权限全部添加进来以适配各个版本，如下：
+
+```xml
+<manifest xmlns:android="http://schemas.android.com/apk/res/android"
+    xmlns:tools="http://schemas.android.com/tools">
+    <uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE" android:maxSdkVersion="32"/>
+    <uses-permission android:name="android.permission.READ_MEDIA_IMAGES" />
+    <uses-permission android:name="android.permission.READ_MEDIA_VIDEO" />
+    <uses-permission android:name="android.permission.READ_MEDIA_VISUAL_USER_SELECTED"/>
+</manifest>
+```
+
+如果使用了相册相关Api，打包时会自动添加上述权限配置，不需额外配置。
+
+### 蓝牙权限
+
+- 19-23
+  - 只需要`AndroidManifest.xml`内注册`BLUETOOTH`、`BLUETOOTH_ADMIN`权限即可。
+- 23-31
+  - 需要动态申请位置权限`ACCESS_FINE_LOCATION`
+- 31
+  - 不再需要动态申请`ACCESS_FINE_LOCATION`，新增权限`BLUETOOTH_SCAN`、`BLUETOOTH_CONNECT`
+
+综上所述，配置如下：
+
+```xml
+<manifest xmlns:android="http://schemas.android.com/apk/res/android"
+    xmlns:tools="http://schemas.android.com/tools">
+
+    <uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" /> 
+    <uses-permission android:name="android.permission.BLUETOOTH" android:maxSdkVersion="30"/>
+    <uses-permission android:name="android.permission.BLUETOOTH_ADMIN"  android:maxSdkVersion="30"/>
+    <uses-permission android:name="android.permission.BLUETOOTH_SCAN" android:usesPermissionFlags="neverForLocation" />
+    <uses-permission android:name="android.permission.BLUETOOTH_CONNECT" />
+
+</manifest>
+```
+
+使用蓝牙相关功能需配置以上权限，并且动态申请蓝牙权限。
+
+### 注意事项
+
+- 权限要按需配置，如果App中未使用相关功能，务必不要申请相关权限，否则可能导致上架审核问题。

package/data/uniappx/native/use/android.md

@@ -0,0 +1,521 @@
+# uni-app x 原生SDK Android版
+
+## 准备
+
+- HBuilder X （4.18版本及以上）
+- android studio
+
+***
+说明：
+
+**蒸汽模式（Vapor）：**
+
+当前文档基于Android Studio Quail 3 | 2026.1.3。gradle版本为9.2.1。gradle插件版本为9.0.1。kotlin插件版本为2.2.0。
+
+**VDOM模式：**
+
+当前文档基于Android Studio Narwhal 3 Feature Drop | 2025.1.3。gradle版本为8.14.3。gradle插件版本为8.12.0。kotlin插件版本为2.2.0。
+
+更早版本的环境配置请参考[文档](../../tutorial/app-env.md)。
+
+***
+
+## 新建uni-app x模块
+
+点击File->New->New Module...
+
+![](https://web-ext-storage.dcloud.net.cn/native/doc/android/new_uniappx.png)
+
+点击左侧`Templates`的`Android Library`。
+
+`Language`选择`Kotlin`。
+
+`Module name`建议设置为`uniappx`。
+
+点击`Finish`。
+
+**注意**
+- `Language` 一定要选择`Kotlin`。
+- uni-app x 项目最低支持版本：蒸汽模式（Vapor）为23，VDOM模式为21。`Minimum SDK`按要求选择正确的版本。
+- `Build configuration language`建议选择`Groovy DSL(build.gradle)`。以下教程均按照此模式进行。
+
+## 工程配置
+
+### 基础库配置
+
+**蒸汽模式（Vapor）：**
+
+将app-common-release.aar，app-runtime-release.aar，breakpad-build-release.aar，uts-runtime-release.aar，ext-component-release.aar，
+uni-dialogPage-release.aar，uni-event-release.aar，uni-crash-release.aar，uni-getElementById-release.aar，uni-pullDownRefresh-release.aar，
+uni-storage-release.aar，uni-exit-release.aar，uni-theme-release.aar，
+uni-getAppBaseInfo-release.aar，uni-getDeviceInfo-release.aar，uni-getSystemInfo-release.aar，uni-getAccessibilityInfo-release.aar，
+uni-getAppAuthorizeSetting-release.aar，uni-getSystemSetting-release.aar，
+uni-openAppAuthorizeSetting-release.aar，uni-prompt-release.aar，uni-rpx2px-release.aar，uni-secure-network-release.aar共23个aar拷贝到uni-app x模块的libs下，如果没有libs需要手动创建，参考下图：
+
+![](https://web-ext-storage.dcloud.net.cn/native/doc/android/main_libs_vapor_v2.png)
+
+::: details VDOM模式
+
+将uts-runtime-release.aar，android-gif-drawable-1.2.28.aar，app-common-release.aar，app-runtime-release.aar，breakpad-build-release.aar，dcloud-layout-release.aar，
+framework-release.aar，uni-exit-release.aar，uni-getAccessibilityInfo-release.aar，uni-getAppAuthorizeSetting-release.aar，uni-getAppBaseInfo-release.aar，
+uni-getSystemSetting-release.aar，uni-openAppAuthorizeSetting-release.aar，uni-prompt-release.aar，uni-storage-release.aar，uni-getDeviceInfo-release.aar，
+uni-getSystemInfo-release.aar，uni-rpx2px-release.aar，uni-theme-release.aar共19个aar拷贝到uni-app x模块的libs下，如果没有libs需要手动创建，参考下图。
+
+![](https://web-ext-storage.dcloud.net.cn/native/doc/android/main_libs_2.jpg)
+
+### 修改build.gradle
+
+修改uniappx模块下的build.gradle
+
+- 添加依赖
+
+	将下面的依赖信息添加到build.gradle中
+
+	::: preview
+
+	> build.gradle（蒸汽模式）
+
+	```groovy
+    dependencies {
+        implementation fileTree(include: ['*.aar'], dir: './libs')// 复制到主模块中需要将`./libs`替换为`../uniappx/libs`
+        implementation "androidx.tracing:tracing-ktx:1.3.0"
+        implementation "androidx.core:core-ktx:1.10.1"
+        implementation "androidx.appcompat:appcompat:1.6.1"
+        implementation "androidx.constraintlayout:constraintlayout:2.2.1"
+        implementation "androidx.exifinterface:exifinterface:1.3.6"
+        implementation "com.google.android.material:material:1.10.0"
+
+        implementation "org.jetbrains.kotlin:kotlin-reflect:2.2.0"
+        implementation "org.jetbrains.kotlinx:kotlinx-coroutines-core:1.7.3"
+        implementation "org.jetbrains.kotlinx:kotlinx-coroutines-android:1.7.3"
+
+        implementation "com.facebook.fresco:fresco:3.4.0"
+        implementation "com.facebook.fresco:animated-base:3.4.0"
+        implementation "com.facebook.fresco:animated-gif:3.4.0"
+        implementation "com.facebook.fresco:animated-webp:3.4.0"
+        implementation "com.facebook.fresco:webpsupport:3.4.0"
+        implementation "com.facebook.fresco:imagepipeline:3.4.0"
+        implementation "com.facebook.fresco:drawee:3.4.0"
+        implementation "com.facebook.fresco:middleware:3.4.0"
+
+        implementation "com.caverock:androidsvg:1.4"
+        implementation "com.alibaba:fastjson:1.2.83"
+        implementation "com.github.getActivity:XXPermissions:18.63"
+        implementation "androidx.profileinstaller:profileinstaller:1.4.1"
+        implementation "com.squareup.okhttp3:okhttp:3.12.12"
+    }
+	```
+
+	> build.gradle.kts（蒸汽模式）
+
+	```groovy
+    dependencies {
+        implementation(fileTree(mapOf("include" to listOf("*.aar"), "dir" to "./libs")))// 复制到主模块中需要将`./libs`替换为`../uniappx/libs`
+        implementation("androidx.tracing:tracing-ktx:1.3.0")
+        implementation("androidx.core:core-ktx:1.10.1")
+        implementation("androidx.appcompat:appcompat:1.6.1")
+        implementation("androidx.constraintlayout:constraintlayout:2.2.1")
+        implementation("androidx.exifinterface:exifinterface:1.3.6")
+        implementation("com.google.android.material:material:1.10.0")
+
+        implementation("org.jetbrains.kotlin:kotlin-reflect:2.2.0")
+        implementation("org.jetbrains.kotlinx:kotlinx-coroutines-core:1.7.3")
+        implementation("org.jetbrains.kotlinx:kotlinx-coroutines-android:1.7.3")
+
+        implementation("com.facebook.fresco:fresco:3.4.0")
+        implementation("com.facebook.fresco:animated-base:3.4.0")
+        implementation("com.facebook.fresco:animated-gif:3.4.0")
+        implementation("com.facebook.fresco:animated-webp:3.4.0")
+        implementation("com.facebook.fresco:webpsupport:3.4.0")
+        implementation("com.facebook.fresco:imagepipeline:3.4.0")
+        implementation("com.facebook.fresco:drawee:3.4.0")
+        implementation("com.facebook.fresco:middleware:3.4.0")
+
+        implementation("com.caverock:androidsvg:1.4")
+        implementation("com.alibaba:fastjson:1.2.83")
+        implementation("com.github.getActivity:XXPermissions:18.63")
+        implementation("androidx.profileinstaller:profileinstaller:1.4.1")
+        implementation("com.squareup.okhttp3:okhttp:3.12.12")
+    }
+	```
+
+	> build.gradle（VDOM模式）
+
+	```groovy
+	dependencies {
+		implementation fileTree(include: ['*.aar'], dir: './libs') // 复制到主模块中需要将`./libs`替换为`../uniappx/libs`
+		implementation "androidx.core:core-ktx:1.10.1"
+		implementation "androidx.recyclerview:recyclerview:1.3.2"
+		implementation "androidx.appcompat:appcompat:1.0.0"
+		implementation "androidx.exifinterface:exifinterface:1.3.6"
+		implementation "androidx.localbroadcastmanager:localbroadcastmanager:1.0.0@aar"
+		implementation "androidx.constraintlayout:constraintlayout:2.1.4"
+		implementation "androidx.webkit:webkit:1.6.0"
+		implementation "com.google.android.material:material:1.4.0"
+		implementation "androidx.viewpager2:viewpager2:1.1.0-beta02"
+		implementation "com.alibaba:fastjson:1.2.83"
+		implementation "com.facebook.fresco:fresco:3.4.0"
+		implementation "com.facebook.fresco:middleware:3.4.0"
+		implementation "com.facebook.fresco:animated-gif:3.4.0"
+		implementation "com.facebook.fresco:webpsupport:3.4.0"
+		implementation "com.facebook.fresco:animated-webp:3.4.0"
+		implementation "com.caverock:androidsvg:1.4"
+		implementation "com.github.bumptech.glide:glide:4.9.0"
+		implementation "org.jetbrains.kotlinx:kotlinx-coroutines-core:1.6.4"
+		implementation "org.jetbrains.kotlinx:kotlinx-coroutines-android:1.6.4"
+		implementation "org.jetbrains.kotlin:kotlin-stdlib:2.2.0"
+		implementation "org.jetbrains.kotlin:kotlin-reflect:2.2.0"
+		implementation "org.jetbrains.kotlinx:kotlinx-serialization-json:1.4.1"
+		implementation "com.squareup.okhttp3:okhttp:3.12.12"
+		implementation "com.github.getActivity:XXPermissions:18.63"
+		implementation "net.lingala.zip4j:zip4j:2.11.5"
+	}
+	```
+
+	> build.gradle.kts（VDOM模式）
+
+	```groovy
+	dependencies {
+		implementation(fileTree(mapOf("dir" to "libs", "include" to listOf("*.aar")))) // 复制到主模块中需要将`./libs`替换为`../uniappx/libs`
+		implementation("androidx.core:core-ktx:1.10.1")
+		implementation("androidx.recyclerview:recyclerview:1.3.2")
+		implementation("androidx.appcompat:appcompat:1.0.0")
+		implementation("androidx.exifinterface:exifinterface:1.3.6")
+		implementation("androidx.localbroadcastmanager:localbroadcastmanager:1.0.0")
+		implementation("androidx.constraintlayout:constraintlayout:2.1.4")
+		implementation("androidx.webkit:webkit:1.6.0")
+		implementation("com.google.android.material:material:1.4.0")
+		implementation("androidx.viewpager2:viewpager2:1.1.0-beta02")
+		implementation("com.alibaba:fastjson:1.2.83")
+		implementation("com.facebook.fresco:fresco:3.4.0")
+		implementation("com.facebook.fresco:middleware:3.4.0")
+		implementation("com.facebook.fresco:animated-gif:3.4.0")
+		implementation("com.facebook.fresco:webpsupport:3.4.0")
+		implementation("com.facebook.fresco:animated-webp:3.4.0")
+		implementation("com.caverock:androidsvg:1.4")
+		implementation("com.github.bumptech.glide:glide:4.9.0")
+		implementation("org.jetbrains.kotlinx:kotlinx-coroutines-core:1.6.4")
+		implementation("org.jetbrains.kotlinx:kotlinx-coroutines-android:1.6.4")
+		implementation("org.jetbrains.kotlin:kotlin-stdlib:2.2.0")
+		implementation("org.jetbrains.kotlin:kotlin-reflect:2.2.0")
+		implementation("org.jetbrains.kotlinx:kotlinx-serialization-json:1.4.1")
+		implementation("com.squareup.okhttp3:okhttp:3.12.12")
+		implementation("com.github.getActivity:XXPermissions:18.63")
+		implementation("net.lingala.zip4j:zip4j:2.11.5")
+	}
+	```
+
+- 添加配置
+
+	将配置添加到android节点下，其中`androidResources`和`packagingOptions`为蒸汽模式（Vapor）特有配置。
+
+	::: preview
+
+	> build.gradle（蒸汽模式）
+
+	```groovy
+    androidResources {
+        noCompress "uni-app-x-framework-vapor", "uni-app-x-framework-vapor-dev", "js"
+        ignoreAssetsPattern '!.svn:!.git:.*:!CVS:!thumbs.db:!picasa.ini:!*.scc:*~'
+    }
+
+    aaptOptions {
+        additionalParameters '--auto-add-overlay'
+        ignoreAssetsPattern '!.svn:!.git:.*:!CVS:!thumbs.db:!picasa.ini:!*.scc:*~'
+
+    }
+    packagingOptions {
+        pickFirst 'lib/*/libstlport_shared.so'
+        pickFirst 'lib/*/libc++_shared.so'
+
+        jniLibs {
+            useLegacyPackaging false
+        }
+    }
+	```
+
+	> build.gradle.kts（蒸汽模式）
+
+	```groovy
+    androidResources {
+        noCompress += listOf("uni-app-x-framework-vapor", "uni-app-x-framework-vapor-dev", "js")
+        ignoreAssetsPattern = "!.svn:!.git:.*:!CVS:!thumbs.db:!picasa.ini:!*.scc:*~"
+    }
+
+    aaptOptions {
+        additionalParameters("--auto-add-overlay")
+        ignoreAssetsPattern = "!.svn:!.git:.*:!CVS:!thumbs.db:!picasa.ini:!*.scc:*~"
+    }
+
+    packagingOptions {
+        pickFirst("lib/*/libstlport_shared.so")
+        pickFirst("lib/*/libc++_shared.so")
+
+        jniLibs {
+            useLegacyPackaging = false
+        }
+    }
+	```
+
+	> build.gradle（VDOM模式）
+
+	```groovy
+	aaptOptions {
+		additionalParameters '--auto-add-overlay'
+		ignoreAssetsPattern '!.svn:!.git:.*:!CVS:!thumbs.db:!picasa.ini:!*.scc:*~'
+	}
+	```
+
+	> build.gradle.kts（VDOM模式）
+
+	```groovy
+	androidResources {
+		additionalParameters += listOf("--auto-add-overlay")
+		ignoreAssetsPattern = "!.svn:!.git:.*:!CVS:!thumbs.db:!picasa.ini:!*.scc:*~"
+	}
+	```
+
+- 配置Java版本
+
+	::: warning 注意
+	仅蒸汽模式（Vapor）需要配置Java版本为17
+
+	```groovy
+    compileOptions {
+        sourceCompatibility JavaVersion.VERSION_17
+        targetCompatibility JavaVersion.VERSION_17
+    }
+	```
+
+***注意：上面的gradle配置需要同时设置到主模块中。***
+
+### 配置gradle插件 @gradleplugin
+
+在项目根目录的build.gradle的顶部添加gradle插件的依赖。参考：
+
+```groovy
+buildscript {
+    dependencies {
+		...
+        classpath(files('../plugins/uts-kotlin-compiler-plugin-0.0.1.jar'))
+        classpath(files('../plugins/uts-kotlin-gradle-plugin-0.0.1.jar'))
+        classpath(files('../plugins/auto-register-gradle-plugin-1.0.0.jar')) // 仅蒸汽模式（Vapor）支持
+    }
+}
+```
+
+**注意：文件uts-kotlin-compiler-plugin-0.0.1.jar、uts-kotlin-gradle-plugin-0.0.1.jar和auto-register-gradle-plugin-1.0.0.jar等jar位于原生SDK中，示例中放到了项目根目录的`plugins`文件夹下。参考：**
+
+![](https://web-ext-storage.dcloud.net.cn/native/doc/android/gradle_plugins_vapor.png)
+
+然后在`uniappx`模块的build.gradle下添加插件`io.dcloud.uts.kotlin`的依赖。参考：
+
+::: preview
+
+> build.gradle
+
+```groovy
+plugins {
+	...
+    id 'io.dcloud.uts.kotlin'
+    id 'io.dcloud.uts.auto-register' // 仅蒸汽模式（Vapor）支持
+}
+```
+
+> build.gradle.kts
+
+```groovy
+plugins {
+	...
+    id("io.dcloud.uts.kotlin")
+    id("io.dcloud.uts.auto-register") // 仅蒸汽模式（Vapor）支持
+}
+```
+
+### 修改项目的settings.gradle
+
+在项目根路径下的settings.gradle中添加`jitpack`的maven的仓库地址和本地gradle插件的路径配置。参考如下：
+
+```groovy
+dependencyResolutionManagement {
+    repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS)
+    repositories {
+        ...
+        maven { url = uri("https://jitpack.io") }
+		flatDir { dirs('./plugins/') }
+    }
+}
+```
+
+### 修改项目的gradle.properties
+
+在项目根路径下的gradle.properties中追加如下内容
+
+```groovy
+android.useAndroidX=true
+android.enableJetifier=true
+```
+
+### 修改uniappx模块下的AndroidManifest.xml @androidmanifest
+
+- 添加activity
+
+	将下面内容拷贝到application节点下
+
+	::: preview
+
+	> AndroidManifest.xml（Vapor）
+
+	```xml
+        <activity
+            android:name="io.dcloud.uniappxv.UniAppActivity"
+            android:configChanges="orientation|keyboardHidden|screenSize|mcc|mnc|fontScale|keyboard|smallestScreenSize|screenLayout|uiMode"
+            android:exported="true"
+            android:label="@string/app_name"
+            android:theme="@style/Theme.AppCompat.DayNight.NoActionBar"
+            android:windowSoftInputMode="adjustResize"
+            tools:replace="android:label,android:exported,android:theme,android:configChanges,android:windowSoftInputMode" />
+	```
+
+	> AndroidManifest.xml（VDOM）
+
+	```xml
+        <activity
+            android:name="io.dcloud.uniapp.UniAppActivity"
+            android:configChanges="orientation|keyboard|keyboardHidden|smallestScreenSize|screenLayout|screenSize|mcc|mnc|fontScale|navigation|uiMode"
+            android:exported="true"
+            android:label="@string/app_name"
+            android:screenOrientation="portrait"
+            android:theme="@style/UniAppX.Activity.DefaultTheme"
+            android:windowSoftInputMode="adjustResize"
+            tools:replace="android:label,android:exported,android:theme,android:configChanges,android:windowSoftInputMode,android:screenOrientation">
+        </activity>
+	```
+
+- 添加appid
+
+	在application节点下添加`DCLOUD_UNI_APPID`节点
+	```xml
+	<meta-data
+		android:name="DCLOUD_UNI_APPID" android:value="替换成应用的appid" />
+	```
+
+- 修改application
+
+	将`application`节点的`android:name`修改为`io.dcloud.uniapp.UniApplication`
+
+	**注意：如果需要自定义application，必须继承自UniApplication**
+
+- 配置应用分发渠道
+
+	在application节点下添加`DCLOUD_CHANNEL`节点
+	```xml
+	<meta-data
+		android:name="DCLOUD_CHANNEL" android:value="替换成需要发布的应用分发渠道" />
+	```
+
+	获取配置的应用分发渠道，可以通过[uni.getAppBaseInfo()](../../api/get-app-base-info.md)。
+
+- 合并AndroidManifest.xml
+
+	如果uni-app x项目根目录下有AndroidManifest.xml文件，你需要按照xml文件的结构将内容拷贝到`uniappx`模块的AndroidManifest.xml中。
+
+### 拷贝资源文件
+1. 导出uni-app x项目的资源文件
+
+	选择项目，然后点击：发行 -> 原生App-本地打包 -> 生成本地打包App资源
+
+	![](https://web-ext-storage.dcloud.net.cn/native/doc/android/export.png)
+
+	导出成功之后会在项目的unpackage/resources目录下生成资源文件
+
+	![](https://web-ext-storage.dcloud.net.cn/native/doc/android/resources.png)
+
+2. 将app-android目录下与appid对应的目录拷贝到uniappx项目的`assets/apps`目录下
+
+	![](https://web-ext-storage.dcloud.net.cn/native/doc/android/app_assets_2.png)
+
+	**注意：apps下的appid必须与AndroidManifest.xml的`DCLOUD_UNI_APPID`保持一致。**
+
+### 拷贝kt文件
+
+::: warning 注意
+仅VDOM模式支持，蒸汽模式（Vapor）无需配置。
+
+需要将`unpackage/resource/app-android/uniappx/app-android/src/`目录下的所有文件拷贝到uniappx项目的`src/main/java`下
+
+![](https://web-ext-storage.dcloud.net.cn/native/doc/android/copykt.png)
+
+注意：不要破坏原有src下的目录结构。
+
+### 添加到主模块
+
+将uni-app x模块添加到主模块中。
+
+::: preview
+
+> build.gradle
+
+```groovy
+	dependencies {
+		implementation project(':uniappx')
+		implementation fileTree(include: ['*.aar'], dir: '../uniappx/libs')
+	}
+```
+
+> build.gradle.kts
+
+```groovy
+	dependencies {
+		implementation(project(":uniappx"))
+		implementation(fileTree(mapOf("dir" to "../uniappx/libs", "include" to listOf("*.aar"))))
+	}
+```
+
+## 配置内置模块@configmodules
+
+根据`unpackage/resource/{appid}/manifest.json`的配置，添加[内置模块的配置](../modules/android/others.md)。
+
+## uts插件配置
+
+uts插件资源位于`unpackage/resource/app-android/uni_modules`下。如果uni_modules下存在uts插件，需要按照[uts插件配置文档](./androiduts.md)将插件集成到项目中。
+
+**蒸汽模式（Vapor）：**
+
+以下模块可以忽略配置：
+- uni-exit
+- uni-getAccessibilityInfo
+- uni-getAppAuthorizeSetting
+- uni-getAppBaseInfo
+- uni-getDeviceInfo
+- uni-getSystemInfo
+- uni-getSystemSetting
+- uni-openAppAuthorizeSetting
+- uni-prompt
+- uni-storage
+- uni-rpx2px
+- uni-theme
+- uni-dialogPage
+- uni-event
+- uni-getElementById
+- uni-pullDownRefresh
+
+::: details VDOM模式
+
+以下模块可以忽略配置：
+- uni-exit
+- uni-getAccessibilityInfo
+- uni-getAppAuthorizeSetting
+- uni-getAppBaseInfo
+- uni-getDeviceInfo
+- uni-getSystemInfo
+- uni-getSystemSetting
+- uni-openAppAuthorizeSetting
+- uni-prompt
+- uni-storage
+- uni-rpx2px
+- uni-theme
+
+## 启动
+
+至此，uni-app x 导入原生项目的所有配置已经完成。uni-app x的启动、退出及运行期间通讯可以参考[文档](androidcomm.md)。

package/data/uniappx/native/use/androidcomm.md

@@ -0,0 +1,104 @@
+## 启动
+
+需要在打开uni-app x的地方添加如下代码，触发逻辑即可打开uni-app x。
+
+```kotlin
+startActivity(Intent(this, UniAppActivity::class.java))
+```
+
+连接手机，点击运行按钮，可以在手机上查看效果。
+
+![avatar](https://img.cdn.aliyun.dcloud.net.cn/nativedocs/5%2BSDK-android/image/7-6.png)
+
+## 通信
+
+### 广播方式
+
+实现实时通讯可以通过安卓原生的广播通信的方式。
+
+#### uni-app x项目
+
+首先需要在当前页面注册一个BroadcastReceiver接受android原生应用发送的广播信息。
+
+发送广播可以通过`UTSAndroid.getUniActivity()?.sendBroadcast(intent)`将信息传送到原生。
+
+```uvue
+<template>
+	<view class="content">
+		<image class="logo" src="/static/logo.png" @click="send"></image>
+		<view class="text-area">
+			<text class="title">{{title}}</text>
+		</view>
+	</view>
+</template>
+
+<style>
+	.content {
+		display: flex;
+		align-items: center;
+		justify-content: center;
+	}
+
+	.logo {
+		height: 200rpx;
+		width: 200rpx;
+		margin-top: 200rpx;
+		margin-bottom: 50rpx;
+	}
+
+	.title {
+		font-size: 36rpx;
+		color: #8f8f94;
+	}
+</style>
+```
+
+#### android原生项目
+
+首先需要在当前activity注册一个BroadcastReceiver接受uni-app x发送的广播信息。
+
+发送广播可以通过`sendBroadcast(inte)`将信息传送到uni-app x。
+
+```kotlin
+class MainActivity : AppCompatActivity() {
+    override fun onCreate(savedInstanceState: Bundle?) {
+        super.onCreate(savedInstanceState)
+        setContentView(R.layout.main_activity)
+        findViewById<View>(R.id.btn_goto).setOnClickListener {
+            startActivity(Intent(this@MainActivity, UniAppActivity::class.java))
+            if (VERSION.SDK_INT >= 33) {
+                registerReceiver(broadcast, IntentFilter("ACTION_TO_NATIVE"), null, null, RECEIVER_EXPORTED)
+            } else {
+                registerReceiver(broadcast, IntentFilter("ACTION_TO_NATIVE"))
+            }
+        }
+    }
+
+    private val broadcast = object : BroadcastReceiver() {
+        val handler = Handler(Looper.getMainLooper())
+        override fun onReceive(context: Context, intent: Intent) {
+            if(intent.action == "ACTION_TO_NATIVE") {
+                Toast.makeText(context, intent.getStringExtra("key"), Toast.LENGTH_SHORT).show()
+                handler.postDelayed({
+                    val inte = Intent("ACTION_FROM_NATIVE")
+                    inte.putExtra("key", "接受来自原生的广播")
+                    context.sendBroadcast(inte)
+                }, 3000)
+            }
+        }
+    }
+
+    override fun onDestroy() {
+        super.onDestroy()
+        unregisterReceiver(broadcast)
+    }
+}
+```
+
+**注意：广播要在页面关闭的时候取消注册，避免可能出现崩溃的问题。**
+
+示例可以参考原生SDK中的`app-comm`工程。
+
+## 退出
+
+退出 uni-app x 应用可以在uni-app x中调用`uni.exit()`，整体退出uni-app x。