摘要:开发过程中,我们不可避免地需要引入其他人的工作成果。库模块导入方式显然无法完成任务,因为其是通过拷贝方式导入。另外,考虑到构建问题,库模块使用的插件与应用模块尽量保持一致。
Android 开发过程中,我们不可避免地需要引入其他人的工作成果。减少重复“造轮子”的时间,投入到更有意义的核心任务当中。
Android 库模块在结构上与 Android 应用模块相同。提供构建应用所需的一切内容,包括源代码(src)、资源文件(res)和 Android 清单文件(AndroidManifest.xml)。
Android Studio IDE 提供选项创建库模块:
在项目中创建一个新的库模块(New Module)
将应用模块转换为库模块(因两者结构基本相同)
如果现有的应用模块包含希望重用的所有代码,可以通过修改 build.gradle文件:
// apply plugin: "com.android.application" apply plugin: "com.android.library"
Android 库模块编译产物为 AAR,需要作为其他应用模块依赖项使用。
Android 应用模块编译产物为 APK,设备上可以直接运行。
Android AAR 类似 Java JAR,除了类文件还可以包含 Android 资源和一个清单配置文件(AndroidManifest.xml)。
导入本地外部模块导入本地的外部模块(e.g. Project B b module)到当前主项目中(e.g. Project A)。
Project B b module 通常为库模块,我们需要在另一个 Project A 应用模块中使用它。
Android Studio IDE 提供选项以依赖项形式来添加库:
添加已编译的 AAR(或 JAR)文件(Import .JAR/.AAR Package)
将库模块导入到您的项目中(Import Module)
两者区别如下:
库模块导入方式,将会复制代码到其他项目:
Project A 目录下出现 Project B b module 的拷贝
库模块导入之后允许编辑库代码,但是修改只对当前项目生效:
Project A 目录下修改 b module 不会影响到 Project B b module
在现实开发过程中,我们希望维护一个统一版本的库模块,这样一来库模块的更新就会同步给所有依赖于它的项目:
Project A、Project C、Project D 都依赖于 Project B b module,库模块 b 的修改会同步到各个项目。
库模块导入方式显然无法完成任务,因为其是通过拷贝方式导入。
添加已编译的 AAR(或 JAR)文件可以完成任务,但是依然需要人工切换项目点选操作。
解决方案:
配置 gradle 通过本地相对路径指定库模块文件夹,实现本地外部模块导入。
打开主项目 settings.gradle 文件导入库:
include ":my-library-module" project(":my-library-module").projectDir = new File(settingsDir, "../my-library-module")
打开主项目应用模块的 build.gradle 文件,并向 dependencies 块中添加依赖:
dependencies { compile project(":my-library-module") }库模块开发注意事项
将库模块引用添加至您的 Android 应用模块后,库模块会根据优先级的顺序与应用模块进行合并。
资源合并冲突当库模块与应用模块均定义了相同资源 ID,默认使用应用模块的资源,e.g. @string/app_name
多个 AAR 库之间发生资源 ID 冲突,根据依赖项列表顺序,优先使用 dependencies 块顶部模块的资源
避免常用资源 ID 冲突的有效办法,是在各个模块中使用具有唯一性的前缀命名规范。
AndroidManifest 合并冲突考虑到兼容性问题,应用模块的 minSdkVersion 必须大于或等于库定义的版本。
库模块中如若使用到仅高版本 SDK 支持的 API,将会导致应用模块编译失败。
Android 在切换到 Gradle 作为构建系统之前,通过 Manifest 设置 minSdkVersion,之后其值会被 build.gradle 文件中的值覆盖。
Android 应用的 APK 文件中只能包含一个 AndroidManifest.xml,不过 Android Studio 项目可以包含多个该文件(来自主应用模块及各个库模块)。因此,在构建应用时,Gradle 构建会将所有清单文件(AndroidManifest.xml)合并。清单文件按照优先级从低到高合并,遵循特定规则合并各个清单文件中的所有 XML 元素 。
清单文件优先级由高到低的顺序:
清单文件构建变体
应用模块的主清单文件
所包括库中的清单文件
多个库存在时,则其清单优先级与依赖顺序即 dependencies 块中的顺序匹配。
Manifest merger failed 示例:
android:theme 在多个 AndroidManifest.xml 被定义且值不同,造成合并冲突。
Project A 主项目 AndroidManifest.xml
Project B b Library Module AndroidManifest.xml
遇到 Manifest 冲突参考 Gradle Console 给出的错误日志和提示,解决冲突。
例如使用 tools:replace 方式避免属性冲突,借助 tools 域名空间(xmlns:tools="http://schemas.android.com/tools")设置 Manifest 的合并优先级。明确表示合并时移除低优先级 library module 中的相关属性,使用高优先级 application module 中定义的对应属性内容。
Project A 主项目 AndroidManifest.xml
模块依赖分析
考虑到多重嵌套依赖问题,Gradle 类似 Maven 支持传递依赖,即库本身依赖于其他库,由此需要解决依赖之间的版本问题。
复杂的依赖关系很可能导致重复引入包,例如:support-v4、support-v7 包,从而发生冲突。
多个模块之间存在相同依赖并且发生冲突,可以通过 exclude 语法过滤相同依赖:
// helloworld build.gradle ... compile ("com.example.helloworld:my-library-module:1.0.0") { exclude group: "com.android.support", module: "support-v4" exclude group: "com.android.support", module: "support-v7" }
上述方法是在主项目引入其他库模块时进行过滤依赖,作为库模块开发者我们也应该考虑到其他用户的使用情况。
provided 语法在创建 Android 库模块时非常有用,将依赖项添加到编译过程中,但不会添加到编译输出中。这样一来减少最终 APK、AAR 产物大小,同时避免添加不必要依赖项。
注意:需要告知用户此依赖项存在,由其如何决定引入依赖。
// my-library-module build.gradle ... ext.supportLibVersion = "26.1.0" dependencies { implementation fileTree(dir: "libs", include: ["*.jar"]) provided "com.android.support:appcompat-v7:${supportLibVersion}" }
Project A 依赖 a、b、c module,同时 a、b module 又依赖于 d module,且 a、b 各自依赖的 d module 版本(version)不一致,不同 version 的 d module 中 API 接口如若发生改变,Project A Build/Sync 将会失败。 例如 version 1.0 中的方法 method1,在 version 2.0 被移除将会遇到 java.lang.NoSuchMethodError。
建议尽可能保持依赖项 d module version 一致,或者使用不同 version 但是差异不大,起码做到 API 能够通用。
通过 ./gradlew dependencies 命令可以查看依赖关系,附加参数可以查看指定类型、模块依赖关系:
./gradlew my-library-module:dependencies --configuration archives
archives - Configuration for archive artifacts. +--- com.android.support:recyclerview-v7:26.1.0 | +--- com.android.support:support-annotations:26.1.0 | +--- com.android.support:support-compat:26.1.0 | | +--- com.android.support:support-annotations:26.1.0 | | --- android.arch.lifecycle:runtime:1.0.0 | | +--- android.arch.lifecycle:common:1.0.0 | | --- android.arch.core:common:1.0.0 | --- com.android.support:support-core-ui:26.1.0 | +--- com.android.support:support-annotations:26.1.0 | --- com.android.support:support-compat:26.1.0 (*)
另外 Android 项目可以使用 ./gradlew androidDependencies。
另外,考虑到构建问题,库模块使用的 gradle 插件与应用模块尽量保持一致。
Android Gradle Plugin 版本不一致可能会影响到依赖项配置语法:
New configuration | Deprecated configuration |
---|---|
implementation | compile |
api | compile |
compileOnly | provided |
runtimeOnly | apk |
创建 Android 库
Add build dependencies
合并多个清单文件
文章版权归作者所有,未经允许请勿转载,若此文章存在违规行为,您可以联系管理员删除。
转载请注明本文地址:https://www.ucloud.cn/yun/14267.html
摘要:和在中的两大重要的概念,分别是和。每个有至少一个。配置阶段在该阶段,脚本将会执行,为每个创建和配置所有的。除了,还有三个基本的命令运行所以的这意味着运行所有的在已连的设备或模拟器上。在下一篇文章中,我们将会定制自己的文件。 这一系列暂不更新,相关技术讨论,请移步微信群,谢谢,希望大家多多支持! showImg(https://segmentfault.com/img/bVtdBU); ...
摘要:对副本的操作函数将给定的基本数组复制到给定的数组中,例如原生代码可以使用和修改数组元素,使用函数将数组复制回数组中。例如用函数获得静态域的方法,例如调用方法以方法为参数通过类函数调用实际的实例方法。 前言 之前写了一篇文章简单的介绍了Android NDK的组件和结构,以及在Android studio中开发NDK,NDK是Android底层的c/c++库,然而要在java中调用c/c...
摘要:指南无论你正在构建什么,这些指南都旨在让你尽快提高工作效率使用团队推荐的最新项目版本和技术。使用进行消息传递了解如何将用作消息代理。安全架构的主题指南,这些位如何组合以及它们如何与交互。使用的主题指南以及如何为应用程序创建容器镜像。 Spring 指南 无论你正在构建什么,这些指南都旨在让你尽快提高工作效率 — 使用Spring团队推荐的最新Spring项目版本和技术。 入门指南 这些...
摘要:我们一般把自动化测试划分为三种分别是单元测试目的是测试代码的最小单元。集成测试用来测试一个完成的组件或子系统,确保多个类之间的交互是否按预期运行。集成测试需要比单元测试需要更长的执行时间,而且更加难以维护,失败的原因难以诊断。 前言;为什么我们要用Gradle管理组件呢?先来看看Android组件化需要实现的目标按照业务逻辑划分模块项目模块能够单独启动测试能够根据需求引入或删除某些业务模块通...
摘要:我们一般把自动化测试划分为三种分别是单元测试目的是测试代码的最小单元。集成测试用来测试一个完成的组件或子系统,确保多个类之间的交互是否按预期运行。集成测试需要比单元测试需要更长的执行时间,而且更加难以维护,失败的原因难以诊断。 前言;为什么我们要用Gradle管理组件呢?先来看看Android组件化需要实现的目标按照业务逻辑划分模块项目模块能够单独启动测试能够根据需求引入或删除某些业务模块通...
阅读 1093·2023-04-26 00:10
阅读 2208·2021-09-22 15:38
阅读 3193·2021-09-22 15:13
阅读 3287·2019-08-30 13:11
阅读 463·2019-08-30 11:01
阅读 2887·2019-08-29 14:20
阅读 3097·2019-08-29 13:27
阅读 1580·2019-08-29 11:33