Skip to content
体验新版
项目
组织
正在加载...
登录
切换导航
打开侧边栏
DCloud
unidocs-zh
提交
140bf407
unidocs-zh
项目概览
DCloud
/
unidocs-zh
通知
3598
Star
108
Fork
921
代码
文件
提交
分支
Tags
贡献者
分支图
Diff
Issue
120
列表
看板
标记
里程碑
合并请求
109
DevOps
流水线
流水线任务
计划
Wiki
0
Wiki
分析
仓库
DevOps
项目成员
Pages
unidocs-zh
项目概览
项目概览
详情
发布
仓库
仓库
文件
提交
分支
标签
贡献者
分支图
比较
Issue
120
Issue
120
列表
看板
标记
里程碑
合并请求
109
合并请求
109
Pages
DevOps
DevOps
流水线
流水线任务
计划
分析
分析
仓库分析
DevOps
Wiki
0
Wiki
成员
成员
收起侧边栏
关闭侧边栏
动态
分支图
创建新Issue
流水线任务
提交
Issue看板
提交
140bf407
编写于
2月 24, 2023
作者:
lizhongyi_
浏览文件
操作
浏览文件
下载
电子邮件补丁
差异文件
update docs uts-for-ios.md
上级
d9a15e1c
变更
1
隐藏空白更改
内联
并排
Showing
1 changed file
with
63 addition
and
61 deletion
+63
-61
docs/plugin/uts-for-ios.md
docs/plugin/uts-for-ios.md
+63
-61
未找到文件。
docs/plugin/uts-for-ios.md
浏览文件 @
140bf407
...
...
@@ -140,14 +140,74 @@ UTS.entitlements 格式及配置规则与 iOS 工程中是一致的,云端打
### 3.4 依赖三方库
uts 插件支持依赖三方库,目前
仅支持 framework 和 xcframework 静态
库
uts 插件支持依赖三方库,目前
支持 framework、xcframework(仅云打包支持)、.a
库
需要将依赖的三方库文件存放到插件目录下
`~/utssdk/app-ios/Framework/`
路径中
#### 3.4.1 framework依赖库说明
需要将依赖的framework或者xcframework文件存放到插件目录下
`~/utssdk/app-ios/Framework/`
路径中
云端打包时会将此目录中所有的依赖库添加到工程中,建议只存放与插件相关的依赖库
以 hello uts 中的 uts-tencentgeolocation 腾讯定位插件为例,本插件需要依赖腾讯定位库
`TencentLBS.framework`
,则将依赖库存放到
`~/uni_modules/uts-tencentgeolocation/utssdk/app-ios/Framework/TencentLBS.framework`
位置即可
#### 3.4.2 .a依赖库相关说明
##### 3.4.2.1 .a库存放的目录结构
<pre
v-pre=
""
data-lang=
""
>
<code
class=
"lang-"
style=
"padding:0"
>
└─Libs // .a库存放目录
├─MyStaticLibA //A静态库(该库所有文件放在此文件夹内,OC库)
│ ├─libMyStaticLib.a //.a文件,必须
│ ├─MyStaticLib.h //A.a库对应的头文件,必须
│ ├─MyClassA.h //需要暴露的头文件A,可选
│ └─MyClassB.h //需要暴露的头文件B,可选
└─TestSwiftLibrary //B静态库(该库所有文件放在此文件夹内,Swift库)
├─libTestSwiftLibrary.a //.a文件,必须
└─TestSwiftLibrary.swiftmodule //.swiftmodule文件夹,必须
</code>
</pre>
注意:
-
将.a库的所有文件存放在一个文件夹内,多个.a库就创建多个文件夹;
-
未对某个.a库文件夹下的文件做递归查找,请不要将.a或.h文件嵌套在多层文件夹内,以免发生错误;
##### 3.4.2.2 .a库的使用说明
-
OC语言创建的.a库在使用时无需import,可直接使用;
-
Swift语言创建的.a库在使用前需要在uts文件中import;
-
HBuilder X目前暂不支持.a库相关代码的语法提示;
##### 3.4.2.3 .a库的使用示例
-
OC语言创建的.a库使用示例:
```
ts
// uts
const
aResult
=
ToolA
.
toolAMethod
();
const
bResult
=
ToolB
.
toolBMethod
();
const
libResult
=
TestLib
.
testLib
();
const
res
=
{
aResult
:
aResult
,
bResult
:
bResult
,
libResult
:
libResult
};
options
.
success
?.(
res
);
```
-
Swift语言创建的.a库使用示例:
```
ts
// uts
import
{
Tool
,
Manager
,
TestLibraryExa
}
from
'
TestLibraryExa
'
;
Manager
.
testManager
();
Tool
.
testTool
()
let
lib
=
TestLibraryExa
();
lib
.
test
()
console
.
log
(
lib
.
version
);
```
## 4 iOS 平台内置库 DCloudUTSFoundation
> HBuilder X 3.6.11+ 版本支持
...
...
@@ -596,65 +656,7 @@ HBuilderX 目前写iOS uts 插件时部分语法提示会有缺失、参数类
-
元组类型目前不支持
### 8 .a依赖库相关说明
#### 8.1 .a库存放的目录结构
<pre
v-pre=
""
data-lang=
""
>
<code
class=
"lang-"
style=
"padding:0"
>
└─Libs // .a库存放目录
├─MyStaticLibA //A静态库(该库所有文件放在此文件夹内,OC库)
│ ├─libMyStaticLib.a //.a文件,必须
│ ├─MyStaticLib.h //A.a库对应的头文件,必须
│ ├─MyClassA.h //需要暴露的头文件A,可选
│ └─MyClassB.h //需要暴露的头文件B,可选
└─TestSwiftLibrary //B静态库(该库所有文件放在此文件夹内,Swift库)
├─libTestSwiftLibrary.a //.a文件,必须
└─TestSwiftLibrary.swiftmodule //.swiftmodule文件夹,必须
</code>
</pre>
注意:
-
将.a库的所有文件存放在一个文件夹内,多个.a库就创建多个文件夹;
-
未对某个.a库文件夹下的文件做递归查找,请不要将.a或.h文件嵌套在多层文件夹内,以免发生错误;
#### 8.2 .a库的使用说明
-
OC语言创建的.a库在使用时无需import,可直接使用;
-
Swift语言创建的.a库在使用前需要在uts文件中import;
-
HBuilder X目前暂不支持.a库相关代码的语法提示;
#### 8.3 .a库的使用示例
-
OC语言创建的.a库使用示例:
```
ts
// uts
const
aResult
=
ToolA
.
toolAMethod
();
const
bResult
=
ToolB
.
toolBMethod
();
const
libResult
=
TestLib
.
testLib
();
const
res
=
{
aResult
:
aResult
,
bResult
:
bResult
,
libResult
:
libResult
};
options
.
success
?.(
res
);
```
-
Swift语言创建的.a库使用示例:
```
ts
// uts
import
{
Tool
,
Manager
,
TestLibraryExa
}
from
'
TestLibraryExa
'
;
Manager
.
testManager
();
Tool
.
testTool
()
let
lib
=
TestLibraryExa
();
lib
.
test
()
console
.
log
(
lib
.
version
);
```
### 9 有关Swift语言创建的Framework和.a的Swift版本兼容性问题
## 8 有关Swift语言创建的Framework和.a的Swift版本兼容性问题
-
由于高版本XCode编译的Swift语言Framework动态库、静态库、.a库在低版本XCode上无法编译通过,因此存在Swift版本兼容性问题;
-
目前打包机使用的XCode版本号是13.2.1,对应的Swift版本是5.5.2;
...
...
编辑
预览
Markdown
is supported
0%
请重试
或
添加新附件
.
添加附件
取消
You are about to add
0
people
to the discussion. Proceed with caution.
先完成此消息的编辑!
取消
想要评论请
注册
或
登录