#1297: update maven SNAPSHOT handling (#1421)

Author: hohwille

CHANGELOG.adoc

@@ -9,6 +9,7 @@ Release with new features and bugfixes:
 * https://github.com/devonfw/IDEasy/issues/1401[#1401]: Privacy option not working properly
 * https://github.com/devonfw/IDEasy/issues/1400[#1400]: ide --offline status does not replicate ide status behavior when offline
 * https://github.com/devonfw/IDEasy/issues/742[#742]: Produce constructive warning if git repo url is not sane
+* https://github.com/devonfw/IDEasy/issues/1297[#1297]: Migration from OSSRH to new Maven Central service
 
 The full list of changes for this release can be found in https://github.com/devonfw/IDEasy/milestone/30?closed=1[milestone 2025.07.001].
 

cli/src/main/java/com/devonfw/tools/ide/tool/IdeasyCommandlet.java

@@ -84,7 +84,7 @@ public VersionIdentifier getConfiguredVersion() {
 
     UpgradeMode upgradeMode = this.mode;
     if (upgradeMode == null) {
-      if (IdeVersion.getVersionString().contains("SNAPSHOT")) {
+      if (IdeVersion.isSnapshot()) {
         upgradeMode = UpgradeMode.SNAPSHOT;
       } else {
         if (IdeVersion.getVersionIdentifier().getDevelopmentPhase().isStable()) {
@@ -108,7 +108,7 @@ public boolean install(boolean silent) {
 
     this.context.requireOnline("upgrade of IDEasy", true);
 
-    if (IdeVersion.isUndefined()) {
+    if (IdeVersion.isUndefined() && !this.context.isForceMode()) {
       this.context.warning("You are using IDEasy version {} which indicates local development - skipping upgrade.", IdeVersion.getVersionString());
       return false;
     }
@@ -135,14 +135,17 @@ public VersionIdentifier getLatestVersion() {
    */
   public boolean checkIfUpdateIsAvailable() {
     VersionIdentifier installedVersion = getInstalledVersion();
+    this.context.success("Your version of IDEasy is {}.", installedVersion);
+    if (IdeVersion.isSnapshot()) {
+      this.context.warning("You are using a SNAPSHOT version of IDEasy. For stability consider switching to a stable release via 'ide upgrade --mode=stable'");
+    }
     if (this.context.isOffline()) {
-      this.context.success("Your version of IDEasy is {}.", installedVersion);
       this.context.warning("Skipping check for newer version of IDEasy because you are offline.");
       return false;
     }
     VersionIdentifier latestVersion = getLatestVersion();
     if (installedVersion.equals(latestVersion)) {
-      this.context.success("Your version of IDEasy is {} which is the latest released version.", installedVersion);
+      this.context.success("Your are using the latest version of IDEasy and no update is available.");
       return false;
     } else {
       this.context.interaction("Your version of IDEasy is {} but version {} is available. Please run the following command to upgrade to the latest version:\n"

cli/src/main/java/com/devonfw/tools/ide/tool/repository/MavenRepository.java

@@ -47,7 +47,7 @@ public final class MavenRepository extends AbstractToolRepository {
   public static final String MAVEN_CENTRAL = "https://repo1.maven.org/maven2";
 
   /** Base URL for Maven Snapshots repository */
-  public static final String MAVEN_SNAPSHOTS = "https://s01.oss.sonatype.org/content/repositories/snapshots";
+  public static final String MAVEN_SNAPSHOTS = "https://central.sonatype.com/repository/maven-snapshots";
 
   /** The {@link #getId() repository ID}. */
   public static final String ID = "maven";

cli/src/main/java/com/devonfw/tools/ide/version/IdeVersion.java

@@ -61,4 +61,11 @@ public static boolean isUndefined() {
     return VERSION_UNDEFINED.equals(INSTANCE.version);
   }
 
+  /**
+   * @return {@code true} if the {@link #getVersionString() current version} is a {@code SNAPSHOT} version, {@code false} otherwise.
+   */
+  public static boolean isSnapshot() {
+    return getVersionString().contains("SNAPSHOT");
+  }
+
 }

cli/src/test/java/com/devonfw/tools/ide/tool/mvn/MvnArtifactTest.java

@@ -59,7 +59,7 @@ public void testIdeasyCliSnapshot() {
         "com/devonfw/tools/IDEasy/ide-cli/2025.01.003-beta-SNAPSHOT/ide-cli-2025.01.003-beta-20250130.023001-3-windows-x64.tar.gz");
     assertThat(artifact).hasToString("com.devonfw.tools.IDEasy:ide-cli:2025.01.003-beta-20250130.023001-3:tar.gz:windows-x64");
     assertThat(artifact.getDownloadUrl()).isEqualTo(
-        "https://s01.oss.sonatype.org/content/repositories/snapshots/com/devonfw/tools/IDEasy/ide-cli/2025.01.003-beta-SNAPSHOT/ide-cli-2025.01.003-beta-20250130.023001-3-windows-x64.tar.gz");
+        "https://central.sonatype.com/repository/maven-snapshots/com/devonfw/tools/IDEasy/ide-cli/2025.01.003-beta-SNAPSHOT/ide-cli-2025.01.003-beta-20250130.023001-3-windows-x64.tar.gz");
     assertThat(artifact.getKey()).isEqualTo(artifact.toString());
     assertThat(artifact).isEqualTo(equal);
     assertThat(artifact.hashCode()).isEqualTo(equal.hashCode());
@@ -118,7 +118,7 @@ public void testMetadataWithSnapshot() {
     assertThat(artifact).hasToString("org.apache.maven.plugins:maven-clean-plugin:*-SNAPSHOT:xml");
     assertThat(artifact.getKey()).isEqualTo(artifact.toString());
     assertThat(artifact.getDownloadUrl()).isEqualTo(
-        "https://s01.oss.sonatype.org/content/repositories/snapshots/org/apache/maven/plugins/maven-clean-plugin/maven-metadata.xml");
+        "https://central.sonatype.com/repository/maven-snapshots/org/apache/maven/plugins/maven-clean-plugin/maven-metadata.xml");
     assertThat(artifact).isEqualTo(equal);
     assertThat(artifact.hashCode()).isEqualTo(equal.hashCode());
   }

cli/src/test/java/com/devonfw/tools/ide/tool/repository/MavenRepositoryTest.java

@@ -193,7 +193,7 @@ void testGetMetadataWithSnapshot() {
 
     // assert
     assertThat(metadata.getUrls()).containsExactly(
-        "https://s01.oss.sonatype.org/content/repositories/snapshots/com/devonfw/tools/IDEasy/ide-cli/2025.01.001-beta-SNAPSHOT/ide-cli-2025.01.001-beta-20250121.023134-9-"
+        "https://central.sonatype.com/repository/maven-snapshots/com/devonfw/tools/IDEasy/ide-cli/2025.01.001-beta-SNAPSHOT/ide-cli-2025.01.001-beta-20250121.023134-9-"
             + os + "-" + arch + ".tar.gz");
     assertThat(metadata.getTool()).isEqualTo(tool);
     assertThat(metadata.getEdition()).isEqualTo(edition);

cli/src/test/resources/ide-projects/upgrade-settings/project/settings/devon/conf/.m2/settings.xml

@@ -4,84 +4,23 @@
     To change it edit conf/ide.properties -->
   <localRepository>${env.M2_REPO}</localRepository>
 
-  <!-- 
-   ATTENTION: 
-   Never ever hardcode passwords as plain text!!!
-   Instead simply use variables in angled brackets prefixed with dollar sign.
-   Then devonfw-ide will automatically promt for these variables, encrypt their value and fill it into the placeholder.
-   In case you want to do it manually follow this guide:
-   https://maven.apache.org/guides/mini/guide-encryption.html
-   devonfw-ide already generates settings-security.xml for you
-   so all you need to do is call:
-     mvn -ep
-   hit return and then type your password (do not supply as argument as otherwise it will be saved to the history of your shell)
-   Then copy the encrypted password as according password to this settings.xml
-   -->
-<servers>
-   <server>
-     <id>repository</id>
-     <username>${env.USERNAME}</username>
-     <password>$[mavenRepoPassword]</password>
-   </server>
- </servers>
-
-  <!--
-  <mirrors>
-    <mirror>
-      <id>nexus.central</id>
-      <mirrorOf>central</mirrorOf>
-      <name>central-mirror</name>
-      <url>https://my-production-line.s2-eu.capgemini.com/nexus3/repository/public</url>
-    </mirror>
-  </mirrors>
-  -->
+  <servers>
+    <server>
+      <id>repository</id>
+      <username>${env.USERNAME}</username>
+      <password>$[mavenRepoPassword]</password>
+    </server>
+  </servers>
 
   <profiles>
     <profile>
       <id>devonfw-ide</id>
       <activation>
-        <activeByDefault>true</activeByDefault> 
+        <activeByDefault>true</activeByDefault>
       </activation>
       <properties>
-        <!--
         <sonar.host.url>http://localhost:9000/</sonar.host.url>
-        <sonar.login>${USER}</sonar.login>
-        <sonar.password>TODO</sonar.password>
-        <jarsigner.storepass>TODO</jarsigner.storepass>
-        <jarsigner.keystore>/projects/myproject/workspaces/main/keystore.p12</jarsigner.keystore>
-        <gpg.keyname>your.email@address.com</gpg.keyname>
-        -->
       </properties>
     </profile>
-    <profile>
-      <!-- https://github.com/devonfw/devon4j/blob/master/documentation/guide-testing-snapshots.asciidoc -->
-      <id>devonfw-snapshots</id>
-      <activation>
-        <!--<activeByDefault>true</activeByDefault>-->
-        <activeByDefault>false</activeByDefault> 
-      </activation>
-      <repositories>
-        <repository>
-          <id>devonfw-snapshots</id>
-          <name>devonfw SNAPSHOT releases</name>
-          <url>https://s01.oss.sonatype.org/content/repositories/snapshots/</url>
-          <releases>
-            <enabled>false</enabled>
-            <updatePolicy>never</updatePolicy>
-            <checksumPolicy>fail</checksumPolicy>
-          </releases>
-          <snapshots>
-            <enabled>true</enabled>
-            <updatePolicy>never</updatePolicy>
-            <checksumPolicy>fail</checksumPolicy>
-          </snapshots>
-        </repository>
-      </repositories>
-    </profile>
   </profiles>
-  <activeProfiles>
-    <!--
-    <activeProfile>my-profile</activeProfile>
-    -->
-  </activeProfiles>
 </settings>

documentation/setup.adoc

@@ -68,13 +68,18 @@ You have to delete this folder manually as we do not want to be responsible for
 
 == Testing SNAPSHOT releases
 
-You can find the latest IDEasy SNAPSHOT releases https://s01.oss.sonatype.org/content/repositories/snapshots/com/devonfw/tools/IDEasy/ide-cli/[here].
+Whenever a story in `IDEasy` is completed by merging a https://docs.github.com/en/github/collaborating-with-pull-requests/proposing-changes-to-your-work-with-pull-requests/about-pull-requests[PR], our https://github.com/features/actions[github actions] will build a new SNAPSHOT release and on success deploy it to maven central portal.
+In order to install and test the latest SNAPSHOT version use the following command:
 
-Whenever a story in `IDEasy` is completed by merging a https://docs.github.com/en/github/collaborating-with-pull-requests/proposing-changes-to-your-work-with-pull-requests/about-pull-requests[PR], our https://github.com/features/actions[github actions] will build a new SNAPSHOT release and on success deploy it to nexus on OSSRH.
-Simply choose the latest SNAPSHOT version folder and then inside that version folder the `*.tar.gz` file for the latest version and your target platform.
-Please open the download link in a new tab to make the download start properly.
-
-Once downloaded, you can proceed as with official releases (see xref:install[install]).
+```
+ide upgrade --mode=snapshot
+```
 
 If you test the latest SNAPSHOT please also give feedback to bug or feature tickets to let us know if things are working or not.
 Thanks for your testing, support and help to make IDEasy better!
+
+NOTE: After you completed your test or the next official release has been shipped please do not forget to switch back to the stable release channel.
+
+```
+ide upgrade --mode=stable
+```