Skip to content
体验新版
项目
组织
正在加载...
登录
切换导航
打开侧边栏
DCloud
unidocs-uni-app-x-zh
提交
577f3a24
U
unidocs-uni-app-x-zh
项目概览
DCloud
/
unidocs-uni-app-x-zh
通知
144
Star
2
Fork
33
代码
文件
提交
分支
Tags
贡献者
分支图
Diff
Issue
9
列表
看板
标记
里程碑
合并请求
11
DevOps
流水线
流水线任务
计划
Wiki
0
Wiki
分析
仓库
DevOps
项目成员
Pages
U
unidocs-uni-app-x-zh
项目概览
项目概览
详情
发布
仓库
仓库
文件
提交
分支
标签
贡献者
分支图
比较
Issue
9
Issue
9
列表
看板
标记
里程碑
合并请求
11
合并请求
11
Pages
DevOps
DevOps
流水线
流水线任务
计划
分析
分析
仓库分析
DevOps
Wiki
0
Wiki
成员
成员
收起侧边栏
关闭侧边栏
动态
分支图
创建新Issue
流水线任务
提交
Issue看板
提交
577f3a24
编写于
7月 09, 2024
作者:
DCloud_iOS_WZT
浏览文件
操作
浏览文件
下载
电子邮件补丁
差异文件
更新 iOS离线SDK文档补隐私清单相关说明
(cherry picked from commit
6004b763
)
上级
20ab42cc
变更
4
显示空白变更内容
内联
并排
Showing
4 changed file
with
45 addition
and
20 deletion
+45
-20
docs/native/modules/ios/modules.md
docs/native/modules/ios/modules.md
+24
-6
docs/native/use/ios.md
docs/native/use/ios.md
+7
-7
docs/native/use/iosapi.md
docs/native/use/iosapi.md
+11
-7
docs/native/use/iosuts.md
docs/native/use/iosuts.md
+3
-0
未找到文件。
docs/native/modules/ios/modules.md
浏览文件 @
577f3a24
...
...
@@ -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
### 添加依赖库以及资源文件
| 依赖库 |
...
...
docs/native/use/ios.md
浏览文件 @
577f3a24
...
...
@@ -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>
...
...
docs/native/use/iosapi.md
浏览文件 @
577f3a24
...
...
@@ -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
...
...
docs/native/use/iosuts.md
浏览文件 @
577f3a24
...
...
@@ -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.
先完成此消息的编辑!
取消
想要评论请
注册
或
登录