uts- Android平台配置1

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 等方式引入相同的依赖，否则会因依赖冲突导致云打包失败。