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

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

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

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

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

4. คลิกตกลง

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

5. คลิกตกลง

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

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

กำหนดค่า CMake เวอร์ชันที่เฉพาะเจาะจง

เครื่องมือจัดการ SDK มี CMake เวอร์ชันแยกออกมา 3.6.0 และเวอร์ชัน 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 แล้วดาวน์โหลดและติดตั้ง Ninja เวอร์ชันล่าสุดที่ใช้ได้กับระบบปฏิบัติการของคุณ อย่าลืมเพิ่มเส้นทางไปยังการติดตั้ง Ninja ลงในตัวแปรสภาพแวดล้อม PATH ด้วย

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

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

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

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

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

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

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

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

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

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