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

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

(cherry picked from commit 6004b763)
上级 20ab42cc
......@@ -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
### 添加依赖库以及资源文件
| 依赖库 |
......
......@@ -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` 下,添加如下配置
```
<dict>
<key>NSAppTransportSecurity</key>
......
......@@ -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
......
......@@ -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` 获取编译产物所在路径。
......
Markdown is supported
0% .
You are about to add 0 people to the discussion. Proceed with caution.
先完成此消息的编辑!
想要评论请 注册