iOS için kurulum kılavuzu

Bu sayfada, MediaPipe Görevleri'ni iOS uygulamalarınızda kullanmak için geliştirme ortamınızı nasıl kuracağınız gösterilmektedir.

Desteklenen cihazlar ve platformlar

MediaPipe Tasks ile iOS uygulamaları oluşturmak için geliştirme ortamınızda şunlar gerekir:

  • macOS Mojave 10.14.3 veya sonraki sürümler.

  • Xcode 10.3 veya sonraki sürümler.

  • En az iOS 12.0 yüklü iOS cihaz. Alternatif olarak, bir iOS simülatörü cihaz kamerasını gerektirmeyen uygulamaları da kullanabilir.

Geliştirici ortamı kurulumu

iOS uygulamasında bir MediaPipe görevi çalıştırmadan önce mevcut bir Xcode projeniz olması veya yerel makinenizde yeni bir proje oluşturmanız gerekir.

MediaPipe Görevleri yalnızca CocoaPods ile yüklenebilir. Başlamadan önce CocoaPods'un 1.12.1 veya sonraki bir sürümünü yüklemeniz gerekir. macOS'e CocoaPods yükleme talimatları için CocoaPods yükleme kılavuzuna bakın.

Örnek kod kurulumu

MediaPipe Örnekleri deposu, MediaPipe görevleri için örnek iOS uygulamaları içerir.

Örnek koddan proje oluşturabilir, projeyi derleyebilir ve görevi çalıştırabilirsiniz. Aşağıdaki adımlar Metin Sınıflandırıcı görevi oluşturur.

Örnek kod projesini içe aktarmak ve derlemek için:

  1. Terminali açın, MediaPipe Örnekleri deposunu klonlayın ve TextClassifier.xcodeproj ile Podfile öğelerini içeren dizine gidin.

    git clone https://github.com/google-ai-edge/mediapipe-samples
    cd mediapipe/examples/text_classification/ios
    
  2. CocoaPods'u kullanarak MediaPipe Görevler'i yükleme:

    pod install
    

    Bu komut, örnek proje dizininde bir TextClassifier.xcworkspace dosyası oluşturur.

  3. Projeyi Xcode'da açmak için TextClassifier.xcworkspace dosyasını çift tıklayın. TextClassifier.xcodeproj dosyası zaten açıksa TextClassifier.xcworkspace dosyasını açmadan önce dosyayı kapatın.

  4. TextClassifier şemasını seçin ve proje pencerenizin araç çubuğundan fiziksel bir iOS cihaz veya simülatör seçin. Fiziksel bir iOS cihaz kullanırken cihazın Mac'inize bağlı olduğundan emin olun.

  5. Projenizin araç çubuğundaki Run düğmesini tıklayın.

Xcode'da uygulama çalıştırmayla ilgili diğer talimatlar için Uygulama oluşturma ve çalıştırma bölümüne bakın.

MediaPipe Görevleri bağımlılıkları

MediaPipe Tasks, vizyon ve metin için önceden oluşturulmuş iki kitaplık sağlar. .tflite model dosyası, modeli kullanan iOS uygulaması paketinde bulunmalıdır. MediaPipe Tas'a bağlı olarak, Vision veya metin kitaplığını CocoaPods Podfile içindeki kapsül listesine ekleyin. Uygulamanız için gerekli kapsüllerle Podfile oluşturma talimatları için CocoaPods'u kullanma bölümüne bakın.

Üretken yapay zeka görevleri

MediaPipe Tasks Generative AI kitaplıkları, görüntü veya metin oluşturma işlemlerini yapan görevler içerir. MediaPipe Tasks Üretici Yapay Zeka kitaplığını yüklemek için MediaPipeTasksGenAI ve MediaPipeTasksGenAIC kapsüllerini Podfile içinde uygulamanızın hedefine ekleyin.

LLM Inference API'si

MediaPipe LLM Çıkarımı görevi, MediaPipeTasksGenAI ve MediaPipeTasksGenAIC kapsüllerinde yer alır.

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

Görüş görevleri

MediaPipe Tasks vizyon kitaplığı, görüntü veya video girişlerini işleyen görevleri içerir. MediaPipe Görevleri vizyon kitaplığını yüklemek için MediaPipeTasksVision kapsülünü Podfile içinde uygulamanızın hedefine ekleyin.

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

Metin görevleri

MediaPipe Tasks metin kitaplığı, dil verilerini metin biçiminde işleyen görevleri içerir. MediaPipe Görevleri metin kitaplığını yüklemek için MediaPipeTasksText kapsülünü Podfile içinde uygulamanızın hedefine ekleyin

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

Test hedeflerini yapılandırın

Uygulamanızın test hedefi varsa MediaPipe görev kitaplığını kullanırken istenmeyen davranışlardan kaçınmak için Podfile'ınızın aşağıdaki uygulamalardan birine uyduğundan emin olun.

En basit uygulama, test hedefinin MediaPipe görev kapsülünü ekleyen ana uygulama hedefinin içine iç içe yerleştirilmemesidir.

target 'MyAppWithMediaPipeTasks' do
  pod 'MediaPipeTasksVision'
end

target 'MyAppWithMediaPipeTasksTests' do

end

Test hedefinin ana uygulama hedefi içine yerleştirilmesi gerekiyorsa Podfile aşağıdaki uygulamaya uygun olmalıdır:

target 'MyAppWithMediaPipeTasks' do
  pod 'MediaPipeTasksVision'

    target 'MyAppWithMediaPipeTasksTests' do
      inherit! :none

    end
end

BaseOptions yapılandırması

BaseOptions, MediaPipe Görev API'larının genel yapılandırılmasına olanak tanır.

Seçenek adı Açıklama Kabul edilen değerler
modelAssetPath iOS uygulama paketindeki bir model dosyasının model yolu. Dize olarak yol.

Donanım hızlandırma

MediaPipe Tasks, iOS'te yalnızca standart CPU işlemcilerde çalışan modelleri destekler.

Sorun giderme

MediaPipe ile ilgili teknik sorularla ilgili yardım almak için tartışma grubunu veya Stack Overflow'u ziyaret ederek topluluktan destek alın. Hataları bildirmek veya özellik isteği göndermek için GitHub'da sorun bildirin.

iOS geliştirme ortamınızı ayarlama konusunda yardım almak için Apple Geliştirici Belgeleri'ni ziyaret edin.