深色模式

開始使用

安裝 SDK

SDK 以檔案交付，不經公開 registry；收到的 zip 內附整合說明 INTEGRATION.md。

交付內容

平台
交付檔
解壓後內容
iOS
LapidSDK-iOS-<版本>.zip
Package.swift 與 LapidSDK.xcframework
Android
LapidSDK-Android-<版本>.zip
maven/，內含 com/rytass/lapid/ 下三個函式庫（AAR、POM、sources）

zip 內的 SHA256SUMS 可核對檔案是否完整：

bash
shasum -a 256 -c SHA256SUMS

加入套件

  1. 解壓 zip，把資料夾放進專案旁邊，例如 Libs/LapidSDK-iOS-0.1.0/。
  2. Xcode 選 File、Add Package Dependencies、Add Local，選該資料夾，並把產品 LapidSDK 加入 App target。
  3. 最低支援 iOS 15。套件不含 macOS slice。

Package.swift 的 .binaryTarget(path:) 只能用於本地套件，不能以遠端 git URL 引用。

  1. 解壓 zip，把 maven/ 放到專案的 libs/ 下，得到 libs/maven/。
  2. 在 settings.gradle.kts 加入本機 repo。
settings.gradle.kts
dependencyResolutionManagement {
    repositories {
        maven { url = uri("libs/maven") }
        google()
        mavenCentral()
    }
}
  1. 在 app/build.gradle.kts 依需要加入模組。
app/build.gradle.kts
dependencies {
    implementation("com.rytass.lapid:lapid-sdk:0.1.0")
    implementation("com.rytass.lapid:lapid-sdk-compose:0.1.0")        // 選用：Compose 元件
    implementation("com.rytass.lapid:lapid-sdk-playintegrity:0.1.0")  // 選用：Play Integrity 證明
}

依賴（coroutines、kotlinx-serialization、core-ktx 等）由 POM 自動解析。最低支援 Android 7.0（minSdk 24）。Kotlin 版本請與 SDK 相同（2.4.21），避免 metadata 不相容。Release 建置開啟 R8 時，SDK 內建的 consumer rules 會自動套用。

Web SDK 為 @lapid/sdk-core，需要 Node 24，或支援 fetch 與 crypto.subtle 的瀏覽器，沒有第三方依賴。

待確認：Web SDK 的發佈管道。目前為私有套件，尚未公開發佈。

Web SDK 不做裝置驗證，也沒有代號解析、session、快取與重試，適合搭配自己的後端使用。

下一步