android - 为什么不能使用pom文件中的maven依赖？

Question

背景
我的任务是为开发人员提供一种方法，将单个依赖项添加到 Android 项目的 build.gradle 文件中，以使用我准备的一些(混淆的)SDK(AAR 文件 - Android 库)。
SDK 本身使用各种依赖项，因此它们将在最终代码中可用很重要，这意味着使用 SDK 的人不会看到由于 class-not-found 而导致的崩溃。
SDK 作为私有(private)存储库存储在 Github 上，开发人员可以通过 Jitpack 使用，它会扫描存储库中的 POM 文件和其他一些文件。
单独使用 AAR 文件，您必须设置与 SDK 相同(或更新)的依赖项。
但是，如果您在发布时使用 POM 文件，则使用者(使用 SDK 的人)不需要编写 SDK 上的每个依赖项，因为它是从 POM 文件中添加的。
问题
出于某种原因，这种行为对我来说不存在。这意味着好像 SDK 不使用任何依赖项，所以如果我尝试使用任何依赖项，我将无法访问类，并且如果我在使用某些依赖项时尝试使用 SDK，则会导致异常ClassNotFoundException。
起初我认为这是因为一些 Proguard 规则，但后来我注意到它也发生在 debug-variant 上(使用 SDK 的应用程序)。
例如，当库在依赖项中使用它时:

implementation 'androidx.security:security-crypto:1.1.0-alpha03'

如果我不使用它，我将无法访问此依赖项的任何类，如果 SDK 尝试访问它的任何类，应用程序将崩溃。
因此，我必须添加 SDK 已经使用的所有依赖项，而不是使用 SDK 的单一依赖项。
我试过的
为了生成 AAR 文件，我使用“assembleRelease”gradle 任务，为了生成 POM 文件，我使用“generatePomFileForReleasePublication”(或“publishReleasePublicationToMavenLocal”)gradle 任务。
该库有很多依赖项。这是它的 build.gradle 文件:

plugins {
    id 'com.android.library'
    id 'kotlin-android'
    id 'kotlin-kapt'
    id 'kotlin-parcelize'
    id 'io.michaelrocks.paranoid'
    id 'maven-publish'
    id 'com.github.dcendents.android-maven'
}

android {
    compileSdkVersion 30
    defaultConfig {
        minSdkVersion 21
        targetSdkVersion 30
        versionCode 1
        versionName "1.0"
    }

    buildTypes {
        release {
            minifyEnabled true
            proguardFiles getDefaultProguardFile('proguard-android-optimize.txt'), 'proguard-rules.pro'
            consumerProguardFiles 'consumer-rules.pro'
        }
    }
    compileOptions {
        sourceCompatibility JavaVersion.VERSION_1_8
        targetCompatibility JavaVersion.VERSION_1_8
    }
    kotlinOptions {
        jvmTarget = '1.8'
    }
    configurations {
        all {
            exclude module: 'httpclient'
        }
    }
    packagingOptions {
        //for google login token
        exclude 'META-INF/DEPENDENCIES'
    }
}

dependencies {
    api "org.jetbrains.kotlin:kotlin-stdlib:$kotlin_version"
    api 'androidx.core:core-ktx:1.6.0-alpha01'
    api 'androidx.collection:collection-ktx:1.2.0-alpha01'
    api 'androidx.security:security-crypto:1.1.0-alpha03'
    def room_version = "2.2.6"
    api "androidx.room:room-runtime:$room_version"
    kapt "androidx.room:room-compiler:$room_version"
    api "androidx.room:room-ktx:$room_version"
    api 'com.squareup.retrofit2:retrofit:2.9.0'
    api 'com.squareup.retrofit2:converter-gson:2.9.0'
    api 'com.squareup.okhttp3:okhttp:5.0.0-alpha.2'
    api 'com.squareup.okhttp3:logging-interceptor:5.0.0-alpha.2'
    api('com.google.android.gms:play-services-auth:19.0.0')
    api('com.google.auth:google-auth-library-oauth2-http:0.25.0')
    api('com.google.apis:google-api-services-people:v1-rev99-1.22.0') {
        exclude group: 'com.google.guava'
    }
    api 'io.michaelrocks:libphonenumber-android:8.12.20'
}

afterEvaluate {
    publishing {
        publications {
            release(MavenPublication) {
                from components.release
            }
        }
    }
}

运行“generatePomFileForReleasePublication”任务，我得到了 POM 文件“pom-default.xml”:

