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

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

إنشاء أمثلة على تطبيقات Android باستخدام Bazel

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

  • ثبِّت إطار عمل MediaPipe باتّباع هذه التعليمات.
  • إعداد بيئة وقت تشغيل Java
  • إعداد الإصدار 35.0.0 أو إصدار أحدث من حزمة تطوير البرامج (SDK) لنظام التشغيل Android
  • إعداد الإصدار 28 أو إصدار أحدث من حزمة تطوير البرامج الأصلية (NDK) لنظام التشغيل Android

تنصح MediaPipe بإعداد حزمة تطوير البرامج (SDK) وNDK لنظام التشغيل Android من خلال "استوديو Android" (يمكنك الاطّلاع على الخطوات أدناه). ومع ذلك، إذا كنت تفضّل استخدام MediaPipe بدون Android Studio، يُرجى تنفيذ الأمر setup_android_sdk_and_ndk.sh لتنزيل حزمة تطوير البرامج (SDK) وNDK لنظام التشغيل Android وإعدادهما قبل إنشاء أي تطبيقات نموذجية لنظام التشغيل Android.

إذا كانت حزمة تطوير البرامج (SDK) وNDK لنظام التشغيل Android مثبّتتَين من قبل (على سبيل المثال، من خلال "استوديو Android")، اضبط $ANDROID_HOME و$ANDROID_NDK_HOME للإشارة إلى حزمة تطوير البرامج (SDK) وNDK المثبّتتَين.

export ANDROID_HOME=<path to the Android SDK>
export ANDROID_NDK_HOME=<path to the Android NDK>

وأضِف قواعد android_ndk_repository() وandroid_sdk_repository() وbind() إلى ملف WORKSPACE كما يلي:

$ echo "android_sdk_repository(name = \"androidsdk\")" >> WORKSPACE
$ echo "android_ndk_repository(name = \"androidndk\", api_level=26)" >> WORKSPACE
$ echo "bind(name = \"android/crosstool\", actual = \"@androidndk//:toolchain\")" >> WORKSPACE

لاستخدام Framework على إصدارات Android السابقة، يجب أن تنتقل MediaPipe إلى مستوى أدنى من واجهة برمجة تطبيقات Android. يمكنك تحقيق ذلك من خلال تحديد api_level = $YOUR_INTENDED_API_LEVEL في android_ndk_repository() و/أو android_sdk_repository() في ملف WORKSPACE.

  1. لإنشاء تطبيق مثال على Android، يجب إنشاء التطبيق استنادًا إلى android_binary هدف الإنشاء المناسب. على سبيل المثال، بالنسبة إلى MediaPipe Hands، يكون الهدف handtrackinggpu في ملف BUILD:

    bazel build -c opt --config=android_arm64 mediapipe/examples/android/src/java/com/google/mediapipe/apps/handtrackinggpu:handtrackinggpu

  2. يجب تثبيته على جهاز يتضمّن ما يلي:

    adb install bazel-bin/mediapipe/examples/android/src/java/com/google/mediapipe/apps/handtrackinggpu/handtrackinggpu.apk