دليل الإعداد لنظام التشغيل iOS

توضح لك هذه الصفحة كيفية إعداد بيئة التطوير لاستخدام MediaPipe "مهام Google" في تطبيقات iOS.

الأجهزة والأنظمة الأساسية المتوافقة

لإنشاء تطبيقات iOS باستخدام MediaPipe Tasks، فإن بيئة التطوير لديك ما يلي:

  • الإصدار 10.14.3 من نظام التشغيل macOS Mojave أو الإصدارات الأحدث

  • Xcode 10.3 أو إصدار أحدث.

  • جهاز iOS يعمل بالإصدار 12.0 من نظام التشغيل iOS على الأقل بدلاً من ذلك، يمكن لمحاكي iOS تتعامل مع التطبيقات التي لا تتطلب كاميرا الجهاز.

إعداد بيئة المطوِّر

قبل تشغيل مهمة MediaPipe على أحد تطبيقات iOS، يجب أن يتوفر لديك إما مشروع Xcode حالي أو إنشاء مشروع جديد على جهازك المحلي.

لا يمكن تثبيت "مهام MediaPipe" إلا باستخدام CocoaPods. يجب تثبيت الإصدار 1.12.1 من CocoaPods أو إصدار أحدث منه قبل البدء. بالنسبة تعليمات لتثبيت CocoaPods على نظام التشغيل macOS، يُرجى الرجوع إلى عملية تثبيت CocoaPods. الدليل.

مثال لإعداد الرمز

MediaPipe أمثلة يحتوي المستودع على أمثلة تطبيقات iOS لمهام MediaPipe.

يمكنك إنشاء مشروع من خلال نموذج الرمز البرمجي، وإنشاء المشروع، ثم تشغيل المهمة. تؤدي الخطوات التالية إلى إنشاء النص المصنِّف المهمة.

لاستيراد نموذج مشروع الرمز البرمجي وإنشاءه:

  1. افتح الوحدة الطرفية وانسخ مستودع أمثلة MediaPipe، ثم انتقِل إلى الدليل الذي يحتوي على TextClassifier.xcodeproj وPodfile.

    git clone https://github.com/google-ai-edge/mediapipe-samples
    cd mediapipe/examples/text_classification/ios
    
  2. تثبيت مهام MediaPipe باستخدام CocoaPods:

    pod install
    

    ينشئ هذا الأمر ملف TextClassifier.xcworkspace في المثال. دليل المشروع.

  3. النقر مرّتين على ملف TextClassifier.xcworkspace لفتح المشروع Xcode. إذا كان ملف TextClassifier.xcodeproj مفتوحًا بالفعل، أغلِقه قبل فتح ملف TextClassifier.xcworkspace.

  4. اختَر المخطط TextClassifier واختَر جهاز iOS أو المحاكي من شريط الأدوات في نافذة المشروع. عند استخدام جهاز iOS فعلي جهازك، فتأكد من توصيله بجهاز Mac.

  5. انقر على الزر Run في شريط أدوات مشروعك.

لمزيد من التعليمات حول تشغيل تطبيق على Xcode، راجع إنشاء تطبيق على Xcode CANNOT TRANSLATE التطبيق.

تبعيات "مهام MediaPipe"

توفر مهام MediaPipe مكتبتين تم إنشاؤهما مسبقًا للرؤية والنص. تشير رسالة الأشكال البيانية يجب وضع ملف طراز .tflite في حزمة تطبيق iOS التي يستخدم النموذج. بناءً على MediaPipe Tas، أضف الرؤية أو النص إلى قائمة المجموعات في CocoaPods Podfile. للحصول على تعليمات حول لإنشاء Podfile باستخدام المجموعات المتسلسلة المطلوبة لتطبيقك، راجِع المقالة استخدام CocoaPods

المهام المتعلّقة بالذكاء الاصطناعي التوليدي

تحتوي مكتبات الذكاء الاصطناعي التوليدي على MediaPipe Tasks على مهام تعالج الصور أو إنشاء النصوص. لتثبيت مكتبة الذكاء الاصطناعي التوليدي في MediaPipe Tasks، أضِف MediaPipeTasksGenAI وMediaPipeTasksGenAIC مجموعة متجاورة إلى هدف تطبيقك في Podfile.

واجهة برمجة تطبيقات استنتاج النماذج اللغوية الكبيرة

يتم تضمين مهمة استنتاج MediaPipe LLM ضمن MediaPipeTasksGenAI وMediaPipeTasksGenAIC مجموعة.

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

المهام المتعلّقة بالرؤية

تحتوي مكتبة رؤية "مهام MediaPipe" على المهام التي تعالج الصور أو الفيديوهات. المدخلات. لتثبيت مكتبة الرؤى في MediaPipe Tasks، أضِف مجموعة واحدة (MediaPipeTasksVision) إلى هدف تطبيقك في Podfile.

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

المهام النصية

تحتوي المكتبة النصية MediaPipe Tasks على المهام التي تعالج بيانات اللغة تنسيق النص. لتثبيت المكتبة النصية "مهام MediaPipe"، أضِف العنصر لوحة واحدة (MediaPipeTasksText) إلى هدف تطبيقك في Podfile

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

إعداد أهداف الاختبار

إذا كان لتطبيقك هدف اختبار، يُرجى التأكُّد من التزام Podfile بأي من الشرطين التاليين عمليات التنفيذ التالية لتجنب أي سلوك غير مرغوب فيه عند استخدام مكتبة مهام MediaPipe

وأبسط طريقة تنفيذ هي ضمان عدم دمج هدف الاختبار داخل هدف التطبيق الرئيسي الذي يضيف مجموعة مهام MediaPipe.

target 'MyAppWithMediaPipeTasks' do
  pod 'MediaPipeTasksVision'
end

target 'MyAppWithMediaPipeTasksTests' do

end

إذا كان يجب دمج هدف الاختبار في هدف التطبيق الرئيسي، يجب أن يكون Podfile مع التنفيذ التالي:

target 'MyAppWithMediaPipeTasks' do
  pod 'MediaPipeTasksVision'

    target 'MyAppWithMediaPipeTasksTests' do
      inherit! :none

    end
end

إعدادات BaseOptions

تسمح BaseOptions بالتهيئة العامة لواجهات برمجة تطبيقات مهام MediaPipe.

اسم الخيار الوصف القيم المقبولة
modelAssetPath مسار النموذج إلى ملف نموذج في حِزمة تطبيقات iOS المسار كسلسلة.

تسريع الأجهزة

على أجهزة iOS، لا تتيح خدمة MediaPipe "مهام Google" تشغيل النماذج إلا على معالِجات وحدة المعالجة المركزية العادية.

تحديد المشاكل وحلّها

للحصول على مساعدة في الإجابة عن الأسئلة الفنية ذات الصلة بـ MediaPipe، انتقل إلى منتدى group أو حزمة القائمة الكاملة للحصول على الدعم من المجتمع. للإبلاغ عن أخطاء أو تقديم طلبات ميزات، يمكنك الإبلاغ عن مشكلة على GitHub.

للحصول على مساعدة في إعداد بيئة تطوير iOS، يُرجى الانتقال إلى Apple Developer (مطوّر برامج Apple). الوثائق: