Einrichtungsleitfaden für iOS

Auf dieser Seite erfahren Sie, wie Sie Ihre Entwicklungsumgebung für die Verwendung von MediaPipe einrichten. Tasks in Ihren iOS-Apps.

Unterstützte Geräte und Plattformen

Zum Erstellen von iOS-Anwendungen mit MediaPipe Tasks, Ihrer Entwicklungsumgebung erfordert Folgendes:

  • macOS Mojave 10.14.3 oder höher.

  • Xcode 10.3 oder höher

  • iOS-Gerät mit iOS 12.0 oder höher Alternativ kann ein iOS-Simulator Anwendungen zu steuern, für die die Kamera des Geräts nicht erforderlich ist.

Einrichtung der Entwicklerumgebung

Bevor Sie eine MediaPipe-Aufgabe in einer iOS-App ausführen, benötigen Sie vorhandenen Xcode-Projekt zu erstellen oder ein neues Projekt auf Ihrem lokalen Computer zu erstellen.

MediaPipe Tasks kann nur mit CocoaPods installiert werden. Sie müssen zuerst CocoaPods 1.12.1 oder höher installieren. Für Anleitung zur Installation von CocoaPods unter macOS finden Sie im Hilfeartikel CocoaPods-Installation .

Beispielcode-Einrichtung

Die MediaPipe Beispiele Repository enthält iOS-Beispielanwendungen für MediaPipe-Aufgaben.

Sie können ein Projekt aus dem Beispielcode erstellen, das Projekt erstellen und den . Mit den folgenden Schritten wird der Text Klassifikator .

So importieren und erstellen Sie das Beispielcodeprojekt:

  1. Öffnen Sie das Terminal, klonen Sie das MediaPipe-Beispiel-Repository und wechseln Sie zu dem Verzeichnis, das TextClassifier.xcodeproj und Podfile enthält.

    git clone https://github.com/google-ai-edge/mediapipe-samples
cd mediapipe/examples/text_classification/ios

  2. MediaPipe Tasks mit CocoaPods installieren:

    pod install

    Mit diesem Befehl wird im Beispiel eine TextClassifier.xcworkspace-Datei erstellt. Projektverzeichnis.

  3. Doppelklicken Sie auf die Datei TextClassifier.xcworkspace, um das Projekt darin zu öffnen. Xcode. Wenn die Datei TextClassifier.xcodeproj bereits geöffnet ist, schließen Sie sie bevor Sie die Datei TextClassifier.xcworkspace öffnen.

  4. Wähle das Schema TextClassifier und dann ein physisches iOS-Gerät oder in der Symbolleiste des Projektfensters aus. Bei Verwendung eines physischen iOS-Geräts muss es mit Ihrem Mac verbunden sein.

  5. Klicken Sie in der Symbolleiste Ihres Projekts auf die Schaltfläche Run.

Weitere Informationen zum Ausführen einer App in Xcode finden Sie unter Erstellen und Ausführen eine App.

MediaPipe Tasks-Abhängigkeiten

MediaPipe Tasks bietet zwei vordefinierte Bibliotheken für Vision und Text. Die Die Modelldatei .tflite muss sich in dem Bundle der iOS-App befinden, das verwendet das Modell. Fügen Sie je nach MediaPipe Tas entweder die Vision oder den Text hinzu zur Liste der Pods in den Podfile von CocoaPods hinzu. Anweisungen zur Erstellen eines Podfile mit den erforderlichen Pods für Ihre Anwendung. Weitere Informationen finden Sie unter Verwendung von CocoaPods

<ph type="x-smartling-placeholder">

Aufgaben mit generativer KI

Die Bibliotheken für Generative AI von MediaPipe Tasks enthalten Aufgaben, die Bilder oder Textgenerierung. Fügen Sie zum Installieren der generativen KI-Bibliothek von MediaPipe Tasks den MediaPipeTasksGenAI und MediaPipeTasksGenAIC Pods zum Ziel Ihrer Anwendung in Podfile.

LLM Inference API

Die MediaPipe-LLM-Inferenzaufgabe ist im MediaPipeTasksGenAI enthalten und MediaPipeTasksGenAIC Pods.

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

Vision-Aufgaben

Die Vision-Bibliothek von MediaPipe Tasks enthält Aufgaben zum Verarbeiten von Bildern oder Videos. Eingaben. Um die Vision-Bibliothek von MediaPipe Tasks zu installieren, fügen Sie den MediaPipeTasksVision zum Ziel Ihrer App in Podfile.

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

Textaufgaben

Die MediaPipe Tasks-Textbibliothek enthält Aufgaben, die Sprachdaten in Textformat. Um die MediaPipe Tasks-Textbibliothek zu installieren, fügen Sie den MediaPipeTasksText zum Ziel Ihrer App in Podfile

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

Testziele konfigurieren

Wenn Ihre Anwendung ein Testziel hat, achten Sie darauf, dass Ihre Podfile-Datei einer der Implementierungen befolgen, um unerwünschtes Verhalten bei der Verwendung eines MediaPipe-Aufgabenbibliothek

Die einfachste Implementierung besteht darin, sicherzustellen, dass das Testziel nicht verschachtelt ist. im Haupt-App-Ziel, das den MediaPipe-Aufgaben-Pod hinzufügt.

target 'MyAppWithMediaPipeTasks' do
  pod 'MediaPipeTasksVision'
end

target 'MyAppWithMediaPipeTasksTests' do

end

Wenn das Testziel im Hauptziel der Anwendung verschachtelt sein muss, muss die Podfile-Datei der folgenden Implementierung entsprechen:

target 'MyAppWithMediaPipeTasks' do
  pod 'MediaPipeTasksVision'

    target 'MyAppWithMediaPipeTasksTests' do
      inherit! :none

    end
end

BaseOptions-Konfiguration

BaseOptions ermöglichen die allgemeine Konfiguration von MediaPipe Task APIs.

Optionsname Beschreibung Gültige Werte
modelAssetPath Der Modellpfad zu einer Modelldatei im iOS-App-Bundle. Pfad als String.

Hardwarebeschleunigung

Unter iOS unterstützt MediaPipe Tasks nur die Ausführung von Modellen auf Standard-CPU-Prozessoren.

Fehlerbehebung

Hilfe bei technischen Fragen zu MediaPipe erhalten Sie in der Gruppe oder Stack Überlauf für Support von Community. Wenn Sie Fehler melden oder Funktionsanfragen stellen möchten, melden Sie ein Problem auf GitHub

Hilfe bei der Einrichtung Ihrer iOS-Entwicklungsumgebung erhalten Sie auf der Apple Developer-Website Dokumentation.