หน้านี้ได้รับการแปลโดย Cloud Translation API

ติดตั้งและกำหนดค่า NDK และ CMake

คุณต้องมีคอมโพเนนต์ต่อไปนี้เพื่อรวบรวมและแก้ไขข้อบกพร่องของโค้ดเนทีฟสำหรับแอป

Android Native Development Kit (NDK): ชุดเครื่องมือที่ช่วยให้คุณสามารถ ใช้โค้ด C และ C++ กับ Android
CMake: เครื่องมือสร้างภายนอกที่ทำงานร่วมกับ Gradle เพื่อสร้างโฆษณาเนทีฟ ไลบรารี คุณไม่จำเป็นต้องใช้คอมโพเนนต์นี้หากคุณวางแผนที่จะใช้ ndk-build เท่านั้น
LLDB: โปรแกรมแก้ไขข้อบกพร่องที่ Android Studio ใช้เพื่อแก้ไขข้อบกพร่องของโค้ดแบบเนทีฟ โดยค่าเริ่มต้น LLDB จะติดตั้งคู่กับ Android Studio ด้วย

หน้านี้จะอธิบายวิธีติดตั้งคอมโพเนนต์เหล่านี้โดยอัตโนมัติ หรือโดยใช้ Android Studio หรือเครื่องมือ sdkmanager เพื่อดาวน์โหลดและติดตั้งด้วยตนเอง

ติดตั้ง NDK และ CMake โดยอัตโนมัติ

ปลั๊กอิน Android Gradle 4.2.0 ขึ้นไปสามารถติดตั้ง NDK และ CMake ที่จำเป็นโดยอัตโนมัติ ครั้งแรกที่คุณสร้างโปรเจ็กต์ในกรณีที่ใบอนุญาตได้รับการยอมรับล่วงหน้า หากคุณอ่านและยอมรับข้อกำหนดในใบอนุญาตแล้ว คุณสามารถยอมรับล่วงหน้า ใบอนุญาตในสคริปต์ด้วยคำสั่งต่อไปนี้:

   yes | ${sdk}/cmdline-tools/latest/bin/sdkmanager --licenses

ติดตั้ง NDK และ CMake

เมื่อคุณติดตั้ง NDK แล้ว Android Studio จะเลือก NDK ล่าสุดที่มี สำหรับ ส่วนใหญ่แล้ว การติดตั้ง NDK เวอร์ชันเริ่มต้นนี้ก็เพียงพอแล้ว หากโครงการของคุณต้องการ NDK เวอร์ชันที่เฉพาะเจาะจงอย่างน้อย 1 เวอร์ชัน คุณสามารถ ดาวน์โหลดและกำหนดค่าเวอร์ชันเฉพาะ การทำเช่นนี้มีประโยชน์ คุณตรวจสอบว่าบิลด์ที่ทำซ้ำได้ในโปรเจ็กต์ต่างๆ ซึ่งแต่ละรายการต้องใช้ ของ NDK Android Studio ติดตั้ง NDK ทุกเวอร์ชันใน ไดเรกทอรี android-sdk/ndk/

หากต้องการติดตั้ง CMake และ NDK เริ่มต้นใน Android Studio ให้ทำดังนี้

เมื่อโปรเจ็กต์เปิดอยู่ ให้คลิกเครื่องมือ > SDK Manager
คลิกแท็บเครื่องมือ SDK
เลือกช่องทำเครื่องหมาย NDK (แสดงคู่กัน) และ CMake

รูปที่ 1 หน้าต่างเครื่องมือ SDK ที่แสดง NDK (แสดงคู่กัน) ตัวเลือก

หมายเหตุ: หากคุณติดตั้ง NDK ไว้ในโฟลเดอร์ ndk-bundle ไฟล์จะปรากฏในโฟลเดอร์ ให้รายการที่มีป้ายกำกับว่า NDK หากใช้ปลั๊กอิน Android Gradle 3.5.0 หรือหลังจากนั้น คุณสามารถเลือกช่องทำเครื่องหมายนี้หรือล้างช่องทำเครื่องหมายได้ การล้างช่องทำเครื่องหมาย ถอนการติดตั้ง NDK เพิ่มเนื้อที่ว่างในดิสก์ และทำให้ช่องทำเครื่องหมาย ให้หายไปจากรายการ หากคุณถอนการติดตั้ง NDK เดิม ให้นำ ค่า ndk.dir ซึ่งเลิกใช้งานแล้วจากโปรเจ็กต์ของคุณ local.properties ไฟล์
คลิกตกลง

