Android平台原生配置
app-android 文件夹下存在Android平台原生配置,包括以下目录或文件
目录名/文件名 | 用途 |
---|---|
assets | Android平台原生assets资源目录 |
libs | Android平台原生引用的三方jar/aar目录 |
res | Android平台原生res资源目录 |
AndroidManifest.xml | Android平台原生应用清单文件 |
config.json | Android平台下的配置文件 |
index.uts | 主入口,interface.uts/index.d.ts声明的能力在Android平台下的实现 |
assets
Android平台原生assets资源目录,建议只保存UTS插件内置的资源文件。
除了插件下有assets目录,项目下也有。注意2者的区别。 如果需要插件使用者配置(如三方SDK的授权文件),则插件作者应该在插件文档中告诉插件使用者,配置到项目的Android原生应用资源目录,而不是配置在插件目录下。详见
libs
Android平台原生三方库目录,支持以下类型文件:
- jar
- aar
- so库
注意:UTS插件本地调试不支持直接使用so文件,需要将so文件和调用代码封装为AAR 或者分别集成 so和jar文件
如果封装三方原生sdk为uni-app插件,可以将sdk的jar/aar文件放到此目录,但因为多个uts插件引用相同三方原生sdk时可能会产生冲突,所以如果sdk支持仓储,建议优先使用仓储配置,而不是直接把jar等文件放在libs目录。
仓储配置参考config.json的dependencies。
关于libs目录的使用,可以参考 Hello UTS
res
Android平台原生res资源目录,建议只保存UTS插件内置的资源文件。
除了插件下有res目录,项目下也有。注意2者的区别。一般使用者的配置不放在插件下,而放在自己的项目下。项目下配置详见
AndroidManifest.xml
Android原生应用清单文件,建议只保存UTS插件内置的清单文件配置。
除了插件下有AndroidManifest.xml,项目下也有。注意2者的区别。一般使用者的配置不放在插件下,而放在自己的项目下。项目下配置详见
config.json
uts插件在Android平台的原生层配置文件,可以在其中配置依赖仓储等gradle相关内容。
{
// 使用NDK时支持的CPU类型,可选(打包时不要复制注释)
"abis": [
"使用NDK时支持的cpu类型, 可取值armeabi-v7a|arm64-v8a|x86|x86_64"
],
// 依赖的仓储配置,可选,打包时会合并到原生工程的build.gradle中(打包时不要复制注释)
"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,
"project": {
"plugins": [
"com.huawei.agconnect"
],
"dependencies": [
"com.huawei.agconnect:agcp:1.6.0.300"
]
}
}
复制代码
-
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'
}
复制代码
-
minSdkVersion 插件支持的Android最低版本,整数类型,取值范围为Android API Level
- uni-app 项目支持最低版本为19,即Android 4.4.2
- uni-app x 项目支持最低版本为21,即Android 5.0
-
project 云端打包项目相关配置,当使用的三方SDK需要配置gradle插件时可配置此项:
-
plugins 此配置将会添加到云端打包工程app及build.gradle文件的“plugins”中:
plugins { id 'com.android.application' // 前面config.json示例配置将会添加如下配置 id 'com.huawei.agconnect' }
复制代码
-
dependencies
此配置将会添加到云端打包工程项目级build.gradle文件的“buildscript > dependencies”中:
buildscript { dependencies { classpath 'com.android.tools.build:gradle:7.2.0' // 前面config.json示例配置将会添加如下配置 classpath "com.huawei.agconnect:agcp:1.6.0.300" } }
复制代码
-
注意:
-
Android平台原生配置(包括引入、变更三方sdk)均需提交云端打包才能生效,真机运行时需使用自定义基座
-
HBuilderX 内置了android常见的依赖:内置依赖清单 ,开发者需要注意两点:
1 内置清单中涉及的依赖,无需手动添加,即可直接使用
2 请勿通过 手动添加jar/aar 等方式引入相同的依赖,否则会因依赖冲突导致云打包失败。
网友评论