Guida introduttiva

Questa pagina descrive come configurare l'SDK per iOS. Se non hai completato i prerequisiti, fallo prima.

Dipendenza

Swift Package Manager

  1. In Xcode, installa il pacchetto Swift Google-SearchInApps-SDK andando a File > Add Packages... (File > Aggiungi pacchetti).

  2. Nel prompt visualizzato, cerca il repository GitHub del pacchetto Swift 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, ti consigliamo di utilizzare Up to Next Major Version (Fino alla prossima versione principale).

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

CocoaPods

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

pod 'Google-SearchInApps-SDK'

Dopodiché, esegui il comando seguente dalla riga di comando:

pod install --repo-update

Se non hai familiarità con CocoaPods, consulta la documentazione ufficiale per informazioni su come creare e utilizzare i 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 dell'SDK (vedi sopra).
  2. Una chiave GSAClientIdentifier con un valore stringa dell'identificatore client dell'app (vedi sopra).

Esempio di 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>

Avvia

Crea un'istanza di ContextualSearchRuntime

Swift

ContextualSearchRuntime

let contextualSearchRuntime = ContextualSearchRuntime()

Objective-C

ContextualSearchRuntime

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

A seguire: funzionalità di ricerca