chore: add multiplatform build

build.gradle

@@ -65,7 +65,11 @@ subprojects {
                         }
                     }
                 }
-                gcc(Gcc)
+                gcc(Gcc){
+					target("linux_aarch64") {
+						cppCompiler.executable = "/usr/bin/gcc"
+					}
+				}
             }
         }
     }

examples/jce/README.md

@@ -1,33 +1,207 @@
 # JCE Examples
 
 Every example in this directory is a standalone example that demonstrates how to use the JCE API in Tongsuo OpenJDK.
-The example depends on tongsuo-openjdk. You need to build tongsuo-openjdk or download it from maven repository.
-Take TLS13Client and TLS13Server as an example.
+
+## Quick Start (Recommended)
+
+The easiest way to run examples is using the provided convenience scripts with the uber JAR:
+
+```shell
+cd examples/jce
+
+# Download uber JAR (static version - no external dependencies)
+wget https://github.com/Tongsuo-Project/tongsuo-java-sdk/releases/download/v1.1.0/tongsuo-openjdk-1.1.0-uber.jar
+
+# Download BouncyCastle (for server only)
+wget https://repo1.maven.org/maven2/org/bouncycastle/bcprov-jdk15on/1.69/bcprov-jdk15on-1.69.jar
+
+# Run client
+./run-client.sh tongsuo-openjdk-1.1.0-uber.jar
+
+# Run server (in another terminal)
+./run-server.sh bcprov-jdk15on-1.69.jar tongsuo-openjdk-1.1.0-uber.jar
+```
+
+The scripts will automatically:
+- ✅ Detect your Java version
+- ✅ Add required JVM parameters (Java 9+)
+- ✅ Compile the code if needed
+- ✅ Run the example
+
+## Prerequisites
+
+**Java 9+ Module System:** When using Java 9 or later, you need to add JVM parameters to allow Conscrypt to access internal Java APIs:
+
+```shell
+--add-opens java.base/java.net=ALL-UNNAMED
+--add-opens java.base/sun.security.x509=ALL-UNNAMED
+```
+
+The convenience scripts (`run-client.sh` and `run-server.sh`) handle this automatically.
 
 ## TLS13Client
 
+### Using Convenience Script (Recommended)
+
 ```shell
 cd examples/jce
 
-# build
-javac -cp /path/to/tongsuo-openjdk-<version>-<os>-<arch>.jar TLS13Client.java
+# Basic usage
+./run-client.sh tongsuo-openjdk-1.1.0-uber.jar
 
-# run
-java -cp .:/path/to/tongsuo-openjdk-<version>-<os>-<arch>.jar TLS13Client
+# Force recompilation
+./run-client.sh --force-compile tongsuo-openjdk-1.1.0-uber.jar
+```
+
+### Manual Usage
+
+```shell
+cd examples/jce
+
+# Build
+javac -cp tongsuo-openjdk-1.1.0-uber.jar TLS13Client.java
+
+# Run (Java 9+)
+java --add-opens java.base/java.net=ALL-UNNAMED \
+     --add-opens java.base/sun.security.x509=ALL-UNNAMED \
+     -cp .:tongsuo-openjdk-1.1.0-uber.jar \
+     TLS13Client
+
+# Run (Java 8)
+java -cp .:tongsuo-openjdk-1.1.0-uber.jar TLS13Client
 ```
 
 ## TLS13Server
 
-TLS13Server depends on bouncycastle and tongsuo-openjdk. You need to download bcprov-jdk from maven repository.
+**Note:** The server requires:
+- BouncyCastle JAR (`bcprov-jdk15on-1.69.jar`)
+- Certificate files: `sm2.crt`, `sm2.key`, `chain.crt` (provided in this directory)
+
+### Using Convenience Script (Recommended)
 
-Note: sm2.crt, sm2.key and chain.crt are required to run the server.
+```shell
+cd examples/jce
+
+# Basic usage
+./run-server.sh bcprov-jdk15on-1.69.jar tongsuo-openjdk-1.1.0-uber.jar
+
+# Force recompilation
+./run-server.sh --force-compile bcprov-jdk15on-1.69.jar tongsuo-openjdk-1.1.0-uber.jar
+```
+
+### Manual Usage
 
 ```shell
 cd examples/jce
 
-# build
-javac -cp /path/to/bcprov-jdk15on-1.69.jar:/path/to/tongsuo-openjdk-<version>-<os>-<arch>.jar  TLS13Server.java
+# Build
+javac -cp bcprov-jdk15on-1.69.jar:tongsuo-openjdk-1.1.0-uber.jar TLS13Server.java
+
+# Run (Java 9+)
+java --add-opens java.base/java.net=ALL-UNNAMED \
+     --add-opens java.base/sun.security.x509=ALL-UNNAMED \
+     -cp .:bcprov-jdk15on-1.69.jar:tongsuo-openjdk-1.1.0-uber.jar \
+     TLS13Server
 
-# run
-java -cp .:/path/to/bcprov-jdk15on-1.69.jar:/path/to/tongsuo-openjdk-<version>-<os>-<arch>.jar TLS13Server
+# Run (Java 8)
+java -cp .:bcprov-jdk15on-1.69.jar:tongsuo-openjdk-1.1.0-uber.jar TLS13Server
 ```
