xmlgraphics-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From Apache Wiki <wikidi...@apache.org>
Subject [Xmlgraphics Wiki] Update of "Maven" by SimonPepping
Date Sun, 29 Aug 2010 18:39:06 GMT
Dear Wiki user,

You have subscribed to a wiki page or wiki category on "Xmlgraphics Wiki" for change notification.

The "Maven" page has been changed by SimonPepping.
The comment on this change is: New description of the Maven build and upload procedure.


  = Maven artifacts for XML Graphics projects =
+ == Prerequesites ==
+  * Apache Account
+  * Maven 2 installed on a local machine (with method 2)
- == Prerequesites ==
+ == First action ==
+ Open the pom template xmlgraphics-commons-pom-template.pom in your editor, and check and
correct the versions of the dependencies, and the dependencies themselves. The version of
the release itself (@version@) is inserted by the build process.
-  * Apache Account
-  * Maven 2 installed on a local machine
+ == Method 1. Using ant and uploading the bundle ==
+ Note: This method is theoretical. It has yet not been tested by the author.
+ The xmlgraphics commons (XGC) build file contains a target 'maven-artifacts'. This target
builds the four maven artifacts xmlgraphics-commons-''version''.jar, xmlgraphics-commons-''version''-sources.jar,
xmlgraphics-commons-''version''-javadoc.jar and pom.xml. It also builds the md5 and sha1 checksum
files, and calls gpg to sign the artifacts. These artifacts and auxiliary files are bundled
in the bundle file xmlgraphics-commons-''version''-bundle.jar.
+ Log into the ASF maven repository at http://repository.apache.org/ with your ASF account,
select 'Staging upload', and upload the bundle. See section 9.5 of the Nexus book, http://www.sonatype.com/books/nexus-book/reference/staging-sect-uploading-staged.html.
Proceed as described in the section 'Closing the repository and promote' below.
+ == Method 2. Uploading using maven ==
+ Generate the four maven artifacts xmlgraphics-commons-''version''.jar, xmlgraphics-commons-''version''-sources.jar,
xmlgraphics-commons-''version''-javadoc.jar and pom.xml in an empty working directory. The
XGC build file does not contain a build target that does just this. You may build the target
'maven-artifacts' and extract the artifacts from the created bundle. If you do not use ant,
copy the pom template xmlgraphics-commons-pom-template.pom to pom.xml in your working directory
and insert the version of the release itself (@version@).
  == Settings ==
  Edit your .m2/settings.xml to contain:
-  <settings xmlns="http://maven.apache.org/POM/4.0.0"
+  . <settings xmlns="http://maven.apache.org/POM/4.0.0"
+   . xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://maven.apache.org/POM/4.0.0
-   xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
-   xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 
-                       http://maven.apache.org/xsd/settings-1.0.0.xsd">
+    . http://maven.apache.org/xsd/settings-1.0.0.xsd">
-     <server>
+    . <server>
+     . <id>apache</id> <username>YOURUSERID</username> <privateKey>YOURLOCALHOMEDIR/.ssh/id_dsa</privateKey>
<filePermissions>664</filePermissions> <directoryPermissions>775</directoryPermissions>
-       <id>apache</id>
-       <username>YOURUSERID</username>
-       <privateKey>YOURLOCALHOMEDIR/.ssh/id_dsa</privateKey>
-       <filePermissions>664</filePermissions>
-       <directoryPermissions>775</directoryPermissions>
-     </server>
+    </server>
-    </servers>
+    . </servers>
+  .
+ Note: It is not clear that the SSH method is still used for log in.
- == Versioning ==
+ Copy the pom file sign-and-deploy.pom.xml to your working directory and use it as a template.
The description section in the file gives an explanation.Then upload the artifacts:
- Versions in Maven should match the released version. For difference in target jdk, -jdk13
(or equivalent) should be added to the version string. Please note that the pom template may
need to be edited, as there may be different requirements (e.g. on XML libraries when using
jdk 1.3).
+  . mvn -f sign-and-deploy.pom.xml -Ppublish -Dfile=xmlgraphics-commons-''version''.
+  .
+ Then  log into the ASF maven repository at http://repository.apache.org/, with your ASF
account, select 'Repositories', select the repository called 'staging', and check the staging
repository for the new version that was just created. Then proceed as described in the following
+ == Close the staging repository and promote ==
+ Close the staging repository and check the messages. If you are satisfied, report the release
on the dev mailing list and ask committers to check. If they are satisfied, the repository
can be promoted. See section 9.7 of the Nexus book, http://www.sonatype.com/books/nexus-book/reference/staging-sect-managing-staging.html.
- == XML Graphics Commons ==
- make sure you use the official binary distribution! I used -bin-jdk1.4
- unpack it, grab jar from build/ and copy it to temp directory
- copy xmlgraphics-commons-pom-template.pom (from svn) to temp directory
- edit xmlgraphics-commons-pom-template.pom, make sure it contains the right version numbers!
(replace @version@ with the right information)
- Deploy artifact:
-  mvn deploy:deploy-file -Durl=sftp://USERNAME@people.apache.org/www/people.apache.org/repo/m2-ibiblio-rsync-repository
-DrepositoryId=apache -Dfile=xmlgraphics-commons-1.2.jar -DpomFile=xmlgraphics-commons-pom-template.pom

- TDB: Discuss if we also need to deploy the -jdk1.3 artifacts.
  == FOP ==
+ Same as XML Graphics Commons, except for the base name, which is fop-''version''. The target
'maven-artifacts' in the fop build file does not yet do checksum calculation and signing.
This can be added once method 1 is confirmed as correct.
- same as XML Graphics Commons.
-  mvn deploy:deploy-file -Durl=sftp://USERNAME@people.apache.org/www/people.apache.org/repo/m2-ibiblio-rsync-repository
-DrepositoryId=apache -Dfile=fop.jar -DpomFile=xmlgraphics-fop-pom-template.pom 
  == Snapshot releases ==
  == Further Information ==
  Log into people.apache.org and check the www/people.apache.org/repo/m2-ibiblio-rsync-repository/org/apache/xmlgraphics/
directories for errors. Delete errors ASAP, as this directory is synced with the main repository!
  see also:

To unsubscribe, e-mail: commits-unsubscribe@xmlgraphics.apache.org
For additional commands, e-mail: commits-help@xmlgraphics.apache.org

View raw message