OSGi 插件提供了工廠方法來創(chuàng)建一個 OsgiManifest 對象。OsgiManifest 繼承自 Manifest。如果應(yīng)用了 Java 插件，OSGi 插件將把默認 jar 的 manifest 對象替換為一個 OsgiManifest 對象。被替換的 manifest 會被合并到新的對象單中。

OSGi 插件使 Peter Kriens BND tool 大量使用。

用法

要使用 OSGi 插件，請在構(gòu)建腳本中包含以下語句：

使用 OSGi 插件

build.gradle

apply plugin: 'osgi'   

隱式應(yīng)用插件

適用于 Java 基礎(chǔ)插件。

任務(wù)

此插件不會添加任何任務(wù)。

依賴管理

待決定

約定對象

OSGi 插件添加了下列約定對象： OsgiPluginConvention

約定屬性

OSGi 插件沒有向 project 添加任何的公約屬性。

約定方法

OSGi 插件添加了以下方法。有關(guān)更多詳細信息，請參見約定對象的 API 文檔。

表 37.1. OSGi 方法

在 classes 目錄下的類文件會被分析出關(guān)于它們的包的依賴，以及它們所公布的包名。并基于此計算 OSGi Manifest 中 Import-Package 和 Export-Package 的值。如果 classpath 中包含了 jar 包和 OSGi bundle，bundle 信息會被用來指定 Import-Package 的值的版本信息。在 OsgiManifest 對象的顯式屬性旁邊，你可以添加 instructions。

OSGi MANIFEST.MF 文件配置

build.gradle

jar {
    manifest { // the manifest of the default jar is of type OsgiManifest
        name = 'overwrittenSpecialOsgiName'
        instruction 'Private-Package',
                'org.mycomp.package1',
                'org.mycomp.package2'
        instruction 'Bundle-Vendor', 'MyCompany'
        instruction 'Bundle-Description', 'Platform2: Metrics 2 Measures Framework'
        instruction 'Bundle-DocURL', 'http://www.mycompany.com'
    }
}
task fooJar(type: Jar) {
    manifest = osgiManifest {
        ~instruction 'Bundle-Vendor', 'MyCompany'
    }
}  

instruction 調(diào)用的第一個參數(shù)是屬性的鍵。其他參數(shù)構(gòu)成了它的值。他們由 Gradle 使用,分隔符連接。要了解更多關(guān)于 instructions 的信息，可以看看 BND tool。