Premiers pas

Cette page explique comment configurer le SDK iOS. Si vous n'avez pas rempli les conditions préalables, faites-le d'abord.

Dépendance

Swift Package Manager

  1. Dans Xcode, installez le package Swift Google-SearchInApps-SDK en accédant à File > Add Packages... (Fichier > Ajouter des 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 Up to Next Major Version (Jusqu'à la prochaine version majeure).

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

CocoaPods

Importez le SDK Google-SearchInApps-SDK dans un projet iOS à l'aide de CocoaPods. Ouvrez le fichier Podfile de votre projet et ajoutez cette ligne à 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 ne connaissez pas CocoaPods, consultez leur documentation officielle pour savoir comment créer et utiliser des fichiers Podfile.

Mettez à 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 du 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 de fichier 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>

Initialiser

Créez une instance de ContextualSearchRuntime

Swift

ContextualSearchRuntime

let contextualSearchRuntime = ContextualSearchRuntime()

Objective-C

ContextualSearchRuntime

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

À suivre : Fonctionnalités de recherche