在Android.bp引入Android.androidx的依赖库

<think>我们正在讨论的是在Android.bp文件中添加AndroidX依赖库。AndroidX是Android Jetpack的一部分，提供了向后兼容的库。在基于Soong构建系统（使用Android.bp）的项目中，我们通常使用Maven仓库来管理这些依赖。 但是，请注意：Android.bp文件通常用于系统级开发（如AOSP），而应用层开发通常使用Gradle（build.gradle）。如果您的项目是AOSP的一部分，需要将AndroidX库集成到系统镜像中，那么您需要将AndroidX库作为预构建的aar或jar添加到您的项目中，因为Soong构建系统并不直接支持从Maven仓库下载依赖（不像Gradle）。 不过，从Android 10（Q）开始，AOSP中已经包含了一些AndroidX库的预构建模块。您可以在AOSP的prebuilts目录下找到它们。如果您的项目是AOSP的一部分，您可以直接使用这些预定义的模块。 如果您需要添加的AndroidX库不在AOSP的预构建库中，您需要手动将aar或jar文件下载到您的项目，然后通过prebuilt_aar或java_import等模块类型引入。 下面我将介绍两种常见情况： 情况1：AOSP中已存在的AndroidX库 情况2：需要手动添加AndroidX库（通过下载aar文件） 我们以添加AndroidX的appcompat库为例。 ### 情况1：使用AOSP中预置的AndroidX库（推荐） 在AOSP中，许多AndroidX库已经作为预构建模块提供。您可以在`prebuilts/sdk/current/androidx`目录下找到它们。要使用这些模块，您只需要在Android.bp文件中通过`static_libs`或`libs`（根据模块类型）来引用。 例如，要添加`appcompat`依赖，您可以查找对应的模块名称。通常，模块名称会以`androidx.appcompat_appcompat`这样的形式存在。您可以在`prebuilts/sdk/current/androidx/Android.bp`文件中查找具体的模块定义。 假设我们找到了模块名为`androidx.appcompat_appcompat`，那么在您的Android.bp文件中可以这样添加： ```blueprint android_app { name: "my_app", // ... 其他属性 static_libs: [ "androidx.appcompat_appcompat", // 其他依赖 ], } ``` ### 情况2：手动添加AndroidX库（下载aar文件） 如果AOSP中没有您需要的AndroidX库，您需要手动下载aar文件（以及可能的传递依赖），然后将它们添加到您的项目中。 步骤： 1. 从Maven仓库下载所需的aar文件（例如，[https://maven.google.com](https://maven.google.com)）。 例如，下载appcompat: - 搜索groupId: `androidx.appcompat`, artifactId: `appcompat`, 选择版本（如1.6.1）。 - 下载文件：`appcompat-1.6.1.aar` 2. 将下载的aar文件放入项目目录，例如`libs/`目录。 3. 在Android.bp中定义`prebuilt_aar`模块。 4. 注意：AndroidX库通常有传递依赖，您需要同时下载这些传递依赖的aar或jar文件，并同样定义为预构建模块，然后在`deps`属性中声明。 示例（以appcompat为例）： 假设我们下载了`appcompat-1.6.1.aar`和它的传递依赖（例如`fragment-1.5.5.aar`、`core-1.9.0.aar`等，具体依赖关系需要查看pom文件）。 项目结构： ``` project/ |-- libs/ |-- appcompat-1.6.1.aar |-- fragment-1.5.5.aar |-- core-1.9.0.aar |-- Android.bp ``` 在Android.bp中： ```blueprint // 定义每个aar文件的预构建模块 prebuilt_aar { name: "androidx-appcompat", aar: "libs/appcompat-1.6.1.aar", // 如果该库有依赖，需要在deps中列出 deps: [ "androidx-fragment", "androidx-core", // ... 其他依赖 ], // 可选：指定sdk版本 sdk_version: "current", } prebuilt_aar { name: "androidx-fragment", aar: "libs/fragment-1.5.5.aar", deps: [ // 它的依赖... ], } prebuilt_aar { name: "androidx-core", aar: "libs/core-1.9.0.aar", // ... 可能还有依赖 } // 然后，在您的应用模块中使用 android_app { name: "my_app", srcs: ["src/**/*.java"], manifest: "AndroidManifest.xml", static_libs: ["androidx-appcompat"], // ... 其他属性 } ``` 但是，手动管理传递依赖非常繁琐。因此，如果可能，尽量使用AOSP中已经提供的AndroidX库。 ### 另一种方法：使用Android.bp中的maven_repository（仅限支持的系统） 在较新的AOSP版本中（具体从哪个版本开始不确定），Soong构建系统支持从Maven仓库下载依赖。您可以在Android.bp文件中使用`maven_repository`模块，并在项目中使用`maven`模块来声明依赖。 但是，请注意，这个功能可能并不稳定，且主要被用于构建系统模块，而不是应用。具体可以参考AOSP文档。 示例： 首先，在顶层Android.bp（或者您模块的Android.bp）中定义Maven仓库： ```blueprint maven_repository { name: "maven_central", // 可以添加多个URL urls: [ "https://repo1.maven.org/maven2", "https://maven.google.com", ], } ``` 然后，在您的模块中，使用`maven`模块来声明依赖： ```blueprint maven { name: "androidx-appcompat", group: "androidx.appcompat", artifact: "appcompat", version: "1.6.1", repository: "maven_central", // 上面定义的仓库名称 } android_app { name: "my_app", // ... static_libs: ["androidx-appcompat"], } ``` 但是，请注意，这种方法在AOSP中可能并不常见，而且需要您的构建环境能够访问互联网。此外，它可能不支持传递依赖的自动下载，您可能需要手动添加所有传递依赖。 ### 总结 在Android.bp中添加AndroidX依赖库的推荐方法： 1. **优先使用AOSP预置的AndroidX库**：在`prebuilts/sdk/current/androidx`中查找，并直接使用模块名称。 2. **手动下载aar并添加**：如果预置库中没有，下载aar文件，使用`prebuilt_aar`模块，并手动管理传递依赖。 3. **尝试使用maven_repository（如果支持）**：在支持的情况下，可以声明Maven仓库和依赖，但需要谨慎使用。 请根据您的项目环境和需求选择合适的方法。 注意：在系统级开发中，通常不建议直接使用Maven仓库下载，因为构建需要可重复和可控。因此，AOSP预置库是首选。 如果您是在开发一个普通的Android应用（非系统级），强烈建议使用Gradle构建系统（build.gradle），它能够非常方便地管理AndroidX依赖。 相关问题： 1. 在Android.bp中如何添加本地jar文件依赖？ 2. 如何处理AndroidX库的传递依赖问题？ 3. 在AOSP中如何更新预置的AndroidX库版本？</think>在 Android.bp 文件中添加 AndroidX 依赖库，需要通过预构建模块（`prebuilt_aar`）或使用 AOSP 内置的 AndroidX 模块实现。以下是详细步骤和方法： --- ### 方法 1：使用 AOSP 内置的 AndroidX 模块（推荐） AOSP 已预置常用 AndroidX 库，可直接通过模块名引用。 **步骤：** 1. **查找模块名** 在 AOSP 源码中查看预置模块： `prebuilts/sdk/current/androidx/Android.bp` 例如： ```blueprint android_library { name: "androidx.appcompat_appcompat", aar: "appcompat/appcompat-1.6.0.aar", sdk_version: "current", } ``` 2. **在目标模块中添加依赖** 在您的 `android_app` 或 `android_library` 模块中引用： ```blueprint android_app { name: "my_app", srcs: ["src/**/*.java"], manifest: "AndroidManifest.xml", static_libs: [ "androidx.appcompat_appcompat", // AndroidX AppCompat "androidx.core_core", // AndroidX Core KTX ], } ``` --- ### 方法 2：手动添加本地 .aar 文件 若需特定版本或未预置的库，需下载 .aar 文件并手动集成。 #### 步骤： 1. **下载 .aar 文件** 从 [Maven Central](https://mvnrepository.com/) 获取 AndroidX 库的 .aar 文件（如 `core-1.9.0.aar`）。 2. **放置文件到项目目录** 创建 `libs/` 目录并放入 .aar 文件： ``` project/ ├── libs/ │ └── core-1.9.0.aar └── Android.bp ``` 3. **在 Android.bp 中声明模块** ```blueprint prebuilt_aar { name: "androidx-core", // 自定义模块名 aar: "libs/core-1.9.0.aar", sdk_version: "current", // 指定 SDK 版本 // 处理传递依赖（如有） deps: [ "androidx.annotation_annotation", ], } ``` 4. **在应用模块中添加依赖** ```blueprint android_app { name: "my_app", srcs: ["src/**/*.java"], static_libs: [ "androidx-core", // 引用自定义模块名 ], manifest: "AndroidManifest.xml", } ``` --- ### 关键注意事项 1. **传递依赖处理** AndroidX 库常有依赖链（如 `appcompat` 依赖 `fragment`）。需在 `deps` 中显式声明所有间接依赖： ```blueprint prebuilt_aar { name: "androidx-appcompat", aar: "libs/appcompat-1.6.1.aar", deps: [ "androidx-fragment", "androidx-activity", ], } ``` 2. **资源冲突解决** 若遇到资源冲突（如重复的 `R` 类），在应用模块中添加： ```blueprint android_app { ... override_symbols: ["R"], // 强制使用主模块的 R 类 } ``` 3. **版本兼容性** 通过 `sdk_version` 确保兼容性： ```blueprint prebuilt_aar { sdk_version: "33", // 匹配 targetSdkVersion } ``` --- ### 完整示例 ```blueprint // 声明 AndroidX Core 模块 prebuilt_aar { name: "androidx-core-ktx", aar: "libs/core-ktx-1.10.0.aar", sdk_version: "33", deps: ["androidx.core_core"], // 核心依赖 } // 声明 AndroidX AppCompat 模块 prebuilt_aar { name: "androidx-appcompat", aar: "libs/appcompat-1.6.1.aar", sdk_version: "33", deps: [ "androidx-core-ktx", "androidx.fragment", ], } // 应用模块 android_app { name: "my_app", srcs: ["src/**/*.java"], manifest: "AndroidManifest.xml", static_libs: [ "androidx-appcompat", // 主依赖 "androidx.constraintlayout", // 直接引用预置模块 ], override_symbols: ["R"], // 解决资源冲突 } ``` > **提示**：优先使用 AOSP 预置模块（方法 1），避免手动管理依赖链。可通过 `m repo` 命令查看所有预置 AndroidX 模块[^1]。 --- ### 常见问题解决 - **构建错误：`No resource found`** 检查是否遗漏资源库依赖（如 `androidx.appcompat_appcompat-res`）。 - **错误：`unresolved reference R`** 添加 `override_symbols: ["R"]` 到应用模块。 - **依赖冲突** 使用 `exclude` 排除重复模块： ```blueprint static_libs: [ "androidx-appcompat", ], exclude_static_libs: ["androidx.legacy_legacy-support-v4"], // 排除冲突库 ``` ---