<?xml version="1.0" encoding="UTF-8"?>
<project xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd" xmlns="http://maven.apache.org/POM/4.0.0"
    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
  <!-- This module was also published with a richer model, Gradle metadata,  -->
  <!-- which should be used instead. Do not delete the following line which  -->
  <!-- is to indicate to Gradle or any Gradle module metadata file consumer  -->
  <!-- that they should prefer consuming it instead. -->
  <!-- do_not_remove: published-with-gradle-metadata -->
  <modelVersion>4.0.0</modelVersion>
  <groupId>MySdk</groupId>
  <artifactId>library</artifactId>
  <version>unspecified</version>
  <packaging>aar</packaging>
  <dependencies>
    <dependency>
      <groupId>org.jetbrains.kotlin</groupId>
      <artifactId>kotlin-stdlib</artifactId>
      <version>1.4.32</version>
      <scope>compile</scope>
      <exclusions>
        <exclusion>
          <artifactId>httpclient</artifactId>
          <groupId>*</groupId>
        </exclusion>
      </exclusions>
    </dependency>
    <dependency>
      <groupId>androidx.core</groupId>
      <artifactId>core-ktx</artifactId>
      <version>1.6.0-alpha01</version>
      <scope>compile</scope>
      <exclusions>
        <exclusion>
          <artifactId>httpclient</artifactId>
          <groupId>*</groupId>
        </exclusion>
      </exclusions>
    </dependency>
    <dependency>
      <groupId>androidx.collection</groupId>
      <artifactId>collection-ktx</artifactId>
      <version>1.2.0-alpha01</version>
      <scope>compile</scope>
      <exclusions>
        <exclusion>
          <artifactId>httpclient</artifactId>
          <groupId>*</groupId>
        </exclusion>
      </exclusions>
    </dependency>
    <dependency>
      <groupId>androidx.security</groupId>
      <artifactId>security-crypto</artifactId>
      <version>1.1.0-alpha03</version>
      <scope>compile</scope>
      <exclusions>
        <exclusion>
          <artifactId>httpclient</artifactId>
          <groupId>*</groupId>
        </exclusion>
      </exclusions>
    </dependency>
    <dependency>
      <groupId>androidx.room</groupId>
      <artifactId>room-runtime</artifactId>
      <version>2.2.6</version>
      <scope>compile</scope>
      <exclusions>
        <exclusion>
          <artifactId>httpclient</artifactId>
          <groupId>*</groupId>
        </exclusion>
      </exclusions>
    </dependency>
    <dependency>
      <groupId>androidx.room</groupId>
      <artifactId>room-ktx</artifactId>
      <version>2.2.6</version>
      <scope>compile</scope>
      <exclusions>
        <exclusion>
          <artifactId>httpclient</artifactId>
          <groupId>*</groupId>
        </exclusion>
      </exclusions>
    </dependency>
    <dependency>
      <groupId>com.squareup.retrofit2</groupId>
      <artifactId>retrofit</artifactId>
      <version>2.9.0</version>
      <scope>compile</scope>
      <exclusions>
        <exclusion>
          <artifactId>httpclient</artifactId>
          <groupId>*</groupId>
        </exclusion>
      </exclusions>
    </dependency>
    <dependency>
      <groupId>com.squareup.retrofit2</groupId>
      <artifactId>converter-gson</artifactId>
      <version>2.9.0</version>
      <scope>compile</scope>
      <exclusions>
        <exclusion>
          <artifactId>httpclient</artifactId>
          <groupId>*</groupId>
        </exclusion>
      </exclusions>
    </dependency>
    <dependency>
      <groupId>com.squareup.okhttp3</groupId>
      <artifactId>okhttp</artifactId>
      <version>5.0.0-alpha.2</version>
      <scope>compile</scope>
      <exclusions>
        <exclusion>
          <artifactId>httpclient</artifactId>
          <groupId>*</groupId>
        </exclusion>
      </exclusions>
    </dependency>
    <dependency>
      <groupId>com.squareup.okhttp3</groupId>
      <artifactId>logging-interceptor</artifactId>
      <version>5.0.0-alpha.2</version>
      <scope>compile</scope>
      <exclusions>
        <exclusion>
          <artifactId>httpclient</artifactId>
          <groupId>*</groupId>
        </exclusion>
      </exclusions>
    </dependency>
    <dependency>
      <groupId>com.google.android.gms</groupId>
      <artifactId>play-services-auth</artifactId>
      <version>19.0.0</version>
      <scope>compile</scope>
      <exclusions>
        <exclusion>
          <artifactId>httpclient</artifactId>
          <groupId>*</groupId>
        </exclusion>
      </exclusions>
    </dependency>
    <dependency>
      <groupId>com.google.auth</groupId>
      <artifactId>google-auth-library-oauth2-http</artifactId>
      <version>0.25.0</version>
      <scope>compile</scope>
      <exclusions>
        <exclusion>
          <artifactId>httpclient</artifactId>
          <groupId>*</groupId>
        </exclusion>
      </exclusions>
    </dependency>
    <dependency>
      <groupId>com.google.apis</groupId>
      <artifactId>google-api-services-people</artifactId>
      <version>v1-rev99-1.22.0</version>
      <scope>compile</scope>
      <exclusions>
        <exclusion>
          <artifactId>httpclient</artifactId>
          <groupId>*</groupId>
        </exclusion>
        <exclusion>
          <artifactId>*</artifactId>
          <groupId>com.google.guava</groupId>
        </exclusion>
      </exclusions>
    </dependency>
    <dependency>
      <groupId>io.michaelrocks</groupId>
      <artifactId>libphonenumber-android</artifactId>
      <version>8.12.20</version>
      <scope>compile</scope>
      <exclusions>
        <exclusion>
          <artifactId>httpclient</artifactId>
          <groupId>*</groupId>
        </exclusion>
      </exclusions>
    </dependency>
    <dependency>
      <groupId>org.jetbrains.kotlin</groupId>
      <artifactId>kotlin-parcelize-runtime</artifactId>
      <version>1.4.32</version>
      <scope>runtime</scope>
      <exclusions>
        <exclusion>
          <artifactId>httpclient</artifactId>
          <groupId>*</groupId>
        </exclusion>
      </exclusions>
    </dependency>
    <dependency>
      <groupId>io.michaelrocks</groupId>
      <artifactId>paranoid-core</artifactId>
      <version>0.3.3</version>
      <scope>runtime</scope>
      <exclusions>
        <exclusion>
          <artifactId>httpclient</artifactId>
          <groupId>*</groupId>
        </exclusion>
      </exclusions>
    </dependency>
  </dependencies>
