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 işe iOS'te Hello World! bölümünden başlayın.
iOS örnek uygulamaları oluşturma
Ön koşul
Bu instructions uygulayarak Mediapipe Framework'ü yükleyin.
Xcode'u yükleyin ve ardından aşağıdakileri kullanarak Komut Satırı Araçları'nı yükleyin:
xcode-select --install
Bazelisk'i yükleyin.
En son sürümleri edinmek için Homebrew aracını kullanmanızı öneririz.
brew install bazelisk
Python 3.7'yi varsayılan Python sürümü olarak ayarlayın ve Python "six" kitaplığını yükleyin. Bu, TensorFlow için gereklidir.
pip3 install --user six
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 telefonunuza aynı kimliğe sahip uygulamaları yüklemenize izin veren bir temel hazırlık profilinizin olması gerekir. Farklı MediaPipe kullanıcıları arasında çakışmaları önlemek amacıyla, iOS demo uygulamalarımızın paket kimlikleri için benzersiz bir önek yapılandırmanız gerekir.
Özel bir temel hazırlık profiliniz varsa aşağıdaki Özel temel hazırlık bölümüne bakın.
Aksi takdirde, benzersiz bir önek oluşturmak için şu komutu çalıştırın:
python3 mediapipe/examples/ios/link_local_profiles.py
Xcode projesi oluşturma
Bu, Xcode'daki örnek uygulamalardan birini düzenlemenize ve hata ayıklamanıza olanak tanır. Ayrıca, otomatik temel hazırlığı kullanmanıza da olanak tanır (sonraki bölüme bakın).
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
öğesini ana dizininizinApplications
dizinine yükler.Tulsi uygulamasını kullanarak
mediapipe/Mediapipe.tulsiproj
uygulamasını açın.Yapılandırmalar sekmesinde MediaPipe yapılandırmasını seçin, ardından aşağıdaki Oluştur düğmesine basın. Xcode projesini kaydetmek için bir konum belirtmeniz istenir. Proje oluşturulduktan sonra Xcode'da açılır.
Paket kimlikleriyle ilgili hata alırsanız önceki bölümü inceleyin.
Temel hazırlık ayarlarını yapın
iOS cihaza uygulama yüklemek için bir temel hazırlık profiline ihtiyacınız vardır. İki seçeneğiniz vardır:
Otomatik temel hazırlık. Bu, bir uygulama oluşturmanıza ve kişisel cihazınıza yüklemenize olanak tanır. Temel hazırlık profili Xcode tarafından yönetilir ve sık sık güncellenmesi gerekir (yaklaşık bir hafta boyunca geçerlidir).
Özel temel hazırlık. Bu özellik, bir Apple geliştirici hesabıyla ilişkili bir temel hazırlık profili kullanır. Bu profillerin geçerlilik süresi daha uzundur ve birden fazla cihazı hedefleyebilir, ancak profil edinmek için Apple'da ücretli bir geliştirici hesabınızın olması gerekir.
Otomatik temel hazırlık
Daha önce açıklandığı gibi MediaPipe için bir Xcode projesi oluşturun
Sol kenar çubuğundaki proje gezgininden "Mediapipe" projesini seçin.
Uygulama hedeflerinden birini seçin (örneğin, HandTrackingGpuApp).
"İmzalama ve Özellikler" sekmesini seçin.
"İmzalamayı otomatik olarak yönet"i işaretleyin ve iletişim kutusunu onaylayın.
Ekip iletişim kutusunda "Your Name (Personal Team)" (Adınız) seçeneğini belirleyin.
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ırlık profilleri oluşturur. Şimdi Bazel'a bunları kullanmasını söylemeniz gerekiyor. Bu işlemi kolaylaştırmak için bir komut dosyası sağladık.
Terminalde, depoyu klonladığınız
mediapipe
dizinine gidin.Şu 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ırlık profilini bulup bağlar.
Özel temel hazırlık
- Apple'dan bir temel hazırlık profili alın.
Temel hazırlık profilinizi
mediapipe/mediapipe/provisioning_profile.mobileprovision
adresine simgesel olarak bağlayın veya kopyalayın.cd mediapipe ln -s ~/Downloads/MyProvisioningProfile.mobileprovision mediapipe/provisioning_profile.mobileprovision
mediapipe/examples/ios/bundle_id.bzl
uygulamasını açın veBUNDLE_ID_PREFIX
özelliğini temel hazırlık profilinizle ilişkili bir önekle değiştirin.
Xcode kullanarak uygulama derleme ve çalıştırma
Xcode projesini oluşturun ve otomatik veya özel temel hazırlığı ayarladığınızdan emin olun.
Artık hedef menüden Mediapipe Framework demolarından istediğinizi seçebilir ve bunları normal şekilde oluşturup çalıştırabilirsiniz.
Komut satırını kullanarak uygulama derleme
Otomatik veya özel temel hazırlığı ayarladığınızdan emin olun.
Örneğin MediaPipe Ellerini 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.Xcode'da
Devices and Simulators
penceresini açın (command-shift-2).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 oluşturulan
.ipa
dosyasını seçin.Artık uygulamayı cihazınızda çalıştırabilirsiniz.