กล่องโต้ตอบจะบอกให้คุณทราบถึงพื้นที่ที่แพ็กเกจ NDK ใช้บนดิสก์
คลิกตกลง
เมื่อติดตั้งเสร็จแล้ว ให้คลิก Finish (เสร็จสิ้น)
โปรเจ็กต์จะซิงค์ไฟล์บิลด์โดยอัตโนมัติและสร้างบิลด์ แก้ไขข้อผิดพลาดที่เกิดขึ้น

กำหนดค่า CMake เวอร์ชันที่ต้องการ

SDK Manager มีเวอร์ชัน 3.6.0 สำหรับ Fork CMake และเวอร์ชัน 3.10.2 โปรเจ็กต์ที่ไม่ได้ตั้งค่า CMake เวอร์ชันเฉพาะนั้นสร้างด้วย CMake 3.10.2 ถึง ตั้งค่าเวอร์ชัน CMake เพิ่มค่าต่อไปนี้ลงในไฟล์ build.gradle ของโมดูล:

ดึงดูด

android {
    ...
    externalNativeBuild {
        cmake {
            ...
            version "cmake-version"
        }
    }
}

Kotlin

android {
    ...
    externalNativeBuild {
        cmake {
            ...
            version = "cmake-version"
        }
    }
}

หากคุณต้องการใช้เวอร์ชัน CMake ที่ไม่รวมอยู่ใน SDK Manager โปรดทำตามขั้นตอนต่อไปนี้

ดาวน์โหลดและติดตั้ง CMake จากเว็บไซต์อย่างเป็นทางการของ CMake
ระบุเวอร์ชัน CMake ที่คุณต้องการให้ Gradle ใช้ในโมดูลของคุณ build.gradle ไฟล์
เพิ่มเส้นทางไปยังการติดตั้ง CMake ลงในสภาพแวดล้อม PATH หรือรวมไว้ในไฟล์ local.properties ของโครงการ เช่น แสดงอยู่ หาก Gradle ไม่พบเวอร์ชันของ CMake ที่คุณระบุใน ไฟล์ build.gradle คุณได้รับข้อผิดพลาดเกี่ยวกับเวอร์ชัน
```
# If you set this property, Gradle no longer uses PATH to find CMake.
cmake.dir = "path-to-cmake"</pre>
```
หากคุณยังไม่ได้ติดตั้งระบบบิลด์นินจาบน ให้ไปที่เว็บไซต์อย่างเป็นทางการของ Ninja และดาวน์โหลดและติดตั้ง Ninja เวอร์ชันล่าสุดสำหรับระบบปฏิบัติการของคุณ ตรวจสอบว่าได้เพิ่มเส้นทางการติดตั้งนินจาลงใน ตัวแปรสภาพแวดล้อม PATH

ติดตั้ง NDK เวอร์ชันที่ต้องการ

หากต้องการติดตั้ง NDK เวอร์ชันที่ต้องการ ให้ทำดังนี้

เมื่อโปรเจ็กต์เปิดอยู่ ให้คลิกเครื่องมือ > SDK Manager
คลิกแท็บเครื่องมือ SDK
เลือกช่องทำเครื่องหมายแสดงรายละเอียดแพ็กเกจ
เลือกช่องทำเครื่องหมาย NDK (แสดงข้างกัน) และช่องทำเครื่องหมายด้านล่าง สอดคล้องกับเวอร์ชัน NDK ที่คุณต้องการติดตั้ง การติดตั้ง Android Studio NDK ทุกเวอร์ชันในandroid-sdk/ndk/ ไดเรกทอรี

