Guide de configuration pour iOS

Cette page explique comment configurer votre environnement de développement pour utiliser MediaPipe Tasks dans vos applications iOS.

Appareils et plates-formes compatibles

Pour créer des applications iOS avec MediaPipe Tasks, votre environnement de développement nécessite les éléments suivants:

  • macOS Mojave 10.14.3 ou version ultérieure.

  • Xcode 10.3 ou version ultérieure.

  • Un appareil iOS équipé d'iOS 12.0 ou version ultérieure Un simulateur iOS peut également gérer les applications qui ne nécessitent pas l'appareil photo de l'appareil.

Configuration de l'environnement de développement

Avant d'exécuter une tâche MediaPipe sur une application iOS, vous devez disposer d'un projet Xcode ou en créer un sur votre ordinateur local.

MediaPipe Tasks ne peut être installé qu'à l'aide de CocoaPods. Vous devez installer CocoaPods 1.12.1 ou une version ultérieure avant de commencer. Pour savoir comment installer CocoaPods sous macOS, consultez le guide d'installation de CocoaPods.

Exemple de configuration de code

Le dépôt MediaPipe Exemples contient des exemples d'applications iOS pour les tâches MediaPipe.

Vous pouvez créer un projet à partir de l'exemple de code, puis exécuter la tâche. Les étapes suivantes compilent la tâche Classificateur de texte.

Pour importer et créer l'exemple de projet de code, procédez comme suit:

  1. Ouvrez le terminal, clonez le dépôt d'exemples MediaPipe, puis accédez au répertoire contenant TextClassifier.xcodeproj et Podfile.

    git clone https://github.com/google-ai-edge/mediapipe-samples
    cd mediapipe/examples/text_classification/ios
    
  2. Installez MediaPipe Tasks à l'aide de CocoaPods:

    pod install
    

    Cette commande crée un fichier TextClassifier.xcworkspace dans le répertoire de l'exemple de projet.

  3. Double-cliquez sur le fichier TextClassifier.xcworkspace pour ouvrir le projet dans Xcode. Si le fichier TextClassifier.xcodeproj est déjà ouvert, fermez-le avant d'ouvrir le fichier TextClassifier.xcworkspace.

  4. Sélectionnez le schéma TextClassifier, puis choisissez un appareil iOS physique ou un simulateur dans la barre d'outils de la fenêtre de votre projet. Si vous utilisez un appareil iOS physique, assurez-vous qu'il est connecté à votre Mac.

  5. Cliquez sur le bouton Run dans la barre d'outils de votre projet.

Pour en savoir plus sur l'exécution d'une application sur Xcode, consultez la page Compiler et exécuter une application.

Dépendances MediaPipe Tasks

MediaPipe Tasks fournit deux bibliothèques prédéfinies pour la vision et le texte. Le fichier de modèle .tflite doit se trouver dans le bundle de l'application iOS qui utilise le modèle. En fonction de l'application MediaPipe Tas, ajoutez la bibliothèque de vision ou de texte à la liste des pods dans le Podfile de CocoaPods. Pour obtenir des instructions sur la création d'un Podfile avec les pods requis pour votre application, consultez la section Utiliser CocoaPods.

Tâches d'IA générative

Les bibliothèques d'IA générative de MediaPipe Tasks contiennent des tâches qui gèrent la génération d'images ou de texte. Pour installer la bibliothèque d'IA générative de tâches MediaPipe, ajoutez les pods MediaPipeTasksGenAI et MediaPipeTasksGenAIC à la cible de votre application dans Podfile.

API LLM Inference

La tâche d'inférence LLM MediaPipe est contenue dans les pods MediaPipeTasksGenAI et MediaPipeTasksGenAIC.

target 'MyLlmInferenceApp' do
  use_frameworks!
  pod 'MediaPipeTasksGenAI'
  pod 'MediaPipeTasksGenAIC'
end

Tâches visuelles

La bibliothèque de vision MediaPipe Tasks contient des tâches qui traitent des entrées d'image ou de vidéo. Pour installer la bibliothèque de vision MediaPipe Tasks, ajoutez le pod MediaPipeTasksVision à la cible de votre application dans Podfile.

target 'MyAppWithMediaPipeTasksVision' do
  use_frameworks!
  pod 'MediaPipeTasksVision'
end

Tâches liées au texte

La bibliothèque de texte MediaPipe Tasks contient des tâches qui traitent les données de langue au format texte. Pour installer la bibliothèque de texte MediaPipe Tasks, ajoutez le pod MediaPipeTasksText à la cible de votre application dans Podfile

target 'MyAppWithMediaPipeTasksText' do
  use_frameworks!
  pod 'MediaPipeTasksText'
end

Configurer les cibles de test

Si votre application a une cible de test, assurez-vous que votre Podfile respecte l'une des implémentations suivantes pour éviter tout comportement indésirable lors de l'utilisation d'une bibliothèque de tâches MediaPipe.

La mise en œuvre la plus simple consiste à s'assurer que la cible de test n'est pas imbriquée dans la cible principale de l'application qui ajoute le pod de tâches MediaPipe.

target 'MyAppWithMediaPipeTasks' do
  pod 'MediaPipeTasksVision'
end

target 'MyAppWithMediaPipeTasksTests' do

end

Si la cible de test doit être imbriquée dans la cible principale de l'application, le fichier Podfile doit être conforme à l'implémentation suivante:

target 'MyAppWithMediaPipeTasks' do
  pod 'MediaPipeTasksVision'

    target 'MyAppWithMediaPipeTasksTests' do
      inherit! :none

    end
end

Configuration de BaseOptions

BaseOptions permet la configuration générale des API MediaPipe Task.

Nom de l'option Description Valeurs acceptées
modelAssetPath Chemin d'accès du modèle à un fichier de modèle du bundle d'applications iOS. Chemin d'accès sous forme de chaîne.

Accélération matérielle

Sur iOS, MediaPipe Tasks n'est compatible qu'avec l'exécution de modèles sur des processeurs de processeur standards.

Dépannage

Pour obtenir de l'aide concernant des questions techniques concernant MediaPipe, consultez le groupe de discussion ou Stack Overflow afin d'obtenir l'aide de la communauté. Pour signaler des bugs ou demander des fonctionnalités, signalez un problème sur GitHub.

Si vous avez besoin d'aide pour configurer votre environnement de développement iOS, consultez la documentation Apple Developer.