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

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

إنشاء أمثلة على تطبيقات iOS

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

1. ثبِّت Mediapipe Framework باتّباع هذه التعليمات.

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

   xcode-select --install
   

3. ثبِّت Bazelisk.

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

   brew install bazelisk
   

4. ثبِّت مكتبة 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 لإنشاءمشاريع IDE من إعدادات إنشاء 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. تتمتع هذه الملفات الشخصية بفترة صلاحية أطول ويمكنها targeting multiple devices، ولكنك تحتاج إلى حساب مطوّر مدفوع لدى Apple للحصول على ملف شخصي.

إدارة الحسابات التلقائية

1. أنشئ مشروع Xcode لاستخدام MediaPipe، كما هو موضّح في القسم السابق.

2. في "مستكشف المشاريع" في الشريط الجانبي الأيمن، اختَر مشروع Mediapipe.

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

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

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

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

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

يؤدي ذلك إلى إنشاء ملفات Provisioning Profile لكل تطبيق اخترته. الآن، عليك إخبار 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. يمكنك الآن اختيار أيّ من نماذج Mediapipe Framework التجريبية في القائمة المستهدَفة، وإنشاء هذه النماذج وتشغيلها كالمعتاد.

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

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 الذي أنشأه IDE Bazel.

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