Platforma MediaPipe na iOS

Wykonaj poniższe instrukcje, aby tworzyć przykładowe aplikacje na iOS za pomocą MediaPipe Platforma. Aby dowiedzieć się więcej o tych przykładowych aplikacjach, zacznij od tekstu Hello Świat! na iOS.

Tworzenie przykładowych aplikacji na iOS

Warunek wstępny

1. Zainstaluj Mediapipe Framework, postępując zgodnie z tymi instrukcjami.

2. Zainstaluj Xcode, a potem Narzędzia wiersza poleceń korzystające z następujących funkcji:

   xcode-select --install
   

3. Zainstaluj aplikację Bazelisk.

   Zalecamy korzystanie z Homebrew, aby pobrać najnowsze wersje.

   brew install bazelisk
   

4. Ustaw Pythona 3.7 jako domyślną wersję Pythona i zainstaluj „6” z Pythona bibliotece. Jest to wymagane w przypadku TensorFlow.

   pip3 install --user six
   

5. Skopiuj repozytorium MediaPipe.

   git clone https://github.com/google/mediapipe.git
   

Konfigurowanie prefiksu identyfikatora pakietu

Wszystkie aplikacje na iOS muszą mieć identyfikator pakietu i musisz mieć profil obsługi administracyjnej która pozwala zainstalować na telefonie aplikację z tym identyfikatorem. Aby uniknąć konfliktów między różnymi użytkownikami MediaPipe, musisz skonfigurować unikalny prefiks identyfikatorów pakietów naszych aplikacji w wersji demonstracyjnej na iOS.

Jeśli masz niestandardowy profil obsługi administracyjnej, zobacz Niestandardowa obsługa administracyjna poniżej.

W przeciwnym razie uruchom to polecenie, aby wygenerować unikalny prefiks:

python3 mediapipe/examples/ios/link_local_profiles.py

Utwórz projekt Xcode

Dzięki temu możesz edytować i debugować jedną z przykładowych aplikacji w Xcode. Dodatkowo umożliwia korzystanie z automatycznej obsługi administracyjnej (patrz sekcja poniżej).

1. Za pomocą narzędzia Tulsi wygenerujemy Projekty Xcode z konfiguracji kompilacji w Bazel.

   # cd out of the mediapipe directory, then:
   git clone https://github.com/bazelbuild/tulsi.git
   cd tulsi
   # remove Xcode version from Tulsi's .bazelrc (see http://github.com/bazelbuild/tulsi#building-and-installing):
   sed -i .orig '/xcode_version/d' .bazelrc
   # build and run Tulsi:
   sh build_and_run.sh
   

   Spowoduje to zainstalowanie aplikacji Tulsi.app w katalogu Applications w katalogu głównym.

2. Otwórz plik mediapipe/Mediapipe.tulsiproj za pomocą aplikacji Tulsi.

3. Wybierz konfigurację MediaPipe na karcie Config (Konfiguracje), a następnie naciśnij przycisk Wygeneruj poniżej. Pojawi się prośba o podanie lokalizacji, w której można zapisać projekt Xcode. Po wygenerowaniu projekt zostanie otwarty w Xcode.

   Jeśli pojawi się błąd dotyczący identyfikatorów pakietów, zapoznaj się z sekcją poprzedniej sekcji.

Konfigurowanie obsługi administracyjnej

Aby instalować aplikacje na urządzeniu z iOS, musisz mieć profil obsługi administracyjnej. OK dostępne są 2 opcje:

1. Automatyczna obsługa administracyjna. Dzięki temu możesz budować i instalować aplikacje na urządzeniu osobistym. Profil obsługi administracyjnej jest zarządzany przez Xcode i musi być często aktualizowane (jest ważne przez około tydzień).

2. Niestandardowa obsługa administracyjna. Używany jest profil obsługi administracyjnej powiązany z konto dewelopera Apple. Te profile mają dłuższy okres ważności i możesz kierować reklamy na wiele urządzeń, ale potrzebujesz płatnego konta dewelopera z w celu uzyskania go od Apple.

Automatyczna obsługa administracyjna

1. Jak już omówiliśmy, utwórz projekt Xcode dla MediaPipe. wcześniej

2. W nawigatorze projektów na lewym pasku bocznym wybierz „Mediapipe”. w projektach AI.

3. Wybierz jeden z celów aplikacji, np. HandTrackingGpuApp.

4. Wybierz opcję „Podpisowanie Możliwości .

5. Zaznacz „Automatyczne zarządzanie podpisywaniem” i potwierdź okno.

6. Wybierz „Your Name (Personal Team)” (Twoje imię i nazwisko, osobisty zespół). w oknie Zespół.

7. Tę konfigurację trzeba przeprowadzić raz dla każdej aplikacji, którą chcesz zainstalować. W razie potrzeby powtórz kroki 3–6.

Spowoduje to wygenerowanie profili obsługi administracyjnej dla każdej wybranej aplikacji. Teraz Ty i poinformować Bazel, żeby z nich korzystali. Opracowaliśmy skrypt, który to ułatwi.

1. W terminalu do katalogu mediapipe, w którym sklonowano plik z repozytorium.

2. Uruchom to polecenie:

   python3 mediapipe/examples/ios/link_local_profiles.py
   

Spowoduje to znalezienie i połączenie profilu obsługi administracyjnej wszystkich aplikacji, w przypadku których masz włączoną automatyczną obsługę administracyjną w aplikacji Xcode.

Niestandardowa obsługa administracyjna

1. Uzyskaj profil obsługi administracyjnej od Apple.

1. Link symboliczny lub skopiuj profil obsługi administracyjnej do mediapipe/mediapipe/provisioning_profile.mobileprovision

   cd mediapipe
   ln -s ~/Downloads/MyProvisioningProfile.mobileprovision mediapipe/provisioning_profile.mobileprovision
   

1. Otwórz aplikację mediapipe/examples/ios/bundle_id.bzl i zmień BUNDLE_ID_PREFIX do prefiksu powiązanego z Twoim profilem obsługi administracyjnej.

Tworzenie i uruchamianie aplikacji za pomocą Xcode

1. Utwórz projekt Xcode i upewnij się, że jest skonfigurowany automatyczny lub obsługę administracyjną użytkowników.

2. W menu docelowym możesz teraz wybrać dowolną wersję demonstracyjną platformy Mediapipe Framework, a potem skompilować je i uruchomić w zwykły sposób.

Tworzenie aplikacji przy użyciu wiersza poleceń

1. Sprawdź, czy masz skonfigurowaną automatyczną lub niestandardową obsługę administracyjną.

2. Używając na przykład narzędzia MediaPipe Hands, uruchom na przykład:

   bazel build -c opt --config=ios_arm64 mediapipe/examples/ios/handtrackinggpu:HandTrackingGpuApp
   

   Możesz zobaczyć prośbę o uprawnienia od codesign na potrzeby podpisania aplikacji.

3. W Xcode otwórz okno Devices and Simulators (command-shift-2).

4. Sprawdź, czy urządzenie jest połączone. Zobaczysz listę zainstalowanych aplikacji. Naciśnij przycisk „+” pod listą i wybierz plik .ipa utworzony przez Bazel.

5. Możesz teraz uruchomić aplikację na urządzeniu.