يُرجى اتّباع التعليمات أدناه لإنشاء تطبيقات Android نموذجية باستخدام إطار عمل MediaPipe.
لمزيد من المعلومات حول هذه التطبيقات النموذجية، ابدأ من Hello World! على Android.
إعداد الإصدار 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 المثبّتتَين.
لاستخدام Framework على إصدارات Android السابقة، يجب أن تنتقل MediaPipe إلى مستوى أدنى من واجهة برمجة تطبيقات Android. يمكنك تحقيق ذلك من خلال تحديد api_level =
$YOUR_INTENDED_API_LEVEL في android_ndk_repository() و/أو android_sdk_repository() في ملف WORKSPACE.
لإنشاء تطبيق مثال على Android، يجب إنشاء التطبيق استنادًا إلى
android_binary هدف الإنشاء المناسب. على سبيل المثال، بالنسبة إلى MediaPipe Hands، يكون الهدف handtrackinggpu في ملف BUILD:
تاريخ التعديل الأخير: 2025-07-24 (حسب التوقيت العالمي المتفَّق عليه)
[[["يسهُل فهم المحتوى.","easyToUnderstand","thumb-up"],["ساعَدني المحتوى في حلّ مشكلتي.","solvedMyProblem","thumb-up"],["غير ذلك","otherUp","thumb-up"]],[["لا يحتوي على المعلومات التي أحتاج إليها.","missingTheInformationINeed","thumb-down"],["الخطوات معقدة للغاية / كثيرة جدًا.","tooComplicatedTooManySteps","thumb-down"],["المحتوى قديم.","outOfDate","thumb-down"],["ثمة مشكلة في الترجمة.","translationIssue","thumb-down"],["مشكلة في العيّنات / التعليمات البرمجية","samplesCodeIssue","thumb-down"],["غير ذلك","otherDown","thumb-down"]],["تاريخ التعديل الأخير: 2025-07-24 (حسب التوقيت العالمي المتفَّق عليه)"],[],[],null,["# MediaPipe Framework on Android\n\nPlease follow instructions below to build Android example apps with MediaPipe Framework.\nTo learn more about these example apps, start from [Hello World! on\nAndroid](./hello_world_android.md).\n\nBuilding Android example apps with Bazel\n----------------------------------------\n\n### Prerequisite\n\n- Install MediaPipe Framework following these [instructions](./install.md).\n- Setup Java Runtime.\n- Setup Android SDK release 35.0.0 or later.\n- Setup Android NDK version 28 or later.\n\nMediaPipe recommends setting up Android SDK and NDK via Android Studio (and see\nbelow for Android Studio setup). However, if you prefer using MediaPipe without\nAndroid Studio, please run\n[`setup_android_sdk_and_ndk.sh`](https://github.com/google/mediapipe/blob/master/setup_android_sdk_and_ndk.sh)\nto download and setup Android SDK and NDK before building any Android example\napps.\n\nIf Android SDK and NDK are already installed (e.g., by Android Studio), set\n`$ANDROID_HOME` and `$ANDROID_NDK_HOME` to point to the installed SDK and NDK. \n\n export ANDROID_HOME=\u003cpath to the Android SDK\u003e\n export ANDROID_NDK_HOME=\u003cpath to the Android NDK\u003e\n\nand add `android_ndk_repository()`, `android_sdk_repository()` and `bind()`\nrules into the\n[`WORKSPACE`](https://github.com/google/mediapipe/blob/master/WORKSPACE) file as\nthe following: \n\n $ echo \"android_sdk_repository(name = \\\"androidsdk\\\")\" \u003e\u003e WORKSPACE\n $ echo \"android_ndk_repository(name = \\\"androidndk\\\", api_level=26)\" \u003e\u003e WORKSPACE\n $ echo \"bind(name = \\\"android/crosstool\\\", actual = \\\"@androidndk//:toolchain\\\")\" \u003e\u003e WORKSPACE\n\nIn order to use Framework on earlier Android versions, MediaPipe needs to switch\nto a lower Android API level. You can achieve this by specifying `api_level =\n$YOUR_INTENDED_API_LEVEL` in android_ndk_repository() and/or\nandroid_sdk_repository() in the\n[`WORKSPACE`](https://github.com/google/mediapipe/blob/master/WORKSPACE) file.\n| **Tip:** You can run this [script](https://github.com/google/mediapipe/blob/master/build_android_examples.sh) to build (and install) all MediaPipe Android example apps.\n\n1. To build an Android example app, build against the corresponding\n `android_binary` build target. For instance, for MediaPipe Hands the target\n is `handtrackinggpu` in the\n [BUILD](https://github.com/google/mediapipe/tree/master/mediapipe/examples/android/src/java/com/google/mediapipe/apps/handtrackinggpu/BUILD)\n file:\n\n **Note:** To reduce the binary size, consider appending `--linkopt=\"-s\"` to the command below to strip symbols. \n\n bazel build -c opt --config=android_arm64 mediapipe/examples/android/src/java/com/google/mediapipe/apps/handtrackinggpu:handtrackinggpu\n\n2. Install it on a device with:\n\n adb install bazel-bin/mediapipe/examples/android/src/java/com/google/mediapipe/apps/handtrackinggpu/handtrackinggpu.apk"]]
