ติดตั้งและกำหนดค่า 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 ให้ทำดังนี้

  1. เมื่อโปรเจ็กต์เปิดอยู่ ให้คลิกเครื่องมือ > SDK Manager

  2. คลิกแท็บเครื่องมือ SDK

  3. เลือกช่องทำเครื่องหมาย NDK (แสดงคู่กัน) และ CMake

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

  4. คลิกตกลง

    กล่องโต้ตอบจะบอกให้คุณทราบถึงพื้นที่ที่แพ็กเกจ NDK ใช้บนดิสก์

  5. คลิกตกลง

  6. เมื่อติดตั้งเสร็จแล้ว ให้คลิก Finish (เสร็จสิ้น)

  7. โปรเจ็กต์จะซิงค์ไฟล์บิลด์โดยอัตโนมัติและสร้างบิลด์ แก้ไขข้อผิดพลาดที่เกิดขึ้น

กำหนดค่า 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 โปรดทำตามขั้นตอนต่อไปนี้

  1. ดาวน์โหลดและติดตั้ง CMake จากเว็บไซต์อย่างเป็นทางการของ CMake
  2. ระบุเวอร์ชัน CMake ที่คุณต้องการให้ Gradle ใช้ในโมดูลของคุณ build.gradle ไฟล์

  3. เพิ่มเส้นทางไปยังการติดตั้ง 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>

  4. หากคุณยังไม่ได้ติดตั้งระบบบิลด์นินจาบน ให้ไปที่เว็บไซต์อย่างเป็นทางการของ Ninja และดาวน์โหลดและติดตั้ง Ninja เวอร์ชันล่าสุดสำหรับระบบปฏิบัติการของคุณ ตรวจสอบว่าได้เพิ่มเส้นทางการติดตั้งนินจาลงใน ตัวแปรสภาพแวดล้อม PATH

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

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

  1. เมื่อโปรเจ็กต์เปิดอยู่ ให้คลิกเครื่องมือ > SDK Manager

  2. คลิกแท็บเครื่องมือ SDK

  3. เลือกช่องทำเครื่องหมายแสดงรายละเอียดแพ็กเกจ

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

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

  5. คลิกตกลง

    กล่องโต้ตอบจะบอกคุณว่าแพ็กเกจ NDK ใช้พื้นที่เท่าใด

  6. คลิกตกลง

  7. เมื่อติดตั้งเสร็จแล้ว ให้คลิก Finish (เสร็จสิ้น)

  8. โปรเจ็กต์จะซิงค์ไฟล์บิลด์โดยอัตโนมัติและสร้างบิลด์ แก้ไขข้อผิดพลาดที่เกิดขึ้น

  9. กำหนดค่าแต่ละโมดูลด้วยเวอร์ชันของ 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