Adding some Maven central repository information.

This commit is contained in:
Robert Greene 2016-11-14 00:22:17 +00:00
parent 84fb7e7d03
commit 95e97e2ae6
2 changed files with 101 additions and 0 deletions

64
build/README-bundle.txt Normal file
View File

@ -0,0 +1,64 @@
These are notes regarding releasing AppleCommaner into the Maven Central Repository.
For future reference, the OSSRH ticket is located at:
https://issues.sonatype.org/browse/OSSRH-26096
Due to the fact that I no longer own the webcodepro.com domain, AppleCommander has
been released under the net.sf.applecommander package.
GAV for AppleCommander:
<dependency>
<groupId>net.sf.applecommander</groupId>
<artifactId>AppleCommander</artifactId>
<version>1.3.5.14</version>
</dependency>
As AppleCommander itself is not a Maven based project, the release process chosen is the
manual one.
Quick notes:
1. The person performing the release must be able to sign the JAR files.
2. It is required to include sources and javadocs in a JAR file.
3. Using the bundle.jar result is quite simple.
4. "bundle-pom.xml" is the POM used for releasing; update version information and rename
appropriately.
Generating javadoc:
The following ANT script was used to generate javadoc on the fly:
<project name="AppleCommander" default="doc">
<target name="doc" description="generate documentation">
<javadoc sourcepath="./sources/src" destdir="./javadoc"/>
</target>
</project>
And then jarred up and named appropriately.
A quick overview of the bundle creation is as follows:
$ find . -name "AppleCommander*" -exec gpg -ab {} \;
$ jar -cvf bundle.jar AppleCommander*
Contents of bundle.jar is as follows:
$ jar -tvf bundle.jar
0 Sun Nov 13 12:30:30 CST 2016 META-INF/
69 Sun Nov 13 12:30:30 CST 2016 META-INF/MANIFEST.MF
499018 Sun Nov 13 10:18:02 CST 2016 AppleCommander-1.3.5.14.jar
473 Sun Nov 13 12:30:30 CST 2016 AppleCommander-1.3.5.14.jar.asc
753461 Sun Nov 13 12:27:06 CST 2016 AppleCommander-1.3.5.14-javadoc.jar
473 Sun Nov 13 12:30:30 CST 2016 AppleCommander-1.3.5.14-javadoc.jar.asc
1204 Sun Nov 13 12:30:14 CST 2016 AppleCommander-1.3.5.14.pom
473 Sun Nov 13 12:30:30 CST 2016 AppleCommander-1.3.5.14.pom.asc
851262 Sun Nov 13 10:18:02 CST 2016 AppleCommander-1.3.5.14-sources.jar
473 Sun Nov 13 12:30:30 CST 2016 AppleCommander-1.3.5.14-sources.jar.asc
Read the reference material as it was very informative.
References:
* http://central.sonatype.org/pages/manual-staging-bundle-creation-and-deployment.html
* http://central.sonatype.org/pages/releasing-the-deployment.html
* https://oss.sonatype.org/

37
build/bundle-pom.xml Normal file
View File

@ -0,0 +1,37 @@
<!--
AppleCommander does not use Maven at this time. This POM is simply to make the
JAR libraries avaialable via Maven Central.
Please visit applecommander.sf.net for more information.
-->
<project>
<modelVersion>4.0.0</modelVersion>
<groupId>net.sf.applecommander</groupId>
<artifactId>AppleCommander</artifactId>
<version>1.3.5.14</version>
<packaging>jar</packaging>
<name>AppleCommander</name>
<description>AppleCommander is a general utility for Apple II disk images.</description>
<url>http://applecommander.sourceforge.net/</url>
<licenses>
<license>
<name>The GNU General Public License (GPL) Version 2, June 1991</name>
<url>https://www.gnu.org/licenses/gpl-2.0.html</url>
<distribution>repo</distribution>
</license>
</licenses>
<developers>
<developer>
<id>robgreene</id>
<email>robgreene@gmail.com</email>
</developer>
<!-- There are others, but not adding them unless they request it. -->
</developers>
<scm>
<url>http://applecommander.cvs.sourceforge.net/viewvc/applecommander/AppleCommander/</url>
</scm>
</project>