diff --git a/docs/native/modules/ios/modules.md b/docs/native/modules/ios/modules.md index c648fbd970392096fbf3b2a7062cc2d9c8c18f9f..a38d7db735150fc725eb05f32443b01255135a1f 100644 --- a/docs/native/modules/ios/modules.md +++ b/docs/native/modules/ios/modules.md @@ -45,7 +45,7 @@ ### 配置uts-config.json(可选) 在`DCloudUTSExtAPI`工程中新建 `uts-config.json` 文件, -uni-video模块需要添加如下配置 +`uni-video`模块需要添加如下配置 ``` { "components": [{ @@ -55,7 +55,8 @@ uni-video模块需要添加如下配置 }] } ``` -uni-payment-alipay模块需要添加如下配置 + +`uni-payment-alipay`模块需要添加如下配置 ``` { "hooksClasses": [ @@ -68,7 +69,8 @@ uni-payment-alipay模块需要添加如下配置 }] } ``` -uni-payment-wxpay模块需要添加如下配置 + +`uni-payment-wxpay`模块需要添加如下配置 ``` { "hooksClasses": [ @@ -81,31 +83,45 @@ uni-payment-wxpay模块需要添加如下配置 }] } ``` + `uts-config.json`配置示例图 ![](https://web-ext-storage.dcloud.net.cn/native/doc/iOS/utsconfig.png) +### 隐私清单 +> 新建隐私清单:`Command + N`选择`App Privacy`点击`Next`,文件名称必须为`PrivacyInfo` + +集成`uni-media`模块需要填写如下隐私清单 +![](https://web-ext-storage.dcloud.net.cn/native/doc/iOS/unimedia_privacyinfo.png) + +集成`uni-payment-wxpay`模块需要填写如下隐私清单 +![](https://web-ext-storage.dcloud.net.cn/native/doc/iOS/uniwxpay_privacyinfo.png) + + ### 编译导出DCloudUTSExtAPI.xcframework 选择构建目标(Any iOS Device/Any iOS Simulator Device),在菜单栏中,选择`Product -> Build`(或使用快捷键`Command + B`),分别编译出真机以及模拟器的Framework文件。 -在菜单栏中,选择`Product -> Copy Build Floder Path` 获取编译产物所在路径。 +在菜单栏中,选择`Product -> Show Build Floder in Finder` 获取编译产物所在路径。 使用xcodebuild命令行创建xcframework ``` xcodebuild -create-xcframework -framework 真机路径/DCloudUTSExtAPI.framework -framework 模拟器路径/DCloudUTSExtAPI.framework -output 导出路径/DCloudUTSExtAPI.xcframework ``` 导出成功后,将 `DCloudUTSExtAPI.xcframework` 添加到主工程,并设置为 `Embed && Sign` -**> 编译模拟器注意事项 -> `Apple芯片`的设备编译模拟器需要在菜单栏中点击 `Product -> Destination -> Show All Run Destinations` ,然后选择 `Rosetta模拟器` 编译** + +> `Apple芯片`的设备编译模拟器需要在菜单栏中点击 `Product -> Destination -> Show All Run Destinations` ,然后选择 `Rosetta模拟器` 编译 ## 主工程配置 根据离线资源中的`manifest.json`文件包含的模块名称,根据下述相关模块文档向`主工程`添加依赖以及工程配置 + ## uni-prompt ### 添加依赖库以及资源文件 | 资源文件 | |---| | uni_uts_toast_error.png、uni_uts_toast_success.png | + + ## uni-media ### 添加依赖库以及资源文件 | 依赖库 | 资源文件 | @@ -128,6 +144,8 @@ xcodebuild -create-xcframework -framework 真机路径/DCloudUTSExtAPI.framework ``` ![](https://web-ext-storage.dcloud.net.cn/native/doc/iOS/unimedia_permission.png) + + ## uni-getLocation-system ### 添加依赖库以及资源文件 | 依赖库 | diff --git a/docs/native/use/ios.md b/docs/native/use/ios.md index 00a9ea84f575ea2e5a27c82bcea0b55a878299e6..d865ceeef522625e1d3664c35c532a8bb43ba59d 100644 --- a/docs/native/use/ios.md +++ b/docs/native/use/ios.md @@ -5,11 +5,11 @@ * Xcode 15.2及以上版本 ## 接入流程 -* 通过 `HBuilder X` 导出离线资源,根据资源内容,配置**原生主工程**环境,添加基础模块需要的依赖库以及资源文件 -* 根据离线资源中的`manifest.json`文件中包含的模块,制作`DCloudUTSExtAPI.xcframework`,并将其添加到**原生主工程**中,详见[集成内置模块](../modules/ios/modules.md) -* 根据离线资源中的`manifest.json`文件中包含的模块,向**原生主工程**添加工程配置以及内置模块需要的资源文件等,详见[集成内置模块](../modules/ios/modules.md) -* 根据离线资源中的`uni_modules`文件夹中包含的UTS插件,制作对应的原生xcframework,并将其添加到**原生主工程**(付费购买的uts插件不支持离线打包),详见[制作UTS插件](iosuts.md) -* 编写代码通过离线API初始化SDK,详见[接入API](iosapi.md) +* 通过 `HBuilder X` 导出离线资源,根据资源内容,配置`原生主工程`环境,添加基础模块需要的依赖库以及资源文件 +* 根据离线资源中的`manifest.json`文件中包含的模块,制作`DCloudUTSExtAPI.xcframework`,并将其添加到`原生主工程`中,详见[集成内置模块](../modules/ios/modules.md) +* 根据离线资源中的`manifest.json`文件中包含的模块,向`原生主工程`添加工程配置以及内置模块需要的资源文件等,详见[集成内置模块](../modules/ios/modules.md) +* 根据离线资源中的`uni_modules`文件夹中包含的UTS插件,制作对应的原生xcframework,并将其添加到`原生主工程`(付费购买的uts插件不支持离线打包),详见[制作UTS插件](iosuts.md) +* 编写代码通过离线API初始化SDK,详见[接入离线SDK](iosapi.md) ## 新建项目(已有可跳过) 1. 启动`Xcode`,点击`File->New->Project`,选择`App`点击`Next` @@ -24,8 +24,8 @@ `Target -> General -> Identity -> Build` 输入应用`versionCode` ## Info.plist配置 - -`Target -> Info` 下,添加如下配置 +1. 若HBuilderX项目`根目录`下包含`Info.plist`文件,需要将该文件内容拷贝到`原生主工程`的`Target -> Info` 下 +2. 在`Target -> Info` 下,添加如下配置 ``` NSAppTransportSecurity diff --git a/docs/native/use/iosapi.md b/docs/native/use/iosapi.md index 7150b50948f87bee9dd8c8b82b4d92e1f5a6b87c..e4fe27f15df5695dd665628f3b1d064ef4189310 100644 --- a/docs/native/use/iosapi.md +++ b/docs/native/use/iosapi.md @@ -3,13 +3,17 @@ > * 离线SDK基于Swift开发,因此原生Objective-C语言开发的应用需要新建一个Swift文件用于添加Swift运行环境以及桥接离线SDK的API,详情可参考UniAppXDemo工程中的`UniAppBridge` # 仅离线打包 -参考如下示例修改AppDelegate(建议直接使用示例中的`HBuilder`工程) -``` -import DCloudUniappRuntime -@main -class AppDelegate: UniAppRootAppDelegate { -} -``` +1. 参考如下示例修改AppDelegate(建议直接使用示例中的`HBuilder`工程) + ``` + import DCloudUniappRuntime + @main + class AppDelegate: UniAppRootAppDelegate { + } + ``` +2. `Main.storyboard`文件中将`ViewController`的`Class`设置为`UniAppRootViewController`,`Module`设置为`DCloudUniappRuntime`. +![](https://web-ext-storage.dcloud.net.cn/native/doc/iOS/main_storyboard_viewcontroller.png) + + # 采用SDK方式接入 ## 初始化SDK diff --git a/docs/native/use/iosuts.md b/docs/native/use/iosuts.md index 348d67bfe5906071a7343728545c7d03dadd6eb9..95938cbd32514a71fa4753807fe9447c6575b5c6 100644 --- a/docs/native/use/iosuts.md +++ b/docs/native/use/iosuts.md @@ -53,6 +53,9 @@ ![](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` 获取编译产物所在路径。