Guida alla configurazione per iOS

Questa pagina mostra come configurare l'ambiente di sviluppo per utilizzare MediaPipe Tasks nelle tue applicazioni iOS.

Piattaforme e dispositivi supportati

Per creare applicazioni iOS con MediaPipe Tasks, il tuo ambiente di sviluppo richiede quanto segue:

  • macOS Mojave 10.14.3 o versioni successive.

  • Xcode 10.3 o versioni successive.

  • Dispositivo iOS con almeno iOS 12.0. In alternativa, un simulatore iOS può gestire applicazioni che non richiedono la fotocamera del dispositivo.

di Gemini Advanced.

Configurazione dell'ambiente di sviluppo

Prima di eseguire un'attività MediaPipe su un'applicazione iOS, devi disporre di una un progetto Xcode esistente o creane uno nuovo sulla tua macchina locale.

Le attività di MediaPipe possono essere installate solo utilizzando CocoaPods. È necessario installare CocoaPods 1.12.1 o versione successiva prima di iniziare. Per istruzioni per installare CocoaPods su macOS, consulta l'articolo sull'installazione di CocoaPods .

Esempio di configurazione del codice

MediaPipe Esempi Il repository contiene applicazioni iOS di esempio per le attività MediaPipe.

Puoi creare un progetto dal codice di esempio, generare il progetto ed eseguire dell'attività. I seguenti passaggi creano il testo Categoria di classificazione dell'attività.

Per importare e creare il progetto di codice di esempio:

  1. Apri il terminale, clona il repository di esempi MediaPipe e vai a la directory contenente TextClassifier.xcodeproj e Podfile.

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

  2. Installa Attività di MediaPipe utilizzando CocoaPods:

    pod install

    Questo comando crea un file TextClassifier.xcworkspace nell'esempio della directory di un progetto.

  3. Fai doppio clic sul file TextClassifier.xcworkspace in cui aprire il progetto Xcode. Se il file TextClassifier.xcodeproj è già aperto, chiudilo prima di aprire il file TextClassifier.xcworkspace.

  4. Seleziona lo schema TextClassifier e scegli un dispositivo iOS fisico oppure dalla barra degli strumenti della finestra del progetto. Se utilizzi un dispositivo iOS fisico assicurati che sia connesso al tuo Mac.

  5. Fai clic sul pulsante Run nella barra degli strumenti del progetto.

Per ulteriori istruzioni sull'esecuzione di un'app su Xcode, consulta la sezione Creazione ed esecuzione un Google Cloud.

Dipendenze attività MediaPipe

MediaPipe Tasks fornisce due librerie predefinite per la visione artificiale e il testo. La Il file del modello .tflite deve trovarsi nel bundle dell'applicazione per iOS che lo utilizza. A seconda della tabella di MediaPipe, aggiungi la visione artificiale o il testo all'elenco dei pod all'interno di CocoaPods Podfile. Per istruzioni su creando un Podfile con i pod richiesti per la tua app, consulta Utilizzare CocoaPods.

Attività dell'IA generativa

Le librerie di IA generativa di MediaPipe Tasks contengono attività che gestiscono immagini o la generazione di testo. Per installare la libreria di IA generativa di MediaPipe Tasks, aggiungi il comando MediaPipeTasksGenAI e MediaPipeTasksGenAIC pod alla destinazione dell'app in Podfile.

API di inferenza LLM

L'attività di inferenza dell'LLM MediaPipe è contenuta all'interno di MediaPipeTasksGenAI e MediaPipeTasksGenAIC pod.

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

Attività relative alla vista

La libreria Task Vision di MediaPipe contiene attività che gestiscono immagini o video di input. Per installare la libreria MediaPipe Tasks Vision, aggiungi MediaPipeTasksVision pod al target della tua app in Podfile.

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

Attività di testo

La libreria di testo delle attività di MediaPipe contiene attività che gestiscono i dati della lingua formato di testo. Per installare la libreria di testo Attività di MediaPipe, aggiungi il componente MediaPipeTasksText pod al target della tua app in Podfile

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

Configura target di test

Se la tua app ha una destinazione di test, assicurati che il podfile rispetti una delle due le seguenti implementazioni per evitare comportamenti indesiderati durante l'utilizzo di con la libreria di attività MediaPipe.

L'implementazione più semplice consiste nell'assicurare che la destinazione di test non sia nidificata all'interno del target dell'app principale che aggiunge il pod di attività MediaPipe.

target 'MyAppWithMediaPipeTasks' do
  pod 'MediaPipeTasksVision'
end

target 'MyAppWithMediaPipeTasksTests' do

end

Se la destinazione di test deve essere nidificata all'interno della destinazione dell'app principale, il podfile deve sono conformi alla seguente implementazione:

target 'MyAppWithMediaPipeTasks' do
  pod 'MediaPipeTasksVision'

    target 'MyAppWithMediaPipeTasksTests' do
      inherit! :none

    end
end

Configurazione BaseOptions

BaseOptions consente la configurazione generale delle API MediaPipe Tasks.

Nome opzione Descrizione Valori accettati
modelAssetPath Percorso del modello di un file del modello nel bundle di applicazioni iOS. Percorso come stringa.

Accelerazione hardware

Su iOS, le attività di MediaPipe supportano solo modelli in esecuzione su processori CPU standard.

Risoluzione dei problemi

Per ricevere assistenza in merito a domande tecniche relative a MediaPipe, leggi la Discussione gruppo o Impila Overflow per ricevere assistenza da la comunità. Per segnalare bug o richiedere funzionalità, segnala un problema su GitHub.

Per assistenza nell'impostazione del tuo ambiente di sviluppo iOS, visita Apple Developer Documentazione.