Privchat SDK Android

Android 平台的 Privchat SDK，基于 privchat-ffi UniFFI 绑定。

产物：AAR（Kotlin wrapper + Rust .so 打包，详见 ARTIFACT_CONTRACT）

前置要求

• JDK 17+
• Android SDK (compileSdk 34)
• Rust + cargo-ndk: cargo install cargo-ndk
• NDK: 需已通过 Android Studio 或 sdkmanager 安装

构建

# 确保 privchat-ffi 已构建
cd ../privchat-sdk
cargo build -p privchat-ffi --release

# 构建 Android 库
cd ../privchat-sdk-android
./gradlew :privchat:assembleRelease

使用

import io.privchat.sdk.android.PrivchatClient
import io.privchat.ffi.PrivchatConfigBuilder
import io.privchat.ffi.ServerEndpoint
import io.privchat.ffi.TransportProtocol

val builder = PrivchatConfigBuilder()
    .dataDir(context.filesDir.resolve("privchat").absolutePath)
    .assetsDir("/path/to/privchat-sdk/assets")
    .serverEndpoint(ServerEndpoint(
        protocol = TransportProtocol.WebSocket,
        host = "127.0.0.1",
        port = 8081u,
        path = "/",
        useTls = false
    ))

val client = PrivchatClient.create(builder).getOrThrow()
client.connect()
client.runBootstrapSync()

Sample

./gradlew :sample:installDebug

详见 sample/README.md。功能最小集：connect • bootstrap sync • list sessions • send text • send image • upload progress • retry • reconnect

API 契约

遵循 SDK_API_CONTRACT。