本頁說明如何設定 iOS SDK。如果您尚未完成前置作業,請先完成這些作業。
依附元件
Swift Package Manager
在 Xcode 中,依序點選「File」>「Add Packages...」(新增 Package),安裝 Google-SearchInApps-SDK Swift Package。
在隨即顯示的提示中,搜尋 Google-SearchInApps-SDK Swift 套件 GitHub 存放區:
https://github.com/google/search-in-apps.git
- 選取要使用的 Google-SearchInApps-SDK Swift 套件版本。對於新專案,建議您使用「升級至下一個主要版本」
完成後,Xcode 就會開始解析套件依附元件,並在背景下載這些依附元件。如要進一步瞭解如何新增套件依附元件,請參閱 Apple 的文章。
CocoaPods
使用 CocoaPods 將 Google-SearchInApps-SDK 匯入 iOS 專案。開啟專案的 Podfile,並將這一行新增至應用程式目標:
pod 'Google-SearchInApps-SDK'
然後在指令列中執行:
pod install --repo-update
如果您是第一次使用 CocoaPods,請參閱其官方說明文件,瞭解如何建立及使用 Podfiles。
更新 Info.plist
更新應用程式的 Info.plist
檔案,新增兩個鍵:
GSAAPIKey
鍵,其中包含 SDK API 金鑰的字串值 (請參閱上方說明)。GSAClientIdentifier
鍵,其中包含應用程式用戶端 ID 的字串值 (請參閱上方說明)。
Info.plist
範例
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0">
<dict>
<key>GSAAPIKey</key>
<string>ABC123...xyz890</string>
<key>GSAClientIdentifier</key>
<string>ms-demo-app-sia</string>
...
</dict>
</plist>
Init
建立 ContextualSearchRuntime
的執行個體
Swift
let contextualSearchRuntime = ContextualSearchRuntime()
Objective-C
ContextualSearchRuntime *searchRuntime = [[ContextualSearchRuntime alloc] init];