+
+## Choosing the Right JAR
+
+We provide two uber JARs:
+
+### Static Uber JAR (Recommended) ⭐
+- **Filename:** `tongsuo-openjdk-{version}-uber.jar`
+- **Size:** ~15-20 MB
+- **Dependencies:** None - all Tongsuo libraries are statically linked
+- **Use when:** You want simplicity and portability
+- **Pros:** Works everywhere, no installation required
+- **Cons:** Larger file size
+
+### Dynamic Uber JAR (Advanced)
+- **Filename:** `tongsuo-openjdk-{version}-dynamic-uber.jar`
+- **Size:** ~1-2 MB
+- **Dependencies:** **Requires Tongsuo installed on your system**
+- **Use when:** You have Tongsuo already installed system-wide
+- **Pros:** Much smaller file size, can use system-optimized libraries
+- **Cons:** Requires system setup
+
+#### Installing Tongsuo (for Dynamic Uber JAR)
+
+**macOS:**
+```bash
+brew install tongsuo
+# Or build from source and install to /usr/local
+```
+
+**Linux:**
+```bash
+# Install to /usr/local/lib
+sudo ldconfig  # Update library cache
+```
+
+**Windows:**
+```bash
+# Add Tongsuo bin/ directory to PATH
+```
+
+**For most users, the static uber JAR is recommended** as it requires no system setup.
+
+## Troubleshooting
+
+### InaccessibleObjectException (Java 9+)
+
+**Error:**
+```
+java.lang.reflect.InaccessibleObjectException: Unable to make java.net.InetAddress$InetAddressHolder java.net.InetAddress.holder() accessible
+```
+
+**Solution:** Add the required JVM parameters:
+```bash
+java --add-opens java.base/java.net=ALL-UNNAMED \
+     --add-opens java.base/sun.security.x509=ALL-UNNAMED \
+     -cp .:tongsuo-openjdk-1.1.0-uber.jar \
+     YourClass
+```
+
+Or use the convenience scripts which handle this automatically.
+
+### UnsatisfiedLinkError (Dynamic Uber JAR only)
+
+**Error:**
+```
+java.lang.UnsatisfiedLinkError: ... libssl.3.dylib ... no such file
+```
+
+**Solution:** Install Tongsuo on your system:
+- **macOS:** `brew install tongsuo`
+- **Linux:** Install to `/usr/local/lib` and run `sudo ldconfig`
+
+Or switch to the static uber JAR which has no external dependencies.
+
+### Compilation Errors
+
+If you encounter compilation errors, try forcing recompilation:
+```bash
+./run-client.sh --force-compile tongsuo-openjdk-1.1.0-uber.jar
+./run-server.sh --force-compile bcprov-jdk15on-1.69.jar tongsuo-openjdk-1.1.0-uber.jar
+```
+
+## Complete Example Session
+
+```bash
+cd examples/jce
+
+# 1. Download dependencies
+wget https://github.com/Tongsuo-Project/tongsuo-java-sdk/releases/download/v1.1.0/tongsuo-openjdk-1.1.0-uber.jar
+wget https://repo1.maven.org/maven2/org/bouncycastle/bcprov-jdk15on/1.69/bcprov-jdk15on-1.69.jar
+
+# 2. Start server in one terminal
+./run-server.sh bcprov-jdk15on-1.69.jar tongsuo-openjdk-1.1.0-uber.jar
+
+# 3. In another terminal, run client
+./run-client.sh tongsuo-openjdk-1.1.0-uber.jar
+```
+
+That's it! The scripts handle everything else automatically. 🎉

examples/jce/TLS13Client.java

