إطار عمل MediaPipe على نظام التشغيل iOS

يُرجى اتّباع التعليمات أدناه لإنشاء نماذج لتطبيقات iOS باستخدام MediaPipe Framework. لمعرفة المزيد من المعلومات عن نماذج التطبيقات هذه، ابدأ من Hello World! on iOS.

إنشاء نماذج لتطبيقات iOS

المتطلبات الأساسية

1. ثبِّت إطار عمل Mediapic باتّباع هذه instructions.

2. ثبِّت Xcode، ثم ثبِّت أدوات سطر الأوامر باستخدام:

   xcode-select --install
   

3. تثبيت Bazelisk

   نقترح عليك استخدام Homebrew للحصول على أحدث الإصدارات.

   brew install bazelisk
   

4. قم بتعيين Python 3.7 كإصدار Python الافتراضي وتثبيت مكتبة Python "s6". هذا الإجراء مطلوب لتطبيق TensorFlow.

   pip3 install --user six
   

5. استنسِخ مستودع MediaPipe.

   git clone https://github.com/google/mediapipe.git
   

إعداد بادئة معرّف الحزمة

يجب أن يكون لجميع تطبيقات iOS معرِّف حزمة، كما يجب أن يكون لديك ملف شخصي لتوفير المتطلبات اللازمة يسمح لك بتثبيت تطبيق يتضمّن هذا المعرّف على هاتفك. لتجنّب التعارضات بين مستخدمي MediaPipe المختلفين، عليك ضبط بادئة فريدة لمعرّفات الحِزم في تطبيقات iOS التجريبية.

إذا كان لديك ملف شخصي مخصص لإدارة الحسابات، فراجع إدارة الحسابات المخصصة أدناه.

بخلاف ذلك، شغِّل هذا الأمر لإنشاء بادئة فريدة:

python3 mediapipe/examples/ios/link_local_profiles.py

إنشاء مشروع Xcode

يتيح لك هذا تعديل أحد نماذج التطبيقات في Xcode وتصحيح الأخطاء فيها. ويتيح لك أيضًا استخدام ميزة توفير المتطلبات اللازمة (يُرجى الاطّلاع على القسم لاحقًا).

1. سنستخدم أداة تُسمى Tulsi لإنشاء مشاريع Xcode من إعدادات إصدار Bazel.

   # cd out of the mediapipe directory, then:
   git clone https://github.com/bazelbuild/tulsi.git
   cd tulsi
   # remove Xcode version from Tulsi's .bazelrc (see http://github.com/bazelbuild/tulsi#building-and-installing):
   sed -i .orig '/xcode_version/d' .bazelrc
   # build and run Tulsi:
   sh build_and_run.sh
   

   سيؤدي هذا الإجراء إلى تثبيت Tulsi.app داخل الدليل Applications في الدليل الرئيسي.

2. افتح mediapipe/Mediapipe.tulsiproj باستخدام تطبيق Tulsi.

3. اختَر إعداد MediaPipe في علامة التبويب "الإعدادات"، ثم اضغط على الزر "إنشاء" أدناه. سيُطلب منك تحديد موقع لحفظ مشروع Xcode. بمجرد إنشاء المشروع، سيتم فتحه في Xcode.

   إذا ظهرت لك رسالة خطأ بشأن معرّفات الحِزم، راجِع القسم السابق.

إعداد إدارة الحسابات

لتثبيت التطبيقات على جهاز iOS، تحتاج إلى ملف شخصي لإدارة الحسابات. هناك خياران:

1. إدارة الحسابات التلقائية. يتيح لك ذلك إنشاء تطبيق وتثبيته على جهازك الشخصي. تتم إدارة الملف الشخصي لإدارة الحسابات بواسطة Xcode، ويجب تحديثه كثيرًا (يكون صالحًا لمدة أسبوع تقريبًا).

2. إدارة حسابات مخصَّصة. يستخدم هذا ملفًا شخصيًا لتوفير المتطلبات اللازمة مرتبطًا بحساب مطور Apple. تتميز هذه الملفات الشخصية بمدة صلاحية أطول ويمكنها استهداف أجهزة متعددة، ولكنك تحتاج إلى حساب مطوِّر مدفوع من Apple للحصول على حساب مطوّر برامج.

توفير المتطلبات اللازمة

1. إنشاء مشروع Xcode لـ MediaPipe، كما هو موضّح سابقًا

2. في شريط التنقل الخاص بالمشروع في الشريط الجانبي الأيسر، حدد مشروع Mediatube.

3. اختَر أحد أهداف التطبيق، مثل HandTrackingGpuApp.

4. انقر على علامة التبويب "التوقيع والإمكانات".

5. ضَع علامة في المربّع "إدارة التوقيع تلقائيًا"، وأكِّد مربع الحوار.

6. حدد "اسمك (الفريق الشخصي)" في قائمة مربع حوار الفريق.

7. يجب تنفيذ هذا الإعداد مرة واحدة لكل تطبيق تريد تثبيته. كرِّر الخطوات من 3 إلى 6 حسب الحاجة.

يؤدي هذا إلى إنشاء ملفات شخصية لإدارة الحسابات لكل تطبيق اخترته. عليك الآن إخبار Bazel باستخدامها. لقد قدّمنا نصًا برمجيًا لتسهيل هذه العملية.

1. في الوحدة الطرفية، إلى دليل mediapipe الذي تم نسخ المستودع فيه.

2. نفِّذ الأمر التالي:

   python3 mediapipe/examples/ios/link_local_profiles.py
   

سيؤدي هذا إلى البحث عن الملف الشخصي لإدارة الحسابات وربطه لجميع التطبيقات التي تم تفعيل إدارة الحسابات التلقائية لها في Xcode.

توفير المتطلبات اللازمة

1. احصل على ملف شخصي لإدارة الحسابات من Apple.

1. عليك إنشاء رابط رمزي أو نسخ الملف الشخصي لإدارة الحسابات إلى mediapipe/mediapipe/provisioning_profile.mobileprovision.

   cd mediapipe
   ln -s ~/Downloads/MyProvisioningProfile.mobileprovision mediapipe/provisioning_profile.mobileprovision
   

1. افتح mediapipe/examples/ios/bundle_id.bzl وغيِّر BUNDLE_ID_PREFIX إلى بادئة مرتبطة بملفك الشخصي لإدارة الحسابات.

إنشاء تطبيق وتشغيله باستخدام Xcode

1. أنشئ مشروع Xcode، وتأكّد من إعداد إمّا إدارة حسابات تلقائية أو مخصّصة.

2. يمكنك الآن تحديد أي عروض توضيحية لإطار عمل Mediatube في القائمة الهدف، وإنشائها وتشغيلها كالمعتاد.

إنشاء تطبيق باستخدام سطر الأوامر

1. يُرجى التأكد من إعداد إدارة الحسابات التلقائية أو المخصّصة.

2. باستخدام MediaPipe Hands على سبيل المثال، شغِّل:

   bazel build -c opt --config=ios_arm64 mediapipe/examples/ios/handtrackinggpu:HandTrackingGpuApp
   

   قد يظهر لك طلب الحصول على إذن من "codesign" لتوقيع التطبيق.

3. في Xcode، افتح نافذة Devices and Simulators (command-shift-2).

4. تأكَّد من أنّ جهازك متصل. ستظهر لك قائمة بالتطبيقات المثبّتة. اضغط على الزر "+" أسفل القائمة، واختَر ملف .ipa الذي أنشأته شركة Bazel.

5. يمكنك الآن تشغيل التطبيق على جهازك.