提交 577f3a24 编写于 作者: DCloud_iOS_WZT's avatar DCloud_iOS_WZT

更新 iOS离线SDK文档补隐私清单相关说明

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