Guia de configuração para iOS

Esta página mostra como configurar seu ambiente de desenvolvimento para usar o MediaPipe Google Tarefas nos seus aplicativos iOS.

Dispositivos e plataformas compatíveis

Para criar aplicativos iOS com o MediaPipe Tasks, seu ambiente de desenvolvimento requer o seguinte:

  • macOS Mojave 10.14.3 ou mais recente.

  • Xcode 10.3 ou mais recente.

  • dispositivo iOS com o iOS 12.0 ou mais recente; Como alternativa, um simulador para iOS pode processar aplicativos que não precisem da câmera do dispositivo.

.

Configuração do ambiente do desenvolvedor

Antes de executar uma tarefa MediaPipe em um aplicativo iOS, você precisa ter um projeto Xcode ou crie um novo em sua máquina local.

O MediaPipe Tasks só pode ser instalado usando o CocoaPods. Você precisa instalar o CocoaPods 1.12.1 ou uma versão mais recente antes de começar. Para instruções para instalar o CocoaPods no macOS, consulte esta página de instalação guia.

Exemplo de configuração de código

O MediaPipe Exemplos contém exemplos de aplicativos iOS para tarefas do MediaPipe.

É possível criar um projeto a partir do código de exemplo, compilar o projeto e executar a tarefa. As etapas a seguir criam a configuração Classificador tarefa.

Para importar e criar o projeto de código de exemplo:

  1. Abra o terminal, clone o repositório de exemplos do MediaPipe e acesse o diretório que contém o TextClassifier.xcodeproj e o Podfile.

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

  2. Instale o MediaPipe Tasks usando o CocoaPods:

    pod install

    Esse comando cria um arquivo TextClassifier.xcworkspace no exemplo do projeto.

  3. Clique duas vezes no arquivo TextClassifier.xcworkspace para abrir o projeto em Xcode. Se o arquivo TextClassifier.xcodeproj já estiver aberto, feche-o. antes de abrir o arquivo TextClassifier.xcworkspace.

  4. Selecione o esquema TextClassifier e escolha um dispositivo físico com iOS ou na barra de ferramentas da janela do projeto. Ao usar um dispositivo iOS físico verifique se ele está conectado ao Mac.

  5. Clique no botão Run, na barra de ferramentas do projeto.

Para mais instruções sobre como executar um aplicativo no Xcode, consulte Como criar e executar um app.

Dependências do MediaPipe Tasks

O MediaPipe Tasks fornece duas bibliotecas pré-criadas para visão e texto. A O arquivo modelo .tflite precisa estar localizado no pacote do aplicativo iOS que usa o modelo. Dependendo do MediaPipe Tas, adicione a visão ou o texto à lista de pods na Podfile do CocoaPods. Para instruções sobre criar um Podfile com os pods necessários para seu aplicativo, consulte Como usar CocoaPods.

Tarefas da IA generativa

As bibliotecas de IA generativa do MediaPipe Tasks contêm tarefas que processam imagens ou geração de textos. Para instalar a biblioteca de IA generativa do MediaPipe Tasks, adicione o MediaPipeTasksGenAI e MediaPipeTasksGenAIC pods ao destino do app em o Podfile.

API LLM Inference

A tarefa de inferência de LLMs do MediaPipe está contida no MediaPipeTasksGenAI e MediaPipeTasksGenAIC de pods.

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

Tarefas de visão

A biblioteca de visão do MediaPipe Tasks contém tarefas que lidam com imagens ou vídeos de entrada. Para instalar a biblioteca de visão do MediaPipe Tasks, adicione o MediaPipeTasksVision ao destino do app em Podfile.

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

Tarefas de texto

A biblioteca de texto MediaPipe Tasks contém tarefas que lidam com dados de idioma no em um formato de texto simples. Para instalar a biblioteca de texto do MediaPipe Tasks, adicione o MediaPipeTasksText ao destino do app em Podfile

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

Configurar destinos de teste

Se o app tiver um destino de teste, verifique se o Podfile está em conformidade com uma das as seguintes implementações para evitar qualquer comportamento indesejável ao usar uma Biblioteca de tarefas do MediaPipe.

A implementação mais simples é garantir que o destino do teste não esteja aninhado. no destino principal do app que adiciona o pod de tarefas do MediaPipe.

target 'MyAppWithMediaPipeTasks' do
  pod 'MediaPipeTasksVision'
end

target 'MyAppWithMediaPipeTasksTests' do

end

Se o destino do teste precisar estar aninhado no destino do app principal, o Podfile precisará estão com a seguinte implementação:

target 'MyAppWithMediaPipeTasks' do
  pod 'MediaPipeTasksVision'

    target 'MyAppWithMediaPipeTasksTests' do
      inherit! :none

    end
end

Configuração BaseOptions

A BaseOptions permite a configuração geral das APIs MediaPipe Task.

Nome da opção Descrição Valores aceitos
modelAssetPath O caminho do modelo para um arquivo modelo no pacote de aplicativos para iOS. Caminho como uma string.

Aceleração de hardware

No iOS, o MediaPipe Tasks só é compatível com a execução de modelos em processadores de CPU padrão.

Solução de problemas

Para obter ajuda com questões técnicas relacionadas ao MediaPipe, visite a discussão group ou Stack Overflow (em inglês) para receber suporte de na comunidade. Para informar bugs ou solicitar recursos, registre um problema no GitHub (em inglês).

Para receber ajuda na configuração do ambiente de desenvolvimento do iOS, visite a página do Apple Developer Documentação.