Skip to content

Commit dc8a3f5

Browse files
committed
preparing sonatype release from github repo
1 parent 7946e58 commit dc8a3f5

File tree

7 files changed

+157
-104
lines changed

7 files changed

+157
-104
lines changed

README.md

Lines changed: 32 additions & 31 deletions
Original file line numberDiff line numberDiff line change
@@ -1,31 +1,5 @@
1-
jCardSim (Official repo of the [jCardSim](http://jcardsim.org) project)
2-
========
3-
4-
### Congratulations! jCardSim has won [Duke's Choice 2013 Award](https://www.java.net/dukeschoice/2013)!
5-
6-
![alt text](https://licelus.com/wp-content/uploads/DCA2013_Badge_Winner.jpg "jCardSim is a winner of Duke's Choice 2013")
7-
8-
This repo is including several [pull request from the original GitHub repository](https://github.com/licel/jcardsim/pulls)
9-
and an up-to-date release files with all changes.
10-
11-
The following pull request have been included:
12-
13-
* #176: Wrap 'nbsp' to CDATA in pom.xml
14-
* #174: test: Do not reuse KeyPair context to generate second key pair
15-
* #171: Bump bcprov-jdk14 from 1.46 to 1.67
16-
* #158: Do not throw CryptoException if EC KeyBuilder.buildKey() does not match a known curve
17-
* #157: Max case 4 command APDU size is 261
18-
* #155: Add option to randomize RandomData
19-
* #151: Building on Linux w/ vpcd support
20-
* #141: Make SecureRandom securely random
21-
* #138: Logical Channel Support / pom.xml fix
22-
* #113 Added resize of ByteContainer for longer buffer
23-
24-
Not included are:
25-
26-
* #75: Fix AssymetricSignatureImpl behaviour wrt ISO9796_MR signatures: covered by more recent patches
27-
* #62: Intercept Shareable creation with proxy: correctness of patch not verified
28-
* #159: Simulate card removal and insertion by raising SIGUSR2 (when using vpcd): This is using an internal Java API
1+
jCardSim (Forked repo of the [jCardSim](http://jcardsim.org) project)
2+
======
293

304
jCardSim is an open source simulator for Java Card, v3.0.5:
315

@@ -61,12 +35,33 @@ assertEquals(0x9000, response.getSW());
6135
* APDU scripting (scripts are compatible with `apdutool` from Java Card Development Kit)
6236
* Simplifies verification tests creation (Common Criteria)
6337

64-
*JavaDoc*: https://github.com/licel/jcardsim/tree/master/javadoc
38+
[*JavaDoc*](./javadoc)
6539

66-
(Javadoc rendered: https://jcardsim.org/jcardsim/)
40+
### Upstream Project Changes
6741

68-
*Latest release 3.0.5*: https://github.com/licel/jcardsim/raw/master/jcardsim-3.0.5-SNAPSHOT.jar
42+
This repo is including several [pull request from the original GitHub repository](https://github.com/licel/jcardsim/pulls)
43+
and an up-to-date release files with all changes.
44+
45+
For issues reporting please use the upstream project. Pull requests can be created.
6946

47+
The following pull request have been included:
48+
49+
* 176: Wrap 'nbsp' to CDATA in pom.xml
50+
* 174: test: Do not reuse KeyPair context to generate second key pair
51+
* 171: Bump bcprov-jdk14 from 1.46 to 1.67
52+
* 158: Do not throw CryptoException if EC KeyBuilder.buildKey() does not match a known curve
53+
* 157: Max case 4 command APDU size is 261
54+
* 155: Add option to randomize RandomData
55+
* 151: Building on Linux w/ vpcd support
56+
* 141: Make SecureRandom securely random
57+
* 138: Logical Channel Support / pom.xml fix
58+
* 113 Added resize of ByteContainer for longer buffer
59+
60+
Not included are:
61+
62+
* 75: Fix AssymetricSignatureImpl behaviour wrt ISO9796_MR signatures: covered by more recent patches
63+
* 62: Intercept Shareable creation with proxy: correctness of patch not verified
64+
* 159: Simulate card removal and insertion by raising SIGUSR2 (when using vpcd): This is using an internal Java API
7065

7166
### What is the difference from Oracle Java Card Development Kit simulator?
7267

@@ -86,6 +81,12 @@ assertEquals(0x9000, response.getSW());
8681

8782
jCardSim is completely written in Java and can therefore be used on all platforms which support Java (Windows, Linux, MacOS, etc).
8883

84+
### Maintainer Information
85+
86+
* [Building & Development](./sitedocs/getting_source_and_compiling.md)
87+
* [Quick Start Guide: API](./sitedocs/quick_start_guide_simulator_api.md)
88+
* [Quick Start Guide: CLI](./sitedocs/quick_start_guide_using_in_cli_mode.md)
89+
8990
### How to help jCardSim?
9091

9192
* Join the team of jCardSim developers.
-2.34 MB
Binary file not shown.

jcardsim-3.0.5-SNAPSHOT.jar

-2.39 MB
Binary file not shown.

pom.xml

Lines changed: 71 additions & 59 deletions
Original file line numberDiff line numberDiff line change
@@ -2,13 +2,28 @@
22
xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
33
<modelVersion>4.0.0</modelVersion>
44

5-
<groupId>com.licel</groupId>
5+
<properties>
6+
<project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
7+
<netbeans.hint.license>apache20</netbeans.hint.license>
8+
<maven-javadoc-plugin.version>2.10.1</maven-javadoc-plugin.version>
9+
<ant.build.dir>${project.build.directory}/antrun/build</ant.build.dir>
10+
<junit.version>4.13.2</junit.version>
11+
<java.version>1.7</java.version>
12+
<jcApiVersion>3.0.5</jcApiVersion>
13+
<maven.compiler.target>1.7</maven.compiler.target>
14+
<maven.compiler.source>1.7</maven.compiler.source>
15+
<asm.version>9.2</asm.version>
16+
<github.dev.host>github.com</github.dev.host>
17+
<group.id>com.licel</group.id>
18+
</properties>
19+
20+
<groupId>${group.id}</groupId>
621
<version>3.0.5-SNAPSHOT</version>
722
<packaging>jar</packaging>
8-
<url>http://maven.apache.org</url>
23+
<url>https://github.com/${github.username}/jcardsim</url>
924

1025
<artifactId>jcardsim</artifactId>
11-
<name>Java Card Runime Environment Simulator</name>
26+
<name>Java Card Runtime Environment Simulator</name>
1227
<description>jCardSim is open-source library contains implementation of Java Card API</description>
1328

1429
<organization>
@@ -22,49 +37,40 @@
2237
<name>jCardSim Team</name>
2338
<organization>Licel Corporation</organization>
2439
</developer>
40+
<developer>
41+
<email>${github.mail}</email>
42+
<name>${github.name}</name>
43+
</developer>
2544
</developers>
2645

2746
<licenses>
2847
<license>
2948
<name>Apache 2</name>
30-
<url>http://www.apache.org/licenses/LICENSE-2.0.txt</url>
49+
<url>https://www.apache.org/licenses/LICENSE-2.0.txt</url>
3150
<distribution>repo</distribution>
3251
</license>
3352
</licenses>
3453

35-
<properties>
36-
<project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
37-
<netbeans.hint.license>apache20</netbeans.hint.license>
38-
<maven-javadoc-plugin.version>2.10.1</maven-javadoc-plugin.version>
39-
<ant.build.dir>${project.build.directory}/antrun/build</ant.build.dir>
40-
<junit.version>4.13.2</junit.version>
41-
<java.version>1.7</java.version>
42-
<jcApiVersion>3.0.5</jcApiVersion>
43-
<asm.version>9.2</asm.version>
44-
</properties>
45-
4654
<distributionManagement>
55+
<snapshotRepository>
56+
<id>ossrh</id>
57+
<url>https://oss.sonatype.org/content/repositories/snapshots</url>
58+
</snapshotRepository>
4759
<repository>
48-
<id>bintray-jcardsim-maven-jCardSim</id>
49-
<name>jcardsim-maven-jCardSim</name>
50-
<url>https://api.bintray.com/maven/jcardsim/maven/jCardSim</url>
60+
<id>ossrh</id>
61+
<url>https://oss.sonatype.org/service/local/staging/deploy/maven2/</url>
5162
</repository>
5263
</distributionManagement>
5364

5465
<scm>
55-
<connection>scm:git:[email protected]:licel/jcardsim.git</connection>
56-
<developerConnection>scm:git:git@github.com:licel/jcardsim.git</developerConnection>
57-
<url>[email protected]:licel/jcardsim.git</url>
66+
<connection>scm:git:[email protected]:${github.username}/jcardsim.git</connection>
67+
<developerConnection>scm:git:git@${github.dev.host}:${github.username}/jcardsim.git</developerConnection>
68+
<url>[email protected]:${github.username}/jcardsim.git</url>
5869
</scm>
5970

6071
<profiles>
6172
<profile>
62-
<id>sign</id>
63-
<activation>
64-
<property>
65-
<name>keystoreLocation</name>
66-
</property>
67-
</activation>
73+
<id>release</id>
6874
<build>
6975
<plugins>
7076
<plugin>
@@ -84,36 +90,53 @@
8490
<plugin>
8591
<groupId>org.apache.maven.plugins</groupId>
8692
<artifactId>maven-javadoc-plugin</artifactId>
87-
<version>${maven-javadoc-plugin.version}</version>
93+
<version>3.2.0</version>
8894
<configuration>
95+
<links>
96+
<link>https://docs.oracle.com/javase/7/docs/api/</link>
97+
<link>https://docs.oracle.com/javase/7/docs/jre/api/security/smartcardio/spec/</link>
98+
</links>
8999
<author>false</author>
100+
<source>7</source>
90101
<bottom><![CDATA[&nbsp;]]></bottom>
91102
</configuration>
92-
</plugin>
93-
<plugin>
94-
<groupId>org.apache.maven.plugins</groupId>
95-
<artifactId>maven-jarsigner-plugin</artifactId>
96-
<version>1.2</version>
97103
<executions>
98104
<execution>
99-
<id>sign</id>
105+
<id>attach-javadocs</id>
100106
<goals>
101-
<goal>sign</goal>
107+
<goal>jar</goal>
102108
</goals>
103109
</execution>
110+
</executions>
111+
</plugin>
112+
<plugin>
113+
<groupId>org.apache.maven.plugins</groupId>
114+
<artifactId>maven-gpg-plugin</artifactId>
115+
<version>1.5</version>
116+
<executions>
104117
<execution>
105-
<id>verify</id>
118+
<id>sign-artifacts</id>
119+
<phase>verify</phase>
106120
<goals>
107-
<goal>verify</goal>
121+
<goal>sign</goal>
108122
</goals>
123+
<configuration>
124+
<keyname>${gpg.keyname}</keyname>
125+
</configuration>
109126
</execution>
110127
</executions>
128+
</plugin>
129+
<plugin>
130+
<groupId>org.sonatype.plugins</groupId>
131+
<artifactId>nexus-staging-maven-plugin</artifactId>
132+
<version>1.6.7</version>
133+
<extensions>true</extensions>
111134
<configuration>
112-
<keystore>${keystoreLocation}</keystore>
113-
<alias>${keyAlias}</alias>
114-
<storepass>${keystorePass}</storepass>
115-
<keypass>${keyPass}</keypass>
116-
<storetype>${storeType}</storetype>
135+
<serverId>ossrh</serverId>
136+
<nexusUrl>https://oss.sonatype.org/</nexusUrl>
137+
<autoReleaseAfterClose>true</autoReleaseAfterClose>
138+
<skipStagingRepositoryClose>true</skipStagingRepositoryClose>
139+
<keepStagingRepositoryOnCloseRuleFailure>true</keepStagingRepositoryOnCloseRuleFailure>
117140
</configuration>
118141
</plugin>
119142
</plugins>
@@ -157,11 +180,13 @@
157180
<plugins>
158181
<plugin>
159182
<groupId>org.apache.maven.plugins</groupId>
160-
<artifactId>maven-compiler-plugin</artifactId>
161-
<version>3.8.1</version>
183+
<artifactId>maven-release-plugin</artifactId>
184+
<version>2.5.3</version>
162185
<configuration>
163-
<source>${java.version}</source>
164-
<target>${java.version}</target>
186+
<autoVersionSubmodules>true</autoVersionSubmodules>
187+
<useReleaseProfile>false</useReleaseProfile>
188+
<releaseProfiles>release</releaseProfiles>
189+
<goals>deploy nexus-staging:release</goals>
165190
</configuration>
166191
</plugin>
167192
<plugin>
@@ -249,19 +274,6 @@
249274
</dependency>
250275
</dependencies>
251276
</plugin>
252-
<plugin>
253-
<groupId>org.apache.maven.plugins</groupId>
254-
<artifactId>maven-javadoc-plugin</artifactId>
255-
<version>${maven-javadoc-plugin.version}</version>
256-
<configuration>
257-
<links>
258-
<link>https://docs.oracle.com/javase/7/docs/api/</link>
259-
<link>https://docs.oracle.com/javase/7/docs/jre/api/security/smartcardio/spec/</link>
260-
</links>
261-
<author>false</author>
262-
<source>7</source>
263-
</configuration>
264-
</plugin>
265277
<plugin>
266278
<groupId>org.apache.maven.plugins</groupId>
267279
<artifactId>maven-shade-plugin</artifactId>

sitedocs/getting_source_and_compiling.md

Lines changed: 33 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -1,9 +1,5 @@
11
## Building & Development
22

3-
### Source code
4-
The official jCardSim source repository is located at [https://github.com/licel/jcardsim](https://github.com/licel/jcardsim).
5-
6-
73
### Building
84

95
1. Install the [Java Development Kit (JDK) 8](http://www.oracle.com/technetwork/java/javase/downloads/) from Oracle.
@@ -13,11 +9,40 @@ The official jCardSim source repository is located at [https://github.com/licel/
139
3. Install [Apache Maven](https://maven.apache.org/download.html), which is used to build jCardSim. Follow the [installation tips](https://maven.apache.org/install.html) to set the `PATH` and `JAVA_HOME` environment variables.
1410

1511
4. From the directory containing the jCardSim source code, execute the following commands:
16-
~~~
17-
mvn initialize
18-
mvn clean install
19-
~~~
2012

13+
~~~
14+
mvn clean install
15+
~~~
16+
17+
### Creating Release
18+
19+
Open Maven's `settings.xml`:
20+
21+
~~~xml
22+
<profiles>
23+
<profile>
24+
<id>jcardsim</id>
25+
<properties>
26+
<!-- the group id to use for the artifact - each deployment must use a unique-->
27+
<group.id>de.ohmesoftware</group.id>
28+
<!-- Run gpg --list-signatures --keyid-format 0xshort and select the key id -->
29+
<gpg.keyname>0x.....</gpg.keyname>
30+
<github.username>github username</github.username>
31+
<github.name>your name</github.name>
32+
<github.mail>email to use</github.mail>
33+
<!-- optional: in case you use several ssh keys and have a ssh host identifier set -->
34+
<github.dev.host>github.com</github.dev.host>
35+
</properties>
36+
</profile>
37+
</profiles>
38+
~~~
39+
40+
Release the jar on Sonatype:
41+
42+
~~~shell
43+
mvn release:clean release:prepare -Pjcardsim
44+
mvn release:perform -Pjcardsim
45+
~~~
2146

2247
### Development
2348
jCardSim is an open source project, and it would be a pleasure for us to see you as committers and contributors!

0 commit comments

Comments
 (0)