tmui-cli 2.0.2 → 2.0.4

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

@@ -0,0 +1,62 @@
+# 导出UTS插件
+> 1. 插件市场的加密uts插件如果没有获得源码授权，则无法在原生工程接入。
+> 2. 如果导出的资源文件不包含 `uni_modules` ，或 `uni_modules` 中的插件均不包含 `app-harmony` 目录可以跳过此章节
+
+鸿蒙上uts插件是单独导出为ets的。
+
+## 集成uts插件编译产物
+
+如下文档使用`/resource`指代鸿蒙资源输出目录
+
+1. 将 uni_modules 入口文件移动到`/entry/src/main/ets/uni_modules/index.generated.ets`, 如果目录不存在则需要手动创建
+
+移动`/resource/uni_modules/index.generated.ets`文件到鸿蒙项目`/entry/src/main/ets/uni_modules/index.generated.ets`
+
+并在鸿蒙项目的`entry/src/main/ets/entryability/EntryAbility.ets`文件中添加如下代码。
+
+```ts
+import { initUniModules } from '../uni_modules/index.generated'
+initUniModules()
+```
+
+![](https://web-ext-storage.dcloud.net.cn/uni-app/harmony/dev/20240904152004.jpg)
+
+2. 将 uts api 对应的 uni_modules 文件部署到鸿蒙工程内
+
+移动`/resource/uni_modules`目录下的 uts api 模块目录到鸿蒙项目`/uni_modules`目录
+
+![](https://web-ext-storage.dcloud.net.cn/uni-app/harmony/dev/20240914143945.jpg)
+
+编译到鸿蒙时每个 uts api 的 uni_module 都会创建一个鸿蒙的静态库。对于静态库有两个概念需要区分一下。
+
+- 静态库的 module 名称（如下称为 moduleName），每个静态库的名称，只允许大小写字母加下划线组成
+- 静态库的包名（如下称为 packageName），静态库被 import 时的名称，类似 npm 包名。不允许使用大写字母
+
+对于一个名称为 uni-getBatteryInfo 的 uni_module，它的 moduleName 为`uni_modules__uni_getbatteryinfo`，packageName 为`@uni_modules/uni-getbatteryinfo`。
+
+packageName 规则较为简单，给 uni_module 名称前加上`@uni_modules`前缀然后转为全小写。
+
+moduleName 是在 packageName 的基础上生成的，移除@符号，将/替换为两个下划线，将-替换为一个下划线
+
+3. 修改鸿蒙项目`oh-package.json5`
+
+为所有本地 uts api 的 uni_module 及其他三方依赖注册 packageName。uni-app 编译器会自动在`/resource/uni_modules`目录下生成`oh-package.json5`文件，该文件包含了所有依赖的信息，可以直接将此文件合并到鸿蒙项目的`oh-package.json5`文件内。
+
+以 uni-getBatteryInfo 为例，在`oh-package.json5`文件内`dependencies`字段下添加如下内容
+
+```json
+"@uni_modules/uni-getbatteryinfo": "./uni_modules/uni-getbatteryinfo"
+```
+
+4. 修改鸿蒙项目`build-profile.json5`
+
+为所有本地 uts api 的 uni_module 注册 moduleName。uni-app 编译器会自动在`/resource/uni_modules`目录下生成`build-profile.json5`文件，该文件包含了所有模块的信息，可以直接将此文件合并到鸿蒙项目的`build-profile.json5`文件内。
+
+以 uni-getBatteryInfo 为例，在`build-profile.json5`文件内`modules`数组内添加如下内容
+
+```json
+{
+  "name": "uni_modules__uni_getbatteryinfo",
+  "srcPath": "./uni_modules/uni-getBatteryInfo"
+}
+```

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

@@ -0,0 +1,90 @@
+# uni-app x 原生SDK iOS版
+
+## 准备环境
+* HBuilder X (VDOM 模式 4.26 及以上版本、蒸汽模式 5.25 及以上版本）
+* Xcode版本建议与[iOS平台云端打包环境](https://doc.dcloud.net.cn/uni-app-x/tutorial/app-env.html#ios%E5%B9%B3%E5%8F%B0%E4%BA%91%E7%AB%AF%E6%89%93%E5%8C%85%E7%8E%AF%E5%A2%83)保持一致
+
+## 接入流程
+1. 在 `HBuilder X` 中导出资源文件，根据资源内容，配置`原生主工程`环境，添加基础模块需要的依赖库以及资源文件
+2. 根据资源文件中的`manifest.json`文件中包含的模块，制作`DCloudUTSExtAPI.xcframework`，并将其添加到`原生主工程`中，详见[集成内置模块](../modules/ios/modules.md)
+3. 根据资源文件中的`manifest.json`文件中包含的模块，向`原生主工程`添加工程配置以及内置模块需要的资源文件等，详见[集成内置模块](../modules/ios/modules.md)
+4. 根据资源文件中的`uni_modules`文件夹中包含的UTS插件，制作对应的原生xcframework，并将其添加到`原生主工程`(付费购买的uts插件不支持原生工程接入)，详见[制作UTS插件](iosuts.md)
+5. 在原生工程中，通过API启动uni原生SDK，详见[API文档](iosapi.md)
+
+## 导出资源文件
+1. 打开 `HBuilder X -> 发行 -> 原生App-本地打包 -> 生成本地打包App资源` 勾选iOS点击生成  
+    ![](https://web-ext-storage.dcloud.net.cn/native/doc/iOS/export.png)
+
+2. 导出成功之后会在项目的`unpackage/resources`目录下生成资源文件   
+
+    ![](https://web-ext-storage.dcloud.net.cn/native/doc/iOS/resources.png)
+
+3. 在原生工程根目录创建文件夹`uni-app-x/apps`,将 `app-ios` 目录下与`appid`对应的目录拷贝到该目录下，然后打开工程将`uni-app-x`文件夹拖入到`Target -> Build Phases -> Copy Bundle Resources`下, 勾选`Copy Items if needed`以及`Create folder references`
+
+    ![](https://web-ext-storage.dcloud.net.cn/native/doc/iOS/copy_resources.png)
+
+## 原生工程配置
+
+`Target -> General -> Minimum Deployments` 选择 `15.0` 及以上版本   
+
+`Target -> Build Settings -> Other Linker Flags` 中添加`-ObjC`
+
+1. 若HBuilderX项目`根目录`下包含`Info.plist`文件，需要将该文件内容拷贝到`原生主工程`的`Target -> Info` 下
+2. 在`Target -> Info` 下，添加如下配置
+```xml
+<dict>
+	<key>NSAppTransportSecurity</key>
+	<dict>
+		<key>NSAllowsArbitraryLoads</key>
+		<true/>
+	</dict>
+	<key>UIFileSharingEnabled</key>
+	<true/>
+	<key>uniapp-x</key>
+	<dict>
+		<key>appid</key>
+		<string>应用的appid</string>
+		<key>ipatype</key>
+		<integer>2</integer> //1自定义基座 2正式包
+		<key>uniRuntimeVersion</key>
+		<string>SDK版本号</string>
+		<key>unionid</key>
+		<string>广告联盟id，如未开通uniad可不填</string>
+		<key>channel</key>
+		<string>appstore</string>
+		<key>initPrivacyAuthorization</key>
+		<true/>
+	</dict>
+</dict>
+```
+![](https://web-ext-storage.dcloud.net.cn/native/doc/iOS/uniappx_app_info_new.jpg)
+
+### uniapp-x节点参数描述
+| 参数 | 描述 |
+|-----|------|
+|  appid   |  应用的appid，必须与manifest.json中appid值一致   | 
+|  ipatype   | 1-自定义基座(在HBuilderX调试时设置该值)，2-正式包(打release包时设置该值)   | 
+|  uniRuntimeVersion   | SDK版本号(必须与HBuilderX版本一致)   | 
+|  unionid   | 广告联盟id，如未开通uniad可不配置此key   | 
+|  channel   | 打包渠道，可根据需求自行更改  | 
+|  initPrivacyAuthorization   | 是否启动默认同意隐私政策  | 
+
+## 集成基础模块
+将以下依赖库(`SDK/Libs 目录下`)添加到工程中
+
+| 依赖库 | 系统依赖库 |
+| ---   | ---|
+| DCloudDebugServe.xcframework `（Do Not Embed）Debug环境下集成）` <br> DCloudUTSFoundation.xcframework `（Embed & Sign）` <br> DCloudUniappRuntime.xcframework `（Embed & Sign）` <br> SDWebImage.xcframework `（Embed & Sign）` <br> DCloudUTSExtAPI.xcframework `（Embed & Sign）` <br> KSCrash.xcframework `（Embed & Sign）` <br> DCloudUniExtComponent.xcframework `（Embed & Sign）蒸汽模式`   |   JavaScriptCore.framework <br> c++ |
+
+> `Target -> Build Phases -> Link Binary With Libraries` 下添加依赖库
+> `Target -> General -> Frameworks,Libraries,and Embedded Content` 下设置`Embed & Sign`
+> DCloudUTSExtAPI.xcframework如何获取详见[集成内置模块](../modules/ios/modules.md)
+
+## 集成内置模块
+根据[集成内置模块](../modules/ios/modules.md)制作`DCloudUTSExtAPI`以及向主工程添加相关配置
+
+## 集成UTS插件
+根据[集成UTS插件](iosuts.md)制作插件库以及向主工程添加相关配置
+
+## 启动与通信
+根据[API文档](iosapi.md)在主工程编写代码完成接入

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

@@ -0,0 +1,288 @@
+> * SDK基于Swift开发，因此原生Objective-C语言开发的应用需要新建一个Swift文件用于添加Swift运行环境以及桥接SDK的API，详情可参考UniAppXDemo工程中的`UniAppBridge`
+
+> **SDK 5.24 及以上**：iOS 使用 `UIScene` 生命周期。请按照下方 `SceneDelegate` 示例接入，不再在 `AppDelegate` 中处理窗口和前后台生命周期。
+
+> **注意**：4.81 之前版本请先升级到 4.81 及以上版本，再按照本文集成 SDK。
+
+## UniAppXSDK API
+
+### 初始化 SDK
+
+```swift
+import DCloudUniappRuntime
+
+// 初始化 SDK
+UniAppXSDK.initSDK()
+```
+### 打开 SDK 页面
+
+```swift
+let options = UniAppXSDKStartOptions.init()
+options.appScheme = "your-app-scheme"
+options.appLink = "your-app-link"
+options.openType = .push
+options.animationType = .auto
+
+UniAppXSDK.start(options: options)
+```
+
+#### UniAppXSDKStartOptions 参数说明
+
+配置启动选项的类。
+
+| 属性 | 类型 | 默认值 | 说明 |
+|------|------|--------|------|
+| `appScheme` | `String?` | `nil` | 应用 Scheme，用于深度链接 |
+| `appLink` | `String?` | `nil` | 应用链接地址 |
+| `openType` | `UniAppXSDKStartOptionsOpenType` | `.push` | 打开方式：push 或 present |
+| `animationType` | `UniAppXSDKStartOptionsAnimationType` | `.auto` | 动画类型 |
+| `animationDuration` | `TimeInterval` | `0.35` | 动画持续时间（秒） |
+| `customAnimationDelegate` | `UniAppXSDKCustomAnimationDelegate?` | `nil` | 自定义动画代理 |
+| `viewController` | `UIViewController?` | `nil` | 指定的视图控制器 |
+
+##### 动画类型 (UniAppXSDKStartOptionsAnimationType)
+- `.auto` - 使用系统默认动画
+- `.none` - 无动画
+- `.slideInRight` - 从右侧滑入
+- `.slideInLeft` - 从左侧滑入
+- `.slideInTop` - 从顶部滑入
+- `.slideInBottom` - 从底部滑入
+- `.fadeIn` - 淡入效果
+- `.zoomOut` - 放大进入
+- `.zoomFadeOut` - 放大淡入
+- `.popIn` - 弹出效果
+- `.custom` - 使用自定义动画代理
+
+##### 自定义动画代理 (UniAppXSDKCustomAnimationDelegate)
+
+实现自定义动画效果，示例如下：
+```swift
+class ViewController: UniAppXSDKCustomAnimationDelegate {
+    public func customEnterAnimation(fromVC: UIViewController, toVC: UIViewController, completion: @escaping (Bool) -> Void) {
+        // Push 模式: 添加到导航控制器
+        if let navController = fromVC.navigationController {
+            navController.view.addSubview(toVC.view)
+            toVC.view.frame = navController.view.bounds
+
+            toVC.view.transform = CGAffineTransform(translationX: navController.view.bounds.width, y: 0)
+                .concatenating(CGAffineTransform(scaleX: 0.8, y: 0.8))
+            toVC.view.alpha = 0.7
+
+            UIView.animate(withDuration: 0.6, delay: 0, options: .curveEaseInOut) {
+                toVC.view.transform = .identity
+                toVC.view.alpha = 1.0
+            } completion: { finished in
+                navController.pushViewController(toVC, animated: false)
+                toVC.view.removeFromSuperview()
+                completion(finished)
+            }
+        } else {
+            //如果没有导航控制器你可以 用present方式跳转 实现其他动画效果
+            completion(true)
+        }
+    }
+    
+    
+    public func customExitAnimation(currentVC: UIViewController, completion: @escaping (Bool) -> Void) {
+        // Push 模式的退出动画：简单翻页效果
+        if let navController = currentVC.navigationController {
+            let viewControllers = navController.viewControllers
+            if viewControllers.count > 1 {
+                navController.popViewController(animated: false)
+                navController.view.addSubview(currentVC.view)
+                currentVC.view.frame = navController.view.bounds
+
+                UIView.animate(withDuration: 0.6, delay: 0, options: .curveEaseInOut) {
+                    currentVC.view.transform = CGAffineTransform(translationX: -navController.view.bounds.width, y: 0)
+                        .concatenating(CGAffineTransform(scaleX: 0.8, y: 0.8))
+                    currentVC.view.alpha = 0.7
+                } completion: { finished in
+                    currentVC.view.removeFromSuperview()
+                    completion(finished)
+                }
+            } else {
+                completion(true)
+            }
+        } else {
+            completion(true)
+        }
+    }
+}
+
+// 使用自定义动画
+options.customAnimationDelegate = self
+options.animationType = .custom
+```
+
+### 退出 SDK 页面
+根据您的需求，选择以下方式调用退出SDK
+* 原生项目中退出调用`UniAppXSDK.exit()`
+* uni-app x项目中退出调用[uni.exit()](https://doc.dcloud.net.cn/uni-app-x/api/exit.html)
+
+### 生命周期集成
+
+5.24 及以上版本使用 `UIScene` 生命周期。先在 `Info.plist` 中声明 scene 配置；`SceneDelegate` 类名需与下方示例保持一致。
+
+```xml
+<key>UIApplicationSceneManifest</key>
+<dict>
+    <key>UIApplicationSupportsMultipleScenes</key>
+    <false/>
+    <key>UISceneConfigurations</key>
+    <dict>
+        <key>UIWindowSceneSessionRoleApplication</key>
+        <array>
+            <dict>
+                <key>UISceneConfigurationName</key>
+                <string>Default Configuration</string>
+                <key>UISceneDelegateClassName</key>
+                <string>$(PRODUCT_MODULE_NAME).SceneDelegate</string>
+            </dict>
+        </array>
+    </dict>
+</dict>
+```
+
+`AppDelegate` 中初始化 SDK，并配置 scene delegate；窗口创建、前后台切换、URL Scheme 和 Universal Link 回调转发到 `UniAppRootSceneDelegate`。如果工程已有自己的 `SceneDelegate`，请将下面的转发代码合并进去。
+
+```swift
+// AppDelegate.swift
+import UIKit
+import DCloudUniappRuntime
+
+@main
+class AppDelegate: UIResponder, UIApplicationDelegate {
+    var window: UIWindow?
+
+    func application(_ application: UIApplication,
+                     didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]?) -> Bool {
+        UniAppXSDK.initSDK()
+        UniAppXSDK.applicationDidFinishLaunchingWithOptions(application, launchOptions)
+        return true
+    }
+
+    @available(iOS 13.0, *)
+    func application(_ application: UIApplication,
+                     configurationForConnecting connectingSceneSession: UISceneSession,
+                     options: UIScene.ConnectionOptions) -> UISceneConfiguration {
+        let configuration = UISceneConfiguration(name: "Default Configuration",
+                                                  sessionRole: connectingSceneSession.role)
+        configuration.delegateClass = SceneDelegate.self
+        return configuration
+    }
+
+    func application(_ application: UIApplication, didRegisterForRemoteNotificationsWithDeviceToken deviceToken: Data) {
+        UniAppXSDK.didRegisterForRemoteNotifications(deviceToken)
+    }
+
+    func application(_ application: UIApplication, didFailToRegisterForRemoteNotificationsWithError error: Error) {
+        UniAppXSDK.didFailToRegisterForRemoteNotifications(error)
+    }
+
+    func application(_ application: UIApplication, didReceiveRemoteNotification userInfo: [AnyHashable: Any],
+                     fetchCompletionHandler completionHandler: @escaping (UIBackgroundFetchResult) -> Void) {
+        UniAppXSDK.applicationDidReceiveRemoteNotificationCompletionHandler(application, userInfo, completionHandler)
+    }
+}
+```
+
+```swift
+// SceneDelegate.swift
+import UIKit
+import DCloudUniappRuntime
+
+@available(iOS 13.0, *)
+class SceneDelegate: UIResponder, UIWindowSceneDelegate {
+    var window: UIWindow?
+    private let sdkSceneDelegate = UniAppRootSceneDelegate()
+
+    func scene(_ scene: UIScene, willConnectTo session: UISceneSession,
+               options connectionOptions: UIScene.ConnectionOptions) {
+        sdkSceneDelegate.scene(scene, willConnectTo: session, options: connectionOptions)
+        guard let windowScene = scene as? UIWindowScene else { return }
+
+        let storyboard = UIStoryboard(name: "Main", bundle: nil)
+        let initialViewController = storyboard.instantiateInitialViewController()!
+        window = sdkSceneDelegate.window ?? UIWindow(windowScene: windowScene)
+        window?.rootViewController = UINavigationController(rootViewController: initialViewController)
+        (UIApplication.shared.delegate as? AppDelegate)?.window = window
+        window?.makeKeyAndVisible()
+    }
+
+    func sceneDidBecomeActive(_ scene: UIScene) { sdkSceneDelegate.sceneDidBecomeActive(scene) }
+    func sceneWillResignActive(_ scene: UIScene) { sdkSceneDelegate.sceneWillResignActive(scene) }
+    func sceneWillEnterForeground(_ scene: UIScene) { sdkSceneDelegate.sceneWillEnterForeground(scene) }
+    func sceneDidEnterBackground(_ scene: UIScene) { sdkSceneDelegate.sceneDidEnterBackground(scene) }
+    func scene(_ scene: UIScene, openURLContexts URLContexts: Set<UIOpenURLContext>) {
+        sdkSceneDelegate.scene(scene, openURLContexts: URLContexts)
+    }
+    func scene(_ scene: UIScene, continue userActivity: NSUserActivity) {
+        sdkSceneDelegate.scene(scene, continue: userActivity)
+    }
+}
+```
+
+推送相关回调仍在 `AppDelegate` 中处理；其他生命周期和 URL/Universal Link 回调均在 `SceneDelegate` 中转发。
+
+## 通信
+iOS平台目前不支持直接在uvue页面调用原生API，开发者可通过UTS插件`发送/接收 通知消息`实现与原生App通信，具体实现代码如下：
+
+### 原生APP向SDK发消息
+UTS插件添加监听：
+``` ts
+const name = "com.ios.notification.name1"; //通知消息标识
+const notificationName = new Notification.Name(name);
+const method = Selector("handleReceiveMessage:")//接收通知消息的方法名
+NotificationCenter.default.addObserver(this, selector = method, name = notificationName, object = null)
+```
+
+``` ts
+@objc static handleReceiveMessage(notification : Notification) {
+	let userInfo = notification.userInfo
+	if(userInfo != null){
+		const message = userInfo!["msg"];
+	}
+}
+```
+
+原生发送通知消息：
+``` swift
+let name = "com.ios.notification.name1"; //通知消息标识
+let message = "消息内容";
+let userInfo: [AnyHashable: Any] = [
+    "msg": message // 你可以在这里放置任何需要传递的信息
+]
+NotificationCenter.default.post(name: Notification.Name(name), object: nil, userInfo: userInfo)
+```    
+
+### SDK向原生APP发消息
+原生添加通知监听：
+``` swift
+const name = "com.ios.notification.name2"; //通知消息标识
+NotificationCenter.default.addObserver(self, selector: #selector(handleNotification(_:)), name: Notification.Name(name), object: nil)
+```
+
+``` swift
+@objc func handleNotification(_ notification: Notification) {
+    if let message = (notification.userInfo?["msg"] as? String) {
+        // 使用message
+        print(message)
+    }
+}
+```
+   
+UTS插件发送消息：
+``` ts
+const name = "com.ios.notification.name2"; //通知消息标识
+const message = "消息内容";
+const notificationName = new Notification.Name(name);
+const userInfo = new Map<string,any>()
+userInfo.set("msg", message); // 你可以在这里放置任何需要传递的信息
+NotificationCenter.default.post(name = notificationName, object = null, userInfo = userInfo);
+```
+
+> 注意：消息接收方必须在发送通知前添加监听事件，否则收不到消息 
+
+### 运行示例
+- 蒸汽模式 SDK工程 `UniAppXVaporDemo` 中，`unimoduleTesIosNotification` 为 UTS 插件，用于演示通信示例，UniAppXSample 为对应的 uni-app-x 源码示例工程
+- VDOM 模式SDK工程 `UniAppXDemo`工程中，`__UNI__00DC103`为通信示例资源文件，将`Info.plist`中`uniapp-x`节点下的`appid`改为`__UNI__00DC103`，并添加`unimoduleTestIosNotification.xcframework`依赖，即可体验通信示例

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

@@ -0,0 +1,87 @@
+# 制作UTS插件
+> 1. 付费uts插件(普通授权版)不支持原生工程接入。
+> 2. 如果导出的资源文件不包含 `uni_modules` ，或 `uni_modules` 中的插件均不包含 `app-ios` 目录可以跳过此章节
+
+## 新建原生插件工程
+根据资源文件下的`uni_modules`下的插件列表，新建原生插件工程
+1. 启动`Xcode`，点击`File->New->Project`，选择`Framework`点击`Next`；
+2. `Product Name`填写规则为：`unimodule`+`插件名称`，其中`-`分割改为驼峰，比如`uni-getbatteryinfo`插件对应的原生工程名应为`unimoduleUniGetbatteryinfo`
+3. `Language`选择为`Objective-C`，点击`Next`即可完成创建
+
+## 插件工程环境配置
+1.  `Target -> General -> Minimum Deployments` 选择 `15.0`
+2.  `Target -> Build Settings -> Mach-O Type` 设置为`Dynamic Library`
+3.  `Target -> Build Settings -> Other Linker Flags` 中添加`-ObjC`, 字母o和c大写
+ 4. `Target -> Build Settings -> Build Libraries for Distribution` 设置为`YES`
+ 5. `Target -> Build Settings -> Enable Module Verifier` 设置为`NO`
+ 6. `Target -> Build Settings -> Framework Search Paths` 中添加SDK的Libs目录（操作方法：双击展开`Framework Search Paths`将`SDK/Libs`文件夹拖入即可）
+7. `插件工程`中新建`uts-config.json`文件，然后将SDK中`SDK/ExtApiSrc/UTSOC.h`以及`SDK/ExtApiSrc/UTSOC.mm`添加到`插件工程`中
+- 注意： `uts-config.json`、`UTSOC.h`、`UTSOC.m` 文件，既存在`SDK/ExtApiSrc/`目录中， 也可以在
+`SDK/UTSPluginExample/unimoduleUtsWorker/unimoduleUtsWorker/` 中获取， `SDK/UTSPluginExample/`  目录中是已经构建好的uts原生插件工程， 该文件在不同版本的sdk中是通用的
+
+## 配置资源文件
+1. 将以下源文件(`SDK/ExtApiSrc 目录下`)、依赖库(`SDK/Libs 目录下`)添加到`插件工程`中，并将依赖库均设置为`Do Not Embed`
+    | uniapp-x源码文件&资源文件 | uniapp-x项目依赖库| uniapp源码文件&资源文件  | uniapp项目依赖库 |
+    |---|---|---|---|
+    | UTSOC.h <br> UTSOC.mm <br> uts-config.json | DCloudUniappRuntime.xcframework <br> DCloudUTSExtAPI.xcframework <br> DCloudUTSFoundation.xcframework | DCloudUTSConfig.h <br> DCloudUTSConfig.m <br> UTSCPP.h <br> UTSCPP.mm <br> config.json | DCUniBase.framework <br> DCloudUTSFoundation.framework  |
+
+> DCloudUTSExtAPI.xcframework的制作详见[集成内置模块](../modules/ios/modules.md)
+
+2. 将导出的资源文件中`uni_modules`目录下的插件资源，按以下列表中的配置方式分别在`主工程`和`插件工程`添加依赖资源
+    | 目录名/文件名 | 	用途 | 配置 |
+    |---|---|---|
+    | Frameworks | 插件依赖的三方库(framework/xcframework) | 将目录下的依赖库添加到`插件工程`中 |
+    | Libs | 插件依赖的三方库(.a) | 将目录下的依赖库添加到`插件工程`中 |
+    | src | 插件源代码 | 将目录下的源代码添加到`插件工程`中 |
+    | Resources | 插件需要引用的资源文件存放目录 | 将目录下的资源文件添加到`主工程`中 |
+    | Info.plist | 需要添加到原生主工程`Info.plist`中的配置文件 | 将该文件配置添加到`主工程`的`Info.plist`中，注意去重 |
+    | UTS.entitlements | 需要添加到原生主工程 `entitlements` 文件中的配置文件 | 根据该文件内容，在主工程中添加对应的`Capability` |
+    | config.json | 插件依赖的`系统库`、`cocoapods三方库`以及一些需要添加到`主工程Info.plist`文件内的配置信息 | 详见下表 |
+
+### config.json配置
+
+| 参数 | 	用途 | 配置 |
+|---|---|---|
+| frameworks | 插件依赖的系统库 | 在`主工程`中搜索并添加该列表中的系统依赖库 |
+| deploymentTarget | 插件最低支持的iOS版本 | 在`插件工程`中`Target -> General -> Minimum Deployments`设置（若大于主工程设置的最低iOS版本需要同步修改主工程的最低支持） |
+| dependencies-pods | 依赖的pod库 | 将其添加到`插件工程`的`Podfile`文件中并执行`pod install` |
+| plists | 需要添加到原生主工程`Info.plist`中的配置文件 | 将字段配置添加到`主工程`的`Info.plist`中 |
+| hooksClass | 用于uts插件应用程序生命周期函数监听 | 在`插件工程`中找到上面创建的`uts-config.json`文件，将该配置内容添加到`hooksClasses`节点下 |
+| provider | 组件的注册信息 | 在`插件工程`中找到上面创建的`uts-config.json`文件，将该配置内容添加到`providers`节点下 |
+| components | 组件的注册信息 | 在`插件工程`中找到上面创建的`uts-config.json`文件，将该配置内容添加到`components`节点下 |
+
+`uts-config.json`配置示例图   
+
+![](https://web-ext-storage.dcloud.net.cn/native/doc/iOS/utsconfig.png)
+
+### 隐私清单
+如果HBuilderX导出的资源文件中包含`PrivacyInfo.xcprivacy`文件，需要将文件内容添加到`插件工程`的同名文件中，注意去重
+
+## 编译导出xcframework
+选择构建目标(Any iOS Device/Any iOS Simulator Device)，在菜单栏中，选择`Product -> Build`（或使用快捷键`Command + B`），分别编译出真机以及模拟器的Framework文件。
+在菜单栏中，选择`Product -> Show Build Floder in Finder` 获取编译产物所在路径。
+使用xcodebuild命令行创建xcframework
+```
+xcodebuild -create-xcframework -framework 真机路径/unimoduleUniGetbatteryinfo.framework -framework 模拟器路径/unimoduleUniGetbatteryinfo.framework -output 导出路径/unimoduleUniGetbatteryinfo.xcframework
+```
+导出成功后，将 `unimoduleUniGetbatteryinfo.xcframework` 添加到主工程，并设置为 `Embed && Sign` 
+
+> 编译模拟器注意事项
+> `Apple芯片`的设备编译模拟器需要在菜单栏中点击 `Product -> Destination -> Show All Run Destinations` ，然后选择 `Rosetta模拟器` 编译
+  
+## 原生项目中调试UTS插件
+首先，你需要创建一个`Xcode Workspace`，它允许你同时打开多个项目（包括你的主工程和UTS插件工程）。
+1. 创建Xcode Workspace  
+* 打开Xcode，选择`File > New > Workspace`。
+* 给你的Workspace命名，例如`MyProject.xcworkspace`。
+* 保存Workspace文件。
+2. 将`主工程`和`UTS插件工程`添加到Workspace  
+* 在Workspace中，选择`File > Add Files to <YourWorkspaceName>`。
+* 找到并选择你的`主工程`和`UTS插件工程`，将它们添加到Workspace中。
+3. 配置`主工程`依赖`UTS插件工程`
+* 在Workspace中，打开主工程的项目设置。
+* 选择`General`标签页，滚动到`Frameworks, Libraries, and Embedded Content`部分。
+* 点击`+`按钮，添加你的`UTS插件工程`生成的framework文件。
+* 确保`Embed & Sign`选项被勾选。
+4. 设置断点和调试 
+* 在`UTS插件工程`工程中设置断点，然后在主工程中触发相关功能来调试UTS插件