หมายเหตุ: เวอร์ชันตัวอย่าง (เช่น เวอร์ชัน Canary และเวอร์ชันเบต้า) ของ NDK จะไม่แสดงในรายการนี้ เว้นแต่คุณจะ เปลี่ยนเวอร์ชันการอัปเดต สำหรับ Android Studio คุณติดตั้งตัวอย่าง Android Studio ได้ ไปพร้อมกันกับเวอร์ชันเสถียร

รูปที่ 2 หน้าต่างเครื่องมือ SDK ที่แสดง NDK (แสดงคู่กัน) ตัวเลือก

หมายเหตุ: หากคุณติดตั้ง NDK ไว้ในโฟลเดอร์ ndk-bundle ไฟล์จะปรากฏในโฟลเดอร์ ให้รายการที่มีป้ายกำกับว่า NDK หากใช้ Gradle เวอร์ชัน 3.5 หรือ หลังจากนั้น คุณสามารถเลือกช่องทำเครื่องหมายนี้หรือล้างช่องทำเครื่องหมายได้ การล้างข้อมูลจะเป็นการถอนการติดตั้ง ติดตั้ง NDK แล้ว เพิ่มพื้นที่ว่างในดิสก์และทำให้ช่องทำเครื่องหมายหายไป จากรายการ หากคุณถอนการติดตั้ง NDK เดิม ให้นำค่า ndk.dir ออก ซึ่งตอนนี้เลิกใช้งานแล้วจากโปรเจ็กต์ของคุณ local.properties ไฟล์
คลิกตกลง

กล่องโต้ตอบจะบอกคุณว่าแพ็กเกจ NDK ใช้พื้นที่เท่าใด
คลิกตกลง
เมื่อติดตั้งเสร็จแล้ว ให้คลิก Finish (เสร็จสิ้น)
โปรเจ็กต์จะซิงค์ไฟล์บิลด์โดยอัตโนมัติและสร้างบิลด์ แก้ไขข้อผิดพลาดที่เกิดขึ้น
กำหนดค่าแต่ละโมดูลด้วยเวอร์ชันของ NDK ที่คุณต้องการใช้ เมื่อใช้ Android Studio 3.6 ขึ้นไป หากคุณไม่ได้ใช้งาน ระบุเวอร์ชัน ปลั๊กอิน Android Gradle จะเลือกเวอร์ชันที่ ที่ทราบว่าเข้ากันได้

กำหนดค่า NDK เวอร์ชันเฉพาะในโปรเจ็กต์ของคุณ

คุณอาจต้องกำหนดค่าเวอร์ชันของ NDK ในโปรเจ็กต์ของคุณ หากหนึ่งใน ต่อไปนี้เป็นจริง

รับค่าโปรเจ็กต์ของคุณมา และคุณต้องใช้ NDK เวอร์ชันที่เฉพาะเจาะจง และปลั๊กอิน Android Gradle (AGP) สำหรับข้อมูลเพิ่มเติม โปรดดู กำหนดค่า NDK สำหรับปลั๊กอิน Android Gradle
คุณได้ติดตั้ง NDK หลายเวอร์ชัน และคุณต้องการใช้ ข้อแรก ในกรณีนี้ ให้ระบุเวอร์ชันโดยใช้ android.ndkVersion ในไฟล์ build.gradle ของโมดูล ดังที่แสดงในโค้ดต่อไปนี้ ตัวอย่าง
ดึงดูด
android { ndkVersion "major.minor.build" // e.g., ndkVersion "21.3.6528147" }
Kotlin
android { ndkVersion = "major.minor.build" // e.g., ndkVersion "21.3.6528147" }

เวอร์ชัน NDK เริ่มต้นต่อเวอร์ชัน AGP

ก่อนเผยแพร่ AGP แต่ละเวอร์ชันได้รับการทดสอบอย่างละเอียดโดยใช้ NDK ล่าสุดที่เสถียร เผยแพร่ในเวลานั้น เวอร์ชัน NDK นี้ใช้ในการสร้างโครงการหากคุณ ไม่ระบุเวอร์ชัน NDK ในไฟล์ build.gradle เวอร์ชัน NDK เริ่มต้น สำหรับ AGP เวอร์ชันต่างๆ แสดงอยู่ใน บันทึกประจำรุ่นของ AGP และ บันทึกประจำรุ่นที่ผ่านมาของ AGP