如何修复 AEM 6.3 - Maven Archetype 12“未找到 DS 描述符”错误？

Question

我们已经使用 Maven Archetype 12 创建了一个 AEM 6.3 项目。我们还没有编写任何代码，只是尝试构建导入 Eclipse 的空项目。

我们收到了文档中提到的错误： https://sling.apache.org/documentation/development/ide-tooling.html#why-do-i-get-an-error-about-no-ds-descriptor-found-at

No DS descriptor found at path target/classes/OSGI-INF/com.xxxxxxx.core.filters.LoggingFilter.xml

文档指出，“一个经常发生的情况是使用 maven-scr-plugin 的 Maven 项目在目标/类之外生成描述符，通常在目标/scr-plugin-generated。要解决这个问题，请确保您使用的是 maven-scr-plugin 1.15.0 或更高版本，并且您没有设置自定义 outputDirectory。"

不幸的是，我们开箱即用的生成项目似乎并非如此。描述符根本没有生成。将maven-scr-plugin 升级到1.15.0 甚至1.26.0 不会改变症状。

此问题的正确解决方法是什么？

环境版本信息

Apache Maven 3.5.0 (ff8f5e7444045639af65f6095c62210b5713f426; 2017-04-03T12:39:06-07:00)
Maven home: C:\usr\apache-maven-3.5.0\bin\..
Java version: 1.8.0_131, vendor: Oracle Corporation
Java home: C:\Program Files\Java\jdk1.8.0_131\jre
Default locale: en_US, platform encoding: Cp1252
OS name: "windows 10", version: "10.0", arch: "amd64", family: "windows"

我可以始终如一地重现错误。所有步骤都记录在这个2-minute video

Answer 1

添加一个空的<Export-Package></Export-Package> 最初是可行的，但是当我开始编写代码时就中断了。长期修复是以下几种情况的组合：

1. 不要使用较新的 OSGI @Component 注解，继续使用 @SlingServlet。

2. 添加这个依赖

   <dependency>
       <groupId>org.apache.felix</groupId>
       <artifactId>org.apache.felix.scr.annotations</artifactId>
       <version>1.12.0</version>
   </dependency>
   

3. 添加这个插件

       <plugin>
           <groupId>org.apache.felix</groupId>
           <artifactId>maven-scr-plugin</artifactId>
           <version>1.26.0</version>
           <executions>
               <execution>
                   <id>generate-scr-scrdescriptor</id>
                   <phase>compile</phase>
                   <goals>
                       <goal>scr</goal>
                   </goals>
               </execution>
           </executions>
       </plugin>           
   

4. 不确定这是否有所作为，但也升级到 Sling IDE Tools 1.2.0

Answer 2

如果将这两个空条目添加到core/pom.xml，问题就会消失：

                    <Export-Package></Export-Package>
                    <Private-Package></Private-Package>

Answer 3

当在 OSGI 框架中没有实现声明式服务时，您会看到此错误。确保您看到 Apache Felix Declarative Services (org.apache.felix.scr) 捆绑包处于活动状态并在您的 felix 控制台中运行。

或者（推荐），您可以使用 OSGI R6 的官方注释。根据felix docs 的说法，Apache Felix SCR 插件的开发处于维护模式。如果您使用的是官方 osgi 注释，则不需要 mvn-scr-plugin。

这个article 应该让您快速开始使用官方注释。