Skip to content
体验新版
项目
组织
正在加载...
登录
切换导航
打开侧边栏
DCloud
unidocs-zh
提交
8d1c4560
unidocs-zh
项目概览
DCloud
/
unidocs-zh
通知
3597
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看板
未验证
提交
8d1c4560
编写于
8月 29, 2022
作者:
打打卡夫卡
提交者:
Gitee
8月 29, 2022
浏览文件
操作
浏览文件
下载
电子邮件补丁
差异文件
update docs/plugin/uts-plugin.md.
Signed-off-by:
杜庆泉
<
zmobs0@163.com
>
上级
fc033589
变更
1
隐藏空白更改
内联
并排
Showing
1 changed file
with
32 addition
and
17 deletion
+32
-17
docs/plugin/uts-plugin.md
docs/plugin/uts-plugin.md
+32
-17
未找到文件。
docs/plugin/uts-plugin.md
浏览文件 @
8d1c4560
...
@@ -27,7 +27,7 @@ UTS语言编译到Android平台,会转为kotlin;编译到iOS平台,会转
...
@@ -27,7 +27,7 @@ UTS语言编译到Android平台,会转为kotlin;编译到iOS平台,会转
|开发语言|java/oc|uts|
|开发语言|java/oc|uts|
|开发环境|Android studio/XCode|HBuilderX|
|开发环境|Android studio/XCode|HBuilderX|
|打包方式|外挂aar 等产出物|编译时生成原生代码|
|打包方式|外挂aar 等产出物|编译时生成原生代码|
|调用方式|uni.requireNativePlugin()|普通的js
直接import
|
|调用方式|uni.requireNativePlugin()|普通的js
函数/对象,可以直接使用
|
uts插件的优势:
uts插件的优势:
...
@@ -88,59 +88,74 @@ package.json为插件的清单文件,这里集成了整个UTS插件的配置
...
@@ -88,59 +88,74 @@ package.json为插件的清单文件,这里集成了整个UTS插件的配置
插件目录下:
插件目录下:
index.d.ts文件是对当前插件能力的声明,
index.d.ts文件是对当前插件能力的
**声明**
index.uts文件是对当前插件能力的实现
针对一些通用的功能,可以用过index.uts实现即可。
index.uts文件是对当前插件能力的
**实现**
但是类似获取电量等原生相关的场景,不同的平台有不同的代码实现,即使使用UTS也无法完全抹平。
针对一些通用的功能,可以用过插件根目录下 index.uts实现即可。
但是类似获取电量等原生强相关的场景,不同的平台有不同的语法和API差异。
因此我们设计了 app-android、app-ios 等目录,用以存放不同的平台的能力实现
因此我们设计了 app-android、app-ios 等目录,用以存放不同的平台的能力实现
```
```
插件标识
插件标识
- utssdk
- utssdk
+ app-android
+ app-android
//Android平台目录
* index.uts
* index.uts
* config.json
* config.json
+ app-ios
+ app-ios
//ios平台目录
* index.uts
* index.uts
* config.json
* config.json
+ web
+ web //web 平台目录
* index.uts
+ mp-weixin
* index.uts
* index.uts
+ mp-xxx
+ mp-xxx
// 其他平台,待实现
- common
- common
- static
- static
- package.json
- package.json
- index.d.ts
- index.d.ts
// 插件能力声明
- index.uts
- index.uts
// 插件能力实现
```
```
下面以app-android 平台为例,介绍具体平台实现的构成
app-android 文件夹下 index.uts
下面以 android 平台为例,介绍平台目录的使用。
app-android 文件夹下存在两个文件
|文件名|用途|
|index.uts|index.d.ts声明的能力在Android平台下的实现|
|config.json|Android平台下的配置文件|
config.json 存放是该插件能力android平台下实现的配置。
下面是一个
实例
下面是一个
config.json 实例,这里的格式与原有的 package.json保持一致的。
[
关于package.json的更多说明
](
https://uniapp.dcloud.net.cn/plugin/uni_modules.html#package-json
)
```
json
```
json
{
{
//
依赖某些arr
"libs"
:
[
"libs"
:
[
"xxx.aar"
"xxx.aar"
],
],
//
依赖某些gradle配置
"dependencies"
:
[{
"dependencies"
:
[{
"id"
:
"com.xxx.richtext:richtext"
,
"id"
:
"com.xxx.richtext:richtext"
,
"source"
:
"implementation 'com.xxx.richtext:richtext:3.0.7'"
"source"
:
"implementation 'com.xxx.richtext:richtext:3.0.7'"
}],
}],
//
Android系统版本要求,最低Android
5.0
"minSdkVersion"
:
21
"minSdkVersion"
:
21
}
,
}
,
```
```
*注意:当同时存在平台目录的index.uts和 根目录index.uts时,会优先获取具体的平台目录*
## 3 开发UTS原生插件
## 3 开发UTS原生插件
以android平台获取电量为例,介绍UTS原生插件开发步骤
以android平台获取电量为例,介绍UTS原生插件开发步骤
...
...
编辑
预览
Markdown
is supported
0%
请重试
或
添加新附件
.
添加附件
取消
You are about to add
0
people
to the discussion. Proceed with caution.
先完成此消息的编辑!
取消
想要评论请
注册
或
登录