</project>

根据各种网站的说法，这似乎是有效且好的，但遗憾的是，正如我所写，当我使用它时，好像这些依赖项都不存在，我需要在消费者端声明它们。
在 Jitpack 的文件 ("jitpack.yml") 中，我有这样的内容:

install: 
  - FILE="-Dfile=library-release.aar" 
  - mvn install:install-file $FILE -DgroupId=my-sdk -DartifactId=MySdk -Dversion=1.0 -Dpackaging=aar -DgeneratePom=true

我尝试了什么:

我尝试使用“实现”和“api”。没有帮助。

我试图删除 scope来自所有dependency标签。没有帮助。

我尝试添加 transitive = true在消费者方面，但这并没有做任何事情，可能是因为无论如何它都是默认的。

删除 POM 文件在 Jitpack 上没有显示任何警告，表明它甚至可能不会检查它。

我注意到 POM 文件提到“这个模块也发布了一个更丰富的模型，应该使用 Gradle 元数据”，所以我尝试找到这个文件，但找不到。运行publishToMavenLocal任务，我得到了另一个文件(“module.json”)，甚至把它而不是pom-default.xml单独的文件(也作为一个完整的替代品)，它没有帮助。

我认为“jitpack.yml”文件和 gradle 文件之间存在一些不一致，所以我为它们设置了相同的“groupId”、“artifactId”和“version”值。

问题

为什么在消费者方面会忽略依赖关系？我怎样才能解决这个问题？这可能是我错过的非常简单的事情...

Jitpack 究竟需要哪些文件？哪些是强制性的？哪些是可选的？

是否也可以避免 packagingOptions {exclude 'META-INF/DEPENDENCIES' } 的部分？在消费者方面？

奖励:我注意到 JavaDocs(或者在我的情况下是 Kdocs，因为我在 Kotlin 中编写了所有内容)也被完全忽略了。我怎样才能使这些也可以访问和可读？

Answer 1

好的，我找到了这样做的方法。答案来自 Jitpack 支持本身。首先，来自他们的报价:

This is caused by the install command and ' -DgeneratePom=true'parameter. It will generate a new pom file but it doesn't knowanything about dependencies.

If you already have a pom file with all the dependencies then youcould add it to the GitHub repository. Instead of '-DgeneratePom=true' you could use '-DpomFile='

We recommend trying that command locally before running on JitPack.

The other option is to put all the source code of the library onJitPack and build from source.

事实上，如果我使用它(并且在库的依赖项中有“api”)，我的大部分问题都会得到解答:

它修复了依赖问题(是的，您不必自定义 -DgroupId=my-sdk -DartifactId=MySdk -Dversion=1.0 ):

install: 
  - FILE="-Dfile=library-release.aar" 
  - mvn install:install-file $FILE -Dpackaging=aar -DpomFile=pom-default.xml

当前存在的文件似乎只有这些:jitpack.yml、library-release.aar、pom-default.xml。

显然现在不需要了。可能通过修复依赖关系问题的同一件事来修复。

话虽如此，现在我对此有以下疑问:

“pom-default.xml”中建议使用不同的文件是什么意思(“这个模块也发布了更丰富的模型，Gradle 元数据，应该使用它。”)？它在哪里？可能是“module.json”文件吗？我尝试改用它，但随后 Jitpack 出现错误。

这个用例的 Jitpack 文档在哪里？他们有一些关于私有(private)存储库的信息，但没有关于 AAR 文件的信息。事实上，我看不到“jitpack.yml”文件。

定制-DgroupId=my-sdk -DartifactId=MySdk -Dversion=1.0的目的是什么？部分？在“jitpack.yml”文件中还是在库的 gradle 文件中？我认为他们根本没有做任何事情......似乎 Github 存储库本身决定了消费者如何使用它。

如何在此处添加要使用的 JavaDocs 和 Kdocs(Kotlin 的)？

尽管这是我问题的主要答案，但我会为其余回答我的人提供赏金:)