iOS'te MediaPipe Çerçevesi

MediaPipe Framework ile iOS örnek uygulamaları oluşturmak için aşağıdaki talimatları uygulayın. Bu örnek uygulamalar hakkında daha fazla bilgi edinmek için iOS'te Merhaba Dünya başlıklı makaleyi inceleyin.

iOS örnek uygulamaları oluşturma

Ön koşul

  1. Mediapipe Framework'u bu talimatları uygulayarak yükleyin.

  2. Xcode'u yükleyin, ardından aşağıdakileri kullanarak Komut Satırı Araçları'nı yükleyin:

    xcode-select --install

  3. Bazelisk'i yükleyin.

    En son sürümleri almak için Homebrew'i kullanmanızı öneririz.

    brew install bazelisk

  4. Python "six" kitaplığını yükleyin. Bu, TensorFlow için gereklidir.

    pip3 install --user six

  5. MediaPipe deposunu klonlayın.

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

Paket kimliği ön eki oluşturma

Tüm iOS uygulamalarının bir paket kimliği olmalıdır ve bu kimliğe sahip bir uygulamayı telefonunuza yüklemenizi sağlayan bir temel hazırlama profiliniz olmalıdır. Farklı MediaPipe kullanıcıları arasında çakışmaları önlemek için iOS demo uygulamalarımızın paket kimlikleri için benzersiz bir ön ek yapılandırmanız gerekir.

Özel temel hazırlama profiliniz varsa aşağıdaki Özel temel hazırlama bölümüne bakın.

Aksi takdirde, benzersiz bir ön ek oluşturmak için şu komutu çalıştırın:

python3 mediapipe/examples/ios/link_local_profiles.py

Xcode projesi oluşturma

Bu sayede Xcode'daki örnek uygulamalardan birini düzenleyebilir ve hata ayıklayabilirsiniz. Ayrıca otomatik temel hazırlığı da kullanmanıza olanak tanır (sonraki bölüme bakın).

  1. Bazel derleme yapılandırmalarından Xcode projeleri oluşturmak için Tulsi adlı bir araç kullanacağız.

    # 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

    Bu işlem, Tulsi.app dosyasını ana dizininizdeki Applications dizinine yükler.

  2. Tulsi uygulamasını kullanarak mediapipe/Mediapipe.tulsiproj'ü açın.

  3. Yapılandırmalar sekmesinde MediaPipe yapılandırmasını seçin ve ardından aşağıdaki Oluştur düğmesine basın. Xcode projesini kaydedeceğiniz konumu seçmeniz istenir. Proje oluşturulduktan sonra Xcode'da açılır.

    Paket kimlikleriyle ilgili bir hata alırsanız önceki bölüme bakın.

Temel hazırlığı ayarlama

iOS cihazlara uygulama yüklemek için temel hazırlama profiline ihtiyacınız vardır. İki seçeneğiniz vardır:

  1. Otomatik temel hazırlık. Bu sayede, uygulama oluşturabilir ve kişisel cihazınıza yükleyebilirsiniz. Hazırlama profili Xcode tarafından yönetilir ve sık sık güncellenmesi gerekir (yaklaşık bir hafta boyunca geçerlidir).

  2. Özel temel hazırlık. Bu işlem için bir Apple geliştirici hesabıyla ilişkili bir temel hazırlama profili kullanılır. Bu profillerin geçerlilik süresi daha uzundur ve birden fazla cihazı hedefleyebilir ancak bu profilleri edinmek için Apple'da ücretli bir geliştirici hesabınız olmalıdır.

Otomatik temel hazırlık

  1. Daha önce bahsedildiği gibi MediaPipe için bir Xcode projesi oluşturun

  2. Sol kenar çubuğundaki proje gezgininde "Mediapipe" projesini seçin.

  3. Uygulama hedeflerinden birini (ör. HandTrackingGpuApp) seçin.

  4. "İmzalama ve Özellikler" sekmesini seçin.

  5. "İmzalamayı otomatik olarak yönet"i işaretleyin ve iletişim kutusunu onaylayın.

  6. Ekip iletişim menüsünde "Adınız (Kişisel Ekip)"i seçin.

  7. Bu kurulumun, yüklemek istediğiniz her uygulama için bir kez yapılması gerekir. Gerekirse 3-6. adımları tekrarlayın.

Bu işlem, seçtiğiniz her uygulama için temel hazırlama profilleri oluşturur. Artık Bazel'e bunları kullanmasını söylemeniz gerekir. Bu işlemi kolaylaştırmak için bir komut dosyası sağladık.

  1. Terminalde, deposu klonladığınız mediapipe dizine gidin.

  2. Bu komutu çalıştırın:

    python3 mediapipe/examples/ios/link_local_profiles.py

Bu işlem, Xcode'da otomatik temel hazırlığı etkinleştirdiğiniz tüm uygulamaların temel hazırlama profilini bulup bağlar.

Özel temel hazırlama

  1. Apple'dan temel hazırlık profili alın.

  1. Temel hazırlama profilinizi mediapipe/mediapipe/provisioning_profile.mobileprovision adresine simge bağlantısı oluşturun veya kopyalayın.

    cd mediapipe
ln -s ~/Downloads/MyProvisioningProfile.mobileprovision mediapipe/provisioning_profile.mobileprovision
  1. mediapipe/examples/ios/bundle_id.bzl dosyasını açın ve BUNDLE_ID_PREFIX değerini, temel hazırlama profilinizle ilişkili bir önek olarak değiştirin.

Xcode'u kullanarak uygulama derleme ve çalıştırma

  1. Xcode projesini oluşturun ve otomatik veya özel temel hazırlığı ayarladığınızdan emin olun.

  2. Artık hedef menüden Mediapipe Framework demolarından herhangi birini seçebilir ve bunları normal şekilde derleyip çalıştırabilirsiniz.

Komut satırını kullanarak uygulama oluşturma

  1. Otomatik veya özel temel hazırlığı ayarladığınızdan emin olun.

  2. Örneğin, MediaPipe Hands'i kullanarak şu komutu çalıştırın:

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

    Uygulamayı imzalamak için codesign tarafından gönderilen bir izin isteği görebilirsiniz.

  3. Xcode'da Devices and Simulators penceresini (Komut-Üst Karakter-2) açın.

  4. Cihazınızın bağlı olduğundan emin olun. Yüklü uygulamaların listesini görürsünüz. Listenin altındaki "+" düğmesine basın ve Bazel tarafından derlenen .ipa dosyasını seçin.

  5. Artık uygulamayı cihazınızda çalıştırabilirsiniz.