Guía de configuración para iOS

En esta página, se muestra cómo configurar tu entorno de desarrollo para usar MediaPipe Tasks en tus aplicaciones para iOS.

Dispositivos y plataformas compatibles

Para crear aplicaciones para iOS con MediaPipe Tasks, tu entorno de desarrollo requiere lo siguiente:

  • macOS Mojave 10.14.3 o versiones posteriores

  • Xcode 10.3 o una versión posterior

  • Dispositivo iOS con al menos iOS 12.0. Por otro lado, un simulador de iOS administrar aplicaciones que no requieren la cámara del dispositivo.

Configuración del entorno de desarrollador

Antes de ejecutar una tarea de MediaPipe en una aplicación para iOS, debes tener un proyecto de Xcode existente o crea uno nuevo en tu máquina local.

Las tareas de MediaPipe solo se pueden instalar con CocoaPods. Debes instalar CocoaPods 1.12.1 o una versión superior para comenzar. Para para instalar CocoaPods en macOS, consulta la instalación de CocoaPods de la guía de YouTube.

Ejemplo de configuración del código

El MediaPipe Ejemplos contiene ejemplos de aplicaciones para iOS destinadas a tareas de MediaPipe.

Puedes crear un proyecto a partir del código de ejemplo, compilarlo y ejecutar la tarea. Los siguientes pasos compilan la clase Text Clasificador tarea.

Para importar y compilar el proyecto de código de ejemplo, haz lo siguiente:

  1. Abre la terminal, clona el repositorio de ejemplos de MediaPipe y navega a el directorio que contiene TextClassifier.xcodeproj y Podfile.

    git clone https://github.com/google-ai-edge/mediapipe-samples
    cd mediapipe/examples/text_classification/ios
    
  2. Instala MediaPipe Tasks con CocoaPods:

    pod install
    

    Con este comando, se crea un archivo TextClassifier.xcworkspace en el ejemplo del proyecto.

  3. Haz doble clic en el archivo TextClassifier.xcworkspace para abrir el proyecto en Xcode. Si el archivo TextClassifier.xcodeproj ya está abierto, ciérralo. antes de abrir el archivo TextClassifier.xcworkspace.

  4. Selecciona el esquema TextClassifier y elige un dispositivo iOS físico. desde la barra de herramientas de la ventana de tu proyecto. Cuando se usa un dispositivo iOS físico asegúrate de que esté conectado a tu Mac.

  5. Haz clic en el botón Run en la barra de herramientas de tu proyecto.

Si necesitas más instrucciones para ejecutar una app en Xcode, consulta Cómo compilar y ejecutar una app. un de la app.

Dependencias de las tareas de MediaPipe

MediaPipe Tasks proporciona dos bibliotecas compiladas previamente para visión y texto. El El archivo de modelo .tflite debe estar ubicado en el paquete de la aplicación para iOS que usa el modelo. Dependiendo de MediaPipe Tas, agrega la visión o el texto a la lista de Pods dentro del Podfile de CocoaPods. Para obtener instrucciones sobre Si creas un Podfile con los Pods necesarios para tu app, consulta Cómo usar CocoaPods.

Tareas de IA generativa

Las bibliotecas de IA generativa de MediaPipe Tasks contienen tareas que controlan imágenes o la generación de texto. Para instalar la biblioteca de IA generativa de MediaPipe Tasks, agrega el Pods de MediaPipeTasksGenAI y MediaPipeTasksGenAIC para el destino de tu app en el Podfile.

API de inferencia de LLM

La tarea de inferencia de MediaPipe LLM se encuentra en MediaPipeTasksGenAI y MediaPipeTasksGenAIC de Pods.

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

Tareas de visión

La biblioteca de visión de MediaPipe Tasks contiene tareas que controlan imágenes o videos de datos. Para instalar la biblioteca de visión de MediaPipe Tasks, agrega el MediaPipeTasksVision para el destino de tu app en Podfile

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

Tareas de texto

La biblioteca de texto de MediaPipe Tasks contiene tareas que manejan datos de idiomas en formato de texto. Para instalar la biblioteca de texto MediaPipe Tasks, agrega el siguiente comando: MediaPipeTasksText Pod para el destino de tu app en Podfile

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

Cómo configurar objetivos de prueba

Si tu app tiene un objetivo de prueba, asegúrate de que tu Podfile cumpla con cualquiera de los siguientes implementaciones para evitar cualquier comportamiento no deseado cuando se usa un Biblioteca de tareas de MediaPipe.

La implementación más simple es asegurarse de que el destino de prueba no esté anidado. dentro del destino principal de la app que agrega el Pod de tareas MediaPipe.

target 'MyAppWithMediaPipeTasks' do
  pod 'MediaPipeTasksVision'
end

target 'MyAppWithMediaPipeTasksTests' do

end

Si el destino de prueba debe estar anidado dentro del destino principal de la app, el Podfile debe cumpla con la siguiente implementación:

target 'MyAppWithMediaPipeTasks' do
  pod 'MediaPipeTasksVision'

    target 'MyAppWithMediaPipeTasksTests' do
      inherit! :none

    end
end

Configuración de BaseOptions

Las BaseOptions permiten la configuración general de las APIs de MediaPipe Task.

Nombre de la opción Descripción Valores aceptados
modelAssetPath La ruta de acceso del modelo a un archivo de modelo en el paquete de aplicación para iOS. Ruta de acceso como una cadena.

Aceleración de hardware

En iOS, MediaPipe Tasks solo admite modelos en ejecución en procesadores de CPU estándar.

Soluciona problemas

Para obtener ayuda con preguntas técnicas relacionadas con MediaPipe, visita la discusión group o Stack Menú ampliado para obtener asistencia de la comunidad. Para informar errores o solicitar funciones, informa un problema en GitHub.

Para obtener ayuda con la configuración de tu entorno de desarrollo de iOS, visita la página de Desarrolladores de Apple Documentación.