Guida introduttiva

Questa pagina descrive come eseguire la configurazione con l'SDK per iOS. Se non hai completato i prerequisiti, completali prima.

Dipendenza

Swift Package Manager

  1. In Xcode, installa il pacchetto Swift Google-SearchInApps-SDK selezionando File > Aggiungi pacchetti….

  2. Nel prompt visualizzato, cerca il repository GitHub del pacchetto Swift Package Google-SearchInApps-SDK:

https://github.com/google/search-in-apps.git
  1. Seleziona la versione del pacchetto Swift Google-SearchInApps-SDK che vuoi utilizzare. Per i nuovi progetti, consigliamo di utilizzare la versione Up to Next Major Version

Al termine, Xcode inizierà a risolvere le dipendenze del pacchetto e a scaricarle in background. Per maggiori dettagli su come aggiungere le dipendenze del pacchetto, consulta l'articolo di Apple.

CocoaPods

Importa l'SDK Google-SearchInApps in un progetto iOS utilizzando CocoaPods. Apri il Podfile del progetto e aggiungi questa riga al target dell'app:

pod 'Google-SearchInApps-SDK'

Quindi, dalla riga di comando, esegui:

pod install --repo-update

Se non hai mai utilizzato CocoaPods, consulta la documentazione ufficiale per informazioni su come creare e utilizzare i file Podfile.

Aggiorna il file Info.plist

Aggiorna il file Info.plist dell'app per aggiungere due chiavi:

  1. Una chiave GSAAPIKey con un valore stringa della chiave API SDK (vedi sopra).
  2. Una chiave GSAClientIdentifier con un valore di stringa dell'identificatore client della tua app (vedi sopra).

Anteprima 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>

Inizializzazione

Crea un'istanza di ContextualSearchRuntime

Swift

ContextualSearchRuntime

let contextualSearchRuntime = ContextualSearchRuntime()

Objective-C

ContextualSearchRuntime

ContextualSearchRuntime *searchRuntime = [[ContextualSearchRuntime alloc] init];

Passaggio successivo: funzionalità di ricerca