Web Analytics

kotbase

⭐ 113 stars Korean by jeffdgr8

Maven Central Kotlin GitHub License Couchbase Community Slack Channel

Kotbase

Kotlin 멀티플랫폼 라이브러리로 Couchbase Lite 지원

소개

Kotbase는 Kotlin Multiplatform과 임베디드 NoSQL JSON 문서 데이터베이스인 Couchbase Lite를 결합합니다. Couchbase Lite는 독립 실행형 클라이언트 데이터베이스로 사용하거나 Couchbase Server 및 Sync Gateway 또는 Capella App Services와 함께 클라우드에서 엣지로 데이터 동기화를 위해 사용할 수 있습니다. 주요 기능은 다음과 같습니다:

Kotbase는 Android 및 JVM(Java SDK를 통해), 네이티브 iOS 및 macOS(Objective-C SDK를 통해), 그리고 실험적 네이티브 Linux 및 Windows 지원(C SDK를 통해)에 대해 완전한 엔터프라이즈 및 커뮤니티 에디션 API 지원을 제공합니다.

설치

공유 모듈의 build.gradle.kts 파일 내 commonMain 소스셋 의존성에 커뮤니티 또는 엔터프라이즈 에디션 의존성을 추가하세요:

kotlin {
    sourceSets {
        commonMain.dependencies {
            // Community Edition
            implementation("dev.kotbase:couchbase-lite:3.2.4-1.2.0")
            // or Enterprise Edition
            implementation("dev.kotbase:couchbase-lite-ee:3.2.4-1.2.0")
        }
    }
}
참고
Couchbase Lite 커뮤니티 에디션은 무료이며 오픈 소스입니다. 엔터프라이즈 에디션은 개발 및 테스트 용도로는 무료이지만,
프로덕션 사용을 위해서는 Couchbase의 라이선스가 필요합니다.
커뮤니티 에디션과 엔터프라이즈 에디션 비교 보기.

Kotbase는 Maven Central에 게시되어 있습니다. Couchbase Lite 엔터프라이즈 에디션 의존성은 추가로 Couchbase Maven 저장소가 필요합니다.

repositories {
    mavenCentral()
    maven("https://mobile.maven.couchbase.com/maven2/dev/")
}

네이티브 플랫폼

네이티브 플랫폼 대상은 Couchbase Lite 종속성 네이티브 바이너리도 추가로 링크해야 합니다. 자세한 내용은 지원 플랫폼을 참조하세요.

리눅스

리눅스에서 실행되는 JVM 또는 네이티브 리눅스를 대상으로 할 때는 libicu 종속성의 특정 버전이 필요합니다. (예상 버전을 나타내는 libLiteCore.so: libicuuc.so.71: cannot open shared object file: No such file or directory와 같은 오류가 표시될 수 있습니다.) 필요한 버전이 배포판의 패키지 관리자에서 제공되지 않는 경우 GitHub에서 다운로드할 수 있습니다.

문서

Kotbase 문서는 kotbase.dev에서 확인할 수 있으며, 시작하기 예제, 사용 가이드, 및 API 참조가 포함되어 있습니다.

Java SDK와의 차이점

Kotbase의 API는 Couchbase Lite Java 및 Android KTX SDK와 일치합니다. 기존 Kotlin 코드를 마이그레이션하는 것은 com.couchbase.lite에서 kotbase로 import 패키지를 변경하는 것만큼 간단할 수 있으나 일부 예외가 있습니다:

Original README: View on GitHub

Translated by OpenAiTx | Last updated: 2026-01-20