Định cấu hình NDK cho trình bổ trợ Android cho Gradle
Sử dụng bộ sưu tập để sắp xếp ngăn nắp các trang
Lưu và phân loại nội dung dựa trên lựa chọn ưu tiên của bạn.
Trang này trình bày cách định cấu hình NDK trong dự án của bạn theo phiên bản trình bổ trợ Android cho Gradle (AGP) mà dự án sử dụng.
Các bước thực hiện sẽ còn tuỳ thuộc vào phiên bản AGP dùng trong dự án. Tìm phiên bản trình bổ trợ Android cho Gradle tại một trong hai nơi sau:
File (Tệp) > Project Structure (Cấu trúc dự án) > Project (Dự án) trong Android Studio
Tệp build.gradle cấp cao nhất trong dự án
Chọn phiên bản dưới đây:
AGP phiên bản 4.1 trở lên
Bạn có các cách sau đây để định cấu hình NDK:
(Nên dùng) Dùng thuộc tính ndkVersion để đặt giá trị cho phiên bản NDK.
Không đặt giá trị cho thuộc tính nào. Android Studio sẽ tự động tải phiên bản NDK mặc định cho phiên bản AGP cụ thể đó (trong trường hợp này là phiên bản NDK 21.0.6113669) hoặc bạn có thể cài đặt NDK qua dòng lệnh. Android Studio cài đặt tất cả phiên bản NDK trong thư mục android-sdk/ndk/. Mỗi phiên bản nằm trong một thư mục con có tên là số phiên bản.
Đối với các trường hợp sử dụng đặc biệt, hãy sử dụng thuộc tính ndkPath:
Groovy
android{ndkPath"/Users/ndkPath/ndk21"// Point to your own NDK}
Kotlin
android{ndkPath="/Users/ndkPath/ndk21"// Point to your own NDK}
Cài đặt NDK qua dòng lệnh
Để cài đặt NDK qua dòng lệnh, hãy làm như sau:
Dùng công cụ sdkmanager để xem các phiên bản của gói CMake và NDK hiện có. Tương tự như các thành phần SDK khác, NDK được phát hành thông qua nhiều kênh:
Nội dung và mã mẫu trên trang này phải tuân thủ các giấy phép như mô tả trong phần Giấy phép nội dung. Java và OpenJDK là nhãn hiệu hoặc nhãn hiệu đã đăng ký của Oracle và/hoặc đơn vị liên kết của Oracle.
Cập nhật lần gần đây nhất: 2025-07-27 UTC.
[[["Dễ hiểu","easyToUnderstand","thumb-up"],["Giúp tôi giải quyết được vấn đề","solvedMyProblem","thumb-up"],["Khác","otherUp","thumb-up"]],[["Thiếu thông tin tôi cần","missingTheInformationINeed","thumb-down"],["Quá phức tạp/quá nhiều bước","tooComplicatedTooManySteps","thumb-down"],["Đã lỗi thời","outOfDate","thumb-down"],["Vấn đề về bản dịch","translationIssue","thumb-down"],["Vấn đề về mẫu/mã","samplesCodeIssue","thumb-down"],["Khác","otherDown","thumb-down"]],["Cập nhật lần gần đây nhất: 2025-07-27 UTC."],[],[],null,["# Configure the NDK for the Android Gradle plugin\n\nThis page shows you how to configure the NDK in your project according to the\nversion of the Android Gradle Plugin (AGP) used by the project.\n| **Note:** If possible, you should try to update the version of AGP in your project to version 4.1 or later. These AGP versions will auto-download the NDK for you in Android Studio.\n\nThe steps vary according to the version of AGP used in the project. Find the\nAndroid Gradle Plugin version in either of the following locations:\n\n- **File \\\u003e Project Structure \\\u003e Project** menu in Android Studio\n- The top-level `build.gradle` file in the project\n\nSelect the version below: \nAGP 4.1+ AGP 4.0 AGP 3.6 AGP 3.5 AGP 3.4\n\nAGP version 4.1+\n----------------\n\nYou have the following options to configure the NDK:\n\n- (Recommended) Use the [`ndkVersion`](/studio/projects/install-ndk#apply-specific-version) property to set the NDK version.\n- Do not set any property. Android Studio will automatically download the [default version of the NDK for that specific AGP version](/studio/projects/install-ndk#default-ndk-per-agp) (in this case, NDK version 21.0.6113669) or you can [install the NDK from the command line](#command-line). Android Studio installs all versions of the NDK in the \u003cvar translate=\"no\"\u003eandroid-sdk\u003c/var\u003e`/ndk/` directory. Each version is located in a subdirectory with the version number as its name.\n- For special use cases, use the `ndkPath` property:\n\n ### Groovy\n\n ```groovy\n android {\n ndkPath \"/Users/ndkPath/ndk21\" // Point to your own NDK\n }\n ```\n\n ### Kotlin\n\n ```kotlin\n android {\n ndkPath = \"/Users/ndkPath/ndk21\" // Point to your own NDK\n }\n ```\n | **Note:** Remove this property before distributing your source code; it should be left outside of your version control system.\n\n### Install the NDK from the command line\n\nTo install the NDK from the command line, do the following:\n\n1. Use the `sdkmanager` tool to view versions of CMake and NDK packages that\n are available. Similar to other SDK components, the NDK is released through\n different channels:\n\n ```scdoc\n sdkmanager --list [--channel=channel_id] // NDK channels: 0 (stable),\n // 1 (beta), or 3 (canary)\n ```\n2. Pass the `sdkmanager` the strings for the packages that you want to install.\n For example, to install CMake or the NDK, use the following syntax:\n\n ```transact-sql\n sdkmanager --install\n [\"ndk;\u003cvar translate=\"no\"\u003emajor\u003c/var\u003e.\u003cvar translate=\"no\"\u003eminor\u003c/var\u003e.\u003cvar translate=\"no\"\u003ebuild\u003c/var\u003e[\u003cvar translate=\"no\"\u003esuffix\u003c/var\u003e]\" | \"cmake;major.minor.micro.build\"]\n [--channel=\u003cvar translate=\"no\"\u003echannel_id\u003c/var\u003e]\n ```\n\n Use the `--channel` option to only install a package if it has been released\n in a channel *up to and including* \u003cvar translate=\"no\"\u003echannel_id.\u003c/var\u003e\n\nFor more information, see [sdkmanager](/studio/command-line/sdkmanager)."]]
