本文由CSDN博客万一博主翻译,其他章节的翻译请参见:
http://blog.csdn.net/column/details/gradle-translation.html
翻译项目请关注Github上的地址:
https://github.com/msdx/gradledoc/tree/1.12。
直接浏览双语版的文档请访问:
http://gradledoc.qiniudn.com/1.12/userguide/userguide.html。
另外,Android 手机用户可通过我写的一个程序浏览文档,带缓存功能的,目前0.2.1版本兼容 android 2.2以上系统,地址如下:
http://www.wandoujia.com/apps/com.githang.gradledoc
翻译不易,转载请注明本文在CSDN博客上的出处:
http://blog.csdn.net/maosidiaoxian/article/details/46825947
关于我对Gradle的翻译,以Github上的项目及http://gradledoc.qiniudn.com 上的文档为准。如有发现翻译有误的地方,将首先在以上两个地方更新。因时间精力问题,博客中发表的译文基本不会同步修改。
第三十七章. OSGi 插件
OSGi 插件提供了工厂方法来创建一个OsgiManifest
对象。OsgiManifest
继承自 Manifest
。要了解常见的清单处理的更多信息,请参阅第 23.13.1节,“Manifest”。如果应用了 Java 插件,OSGi 插件将把默认 jar 的 manifest 对象替换为一个OsgiManifest
对象。被替换的manifest 会被合并到新的对象单中。
OSGi 插件使 Peter Kriens BND tool 大量使用。
OSGi 插件添加了下列约定对象: OsgiPluginConvention
OSGi 插件添加了以下方法。有关更多详细信息,请参见约定对象的 API 文档。
表 37.1. OSGi 方法
方法 | 返回类型 | 描述 |
osgiManifest() | OsgiManifest |
返回一个 OsgiManifest 对象。 |
osgiManifest(Closure cl) | OsgiManifest |
返回一个通过闭包配置的 OsgiManifest 对象。 |
在classes 目录下的类文件会被分析出关于它们的包的依赖,以及它们所公布的包名。并基于此计算 OSGi Manifest 中Import-Package和Export-Package的值。如果 classpath 中包含了 jar 包和 OSGi bundle,bundle 信息会被用来指定 Import-Package的值的版本信息。在 OsgiManifest
对象的显式属性旁边,你可以添加instructions。
示例 37.2. 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 调用的第一个参数是属性的键。其他参数构成了它的值。他们由 Gradle 使用,
分隔符连接。要了解更多关于 instructions 的信息,可以看看BND tool。