MediaPipe에서는 Android 스튜디오를 통해 Android SDK 및 NDK를 설정하는 것이 좋습니다 (Android 스튜디오 설정은 아래 참고). 하지만 Android 스튜디오 없이 MediaPipe를 사용하려면 Android 예시 앱을 빌드하기 전에 setup_android_sdk_and_ndk.sh를 실행하여 Android SDK와 NDK를 다운로드하고 설정하세요.
Android SDK와 NDK가 이미 설치되어 있는 경우 (예: Android 스튜디오에 의해) 설치된 SDK와 NDK를 가리키도록 $ANDROID_HOME와 $ANDROID_NDK_HOME를 설정합니다.
이전 Android 버전에서 프레임워크를 사용하려면 MediaPipe가 더 낮은 Android API 수준으로 전환해야 합니다. WORKSPACE 파일의 android_ndk_repository() 또는 android_sdk_repository()에서 api_level =
$YOUR_INTENDED_API_LEVEL를 지정하면 됩니다.
Android 예시 앱을 빌드하려면 해당 android_binary 빌드 타겟에 대해 빌드하세요. 예를 들어 MediaPipe Hands의 경우 타겟은 BUILD 파일의 handtrackinggpu입니다.
[[["이해하기 쉬움","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(UTC)"],[],[],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"]]
