From 8ce5b8f8104e49098873b3e140ab69f827968383 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?=E6=9D=9C=E5=BA=86=E6=B3=89?= Date: Fri, 2 Sep 2022 04:14:25 +0000 Subject: [PATCH] update docs/plugin/uts-plugin.md. MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Signed-off-by: 杜庆泉 --- docs/plugin/uts-plugin.md | 38 ++++++++++++++++++++++++++++---------- 1 file changed, 28 insertions(+), 10 deletions(-) diff --git a/docs/plugin/uts-plugin.md b/docs/plugin/uts-plugin.md index fc84fdb3d..aa5239a31 100644 --- a/docs/plugin/uts-plugin.md +++ b/docs/plugin/uts-plugin.md @@ -100,6 +100,7 @@ package.json的完整文档[详见](uni_modules.md#package.json) 
 	
+
 ┌─utssdk
 │	├─app-android //Android平台目录
 │	│ └─index.uts
@@ -109,7 +110,7 @@ package.json的完整文档[详见](uni_modules.md#package.json)
 │	│ └─config.json //ios原生配置
 │	├─web //web平台目录
 │	│ └─index.uts
-│	└─mp-xxx  // 其他平台，待实现
+│	└─mp-xxx  // 其他平台
 ├─common // 可跨端公用的uts代码。推荐，不强制
 ├─static // 静态资源
 ├─package.json
@@ -281,34 +282,49 @@ import { getAppContext } from "io.dcloud.uts.android";
 
 ### getAppContext
 
-获取当前应用Application上下文，对应android平台上的application context
+获取当前应用Application上下文，对应android平台 Context.getApplicationContext 函数实现
+
+Android开发场景中，调用应用级别的资源/能力，需要使用此上下文。更多用法，参考[Android官方文档]()
+
+
 ```ts
-fun getAppContext():Context?
+// [示例]获取asset下的音频，并且播放
+let assetManager = getAppContext()!.getAssets();
+let afd = assetManager.openFd("free.mp3");
+let mediaPlayer = new MediaPlayer();
+mediaPlayer.setDataSource(afd.getFileDescriptor(),afd.getStartOffset(), afd.getLength());
+mediaPlayer.prepare();
+mediaPlayer.start();
 ```
 
 ### getUniActivity
 
-获取当前应用宿主activity示例，当前 uni-app 应用实例的宿主activity
+获取当前插件所属的activity实例，对应android平台 getActivity 函数实现
+
+Android开发场景中，调用活动的级别的资源/能力，需要使用此上下文。更多用法，参考[Android官方文档]()
+
 ```ts
-fun getUniActivity():Context?
+// [示例]获取当前activity顶层容器
+let frameContent = decorView.findViewById(android.R.id.content)
 ```
 
 ### getResourcePath(resourceName:String)
 
 获取指定插件资源 的运行期绝对路径
-```ts
-fun getResourcePath(resourceName:String):String
-```
+
 
 比如，插件A使用到了一张图片，开发期间 存放位置为`uni_modules/test-uts-static/static/logo.png`
 
 程序运行期间，需要获取到此资源，可以使用 
  
 ```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")
+
 ```
 
-得到文件运行时路径: `/storage/emulated/0/Android/data/io.dcloud.HBuilder/apps/__UNI__3732623/www/uni_modules/test-uts-static/static/logo.png`
+
 
 ### onAppActivityPause
 
@@ -326,6 +342,7 @@ getResourcePath("uni_modules/test-uts-static/static/logo.png")
 
 容器的宿主activity 回退物理按键点击时触发
 
+
 ## 常见问题
 
 ### 常见报错
@@ -346,7 +363,8 @@ let textSize =  30.0.toFloat();
 android中UI相关的api，很多会要求泛型，目前uts支持用as关键字强转，满足类似的场景
 
 ```ts
-let frameContent = decorView.findViewById(android.R.id.content) as FrameLayout
+let frameContent = decorView.findViewById(android.R.id.content)
+let layoutParam = new FrameLayout.LayoutParams(ViewGroup.LayoutParams.MATCH_PARENT,ViewGroup.LayoutParams.WRAP_CONTENT);
 ```
 
 ## 路线图
-- 
GitLab