Udhëzues konfigurimi për iOS

Kjo faqe ju tregon se si të konfiguroni mjedisin tuaj të zhvillimit për të përdorur MediaPipe Tasks në aplikacionet tuaja iOS.

Pajisjet dhe platformat e mbështetura

Për të krijuar aplikacione iOS me MediaPipe Tasks, mjedisi juaj i zhvillimit kërkon sa më poshtë:

• macOS Mojave 10.14.3 ose më i ri.

• Xcode 10.3 ose më i madh.

• Pajisja iOS me të paktën iOS 12.0. Përndryshe, një simulator iOS mund të trajtojë aplikacione që nuk kërkojnë kamerën e pajisjes.

Konfigurimi i mjedisit të zhvilluesit

Përpara se të ekzekutoni një detyrë MediaPipe në një aplikacion iOS, ose duhet të keni një projekt ekzistues Xcode ose të krijoni një të ri në kompjuterin tuaj lokal.

MediaPipe Tasks mund të instalohet vetëm duke përdorur CocoaPods . Duhet të instaloni CocoaPods 1.12.1 ose më të ri përpara se të filloni. Për udhëzime për instalimin e CocoaPods në macOS, referojuni udhëzuesit të instalimit të CocoaPods .

Shembull i konfigurimit të kodit

Depoja e Shembujve të MediaPipe përmban shembuj të aplikacioneve iOS për detyrat e MediaPipe.

Ju mund të krijoni një projekt nga kodi shembull, të ndërtoni projektin dhe të ekzekutoni detyrën. Hapat e mëposhtëm ndërtojnë detyrën e Klasifikimit të Tekstit .

Për të importuar dhe ndërtuar shembullin e projektit të kodit:

1. Hapni terminalin, klononi depon e MediaPipe Examples dhe lundroni te drejtoria që përmban TextClassifier.xcodeproj dhe Podfile .

   git clone https://github.com/google-ai-edge/mediapipe-samples
   cd mediapipe-samples/examples/text_classification/ios
   

2. Instaloni MediaPipe Tasks duke përdorur CocoaPods:

   pod install
   

   Kjo komandë krijon një skedar TextClassifier.xcworkspace në direktorinë e projektit shembull.

3. Klikoni dy herë në skedarin TextClassifier.xcworkspace për të hapur projektin në Xcode. Nëse skedari TextClassifier.xcodeproj është tashmë i hapur, mbylleni atë përpara se të hapni skedarin TextClassifier.xcworkspace .

4. Zgjidhni skemën TextClassifier dhe zgjidhni një pajisje fizike ose simulator iOS nga shiriti i veglave të dritares së projektit tuaj. Kur përdorni një pajisje fizike iOS, sigurohuni që ajo të jetë e lidhur me Mac-in tuaj.

5. Klikoni butonin Run në shiritin e veglave të projektit tuaj.

Për më shumë udhëzime mbi ekzekutimin e një aplikacioni në Xcode, referojuni Ndërtimi dhe ekzekutimi i një aplikacioni .

Varësitë e MediaPipe Tasks

MediaPipe Tasks ofron dy biblioteka të para-ndërtuara për vizion dhe tekst. Skedari i modelit .tflite duhet të gjendet në paketën e aplikacionit iOS që përdor modelin. Në varësi të MediaPipe Tas, shtoni ose vizionin ose bibliotekën e tekstit në listën e pods brenda Podfile CocoaPods. Për udhëzime mbi krijimin e një Podfile me pods-et e kërkuara për aplikacionin tuaj, referojuni Përdorimit të CocoaPods .

Detyrat gjeneruese të AI

Bibliotekat MediaPipe Tasks Generative AI përmbajnë detyra që trajtojnë gjenerimin e imazhit ose tekstit. Për të instaluar bibliotekën MediaPipe Tasks Generative AI, shtoni pods MediaPipeTasksGenAI dhe MediaPipeTasksGenAIC në objektivin e aplikacionit tuaj në Podfile .

LLM Inference API

Detyra MediaPipe LLM Inference gjendet brenda pods MediaPipeTasksGenAI dhe MediaPipeTasksGenAIC .

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

Detyrat e vizionit

Biblioteka e vizionit të MediaPipe Tasks përmban detyra që trajtojnë hyrjet e imazheve ose videove. Për të instaluar bibliotekën e vizionit të MediaPipe Tasks, shtoni podin MediaPipeTasksVision në objektivin e aplikacionit tuaj në skedarin Podfile .

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

Detyrat e tekstit

Biblioteka e tekstit të MediaPipe Tasks përmban detyra që trajtojnë të dhënat e gjuhës në format teksti. Për të instaluar bibliotekën e tekstit të MediaPipe Tasks, shtoni podin MediaPipeTasksText në objektivin e aplikacionit tuaj në Podfile

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

Konfiguro objektivat e provës

Nëse aplikacioni juaj ka një objektiv testimi, sigurohuni që skedari juaj Podfile t'i përmbahet njërit prej zbatimeve të mëposhtme për të shmangur çdo sjellje të padëshiruar kur përdorni një bibliotekë detyrash MediaPipe.

Zbatimi më i thjeshtë është të siguroheni që objektivi i testimit të mos jetë i vendosur brenda objektivit kryesor të aplikacionit që shton podin e detyrave MediaPipe.

target 'MyAppWithMediaPipeTasks' do
  pod 'MediaPipeTasksVision'
end

target 'MyAppWithMediaPipeTasksTests' do

end

Nëse objektivi i testimit duhet të vendoset brenda objektivit kryesor të aplikacionit, skedari Podfile duhet të përputhet me zbatimin e mëposhtëm:

target 'MyAppWithMediaPipeTasks' do
  pod 'MediaPipeTasksVision'

    target 'MyAppWithMediaPipeTasksTests' do
      inherit! :none

    end
end

Konfigurimi i BaseOptions

BaseOptions lejojnë konfigurimin e përgjithshëm të MediaPipe Task API.

Përshpejtimi i harduerit

Në iOS, MediaPipe Tasks mbështet vetëm modelet e ekzekutimit në procesorë standardë CPU.

Zgjidhja e problemeve

Për ndihmë me pyetje teknike në lidhje me MediaPipe, vizitoni grupin e diskutimit ose Stack Overflow për mbështetje nga komuniteti. Për të raportuar gabime ose për të bërë kërkesa për veçori, paraqisni një problem në GitHub .

Për ndihmë në konfigurimin e mjedisit tuaj të zhvillimit të iOS, vizitoni Dokumentacionin e Zhvilluesit të Apple .