无法使用 @IntDef 注释导入 AAR 库答案

【问题标题】：Can't import AAR library with @IntDef annotations无法使用 @IntDef 注释导入 AAR 库
【发布时间】：2017-03-21 01:49:11
【问题描述】：

我的库中有以下代码：

@Documented
@IntDef({OpacityAnimationType.NONE,
        OpacityAnimationType.BLINKING,
        OpacityAnimationType.SHINY,
        OpacityAnimationType.AURA,
})
public @interface OpacityAnimationType {
    int NONE = 0;
    int BLINKING = 1;
    int SHINY = 2;
    int AURA = 3;
}

在我有图书馆的 gradle 中

android {
    compileSdkVersion 25
    buildToolsVersion "25.0.2"

    defaultConfig {
        minSdkVersion 16
        targetSdkVersion 25
        versionCode 1
        versionName "1.0"

        testInstrumentationRunner "android.support.test.runner.AndroidJUnitRunner"

        javaCompileOptions {
            annotationProcessorOptions {
                arguments = ["library" : "true"]
            }
        }
    }
}

和

configurations {
    javadocDeps
}

dependencies {
    compile fileTree(dir: 'libs', include: ['*.jar'])
    compile "com.android.support:appcompat-v7:$supportLibraryVersion"
    compile "com.android.support:support-annotations:$supportLibraryVersion"

    javadocDeps "com.android.support:support-annotations:$supportLibraryVersion"
}

我将其部署到 JFrog BinTray，然后尝试在我的应用程序中使用它。我必须从库依赖项中排除 appcompat-v7 和 support-annotations，但我构建仍然失败：

错误：无法解决：annotationProcessor

现在我被卡住了，尝试了很多东西，但没有任何帮助。我无法用这个库构建主项目。我是否需要实现任何自定义 AnnotationProcessor 才能使用 @IntDef's？

【问题讨论】：

也尝试从库中删除，但没有帮助 javadocDeps "com.android.support:support-annotations:$supportLibraryVersion" 试图从主项目的库依赖中删除 @aar，但它也没有帮助。

标签： android gradle annotations aar annotation-processor

【解决方案1】：

所以我终于能够克服这个问题了！

看起来在自定义注释的情况下还需要自定义注释处理器。现在我决定跳过创建自定义注解处理器，并且不使用@IntDef 枚举的自定义注解。

但是无论如何，如果您的库使用现有的注释并且您将其发布到 mavenCentral 或 jCenter 或其他存储库并在其他项目中使用它，那么您需要为 javadoc 任务添加一些魔法。

从这里开始： https://github.com/vulko/AnimatedArcProgressView/blob/master/library/build.gradle 与

    configurations {
        javadocDeps
    }
    dependencies {
        // ...
        compile("com.android.support:support-annotations:$supportLibraryVersion") {
            transitive false;
        }   
        javadocDeps "com.android.support:support-annotations:$supportLibraryVersion"
    }

然后继续在此处发布 gradle 脚本：https://github.com/vulko/AnimatedArcProgressView/blob/master/gradle/publish-library.gradle with：

task androidJavadocs(type: Javadoc) {
    source = android.sourceSets.main.java.source

    // this is the magic
    classpath += configurations.javadocDeps

    classpath += project.files(android.getBootClasspath().join(File.pathSeparator))
}

无论如何，所有代码都可以在这里找到： https://github.com/vulko/AnimatedArcProgressView/

【讨论】：

【解决方案2】：

一直在谷歌搜索这个问题，看起来如果库中有任何注释，库需要一个包含这些注释的项目。虽然不确定处理器，但希望不需要它，否则我将不得不从自定义注释切换到 @IntDef 并使用一些静态最终 int。

还需要一些 gradle 魔法来做到这一点，到目前为止还没有好的教程，但是 github 上有一堆带有处理器和注释的代码。我想避免使用自定义处理器，因为我根本不需要它。

无论如何，当我最终设法解决这个问题时，我会尽量保持这个线程的更新。

【讨论】：

【解决方案3】：

现在故事还在继续。我必须在库项目中为注释创建一个 annotations 子模块，并且我必须将 @IntDef 移出它，否则它将无法将任何 android 注释导入子模块。所以我已经将@IntDef 移到库中，它们现在使用来自子模块的自定义注释。

即使我能够构建和部署它，也无法导入库工件，原因是：

错误：找不到 com.kvolkov.animatedprogressviews：注释：未指定。搜索到以下位置：要求：项目：> com.kvolkov.animatedprogressviews:library:1.0-RC5

我认为发生这种情况是因为我现在需要将 annotations 子模块部署为单独的工件，但我不能这样做，因为我无法匹配 .gradle 的某些教程中的代码带有用于 bintray 的插件的 annotations 模块，以便从工作室将其部署到那里...

嗯，这还没有结束。如果 any1 有兴趣或愿意提供帮助，您可以在这里查看当前的库代码： https://github.com/vulko/AnimatedArcProgressView

我很高兴收到一些帮助或建议，因为所有关于此的信息都使用 apt 而不是注释处理器。

【讨论】：