本文介紹通過Swift Package接入ZOLOZ iOS SDK的完整流程。

概述

Swift Package版SDK與CocoaPods版SDK的核心功能相同，在整合方式和依賴管理上略有差異。

Swift Package版SDK採用XCFramework格式，支援在Apple晶片模擬器上編譯和運行。

前提條件

在接入ZOLOZ iOS SDK之前，請確保您使用的開發工具為Xcode 15.0及以上版本。

接入步驟

步驟1：添加包依賴

在Xcode中，選擇File > Add Package Dependencies...。
在彈窗右上方的搜尋方塊中輸入倉庫地址，地址為https://github.com/zoloz-pte-ltd/zoloz-demo-ios。
在Dependency Rule地區中選擇Branch，並輸入分支名稱master，然後單擊Add Package。
選擇需要引入的Package Products，設定完成後單擊Add Package。
- 非特殊定製版SDK客戶，請將ZolozKitWithoutWebContainer設定為None。
- 如果您不需要使用NFC功能，請將ZolozKitNfcReader設定為None。

步驟2：檢查SDK引用結果

SDK引用成功後，在您的專案的Package Dependencies中會顯示zolozkit。

驗證接入結果

接入完成後，您可以通過以下兩項測實驗證SDK是否接入成功。

檢查Metainfo擷取結果

在您的專案中運行以下代碼擷取Metainfo，如果成功顯示Metainfo資訊，表示SDK接入成功。

let metainfo = ZLZFacade.getMetaInfo();
print(metainfo)

以下是完整的Metainfo樣本：

{
    "appVersion": "1", 
    "bioMetaInfo": "3.46.0:0,2;RJBBACRJIIFQGQDKRIJ4BNJADJJB;2.1.2.260114104408", 
    "appName": "com.zoloz.flamingo", 
    "deviceType": "ios", 
    "osVersion": "iOS 26.1", 
    "keyHash": "5EBCF1", 
    "buildVersion": "2.1.2.260114104408", 
    "apdidToken": "ZLZDD82FDC4D7014D46BFCF0541ED50****", 
    "deviceModel": "iPhone13,3"}

檢查資源檔引入結果

在您的專案中運行以下代碼，檢查ZOLOZ所需的資源檔是否引入成功。

let url = Bundle.main.url(forResource: "zolozkit_resources", withExtension: "bundle")
if let bundleURL = url, let bundle = Bundle(url: bundleURL) {
    let files = try! FileManager.default.contentsOfDirectory(atPath: bundle.resourcePath!)
    let msg = files.joined(separator: ", ")
    print(msg)
    let alert = UIAlertController(title: "Zoloz Bundles", message: msg, preferredStyle: .alert)
    alert.addAction(UIAlertAction(title: "OK", style: .default))
    self.present(alert, animated: true)
} else {
    let alert = UIAlertController(title: "Error", message: "zolozkit_resources.bundle not found", preferredStyle: .alert)
    alert.addAction(UIAlertAction(title: "CLOSE", style: .default))
    self.present(alert, animated: true)
}

如果能夠正確顯示以下檔案，表示SDK及其資源檔已接入成功。

WebContainerLite.bundle, ZolozNfcReader.bundle, ToygerService.bundle, Info.plist, BioAuthEngine.bundle, ZolozKit.bundle