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

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

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

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

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

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

   xcode-select --install
   

3. ثبِّت Bazelisk.

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

   brew install bazelisk
   

4. اضبط Python 3.7 كإصدار Python التلقائي وثبِّت لغة Python "six" المكتبة. هذا الإجراء مطلوب لبرنامج 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. في شريط تنقل المشروع في الشريط الجانبي الأيمن، حدد "Mediapi" (شريطي الوسائط) مشروعك.

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. يمكنك الآن تحديد أي من الإصدارات التجريبية لإطار Mediapiframe في القائمة المستهدفة، وإنشائها وتشغيلها كالمعتاد.

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

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. يمكنك الآن تشغيل التطبيق على جهازك.