iOS 版 MediaPipe 架構

請按照以下操作說明，使用 MediaPipe 建構 iOS 範例應用程式 架構。如要進一步瞭解這些範例應用程式，請先從「Hello 全世界！在 iOS 裝置上。

建構 iOS 範例應用程式

修課條件

  1. 請按照這些操作說明安裝 Mediapipe Framework。

  2. 安裝 Xcode，然後安裝 指令列工具 (使用：

    xcode-select --install

  3. 安裝 Bazelisk。

    建議你使用 Homebrew 取得最新版本。

    brew install bazelisk

  4. 將 Python 3.7 設為預設 Python 版本，然後安裝 Python「six」 資源庫。這是 TensorFlow 的必要欄位。

    pip3 install --user six

  5. 複製 MediaPipe 存放區。

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

設定軟體包 ID 前置字串

所有 iOS 應用程式都必須具有軟體包 ID，且須有佈建設定檔 ：在手機上以該 ID 安裝應用程式。避免衝突 請務必在不同的 MediaPipe 使用者之間 iOS 試用版應用程式的軟體包 ID。

如果您使用的是自訂佈建設定檔，請參閱 自訂帳戶管理一節。

否則，請執行下列指令來產生不重複的前置字串：

python3 mediapipe/examples/ios/link_local_profiles.py

建立 Xcode 專案

這樣您就可以編輯 Xcode 中的其中一個範例應用程式，並進行偵錯。此外， 可讓您使用自動佈建功能 (請見後續章節)。

  1. 我們將使用 Tulsi 這項工具 來自 Bazel 建構設定的 Xcode 專案。

    # 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

    這會將 Tulsi.app 安裝在目錄的 Applications 目錄中 主目錄下

  2. 使用 Tulsi 應用程式開啟 mediapipe/Mediapipe.tulsiproj。

  3. 在「設定」分頁中選取 MediaPipe 設定，然後按下「產生」 按鈕。系統將要求您提供儲存 Xcode 專案的位置。 專案產生後，將以 Xcode 開啟。

    如果收到有關軟體包 ID 的錯誤，請參閱 上一節。

設定佈建

如要在 iOS 裝置上安裝應用程式，您必須擁有佈建設定檔。有 有兩種選項：

  1. 自動佈建。這樣您可以建構並安裝應用程式 個人裝置。佈建設定檔是由 Xcode 管理，必須具有 經常更新 (有效期限約一週)。

  2. 自訂佈建。這會使用與 Apple 開發人員帳戶。這些商家檔案的有效期限較長 可指定多部裝置，但您需要有 Apple 購買。

自動佈建

  1. 按照先前討論的內容建立 MediaPipe 的 Xcode 專案 早期

  2. 在左側欄的專案導覽器中，選取「Mediapipe」 專案。

  3. 選取其中一個應用程式目標，例如 HandTrackingGpuApp。

  4. 選取「簽署與功能」分頁。

  5. 勾選「自動管理簽名」，並確認對話方塊。

  6. 選取「Your Name (個人團隊)」。

  7. 您只需為每個要安裝的應用程式進行一次這項設定。 視需要重複步驟 3 到 6。

系統隨即會為您選取的每個應用程式產生佈建設定檔。現在您 需要告訴 Bazel 使用。我們提供了指令碼來協助您完成這項工作。

  1. 在終端機中，前往您複製mediapipe Cloud Storage 也提供目錄同步處理功能

  2. 執行下列指令：

    python3 mediapipe/examples/ios/link_local_profiles.py

這項操作會針對符合以下條件的所有應用程式尋找並連結其佈建設定檔 您已在 Xcode 中啟用自動佈建功能。

自訂佈建

  1. 從 Apple 取得佈建設定檔。
，瞭解如何調查及移除這項存取權。

  1. 將佈建設定檔建立符號連結或複製到 mediapipe/mediapipe/provisioning_profile.mobileprovision。

    cd mediapipe
ln -s ~/Downloads/MyProvisioningProfile.mobileprovision mediapipe/provisioning_profile.mobileprovision
，瞭解如何調查及移除這項存取權。
  1. 開啟 mediapipe/examples/ios/bundle_id.bzl，然後變更 將 BUNDLE_ID_PREFIX 設為與佈建設定檔相關聯的前置字串。

使用 Xcode 建構及執行應用程式

  1. 建立 Xcode 專案，並確認你已設定自動或 自訂佈建

  2. 您現在可以在目標選單中選取 Mediapipe 架構示範 並照常建構和執行

，瞭解如何調查及移除這項存取權。

使用指令列建構應用程式

  1. 確認您已設定自動或自訂佈建功能。

  2. 例如，使用 MediaPipe Hands，執行：

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

    您可能會收到「codesign」發出的權限要求，用於簽署應用程式。

  3. 在 Xcode 中開啟 Devices and Simulators 視窗 (command-shift-2)。

  4. 請確認裝置已連接。系統會列出已安裝的應用程式。 按下「+」鍵按鈕，然後選取.ipa Bazel。

  5. 您現在可以在裝置上執行應用程式。

，瞭解如何調查及移除這項存取權。