@@ -29,7 +29,7 @@
 public class TLS13Client {
     public static void main(String[] args)throws Exception{
         String ip = "127.0.0.1";
-        int port = 443;
+        int port = 8443;
         String ciperSuites = "TLS_SM4_GCM_SM3:TLS_SM4_CCM_SM3";
         String caCert = "chain.crt";
 
@@ -79,28 +79,55 @@ public void checkServerTrusted(X509Certificate[] certs, String authType) throws
         }
 
         BufferedWriter out = new BufferedWriter(new OutputStreamWriter(sslSocket.getOutputStream()));
+        System.out.println("\n━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━");
+        System.out.println("Sending HTTP request to server...");
+        System.out.println("━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━");
         out.write("GET / HTTP/1.0\r\n\r\n");
         out.flush();
 
-        System.out.println("client ssl send msessage success...");
+        System.out.println("Request sent successfully");
 
         BufferedInputStream streamReader = new BufferedInputStream(sslSocket.getInputStream());
         BufferedReader bufferedReader = new BufferedReader(new InputStreamReader(streamReader, "utf-8"));
+
+        System.out.println("\n━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━");
+        System.out.println("Response from server:");
+        System.out.println("━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━");
+
         String line = null;
+        int lineCount = 0;
         while((line = bufferedReader.readLine())!= null){
-            System.out.println("client receive server data:" + line);
+            System.out.println(line);
+            lineCount++;
+        }
+
+        if (lineCount == 0) {
+            System.out.println("⚠️  No data received from server!");
+        } else {
+            System.out.println("\n━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━");
+            System.out.println("✅ Successfully received " + lineCount + " lines from server");
+            System.out.println("━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━");
         }
 
-        while (true) {
-            try {
-                sslSocket.sendUrgentData(0xFF);
-                Thread.sleep(1000L);
-                System.out.println("client waiting server close");
-            } catch (Exception e) {
-                bufferedReader.close();
-                out.close();
-                sslSocket.close();
-            }
+        // Close resources in correct order: writers first, then readers, then socket
+        try {
+            out.close();
+        } catch (Exception e) {
+            // Ignore close errors
+        }
+
+        try {
+            bufferedReader.close();
+        } catch (Exception e) {
+            // Ignore close errors
+        }
+
+        try {
+            sslSocket.close();
+        } catch (Exception e) {
+            // Ignore close errors
         }
+
+        System.out.println("\nConnection closed");
     }
 }

examples/jce/TLS13Server.java

@@ -66,7 +66,7 @@ public static void main(String[] args)throws Exception{
          System.out.println("Server SSL context init success...");
 
         SSLServerSocketFactory socketFactory = sslContext.getServerSocketFactory();
-        SSLServerSocket serverSocket = (SSLServerSocket)socketFactory.createServerSocket(443);
+        SSLServerSocket serverSocket = (SSLServerSocket)socketFactory.createServerSocket(8443);
 
         if(ciperSuites != null && !"".equals(ciperSuites.trim())){
             String[] ciperSuiteArray = ciperSuites.split(":");
@@ -79,24 +79,54 @@ public static void main(String[] args)throws Exception{
 
         while (true){
             SSLSocket sslSocket = (SSLSocket)serverSocket.accept();
+            System.out.println("Client connected from: " + sslSocket.getInetAddress());
 
             try {
                 BufferedReader in = new BufferedReader( new InputStreamReader(sslSocket.getInputStream()) );
                 BufferedWriter out = new BufferedWriter(new OutputStreamWriter(sslSocket.getOutputStream()));
-                String msg = null;
-                char[] cbuf = new char[1024];
-                int len = 0;
-                while((len = in.read(cbuf, 0, 1024)) != -1 ){
-                    msg = new String(cbuf, 0, len);
-                    out.write(msg);
-                    out.flush();
-
-                    if("Bye".equals(msg)) {
-                         break;
+
+                // Read the HTTP request
+                String requestLine = null;
+                StringBuilder request = new StringBuilder();
+                String line;
+                while ((line = in.readLine()) != null) {
+                    if (requestLine == null) {
+                        requestLine = line;
+                    }
+                    request.append(line).append("\n");
+                    // HTTP request ends with an empty line
+                    if (line.isEmpty()) {
+                        break;
                     }
-                    System.out.printf("Received Message --> %s \n", msg);
                 }
+
+                System.out.println("Received request:");
+                System.out.println(request.toString());
+
+                // Send HTTP response
+                String response = "HTTP/1.0 200 OK\r\n" +
+                                "Content-Type: text/html; charset=UTF-8\r\n" +
+                                "Content-Length: 116\r\n" +
+                                "Connection: close\r\n" +
+                                "\r\n" +
+                                "<html>\n" +
+                                "<head><title>Tongsuo TLS 1.3 Server</title></head>\n" +
+                                "<body>\n" +
+                                "<h1>Hello from Tongsuo!</h1>\n" +
+                                "<p>TLS 1.3 with SM cipher suites is working! 🎉</p>\n" +
+                                "</body>\n" +
+                                "</html>\n";
+
+                out.write(response);
+                out.flush();
+                System.out.println("Response sent successfully");
+
+                // Close the connection
+                sslSocket.close();
+                System.out.println("Connection closed\n");
+
             } catch (IOException e){
+                 System.err.println("Error handling client connection:");
                  e.printStackTrace();
             }
         }