Premiers pas

Cette page explique comment configurer le SDK pour iOS. Si vous n'avez pas rempli les conditions préalables, commencez par le faire.

Dépendance

Swift Package Manager

  1. Dans Xcode, installez le package Swift Google-SearchInApps-SDK en accédant à File > Add Packages….

  2. Dans l'invite qui s'affiche, recherchez le dépôt GitHub du package Swift Google-SearchInApps-SDK :

https://github.com/google/search-in-apps.git
  1. Sélectionnez la version du package Swift Google-SearchInApps-SDK que vous souhaitez utiliser. Pour les nouveaux projets, nous vous recommandons d'utiliser l'option Jusqu'à la prochaine version majeure

Une fois que vous avez terminé, Xcode commence à résoudre les dépendances de vos packages et à les télécharger en arrière-plan. Pour en savoir plus sur l'ajout de dépendances de packages, consultez l'article d'Apple.

CocoaPods

Importez le SDK Google-SearchInApps dans un projet iOS à l'aide de CocoaPods. Ouvrez le fichier Podfile de votre projet et ajoutez la ligne suivante à la cible de votre application :

pod 'Google-SearchInApps-SDK'

Ensuite, exécutez la commande suivante à partir de la ligne de commande :

pod install --repo-update

Si vous débutez avec CocoaPods, consultez la documentation officielle pour en savoir plus sur la création et l'utilisation de Podfiles.

Mettre à jour votre fichier Info.plist

Mettez à jour le fichier Info.plist de votre application pour ajouter deux clés :

  1. Une clé GSAAPIKey avec une valeur de chaîne correspondant à votre clé API de SDK (voir ci-dessus).
  2. Une clé GSAClientIdentifier avec une valeur de chaîne correspondant à l'identifiant client de votre application (voir ci-dessus).

Exemple 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

Créez une instance de ContextualSearchRuntime.

Swift

ContextualSearchRuntime

let contextualSearchRuntime = ContextualSearchRuntime()

Objective-C

ContextualSearchRuntime

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

Étape suivante : Fonctionnalités de recherche