Skip to content
体验新版
项目
组织
正在加载...
登录
切换导航
打开侧边栏
DCloud
unidocs-zh
提交
2cd10e7e
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看板
提交
2cd10e7e
编写于
11月 30, 2022
作者:
杜庆泉
浏览文件
操作
浏览文件
下载
电子邮件补丁
差异文件
Update uts-for-android.md
上级
e205be7f
变更
1
隐藏空白更改
内联
并排
Showing
1 changed file
with
36 addition
and
89 deletion
+36
-89
docs/plugin/uts-for-android.md
docs/plugin/uts-for-android.md
+36
-89
未找到文件。
docs/plugin/uts-for-android.md
浏览文件 @
2cd10e7e
...
...
@@ -278,7 +278,7 @@ HX3.6.7 版本内置了以下依赖
但Android开发中经常要复写application和activity,uni-app主引擎已经复写了相关类。所以想要操作application和activity,需要调用uni-app引擎封装的API。
这些api在
`io.dcloud.uts
.android`
库中
,具体见下。
这些api在
`io.dcloud.uts
`
库下 UTSAndroid对象
,具体见下。
### 4.1 application 上下文相关
...
...
@@ -288,7 +288,7 @@ HX3.6.7 版本内置了以下依赖
```
ts
import
{
getAppContext
}
from
"
io.dcloud.uts.android
"
;
import
{
UTSAndroid
}
from
"
io.dcloud.uts
"
;
```
用法说明:获取当前应用Application上下文,对应android平台 Context.getApplicationContext 函数实现
...
...
@@ -298,7 +298,7 @@ Android开发场景中,调用应用级别的资源/能力,需要使用此上
```
ts
// [示例]获取asset下的音频,并且播放
let
assetManager
=
getAppContext
()
!
.
getAssets
();
let
assetManager
=
UTSAndroid
.
getAppContext
()
!
.
getAssets
();
let
afd
=
assetManager
.
openFd
(
"
free.mp3
"
);
let
mediaPlayer
=
new
MediaPlayer
();
mediaPlayer
.
setDataSource
(
afd
.
getFileDescriptor
(),
afd
.
getStartOffset
(),
afd
.
getLength
());
...
...
@@ -313,7 +313,7 @@ mediaPlayer.start();
```
ts
import
{
getResourcePath
}
from
"
io.dcloud.uts.android
"
;
import
{
UTSAndroid
}
from
"
io.dcloud.uts
"
;
```
获取指定插件资源的运行期绝对路径
...
...
@@ -321,7 +321,7 @@ import { getResourcePath } from "io.dcloud.uts.android";
```
ts
// [示例]获取指定资源路径
// 得到文件运行时路径: `/storage/emulated/0/Android/data/io.dcloud.HBuilder/apps/__UNI__3732623/www/uni_modules/test-uts-static/static/logo.png`
getResourcePath
(
"
uni_modules/test-uts-static/static/logo.png
"
)
UTSAndroid
.
getResourcePath
(
"
uni_modules/test-uts-static/static/logo.png
"
)
```
...
...
@@ -329,16 +329,13 @@ getResourcePath("uni_modules/test-uts-static/static/logo.png")
##### onAppTrimMemory
> HBuilderX 3.6.
8
+
> HBuilderX 3.6.
11
+
```
ts
import
{
onAppTrimMemory
}
from
"
io.dcloud.uts.android
"
;
```
App 内存不足时,系统回调函数 对应原生的API: onTrimMemory
```
ts
onAppTrimMemory
((
level
:
Number
)
=>
{
UTSAndroid
.
onAppTrimMemory
((
level
:
Number
)
=>
{
let
eventName
=
"
onAppTrimMemory -
"
+
level
;
console
.
log
(
eventName
);
});
...
...
@@ -346,11 +343,8 @@ onAppTrimMemory((level:Number) => {
##### offAppTrimMemory
> HBuilderX 3.6.
9
+
> HBuilderX 3.6.
11
+
```
ts
import
{
offAppTrimMemory
}
from
"
io.dcloud.uts.android
"
;
```
onAppTrimMemory 对应的反注册函数
...
...
@@ -358,9 +352,9 @@ onAppTrimMemory 对应的反注册函数
```
ts
// 移除所有监听
offAppTrimMemory
()
UTSAndroid
.
offAppTrimMemory
()
// 移除指定监听
offAppTrimMemory
((
level
:
Number
)
=>
{
UTSAndroid
.
offAppTrimMemory
((
level
:
Number
)
=>
{
});
```
...
...
@@ -370,16 +364,13 @@ offAppTrimMemory((level:Number) => {
##### onAppConfigChange
> HBuilderX 3.6.
8
+
> HBuilderX 3.6.
1
+
```
ts
import
{
onAppConfigChange
}
from
"
io.dcloud.uts.android
"
;
```
App 配置发生变化时触发,比如横竖屏切换 对应原生的API: onConfigurationChanged
```
ts
onAppConfigChange
((
ret
:
UTSJSONObject
)
=>
{
UTSAndroid
.
onAppConfigChange
((
ret
:
UTSJSONObject
)
=>
{
let
eventName
=
"
onAppConfigChange -
"
+
JSON
.
stringify
(
ret
);
console
.
log
(
eventName
);
});
...
...
@@ -387,11 +378,6 @@ onAppConfigChange((ret:UTSJSONObject) => {
##### offAppConfigChange
> HBuilderX 3.6.9+
```
ts
import
{
offAppConfigChange
}
from
"
io.dcloud.uts.android
"
;
```
与onAppConfigChange 对应的反注册函数
...
...
@@ -399,9 +385,9 @@ import { offAppConfigChange } from "io.dcloud.uts.android";
```
ts
// 移除所有监听
offAppConfigChange
();
UTSAndroid
.
offAppConfigChange
();
// 移除指定监听
offAppConfigChange
(
function
(
ret
){
UTSAndroid
.
offAppConfigChange
(
function
(
ret
){
});
```
...
...
@@ -415,7 +401,7 @@ offAppConfigChange(function(ret){
比如获取app缓存目录:
```
getAppContext()!.getExternalCacheDir()!.getPath()
UTSAndroid.
getAppContext()!.getExternalCacheDir()!.getPath()
```
...
...
@@ -423,11 +409,8 @@ getAppContext()!.getExternalCacheDir()!.getPath()
#### 4.2.1 getUniActivity
> HBuilderX 3.6.
3
+
> HBuilderX 3.6.
11
+
```
ts
import
{
getUniActivity
}
from
"
io.dcloud.uts.android
"
;
```
获取当前插件所属的activity实例,对应android平台 getActivity 函数实现
...
...
@@ -444,14 +427,11 @@ let frameContent = decorView.findViewById<FrameLayout>(android.R.id.content)
> HBuilderX 3.6.3+
```
ts
import
{
onAppActivityPause
}
from
"
io.dcloud.uts.android
"
;
```
App的activity onPause时触发
```
ts
onAppActivityPause
(()
=>
{
UTSAndroid
.
onAppActivityPause
(()
=>
{
let
eventName
=
"
onAppActivityPause -
"
+
Date
.
now
();
console
.
log
(
eventName
);
});
...
...
@@ -465,15 +445,12 @@ onAppActivityPause 对应的反注册函数
如果传入的函数可为空,如果为空,则视为移除所有监听
```
ts
import
{
offAppActivityPause
}
from
"
io.dcloud.uts.android
"
;
```
```
ts
// 移除全部监听
offAppActivityPause
();
UTSAndroid
.
offAppActivityPause
();
// 移除指定监听
offAppActivityPause
(()
=>
{
UTSAndroid
.
offAppActivityPause
(()
=>
{
});
```
...
...
@@ -485,14 +462,12 @@ offAppActivityPause(() => {
> HBuilderX 3.6.3+
```
ts
import
{
onAppActivityResume
}
from
"
io.dcloud.uts.android
"
;
```
App的activity onResume时触发
```
ts
onAppActivityResume
(()
=>
{
UTSAndroid
.
onAppActivityResume
(()
=>
{
let
eventName
=
"
onAppActivityResume -
"
+
Date
.
now
();
console
.
log
(
eventName
);
});
...
...
@@ -506,15 +481,12 @@ onAppActivityResume 对应的反注册函数
如果传入的函数可为空,如果为空,则视为移除所有监听
```
ts
import
{
onAppActivityResume
}
from
"
io.dcloud.uts.android
"
;
```
```
ts
// 移除全部监听
onAppActivityResume
();
UTSAndroid
.
onAppActivityResume
();
// 移除指定监听
onAppActivityResume
(()
=>
{
UTSAndroid
.
onAppActivityResume
(()
=>
{
});
```
...
...
@@ -526,14 +498,11 @@ onAppActivityResume(() => {
> HBuilderX 3.6.3+
```
ts
import
{
onAppActivityDestroy
}
from
"
io.dcloud.uts.android
"
;
```
App 的 activity onDestroy时触发
```
ts
onAppActivityDestroy
(()
=>
{
UTSAndroid
.
onAppActivityDestroy
(()
=>
{
let
eventName
=
"
onAppActivityDestroy-
"
+
Date
.
now
();
console
.
log
(
eventName
);
});
...
...
@@ -547,15 +516,12 @@ onAppActivityDestroy 对应的反注册函数
如果传入的函数可为空,如果为空,则视为移除所有监听
```
ts
import
{
offAppActivityDestroy
}
from
"
io.dcloud.uts.android
"
;
```
```
ts
// 移除全部监听
offAppActivityDestroy
();
UTSAndroid
.
offAppActivityDestroy
();
// 移除指定监听
offAppActivityDestroy
(()
=>
{
UTSAndroid
.
offAppActivityDestroy
(()
=>
{
});
```
...
...
@@ -567,14 +533,11 @@ offAppActivityDestroy(() => {
> HBuilderX 3.6.3+
```
ts
import
{
onAppActivityBack
}
from
"
io.dcloud.uts.android
"
;
```
App 的 activity 回退物理按键点击时触发
```
ts
onAppActivityBack
(()
=>
{
UTSAndroid
.
onAppActivityBack
(()
=>
{
let
eventName
=
"
onAppActivityBack-
"
+
Date
.
now
();
console
.
log
(
eventName
);
});
...
...
@@ -589,15 +552,12 @@ onAppActivityBack 对应的反注册函数
如果传入的函数可为空,如果为空,则视为移除所有监听
```
ts
import
{
offAppActivityBack
}
from
"
io.dcloud.uts.android
"
;
```
```
ts
// 移除全部监听
offAppActivityBack
();
UTSAndroid
.
offAppActivityBack
();
// 移除指定监听
offAppActivityBack
(()
=>
{
UTSAndroid
.
offAppActivityBack
(()
=>
{
});
```
...
...
@@ -609,14 +569,10 @@ offAppActivityBack(() => {
> HBuilderX 3.6.8+
```
ts
import
{
onAppActivityResult
}
from
"
io.dcloud.uts.android
"
;
```
App 的 activity 启动其他activity的回调结果监听 对应原生的 onActivityResult
```
ts
onAppActivityResult
((
requestCode
:
Int
,
resultCode
:
Int
,
data
?:
Intent
)
=>
{
UTSAndroid
.
onAppActivityResult
((
requestCode
:
Int
,
resultCode
:
Int
,
data
?:
Intent
)
=>
{
let
eventName
=
"
onAppActivityResult - requestCode:
"
+
requestCode
+
"
-resultCode:
"
+
resultCode
+
"
-data:
"
+
JSON
.
stringify
(
data
);
console
.
log
(
eventName
);
});
...
...
@@ -630,15 +586,12 @@ onAppActivityResult 对应的反注册函数
如果传入的函数可为空,如果为空,则视为移除所有监听
```
ts
import
{
offAppActivityResult
}
from
"
io.dcloud.uts.android
"
;
```
```
ts
// 移除全部监听
offAppActivityResult
();
UTSAndroid
.
offAppActivityResult
();
// 移除指定监听
offAppActivityResult
(()
=>
{
UTSAndroid
.
offAppActivityResult
(()
=>
{
});
```
...
...
@@ -649,14 +602,11 @@ offAppActivityResult(() => {
> HBuilderX 3.6.3+
```
ts
import
{
onAppActivityRequestPermissionsResult
}
from
"
io.dcloud.uts.android
"
;
```
App 的 activity 获得权限请求结果的回调
```
ts
onAppActivityRequestPermissionsResult
((
requestCode
:
number
,
UTSAndroid
.
onAppActivityRequestPermissionsResult
((
requestCode
:
number
,
permissions
:
MutableList
<
string
>
,
grantResults
:
MutableList
<
number
>
)
=>
{
...
...
@@ -679,15 +629,12 @@ onAppActivityRequestPermissionsResult 对应的反注册函数
如果传入的函数可为空,如果为空,则视为移除所有监听
```
ts
import
{
offAppActivityRequestPermissionsResult
}
from
"
io.dcloud.uts.android
"
;
```
```
ts
// 移除全部监听
offAppActivityRequestPermissionsResult
();
UTSAndroid
.
offAppActivityRequestPermissionsResult
();
// 移除指定监听
offAppActivityRequestPermissionsResult
(()
=>
{
UTSAndroid
.
offAppActivityRequestPermissionsResult
(()
=>
{
});
-----------------------------
...
...
@@ -698,7 +645,7 @@ offAppActivityRequestPermissionsResult(() => {
比如获取当前activity的顶层View容器
```
ts
getUniActivity()!.getWindow().getDecorView();
UTSAndroid.
getUniActivity()!.getWindow().getDecorView();
```
...
...
编辑
预览
Markdown
is supported
0%
请重试
或
添加新附件
.
添加附件
取消
You are about to add
0
people
to the discussion. Proceed with caution.
先完成此消息的编辑!
取消
想要评论请
注册
或
登录