search

microsoft / oauth2-useragent

Microsoft OAuth 2.0 User Agent library for Java. Provides classes to facilitate the implementation of "4.1. Authorization Code Grant" from RFC 6749.
Other
35 stars 22 forks source link

Generate and attach javadoc JAR for aggregate project #4

Closed olivierdagenais closed 8 years ago

olivierdagenais commented 8 years ago

Summary

A bit of clean-up and re-work of the POMs to make sure we only install & deploy the needed artifacts and not those of intermediate projects. Deploying to Maven central requires deploying -sources and -javadoc JARs so this pull request makes us satisfy the latter requirement (and then some).

Manual testing

  1. Ran mvn clean deploy -D performRelease=true -P release and confirmed that the parent project's artifact (the parent POM) was installed and deployed, as well as only the aggregate project/module was:
    1. Generating a -javadoc artifact
    2. Generating a -sources artifact
    3. Installing the JARs (and their PGP signatures) to the local cache
    4. Deploying the JARs (and their PGP signatures) to the snapshot repository
  2. Temporarily configured the GCM4ML to point to version 0.5.5-SNAPSHOT of this library (which was installed/deployed in the previous step) and then rebuilt, including running the unit tests.
  3. Cleared my local cache and rebuilt GCM4ML. The SNAPSHOT artifacts were downloaded from the snapshot repository, except for -sources and -javadoc (these aren't automatically downloaded on purpose). I then instructed Maven to go fetch the associated -javadoc and confirmed that my IDE (IntelliJ IDEA) was able to fetch & render documentation associated with the oauth2-useragent project, even in the absence of the associated source code.

Mission accomplished!