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

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

الأجهزة والمنصّات المتوافقة

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

  • macOS Mojave 10.14.3 أو الإصدارات الأحدث.

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

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

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

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

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

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

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

يمكنك إنشاء مشروع من نموذج التعليمات البرمجية وبناء المشروع وتشغيل المهمة. وتُنشئ الخطوات التالية مهمة Text Classifier.

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

  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، راجع إنشاء تطبيق وتشغيله.

تبعيات مهام MediaPipe

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

مهام الذكاء الاصطناعي التوليدي

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

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

تتضمّن مهمة الاستدلال اللغوي الكبير MediaPipe في مجموعات MediaPipeTasksGenAI وMediaPipeTasksGenAIC.

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

مهام بصرية

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

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

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

تحتوي مكتبة نص "مهام MediaPipe" على مهام تعالج بيانات اللغة بتنسيق نصي. لتثبيت مكتبة نصوص "مهام 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" مع تشغيل النماذج إلا على معالِجات وحدة المعالجة المركزية العادية.

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

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

للحصول على مساعدة في إعداد بيئة تطوير iOS، انتقِل إلى مستندات مطوّري برامج Apple.