From a7f979f67ae9f44f68a979abf10e1209069e0b78 Mon Sep 17 00:00:00 2001 From: yanyilin Date: Fri, 9 Sep 2022 18:25:48 +0800 Subject: [PATCH] =?UTF-8?q?=E5=AE=8C=E5=96=84Android=E5=B9=B3=E5=8F=B0conf?= =?UTF-8?q?ig.json=E7=9A=84=E9=85=8D=E7=BD=AE=E8=AF=B4=E6=98=8E?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- docs/plugin/uts-plugin.md | 48 +++++++++++++++++++++++++++++++-------- 1 file changed, 39 insertions(+), 9 deletions(-) diff --git a/docs/plugin/uts-plugin.md b/docs/plugin/uts-plugin.md index 21f6f96ef..d2fba95fb 100644 --- a/docs/plugin/uts-plugin.md +++ b/docs/plugin/uts-plugin.md @@ -182,13 +182,11 @@ Android平台原生三方库目录,支持以下类型文件: 如果使用了NDK开发so库,也支持保存到此目录,需按Android的abi类型分目录保存。 -如果封装三方原生sdk为uni-app插件,经常需要使用本目录。 +如果封装三方原生sdk为uni-app插件,可以将sdk的jar/aar文件放到此目录,但不推荐这么做,如果三方原生sdk支持仓储建议优先使用仓储,参考config.json的[dependencies](#dependencies)。 关于libs目录的使用,可以参考 [Hello UTS](https://gitcode.net/dcloud/hello-uts/-/tree/master/uni_modules) -**遗留事项** - -HX 3.6.1 libs使用存在[临时注意事项](#tempnotice) +> 遗留事项: HBuilderX3.6.1版本对libs目录使用还不完善,[详见](#tempnotice) ##### res Android平台原生res资源目录,建议只保存UTS插件内置的资源文件。 @@ -207,18 +205,50 @@ uts插件在Android平台的原生层配置文件,可以在其中配置依赖 { // 使用NDK时支持的CPU类型,可选 "abis": [ - "使用NDK时支持的cpu类型, 可取值armeabi-v7a|arm64-v8a|x86" + "使用NDK时支持的cpu类型, 可取值armeabi-v7a|arm64-v8a|x86|x86_64" ], // 依赖的仓储配置,可选,打包时会合并到原生工程的build.gradle中 - "dependencies": [{ - "id": "com.xxx.richtext:richtext", - "source": "implementation 'com.xxx.richtext:richtext:3.0.7'" - }], + "dependencies": [ + "androidx.core:core-ktx:1.6.0", + { + "id": "com.xxx.richtext:richtext", + "source": "implementation 'com.xxx.richtext:richtext:3.0.7'" + } + ], // Android系统版本要求,最低Android 5.0 "minSdkVersion": 21 } ``` +- abis +当插件使用了NDK开发的so库时配置,描述插件支持CPU类型。 +可取值:armeabi-v7a、arm64-v8a、x86、x86_64 + + + +- dependencies +配置插件依赖的仓储,云端打包时会合并到Android原生工程的build.gradle的 +数组类型,数组中的项可以是字符串类型或JSON对象 +对于字符串类型项,将会作为`implementation`方式依赖添加到build.gradle中,上面示例中"androidx.core:core-ktx:1.6.0"将会添加以下配置 +``` +dependencies { + implementation 'androidx.core:core-ktx:1.6.0' +} +``` +对于JSON类型项,将会把source字段值作为gradle源码添加到build.gradle中,上面示例中"id": "com.xxx.richtext:richtext"项将会添加以下配置 +``` +dependencies { + implementation 'com.xxx.richtext:richtext:3.0.7' +} +``` + +> 遗留事项: HBuilderX3.6.1版本对dependencies配置支持还不完善,[详见](#tempnotice) + +- minSdkVersion +插件支持的Android最低版本,整数类型,取值范围为Android API Level +默认uni-app最低支持版本为19,即Android4.3.3 + + **注意:** Android平台原生配置需提交云端打包才能生效,真机运行时需使用[自定义基座](https://uniapp.dcloud.net.cn/tutorial/run/run-app.html#customplayground) -- GitLab