前言
前面为大家介绍了编辑码插件的大体结构,本篇为大家详解怎么配置编解码插件上传包的参数!
向大家推荐如何做到电信NB与移动NB兼容
第23条“婚约”
编解码插件上传位置
上一篇结尾我们说了如果进行插件开发,必须先了解上传插件包的结构和要求,何为“上传包”?
首先,这个“上传包”就在我们下载的demo文件中:
它指的是把我们写好的编解码插件打成一个jar包,然后再写一个配置文件,这个配置文件的内容与这个jar包相关,与你当前所处的电信平台的产品相关,也就是说配置文件关联你的jar包和当前需要上传jar包的项目!
综上所述,上传的文件会有各种各样的限制,直接上图证明俺不是瞎说的!
前14条主要约束我们的产品信息完整和配置文件内容,只要按照要求填写就完了!
这里我们不再一条条对了,直接跟大家说需要怎么修改package.zip中的package-info.json文件
首先文件格式如下:
{"specVersion":"1.0","fileName":"codec-demo","version":"0.0.1","deviceType":"WaterMeter","manufacturerName":"bcdyd","model":"WaterMeter","description":"codec","platform":"linux","packageType":"CIGPlugin","date":"-11-26 08:16:59","ignoreList":[],"bundles":[{"bundleName": "WaterMeter-厂商ID-WaterMeter","bundleVersion": "0.0.1","priority":5,"fileName": "WaterMeter-厂商ID-WaterMeter-0.0.1.jar","bundleDesc":"","versionDesc":""}]}
specVersion:不需要修改;
fileName:不需要修改;
version:需要和你的jar包中版本对应,即与项目pom.xml 中的
<version>0.0.1</version>
一致;
deviceType:与你平台上的设备类型一致;
manufacturerName:与你平台上的厂商名称一致;
model:与你平台上的产品型号是一致的;
description:不需要修改;
platform:不需要修改;
packageType:不需要修改;
date:不需要修改;
ignoreList:不需要修改;
bundleName:设备类型-厂商ID-产品型号;
bundleVersion:与version一致;
priority:不需要修改;
fileName:jar包名字;
bundleDesc:不需要修改;
versionDesc:不需要修改;
修改项目中的pom文件:
大体结构:
<project xmlns="/POM/4.0.0" xmlns:xsi="/2001/XMLSchema-instance"xsi:schemaLocation="/POM/4.0.0 /xsd/maven-4.0.0.xsd"><modelVersion>4.0.0</modelVersion><groupId>com.thrid.party</groupId><!-- 请修改为你的编解码插件的名字,命名规范:设备类型-厂商ID-设备型号,例如:WaterMeter-Huawei-NBIoTDevice --><artifactId>WaterMeter-Huawei-NBIoTDevice</artifactId><version>1.0.0</version><!-- 请检查这里的值为bundle,不能为jar --><packaging>bundle</packaging><properties><project.build.sourceEncoding>UTF-8</project.build.sourceEncoding><junit.version>4.11</junit.version><fasterxml.jackson.version>2.7.4</fasterxml.jackson.version><felix.maven.plugin.version>2.5.4</felix.maven.plugin.version><json.lib.version>2.4</json.lib.version><m2m.cig.version>1.3.1</m2m.cig.version><slf4j.api.version>1.7.6</slf4j.api.version><basedir>./</basedir></properties><dependencies><!-- 单元测试使用 --><dependency><groupId>junit</groupId><artifactId>junit</artifactId><version>${junit.version}</version></dependency><!-- 日志使用 --><dependency><groupId>org.slf4j</groupId><artifactId>slf4j-api</artifactId><version>${slf4j.api.version}</version></dependency><!-- 转换JSON使用,必须 --><dependency><groupId>com.fasterxml.jackson.core</groupId><artifactId>jackson-databind</artifactId><version>${fasterxml.jackson.version}</version></dependency><!-- Huawei提供的编解码接口,必须 --><!-- systemPath请替换成你本地的目录 \codecDemo\lib\com.huawei.m2m.cig.tup-1.3.1.jar --><dependency><groupId>com.huawei</groupId><artifactId>protocal-jar</artifactId><version>1.3.1</version><scope>system</scope><systemPath>${basedir}/lib/com.huawei.m2m.cig.tup-1.3.1.jar</systemPath></dependency></dependencies><build><plugins><!-- 编码需要使用JDK1.8版本 --><plugin><groupId>org.apache.maven.plugins</groupId><artifactId>maven-compiler-plugin</artifactId><configuration><source>1.8</source><target>1.8</target></configuration></plugin><!-- OSGI规范打包配置 --><plugin><groupId>org.apache.felix</groupId><artifactId>maven-bundle-plugin</artifactId><version>${felix.maven.plugin.version}</version><extensions>true</extensions><configuration><buildDirectory>./target</buildDirectory><archive><addMavenDescriptor>false</addMavenDescriptor></archive><instructions><Bundle-RequiredExecutionEnvironment>J2SE-1.5</Bundle-RequiredExecutionEnvironment><Bundle-Activator></Bundle-Activator><Service-Component>OSGI-INF/*</Service-Component><!-- 请修改为你的编解码插件的名字,命名规范:设备类型-厂商ID-设备型号,例如:WaterMeter-Huawei-NBIoTDevice --><Bundle-SymbolicName>WaterMeter-Huawei-NBIoTDevice</Bundle-SymbolicName><Export-Package></Export-Package><Import-Package>org.slf4j,org.slf4j.spi,org.apache.log4j.spi,com.huawei.m2m.cig.tup.modules.protocol_adapter,com.fasterxml.jackson.databind,com.fasterxml.jackson.databind.node</Import-Package><!-- 除junit,slf4j-api,jackson-databind,protocal-jar, 其他所有的依赖包,必须把包对应的artifactId填入Embed-Dependency。artifactId之间以逗号分隔。 --><Embed-Dependency><!-- json-lib --></Embed-Dependency></instructions></configuration><executions><execution><id>generate-resource</id><goals><goal>manifest</goal></goals></execution></executions></plugin></plugins></build></project>
按照注释修改完成就ok了~!
修改maven配置文件:
在如图所示的位置:
<?xml version="1.0" encoding="UTF-8"?><scr:component xmlns:scr="/xmlns/scr/v1.1.0" immediate="true" name="com.Huawei.NBIoTDevice.WaterMeter.ProtocolAdapterImpl"><implementation class="com.Huawei.NBIoTDevice.WaterMeter.ProtocolAdapterImpl"/><service><provide interface="com.huawei.m2m.cig.tup.modules.protocol_adapter.IProtocolAdapter" /></service></scr:component>
这里需要重点注意一下,第21条22条23条就是说的这个文件!
上面说的name也好class也好都是项目中ProtocolAdapterImpl.java文件的访问路径,这里还有一点需要注意,就是本项目的包名:
如上题所示我们的包名不是随便取的,必须是com.厂商名称.产品型号.设备类型
完成以上工作,就完成了编解码项目的所有配置工作,下一步就是找到程序被调用的入口及编写窍门了!!
编解码插件编写入口!