Panduan penyiapan untuk iOS

Halaman ini menunjukkan cara menyiapkan lingkungan pengembangan untuk menggunakan Tugas MediaPipe di aplikasi iOS Anda.

Perangkat dan platform yang didukung

Untuk membuat aplikasi iOS dengan MediaPipe Tasks, lingkungan pengembangan Anda memerlukan hal-hal berikut:

  • macOS Mojave 10.14.3 atau yang lebih baru.

  • Xcode 10.3 atau yang lebih baru.

  • Perangkat iOS yang memiliki minimal iOS 12.0. Atau, simulator iOS dapat menangani aplikasi yang tidak memerlukan kamera perangkat.

Penyiapan lingkungan developer

Sebelum menjalankan tugas MediaPipe di aplikasi iOS, Anda harus sudah memiliki project Xcode atau membuat yang baru di komputer lokal.

MediaPipe Tasks hanya dapat diinstal menggunakan CocoaPods. Anda harus menginstal CocoaPods 1.12.1 atau yang lebih baru sebelum memulai. Untuk mengetahui petunjuk cara menginstal CocoaPods di macOS, lihat panduan penginstalan CocoaPods.

Contoh penyiapan kode

Repositori MediaPipe Examples berisi contoh aplikasi iOS untuk tugas MediaPipe.

Anda dapat membuat project dari kode contoh, membuat project, dan menjalankan tugas. Langkah-langkah berikut akan membangun tugas Text Classifier.

Untuk mengimpor dan membangun project kode contoh:

  1. Buka terminal, clone repositori Contoh MediaPipe, lalu buka direktori yang berisi TextClassifier.xcodeproj dan Podfile.

    git clone https://github.com/google-ai-edge/mediapipe-samples
    cd mediapipe/examples/text_classification/ios
    
  2. Instal MediaPipe Tasks menggunakan CocoaPods:

    pod install
    

    Perintah ini akan membuat file TextClassifier.xcworkspace dalam direktori contoh project.

  3. Klik dua kali file TextClassifier.xcworkspace untuk membuka project di Xcode. Jika file TextClassifier.xcodeproj sudah terbuka, tutup sebelum membuka file TextClassifier.xcworkspace.

  4. Pilih skema TextClassifier dan pilih simulator atau perangkat iOS fisik dari toolbar jendela project Anda. Saat menggunakan perangkat iOS fisik, pastikan perangkat tersebut terhubung ke Mac Anda.

  5. Klik tombol Run di toolbar project Anda.

Untuk petunjuk selengkapnya tentang menjalankan aplikasi di Xcode, lihat Mem-build dan menjalankan aplikasi.

Dependensi Tugas MediaPipe

MediaPipe Tasks menyediakan dua library bawaan untuk visi dan teks. File model .tflite harus berada dalam paket aplikasi iOS yang menggunakan model tersebut. Bergantung pada MediaPipe Tas, tambahkan library visi atau teks ke daftar pod dalam Podfile CocoaPods. Untuk petunjuk cara membuat Podfile dengan pod yang diperlukan untuk aplikasi Anda, lihat Menggunakan CocoaPods.

Tugas AI generatif

Library AI Generatif MediaPipe Tasks berisi tugas yang menangani pembuatan gambar atau teks. Untuk menginstal library AI Generatif MediaPipe Tasks, tambahkan pod MediaPipeTasksGenAI dan MediaPipeTasksGenAIC ke target aplikasi Anda di Podfile.

API Inferensi LLM

Tugas Inferensi LLM MediaPipe dimuat dalam pod MediaPipeTasksGenAI dan MediaPipeTasksGenAIC.

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

Tugas visi

Library Vision MediaPipe Tasks berisi tugas yang menangani input gambar atau video. Untuk menginstal library Vision MediaPipe Tasks, tambahkan pod MediaPipeTasksVision ke target aplikasi Anda di Podfile.

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

Tugas teks

Library teks MediaPipe Tasks berisi tugas yang menangani data bahasa dalam format teks. Untuk menginstal library teks MediaPipe Tasks, tambahkan pod MediaPipeTasksText ke target aplikasi Anda di Podfile

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

Mengonfigurasi target pengujian

Jika aplikasi Anda memiliki target pengujian, pastikan Podfile Anda mematuhi salah satu penerapan berikut untuk menghindari perilaku yang tidak diinginkan saat menggunakan library tugas MediaPipe.

Implementasi paling sederhana adalah memastikan bahwa target pengujian tidak disusun bertingkat dalam target aplikasi utama yang menambahkan pod tugas MediaPipe.

target 'MyAppWithMediaPipeTasks' do
  pod 'MediaPipeTasksVision'
end

target 'MyAppWithMediaPipeTasksTests' do

end

Jika target pengujian harus disarangkan dalam target aplikasi utama, Podfile harus sesuai dengan implementasi berikut:

target 'MyAppWithMediaPipeTasks' do
  pod 'MediaPipeTasksVision'

    target 'MyAppWithMediaPipeTasksTests' do
      inherit! :none

    end
end

Konfigurasi BaseOptions

BaseOptions memungkinkan konfigurasi umum MediaPipe Task API.

Nama opsi Deskripsi Nilai yang diterima
modelAssetPath Jalur model ke file model dalam paket aplikasi iOS. Jalur sebagai string.

Akselerasi hardware

Di iOS, MediaPipe Tasks hanya mendukung model yang berjalan pada prosesor CPU standar.

Pemecahan masalah

Untuk mendapatkan bantuan terkait pertanyaan teknis terkait MediaPipe, kunjungi grup diskusi atau Stack Overflow untuk mendapatkan dukungan dari komunitas. Untuk melaporkan bug atau mengajukan permintaan fitur, ajukan masalah di GitHub.

Untuk mendapatkan bantuan dalam menyiapkan lingkungan pengembangan iOS, buka Dokumentasi Developer Apple.