wso2 - 编写自定义功能

Question

我们想为 wso2 carbon 编写我们自己的自定义扩展（功能）。是否有一些用于创作功能的文档？

我们确实设法“破解”了我们编写自定义功能的方式。但是我们如何托管它？似乎 Carbon 正在查看一些非常具体的存储库描述符——artifacts.jar 和 content.jar

我们如何在不绑定到 Carbon 构建的情况下生成这些描述符。是否有一些文档描述了如何设置第三方功能存储库？

Answer 1

Creating-your-own-wso2-carbon-components网络研讨会讨论了创建碳组件以及这些组件的功能。它涵盖了很多基础知识和最佳实践。

要托管您编写的已创建功能，您需要从这些功能生成一个 p2 存储库。p2-repo 概念来自 WSO2 产品使用的下划线Eclipse Equinox项目。

WSO2 编写了自己的名为 carbon-p2-plugin 的 maven 插件，可帮助生成 p2-repo。这是你可以做到的。只需新建一个 maven 项目（打包：pom），然后在 carbon-p2-plugin 插件配置下设置要发布的功能。以下是您可以使用的示例 pom.xml。这是从carbon 4.1.0 的 p2-repo 生成 pom.xml复制的，我对其进行了简化。

我已经测试了这个 pom 文件，它对我有用。有两个示例特征定义。将那些 featureArtifactDef 替换为您自己的功能定义。格式为 $groupId:$artifactId:$version。

当你通过 maven 构建它时，maven 会创建 target/p2-repo 目录。这包含 p2-repository，其中包含完整的 p2-repo，包括 artifacts.jar 和 content.jar。您可以只使用此文件夹来安装功能，也可以将其托管在某个地方。托管没有特殊要求。

<project xmlns="http://maven.apache.org/POM/4.0.0"
         xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
         xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/maven-v4_0_0.xsd">

    <parent>
        <groupId>org.wso2.carbon</groupId>
        <artifactId>carbon-features</artifactId>
        <version>4.1.0</version>
    </parent>

    <modelVersion>4.0.0</modelVersion>
    <artifactId>mysample-feature-repository</artifactId>
    <version>4.1.0</version>
    <packaging>pom</packaging>
    <name>WSO2 Carbon - Feature Repository</name>

    <build>
      <plugins>
        <plugin>
          <groupId>org.wso2.maven</groupId>
            <artifactId>carbon-p2-plugin</artifactId>
            <version>1.5.2</version>
            <executions>
              <execution>
                <id>2-p2-repo-generation</id>
                <phase>package</phase>
                <goals>
                  <goal>p2-repo-gen</goal>
                 </goals>
                 <configuration>
                   <p2AgentLocation>${basedir}/target/p2-agent</p2AgentLocation>
                   <metadataRepository>file:${basedir}/target/p2-repo</metadataRepository>
                   <artifactRepository>file:${basedir}/target/p2-repo</artifactRepository>
                   <publishArtifacts>true</publishArtifacts>
                   <publishArtifactRepository>true</publishArtifactRepository>
                   <featureArtifacts> 

<!-- change the featureArtifactDef to match your needs -->

                      <featureArtifactDef>
                                    org.wso2.carbon:org.wso2.carbon.service.mgt.feature:4.1.0
                      </featureArtifactDef>
                      <featureArtifactDef>
                                    org.wso2.carbon:org.wso2.carbon.registry.core.feature:4.1.0
                      </featureArtifactDef>


               </featureArtifacts>
             </configuration>
          </execution>
        </executions>
      </plugin>
    </plugins>
  </build>
</project>