Przewodnik po konfiguracji systemu iOS

Z tej strony dowiesz się, jak skonfigurować środowisko programistyczne pod kątem korzystania z MediaPipe Listy zadań w aplikacjach na iOS.

Obsługiwane urządzenia i platformy

Aby tworzyć aplikacje na iOS za pomocą MediaPipe Tasks, Twojego środowiska programistycznego wymaga:

• System macOS Mojave 10.14.3 lub nowszy

• Xcode w wersji 10.3 lub nowszej.

• Urządzenie z systemem iOS w wersji 12.0 lub nowszej. Z kolei symulator iOS obsługi aplikacji, które nie wymagają aparatu urządzenia.

Konfiguracja środowiska programistycznego

Zanim uruchomisz zadanie MediaPipe w aplikacji na iOS, musisz mieć istniejącego projektu Xcode lub utwórz nowy projekt na komputerze lokalnym.

Zadania MediaPipe można zainstalować tylko za pomocą CocoaPods. Zanim zaczniesz, musisz zainstalować CocoaPods w wersji 1.12.1 lub nowszej. Dla: instrukcje instalowania CocoaPods w macOS znajdziesz w sekcji dotyczącej instalacji CocoaPods .

Przykładowa konfiguracja kodu

Narzędzie MediaPipe Przykłady repozytorium zawiera przykładowe aplikacje na iOS do zadań MediaPipe.

Możesz utworzyć projekt na podstawie przykładowego kodu, skompilować go i uruchomić zadanie. Kolejne kroki tworzą tekst Klasyfikator zadanie.

Aby zaimportować i skompilować przykładowy projekt kodu:

1. Otwórz terminal, skopiuj repozytorium MediaPipe Example i przejdź do w katalogu zawierającym TextClassifier.xcodeproj i Podfile.

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

2. Zainstaluj Listę zadań MediaPipe za pomocą CocoaPods:

   pod install
   

   To polecenie tworzy plik TextClassifier.xcworkspace w przykładzie katalogu projektu.

3. Kliknij dwukrotnie plik TextClassifier.xcworkspace, aby otworzyć projekt Xcode. Jeśli plik TextClassifier.xcodeproj jest już otwarty, zamknij go przed otwarciem pliku TextClassifier.xcworkspace.

4. Wybierz schemat TextClassifier i fizyczne urządzenie z iOS lub na pasku narzędzi w oknie projektu. Na fizycznym urządzeniu z iOS upewnij się, że jest ono podłączone do komputera Mac.

5. Kliknij przycisk Run na pasku narzędzi projektu.

Więcej instrukcji dotyczących uruchamiania aplikacji przy użyciu Xcode znajdziesz w sekcji Tworzenie i uruchamianie aplikacji

Zależności zadań MediaPipe

MediaPipe Tasks udostępnia 2 gotowe biblioteki do rozpoznawania treści i tekstu. .tflite plik modelu musi znajdować się w pakiecie aplikacji na iOS, która korzysta z modelu. W zależności od narzędzia MediaPipe Tas dodaj wizję lub tekst. do listy podów w CocoaPods Podfile. Instrukcje dotyczące Tworzenie Podfile z podami wymaganymi dla aplikacji znajdziesz w sekcji Korzystanie z CocoaPods.

Zadania generatywnej AI

Biblioteki generatywnej AI MediaPipe Tasks zawierają zadania, które obsługują obrazy lub generowanie tekstu. Aby zainstalować bibliotekę generatywnej AI MediaPipe Tasks, dodaj funkcję MediaPipeTasksGenAI i MediaPipeTasksGenAIC bloków reklamowych do celu Twojej aplikacji w: Podfile.

Interfejs LLM Inference API

Zadanie wnioskowania z użyciem MediaPipe LLM znajduje się w: MediaPipeTasksGenAI i MediaPipeTasksGenAIC pody.

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

Zadania związane z widocznością

Biblioteka Vision MediaPipe Tasks zawiera zadania obsługujące obrazy i filmy danych wejściowych. Aby zainstalować bibliotekę Vision MediaPipe Tasks, dodaj komponent MediaPipeTasksVision blok do osiągnięcia celu aplikacji w Podfile.

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

Zadania związane z tekstem

Biblioteka tekstowa MediaPipe Tasks zawiera zadania, które obsługują dane językowe w w formacie tekstowym. Aby zainstalować bibliotekę tekstową MediaPipe Tasks, dodaj rozszerzenie MediaPipeTasksText blok reklamowy do celu Twojej aplikacji w Podfile

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

Skonfiguruj cele testowe

Jeśli Twoja aplikacja ma testowe miejsce docelowe, upewnij się, że plik Podfile jest zgodny z jedną z tych poniższych implementacji, aby uniknąć niepożądanych zachowań przy korzystaniu z Biblioteka zadań MediaPipe.

Najprostszym sposobem jest sprawdzenie, czy miejsce docelowe testowe nie jest zagnieżdżone w głównym celu aplikacji, do którego dodany jest pod zadania MediaPipe.

target 'MyAppWithMediaPipeTasks' do
  pod 'MediaPipeTasksVision'
end

target 'MyAppWithMediaPipeTasksTests' do

end

Jeśli miejsce docelowe testowe musi być zagnieżdżone w głównym miejscu docelowym aplikacji, plik Podfile musi być muszą być zgodne z tym wdrożeniem:

target 'MyAppWithMediaPipeTasks' do
  pod 'MediaPipeTasksVision'

    target 'MyAppWithMediaPipeTasksTests' do
      inherit! :none

    end
end

Konfiguracja BaseOptions

Interfejsy BaseOptions umożliwiają ogólną konfigurację interfejsów MediaPipe Task API.

Akceleracja sprzętowa

W systemie iOS MediaPipe Tasks obsługuje tylko modele z procesorem o standardowym procesorze.

Rozwiązywanie problemów

Aby uzyskać pomoc dotyczącą kwestii technicznych związanych z MediaPipe, zapoznaj się z dyskusją na ten temat grupa lub Stos Overflow, aby uzyskać pomoc od dla społeczności. Aby zgłosić błędy lub poprosić o dodanie funkcji, zgłoś problem na GitHub.

Pomoc w konfigurowaniu środowiska programistycznego iOS znajdziesz na stronie Apple Developer Dokumentacja