/** * POST TITLE: Maven Central vs JitPack - Java Library Publishing Guide * * Comprehensive comparison and implementation for both publishing methods */ import java.io.*; import java.nio.file.*; import java.util.*; public class PublishingComparison { /** * Maven Central Publishing Implementation */ public static class MavenCentralPublisher { private static final String CENTRAL_REPO_URL = "https://repo1.maven.org/maven2/"; private static final String SNAPSHOT_REPO_URL = "https://oss.sonatype.org/content/repositories/snapshots/"; public void publishToMavenCentral(String groupId, String artifactId, String version, File artifactFile, File sourcesJar, File javadocJar) { System.out.println("🚀 Starting Maven Central Publication Process"); System.out.println("============================================="); // Step 1: Pre-requisites check if (!checkPrerequisites()) { throw new RuntimeException("Maven Central prerequisites not met"); } // Step 2: Sign artifacts List<File> signedArtifacts = signArtifacts(artifactFile, sourcesJar, javadocJar); // Step 3: Generate POM file File pomFile = generatePomFile(groupId, artifactId, version); // Step 4: Upload to Sonatype OSSRH uploadToSonatype(groupId, artifactId, version, signedArtifacts, pomFile); // Step 5: Close and release staging repository closeAndReleaseStagingRepo(); System.out.println("✅ Publication process completed. Artifacts will sync to Maven Central in ~2 hours"); } private boolean checkPrerequisites() { System.out.println("📋 Checking prerequisites..."); // Check GPG setup if (!checkGpgInstallation()) { System.out.println("❌ GPG not installed or configured"); return false; } // Check Sonatype credentials if (!checkSonatypeCredentials()) { System.out.println("❌ Sonatype credentials not configured"); return false; } // Check project metadata if (!validateProjectMetadata()) { System.out.println("❌ Project metadata validation failed"); return false; } System.out.println("✅ All prerequisites met"); return true; } private boolean checkGpgInstallation() { try { Process process = Runtime.getRuntime().exec("gpg --version"); return process.waitFor() == 0; } catch (Exception e) { return false; } } private boolean checkSonatypeCredentials() { String username = System.getenv("SONATYPE_USERNAME"); String password = System.getenv("SONATYPE_PASSWORD"); return username != null && !username.isEmpty() && password != null && !password.isEmpty(); } private boolean validateProjectMetadata() { // Validate groupId, artifactId, version formatting // Check license, SCM, developer information return true; } private List<File> signArtifacts(File... artifacts) { System.out.println("🔐 Signing artifacts with GPG..."); List<File> signedFiles = new ArrayList<>(); for (File artifact : artifacts) { if (artifact != null) { File ascFile = new File(artifact.getAbsolutePath() + ".asc"); // Simulate GPG signing System.out.println(" Signing: " + artifact.getName()); signedFiles.add(artifact); signedFiles.add(ascFile); } } return signedFiles; } private File generatePomFile(String groupId, String artifactId, String version) { System.out.println("📄 Generating POM file..."); String pomContent = String.format(""" <?xml version="1.0" encoding="UTF-8"?> <project 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 http://maven.apache.org/xsd/maven-4.0.0.xsd"> <modelVersion>4.0.0</modelVersion> <groupId>%s</groupId> <artifactId>%s</artifactId> <version>%s</version> <packaging>jar</packaging> <name>%s</name> <description>A sample Java library</description> <url>https://github.com/yourusername/your-repo</url> <licenses> <license> <name>MIT License</name> <url>https://opensource.org/licenses/MIT</url> </license> </licenses> <developers> <developer> <name>Your Name</name> <email>[email protected]</email> </developer> </developers> <scm> <connection>scm:git:https://github.com/yourusername/your-repo.git</connection> <developerConnection>scm:git:https://github.com/yourusername/your-repo.git</developerConnection> <url>https://github.com/yourusername/your-repo</url> </scm> </project> """, groupId, artifactId, version, artifactId); try { File pomFile = File.createTempFile("pom", ".xml"); Files.writeString(pomFile.toPath(), pomContent); return pomFile; } catch (IOException e) { throw new RuntimeException("Failed to generate POM file", e); } } private void uploadToSonatype(String groupId, String artifactId, String version, List<File> artifacts, File pomFile) { System.out.println("📤 Uploading to Sonatype OSSRH..."); // Simulate Nexus Staging Upload for (File artifact : artifacts) { System.out.println(" Uploading: " + artifact.getName()); // Actual implementation would use Maven Wagon or HTTP client } System.out.println(" Uploading POM: " + pomFile.getName()); } private void closeAndReleaseStagingRepo() { System.out.println("🔒 Closing and releasing staging repository..."); // Simulate Nexus Staging workflow System.out.println(" Closing staging repository..."); System.out.println(" Releasing to Maven Central..."); } public void verifyPublication(String groupId, String artifactId, String version) { System.out.println("🔍 Verifying publication on Maven Central..."); String artifactPath = groupId.replace('.', '/') + "/" + artifactId + "/" + version; String centralUrl = CENTRAL_REPO_URL + artifactPath; // Check if artifact exists in Maven Central System.out.println(" Checking: " + centralUrl); // Implementation would use HTTP client to check availability } } /** * JitPack Publishing Implementation */ public static class JitPackPublisher { private static final String JITPACK_URL = "https://jitpack.io"; public void publishWithJitPack(String gitRepoUrl, String tagOrCommit) { System.out.println("\n🚀 Starting JitPack Publication Process"); System.out.println("======================================"); // Step 1: Validate Git repository if (!validateGitRepository(gitRepoUrl)) { throw new RuntimeException("Invalid Git repository: " + gitRepoUrl); } // Step 2: Check build compatibility if (!checkBuildCompatibility(gitRepoUrl)) { throw new RuntimeException("Repository not compatible with JitPack build"); } // Step 3: Trigger JitPack build String buildId = triggerJitPackBuild(gitRepoUrl, tagOrCommit); // Step 4: Monitor build status monitorBuildStatus(buildId); System.out.println("✅ Publication process completed. Artifacts available immediately"); } private boolean validateGitRepository(String gitRepoUrl) { System.out.println("📋 Validating Git repository..."); // Check if it's a valid GitHub, GitLab, or Bitbucket URL boolean isValid = gitRepoUrl.matches("https://(github|gitlab|bitbucket)\\.com/.+/.+"); System.out.println(" Repository URL valid: " + isValid); return isValid; } private boolean checkBuildCompatibility(String gitRepoUrl) { System.out.println("🔍 Checking build compatibility..."); // Check for build configuration files boolean hasBuildConfig = checkForBuildFiles(gitRepoUrl); System.out.println(" Build configuration found: " + hasBuildConfig); return hasBuildConfig; } private boolean checkForBuildFiles(String gitRepoUrl) { // Simulate checking for build files // In reality, this would check the repository for: // - build.gradle, settings.gradle (Gradle) // - pom.xml (Maven) // - jitpack.yml (custom configuration) return true; } private String triggerJitPackBuild(String gitRepoUrl, String tagOrCommit) { System.out.println("🎯 Triggering JitPack build..."); String repoPath = extractRepoPath(gitRepoUrl); String buildId = repoPath + ":" + tagOrCommit; System.out.println(" Build ID: " + buildId); System.out.println(" Build URL: " + JITPACK_URL + "/" + buildId); return buildId; } private String extractRepoPath(String gitRepoUrl) { // Extract username/repo from URL return gitRepoUrl.replace("https://", "") .replace("github.com/", "") .replace("gitlab.com/", "") .replace("bitbucket.org/", "") .replace(".git", ""); } private void monitorBuildStatus(String buildId) { System.out.println("📊 Monitoring build status..."); // Simulate build process System.out.println(" Build queued..."); System.out.println(" Building..."); System.out.println(" Running tests..."); System.out.println(" Publishing artifacts..."); System.out.println(" ✅ Build completed successfully"); } public void verifyPublication(String gitRepoUrl, String tagOrCommit) { System.out.println("🔍 Verifying publication on JitPack..."); String repoPath = extractRepoPath(gitRepoUrl); String jitpackUrl = JITPACK_URL + "/#" + repoPath + "/" + tagOrCommit; System.out.println(" Check: " + jitpackUrl); System.out.println(" Usage in build.gradle:"); System.out.println(" implementation 'com.github." + repoPath + ":" + tagOrCommit + "'"); } } /** * Comparison and Decision Helper */ public static class PublishingDecisionHelper { public enum PublishingMethod { MAVEN_CENTRAL, JITPACK, BOTH } public static class ProjectRequirements { private boolean enterpriseUse; private boolean openSource; private boolean quickSetup; private boolean longTermStability; private boolean automaticBuilds; private boolean signingRequired; private boolean multiModule; // Builder pattern public static class Builder { private ProjectRequirements requirements = new ProjectRequirements(); public Builder enterpriseUse(boolean enterpriseUse) { requirements.enterpriseUse = enterpriseUse; return this; } public Builder openSource(boolean openSource) { requirements.openSource = openSource; return this; } public Builder quickSetup(boolean quickSetup) { requirements.quickSetup = quickSetup; return this; } public Builder longTermStability(boolean longTermStability) { requirements.longTermStability = longTermStability; return this; } public Builder automaticBuilds(boolean automaticBuilds) { requirements.automaticBuilds = automaticBuilds; return this; } public Builder signingRequired(boolean signingRequired) { requirements.signingRequired = signingRequired; return this; } public Builder multiModule(boolean multiModule) { requirements.multiModule = multiModule; return this; } public ProjectRequirements build() { return requirements; } } // Getters public boolean isEnterpriseUse() { return enterpriseUse; } public boolean isOpenSource() { return openSource; } public boolean isQuickSetup() { return quickSetup; } public boolean isLongTermStability() { return longTermStability; } public boolean isAutomaticBuilds() { return automaticBuilds; } public boolean isSigningRequired() { return signingRequired; } public boolean isMultiModule() { return multiModule; } } public PublishingMethod recommendMethod(ProjectRequirements requirements) { int mavenCentralScore = 0; int jitpackScore = 0; // Scoring logic if (requirements.isEnterpriseUse()) mavenCentralScore += 2; if (requirements.isLongTermStability()) mavenCentralScore += 2; if (requirements.isSigningRequired()) mavenCentralScore += 2; if (requirements.isMultiModule()) mavenCentralScore += 1; if (requirements.isQuickSetup()) jitpackScore += 2; if (requirements.isAutomaticBuilds()) jitpackScore += 2; if (requirements.isOpenSource()) jitpackScore += 1; if (mavenCentralScore > jitpackScore) { return PublishingMethod.MAVEN_CENTRAL; } else if (jitpackScore > mavenCentralScore) { return PublishingMethod.JITPACK; } else { return PublishingMethod.BOTH; } } public void printComparisonTable() { System.out.println("\n📊 Maven Central vs JitPack Comparison"); System.out.println("===================================="); System.out.printf("%-25s | %-12s | %-12s%n", "FEATURE", "MAVEN CENTRAL", "JITPACK"); System.out.printf("%-25s | %-12s | %-12s%n", "-------------------------", "------------", "------------"); String[][] comparisonData = { {"Setup Complexity", "High", "Low"}, {"Time to Publish", "2+ hours", "Immediate"}, {"Artifact Signing", "Required", "Optional"}, {"Enterprise Adoption", "High", "Medium"}, {"Build Process", "Manual", "Automatic"}, {"Repository", "Central", "Git-based"}, {"Version Management", "Manual", "Git tags"}, {"Multi-module Support", "Excellent", "Limited"}, {"Custom Builds", "No", "Yes (jitpack.yml)"}, {"Cost", "Free", "Free"} }; for (String[] row : comparisonData) { System.out.printf("%-25s | %-12s | %-12s%n", row[0], row[1], row[2]); } } } /** * Gradle Configuration Examples */ public static class GradleConfigurations { public String getMavenCentralGradleConfig() { return """ // build.gradle for Maven Central publishing plugins { id 'java-library' id 'maven-publish' id 'signing' } group = 'com.yourcompany' version = '1.0.0' java { withJavadocJar() withSourcesJar() } publishing { publications { mavenJava(MavenPublication) { from components.java pom { name = 'Your Library' description = 'A fantastic Java library' url = 'https://github.com/yourusername/your-repo' licenses { license { name = 'MIT License' url = 'https://opensource.org/licenses/MIT' } } developers { developer { id = 'yourusername' name = 'Your Name' email = '[email protected]' } } scm { connection = 'scm:git:https://github.com/yourusername/your-repo.git' developerConnection = 'scm:git:https://github.com/yourusername/your-repo.git' url = 'https://github.com/yourusername/your-repo' } } } } repositories { maven { name = 'OSSRH' url = version.endsWith('SNAPSHOT') ? 'https://oss.sonatype.org/content/repositories/snapshots/' : 'https://oss.sonatype.org/service/local/staging/deploy/maven2/' credentials { username = project.findProperty('sonatypeUsername') password = project.findProperty('sonatypePassword') } } } } signing { sign publishing.publications.mavenJava } """; } public String getJitPackGradleConfig() { return """ // build.gradle for JitPack - Minimal configuration needed! plugins { id 'java-library' } group = 'com.github.yourusername' version = 'v1.0.0' // Use git tags for versions // That's it! JitPack will automatically build and publish // Optional: Add jitpack.yml for custom build configuration """; } public String getJitPackYmlConfig() { return """ # jitpack.yml - Custom build configuration jdk: - openjdk17 before_install: - sdk install java 17.0.2-open - sdk use java 17.0.2-open install: - ./gradlew build publishToMavenLocal """; } } /** * Demo and Usage Examples */ public static void main(String[] args) { System.out.println("🎯 Java Library Publishing Guide: Maven Central vs JitPack"); System.out.println("=========================================================\n"); // Decision helper PublishingDecisionHelper decisionHelper = new PublishingDecisionHelper(); decisionHelper.printComparisonTable(); // Example project requirements PublishingDecisionHelper.ProjectRequirements requirements = new PublishingDecisionHelper.ProjectRequirements.Builder() .enterpriseUse(true) .openSource(true) .quickSetup(false) .longTermStability(true) .automaticBuilds(false) .signingRequired(true) .multiModule(true) .build(); PublishingDecisionHelper.PublishingMethod recommended = decisionHelper.recommendMethod(requirements); System.out.println("\n💡 Recommended publishing method: " + recommended); // Demonstrate both publishing methods MavenCentralPublisher centralPublisher = new MavenCentralPublisher(); JitPackPublisher jitpackPublisher = new JitPackPublisher(); // Maven Central example System.out.println("\n" + "=".repeat(50)); try { centralPublisher.publishToMavenCentral( "com.example", "my-library", "1.0.0", new File("my-library-1.0.0.jar"), new File("my-library-1.0.0-sources.jar"), new File("my-library-1.0.0-javadoc.jar") ); centralPublisher.verifyPublication("com.example", "my-library", "1.0.0"); } catch (Exception e) { System.out.println("Maven Central simulation completed with expected setup requirements"); } // JitPack example System.out.println("\n" + "=".repeat(50)); jitpackPublisher.publishWithJitPack( "https://github.com/yourusername/your-java-library", "v1.0.0" ); jitpackPublisher.verifyPublication( "https://github.com/yourusername/your-java-library", "v1.0.0" ); // Show Gradle configurations GradleConfigurations gradleConfigs = new GradleConfigurations(); System.out.println("\n📝 Gradle Configuration Examples:"); System.out.println("\n--- Maven Central Configuration ---"); System.out.println(gradleConfigs.getMavenCentralGradleConfig()); System.out.println("\n--- JitPack Configuration ---"); System.out.println(gradleConfigs.getJitPackGradleConfig()); System.out.println("\n--- JitPack YML Configuration ---"); System.out.println(gradleConfigs.getJitPackYmlConfig()); } }

Key Differences Summary

When to Use Each

Use Maven Central when:

• Enterprise/library distribution
• Long-term stability required
• Artifact signing is mandatory
• Multi-module complex projects

Use JitPack when:

• Quick prototyping
• Internal/team projects
• Automatic builds from Git
• Simple setup needed

Use Both when:

• Maximum reach and flexibility needed
• Enterprise + community distribution

This comprehensive guide helps Java developers choose the right publishing strategy based on their specific needs and project requirements.