feat: upgrade to API 3.0.0

build.gradle.kts

@@ -16,7 +16,7 @@ plugins {
 dependencies {
   implementation(fileTree(mapOf("dir" to "libs", "include" to listOf("*.jar"))))
   implementation("org.eclipse.keyple:keyple-common-java-api:2.0.2")
-  implementation("org.eclipse.keyple:keyple-plugin-java-api:2.3.2")
+  implementation("org.eclipse.keyple:keyple-plugin-java-api:3.0.0-SNAPSHOT") { isChanging = true }
   implementation("org.eclipse.keyple:keyple-util-java-lib:2.4.1")
   implementation("net.java.dev.jna:jna:5.15.0")
   compileOnly("org.slf4j:slf4j-api:1.7.36")

gradle.properties

@@ -2,7 +2,7 @@
 group = org.eclipse.keyple
 title = Keyple Plugin PCSC Java Lib
 description = Keyple add-on to manage PC/SC readers
-version = 2.6.3-SNAPSHOT
+version = 3.0.0-SNAPSHOT
 
 # Java Configuration
 javaSourceLevel = 1.8

src/main/java/org/eclipse/keyple/plugin/pcsc/PcscReader.java

@@ -210,14 +210,21 @@ enum DisconnectionMode {
   PcscReader setIsoProtocol(IsoProtocol isoProtocol);
 
   /**
-   * Changes the action to be taken after disconnection (default value {@link
-   * DisconnectionMode#RESET}).
+   * Changes the action to be taken when the internal {@code closePhysicalChannel()} method is
+   * called (default value {@link DisconnectionMode#RESET}).
    *
-   * <p>The card is either reset or left as is.
+   * <p>This setting applies to the forced-close path (e.g. non-observable mode, or abnormal
+   * termination). In observable mode, the channel is closed by {@code deselectCard()} (always
+   * SCARD_UNPOWER_CARD) before card-removal detection, so the internal {@code
+   * closePhysicalChannel()} method is typically a no-op and this setting has no effect.
+   *
+   * <p>{@link DisconnectionMode#UNPOWER} and {@link DisconnectionMode#EJECT} require the default
+   * jnasmartcardio provider; they silently fall back to {@link DisconnectionMode#RESET} with other
+   * providers.
    *
    * @param disconnectionMode The {@link DisconnectionMode} to use (must be not null).
    * @return This instance.
-   * @throws IllegalArgumentException If disconnectionMode is null
+   * @throws IllegalArgumentException If disconnectionMode is null.
    * @since 2.0.0
    */
   PcscReader setDisconnectionMode(DisconnectionMode disconnectionMode);