tmui-cli 2.0.3 → 2.0.4

package/data/uni-app-x-docs/native/use/harmonyapi.md

@@ -0,0 +1,205 @@
+## 初始化 SDK
+
+打开鸿蒙项目文件 entry/src/main/ets/entryability/EntryAbility.ets，增加 uni-app sdk 初始化逻辑。
+
+::: preview
+> VDOM模式
+```typescript
+import { window } from "@kit.ArkUI";
+import { UniEntryAbility } from "@dcloudio/uni-app-x-runtime";
+import BuildProfile from "BuildProfile";
+
+export default class EntryAbility extends UniEntryAbility {
+  onImport(path: string): Promise<void | Object> {
+    return import(path);
+  }
+
+  constructor() {
+    super("你的APPID", {
+      debug: BuildProfile.DEBUG,
+    });
+  }
+
+  onWindowStageCreate(windowStage: window.WindowStage): void {
+    super.onWindowStageCreate(windowStage, false);
+
+    windowStage.loadContent("pages/Index", (err) => {
+      if (err.code) {
+        return;
+      }
+    });
+  }
+}
+```
+> 蒸汽模式
+```typescript
+import { window } from "@kit.ArkUI";
+import { UniEntryAbility } from "@dcloudio/uni-app-x-vapor-runtime";
+import BuildProfile from "BuildProfile";
+
+export default class EntryAbility extends UniEntryAbility {
+  onImport(path: string): Promise<void | Object> {
+    return import(path);
+  }
+
+  constructor() {
+    super("你的APPID", {
+      debug: BuildProfile.DEBUG,
+    });
+  }
+
+  onWindowStageCreate(windowStage: window.WindowStage): void {
+    super.onWindowStageCreate(windowStage, false);
+
+    windowStage.loadContent("pages/Index", (err) => {
+      if (err.code) {
+        return;
+      }
+    });
+  }
+}
+```
+:::
+
+## 启动
+
+::: preview
+> VDOM模式
+```typescript
+export type AnimationType =
+  | "slide-in-right"
+  | "slide-in-left"
+  | "slide-in-top"
+  | "slide-in-bottom"
+  | "fade-in"
+  | "none";
+interface IOpenUniAppConfig {
+  animationType?: AnimationType;
+  animationDuration?: number;
+}
+export declare function openUniApp(
+  appID: string,
+  config?: IOpenUniAppConfig
+): void;
+```
+> 蒸汽模式
+```typescript
+export type AnimationType =
+  | "slide-in-right"
+  | "slide-in-left"
+  | "slide-in-top"
+  | "slide-in-bottom"
+  | "fade-in"
+  | "none";
+interface IOpenUniAppConfig {
+  animationType?: AnimationType;
+  animationDuration?: number;
+}
+export interface IUniAppSDK {
+  close(): void
+}
+export declare function openUniApp(
+  appID: string,
+  config?: IOpenUniAppConfig
+): IUniAppSDK;
+```
+:::
+
+### 示例代码
+
+::: preview
+> VDOM模式
+```ts
+import { openUniApp } from '@dcloudio/uni-app-x-runtime'
+
+@Entry
+@Component
+struct Index {
+  build() {
+    RelativeContainer() {
+      Button('Open')
+        .onClick(() => {
+          openUniApp('你的APPID', {
+            animationType: 'fade-in',
+          })
+        })
+    }
+    .height('100%')
+    .width('100%')
+  }
+}
+```
+> 蒸汽模式
+```ts
+import { openUniApp } from '@dcloudio/uni-app-x-vapor-runtime'
+
+@Entry
+@Component
+struct Index {
+  build() {
+    RelativeContainer() {
+      Button('Open')
+        .onClick(() => {
+          const app = openUniApp('你的APPID', {
+            animationType: 'fade-in',
+          })
+        })
+    }
+    .height('100%')
+    .width('100%')
+  }
+}
+```
+:::
+
+## 退出
+
+退出应用可以在 uni-app x 中调用 uni.exit()，整体退出 uni-app x。
+
+蒸汽模式还可以通过应用实例的 close 方法进行关闭。
+
+```ts
+const app = openUniApp('你的APPID', {
+  animationType: 'fade-in',
+})
+setTimeout(() => {
+  app.close()
+}, 3000)
+```
+
+## 通信
+
+可以使用 [Emitter 模块](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/js-apis-emitter?ha_source=Dcloud&ha_sourceId=89000448)进行消息通信。
+
+### 原生 APP 监听消息以及向 uni-app x 发送消息
+
+```ts
+// Index.ets
+import emitter from '@ohos.events.emitter'
+
+emitter.on('launch', (data) => {
+  console.log('launch:', data.data)
+
+  emitter.emit('message', {
+    data: 'hello'
+  })
+})
+```
+
+### uni-app x 监听消息以及向原生 APP 发送消息
+
+```vue
+<script setup lang="uts">
+  import emitter from '@ohos.events.emitter'
+
+  emitter.on('message', (data) => {
+    console.log('message:', data.data)
+  })
+
+  onLaunch(() => {
+    emitter.emit('launch', {
+      data: 'launch'
+    })
+  })
+</script>
+```

package/data/uni-app-x-docs/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/uni-app-x-docs/native/use/ios.md

@@ -0,0 +1,96 @@
+# 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/uni-app-x-docs/native/use/iosapi.md

@@ -0,0 +1,290 @@
+> * 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`依赖，即可体验通信示例