SocketIO client implementation enables asynchronous socket creation, streamlined thread safety, and simplified binary message handling. Offers logging integration and example usage across multiple platforms.
KMP (pure Kotlin) implementation of SocketIO client.
| Platform | 🛠Builds🛠 + 🔬Tests🔬 |
|---|---|
JVM 17 | 🚀 |
JS (Chrome, Node) | 🚀 |
WasmJS (Chrome, Node) | 🚀 |
Android | 🚀 |
iOS | 🚀 |
macOS | 🚀 |
Windows X64 | 🚀 |
Linux X64 | 🚀 |
You only need to add gradle dependency:
// add common source set dependency
kotlin {
sourceSets {
val commonMain by getting {
dependencies {
implementation("com.piasy:kmp-socketio:$version")
}
}
}
}
val opt = IO.Options()
// opt.trustAllCerts = true
// opt.httpClient = yourSharedHttpClient
IO.socket("http://localhost:3000", opt) { socket ->
socket.on(Socket.EVENT_CONNECT) { args ->
println("on connect ${args.joinToString()}")
val bin = UnsafeByteStringOperations.wrapUnsafe(byteArrayOf(0x1, , , ))
socket.emit(, , , bin, GMTDate())
}.on() { args ->
println()
}
socket.()
}
If you set opt.httpClient, kmp-socketio will reuse this externally managed Ktor HttpClient
for both polling and websocket transports.
When websocket transport is enabled, make sure your shared client installs the Ktor WebSockets plugin.
Most of the APIs are the same as socket.io-client-java, here are some differences:
emit only accepts String/Boolean/Number/JsonElement/ByteString, other types will be converted to String using toString(), so there is no way to put ByteString in JsonElement.You can open this project in Android Studio, but please setup iOS example project first:
brew install cocoapods xcodegen
# if you have installed them earlier, you need to remove them at first,
# or run brew link --overwrite xcodegen cocoapods
cd example/iosApp
xcodegen
pod install
Otherwise you may see error like below:
> Task :example:shared:podInstall FAILED
FAILURE: Build failed with an exception.
* What went wrong:
Execution failed for task ':example:shared:podInstall'.
> 'pod install' command failed with code 1.
Error message:
Please, check that podfile contains following lines in header:
source 'https://cdn.cocoapods.org'
Please, check that each target depended on shared contains following dependencies:
To check coverage details, run ./gradlew :kmp-socketio:jvmTest --info && ./gradlew koverHtmlReport,
then check kmp-socketio/build/reports/kover/html/index.html.
Before running examples, run node kmp-socketio/src/jvmTest/resources/socket-server.js to start the socket-io echo server,
and update the local IP address in example/shared/src/commonMain/kotlin/com/piasy/kmp/socketio/example/Greeting.kt.
Open the project (the repo root dir) in Android studio, and run the example.androidApp target.
cd example/iosApp
pod install
# open iosApp.xcworkspace in Xcode, and run it.
Use Chrome CORS Unblock extension to workaround with CORS error.
./gradlew :example:shared:jsBrowserDevelopmentRun
Use Chrome CORS Unblock extension to workaround with CORS error.
./gradlew :example:shared:wasmJsBrowserDevelopmentRun
.\gradlew runKmp_socketioDebugExecutableMingwX64
./gradlew runKmp_socketioDebugExecutableLinuxX64
./gradlew runKmp_socketioDebugExecutableMacosX64
Maven central portal credentials and signing configs are set in ~/.gradle/gradle.properties.
# on Linux: need manual release on website
./gradlew clean publishLinuxX64PublicationToMavenCentralRepository --no-configuration-cache
# on Windows: need manual release on website
.\gradlew clean publishMingwX64PublicationToMavenCentralRepository --no-configuration-cache
# on macOS: need manual release on website
./gradlew clean \
publishKotlinMultiplatformPublicationToMavenCentralRepository \
publishAndroidReleasePublicationToMavenCentralRepository \
publishJvmPublicationToMavenCentralRepository \
publishIosArm64PublicationToMavenCentralRepository \
publishIosSimulatorArm64PublicationToMavenCentralRepository \
publishIosX64PublicationToMavenCentralRepository \
publishMacosArm64PublicationToMavenCentralRepository \
publishMacosX64PublicationToMavenCentralRepository \
publishJsPublicationToMavenCentralRepository \
publishWasmJsPublicationToMavenCentralRepository \
--no-configuration-cache
Login to https://central.sonatype.com/publishing/deployments, and release them manually.
Surfaced from shared tags and platforms — no rankings paid for.