Panduan penyiapan untuk iOS

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

Perangkat dan platform yang didukung

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

• macOS Mojave 10.14.3 atau yang lebih baru.

• Xcode 10.3 atau yang lebih baru.

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

Penyiapan lingkungan developer

Sebelum menjalankan tugas MediaPipe pada aplikasi iOS, Anda harus memiliki proyek Xcode yang sudah ada atau buat yang baru di mesin lokal Anda.

MediaPipe Tasks hanya dapat diinstal menggunakan CocoaPods. Anda harus menginstal CocoaPods 1.12.1 atau versi yang lebih baru sebelum memulai. Sebagai petunjuk untuk menginstal CocoaPods di macOS, lihat Penginstalan CocoaPods panduan kami.

Contoh penyiapan kode

MediaPipe Contoh berisi contoh aplikasi iOS untuk tugas MediaPipe.

Anda dapat membuat proyek dari kode contoh, membangun proyek, dan menjalankan tugas Anda. Langkah-langkah berikut akan membangun properti Text Pengklasifikasi tugas Anda.

Untuk mengimpor dan membangun contoh proyek kode:

1. Buka terminal, buat 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 membuat file TextClassifier.xcworkspace dalam contoh project.

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

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

5. Klik tombol Run di toolbar project Anda.

Untuk petunjuk lebih lanjut tentang menjalankan aplikasi di Xcode, lihat Membangun dan menjalankan sebuah aplikasi.

Dependensi Tugas MediaPipe

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

Tugas AI generatif

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

LLM Inference API

Tugas Inferensi LLM MediaPipe dimuat dalam MediaPipeTasksGenAI serta MediaPipeTasksGenAIC pod.

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

Tugas penglihatan

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

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

Tugas teks

Pustaka teks MediaPipe Tasks berisi tugas yang menangani data bahasa di format teks. Untuk menginstal library teks MediaPipe Tasks, tambahkan MediaPipeTasksText pod 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 implementasi berikut untuk menghindari perilaku yang tidak diinginkan saat menggunakan Library tugas MediaPipe.

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

target 'MyAppWithMediaPipeTasks' do
  pod 'MediaPipeTasksVision'
end

target 'MyAppWithMediaPipeTasksTests' do

end

Jika target pengujian harus disusun bertingkat dalam target aplikasi utama, Podfile harus sesuai dengan penerapan berikut:

target 'MyAppWithMediaPipeTasks' do
  pod 'MediaPipeTasksVision'

    target 'MyAppWithMediaPipeTasksTests' do
      inherit! :none

    end
end

Konfigurasi BaseOptions

BaseOptions memungkinkan konfigurasi umum MediaPipe Task API.

Akselerasi hardware

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

Pemecahan masalah

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

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