เพิ่มโค้ด C และ C++ ในโปรเจ็กต์

เพิ่มโค้ด C และ C++ ลงในโปรเจ็กต์ Android โดยวางโค้ดลงในไดเรกทอรี cpp ในโมดูลโปรเจ็กต์ เมื่อคุณสร้างโปรเจ็กต์ โค้ดนี้จะได้รับการคอมไพล์เป็นไลบรารีแบบเนทีฟที่ Gradle สามารถแพ็กเกจกับแอปของคุณได้ จากนั้นโค้ด Java หรือ Kotlin จะเรียกใช้ฟังก์ชันในไลบรารีแบบเนทีฟผ่าน Java Native Interface (JNI) ได้ ดูข้อมูลเพิ่มเติมเกี่ยวกับการใช้เฟรมเวิร์ก JNI ได้ที่เคล็ดลับ JNI สำหรับ Android

Android Studio รองรับ CMake ซึ่งมีประโยชน์สำหรับโปรเจ็กต์ข้ามแพลตฟอร์ม นอกจากนี้ Android Studio ยังรองรับ ndk-build ซึ่งอาจเร็วกว่า CMake แต่รองรับเฉพาะ Android เท่านั้น ขณะนี้ระบบยังไม่รองรับการใช้ทั้ง CMake และ ndk-build ในโมดูลเดียวกัน

หากต้องการนำเข้าไลบรารี ndk-build ที่มีอยู่ไปยังโปรเจ็กต์ Android Studio ให้ดูวิธีลิงก์ Gradle กับโปรเจ็กต์ไลบรารีแบบเนทีฟ

หน้านี้แสดงวิธีตั้งค่า Android Studio ด้วยเครื่องมือสร้างที่จำเป็น สร้างโปรเจ็กต์ใหม่ที่รองรับ C/C++ และเพิ่มไฟล์ C/C++ ใหม่ลงในโปรเจ็กต์

หากต้องการเพิ่มโค้ดแบบเนทีฟลงในโปรเจ็กต์ที่มีอยู่ ให้ทำตามขั้นตอนต่อไปนี้แทน

  1. สร้างไฟล์ต้นฉบับแบบเนทีฟใหม่และเพิ่มไฟล์ลงในโปรเจ็กต์ Android Studio
    • ข้ามขั้นตอนนี้หากคุณมีโค้ดแบบเนทีฟอยู่แล้วหรือต้องการนำเข้าไลบรารีแบบเนทีฟที่สร้างไว้ล่วงหน้า
  2. กำหนดค่า CMake เพื่อสร้างซอร์สโค้ดแบบเนทีฟเป็นไลบรารี สคริปต์บิลด์นี้จำเป็นหากคุณนำเข้าและลิงก์กับไลบรารีที่สร้างไว้ล่วงหน้าหรือไลบรารีแพลตฟอร์ม
    • หากคุณมีไลบรารีแบบเนทีฟอยู่แล้วซึ่งมีสคริปต์บิลด์ CMakeLists.txt หรือใช้ ndk-build และมีสคริปต์บิลด์ Android.mk ให้ข้ามขั้นตอนนี้
  3. กำหนดค่า Gradle โดยระบุเส้นทางไปยัง CMake หรือไฟล์สคริปต์ ndk-build Gradle จะใช้สคริปต์บิลด์เพื่อนำเข้าซอร์สโค้ดไปยังโปรเจ็กต์ Android Studio และแพ็กเกจไลบรารีแบบเนทีฟลงในแอป

เมื่อกำหนดค่าโปรเจ็กต์แล้ว ให้เข้าถึงฟังก์ชันเนทีฟจากโค้ด Java หรือ Kotlin โดยใช้เฟรมเวิร์ก JNI หากต้องการสร้างและเรียกใช้แอป ให้คลิกเรียกใช้ เรียกใช้ แล้วเรียกใช้แอปจากแถบเมนู

หมายเหตุ: หากโปรเจ็กต์ที่มีอยู่ใช้เครื่องมือ ndkCompile ที่เลิกใช้งานแล้ว ให้ย้ายข้อมูลไปใช้ CMake หรือ ndk-build

ดาวน์โหลด NDK และเครื่องมือสร้าง

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

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

ดูข้อมูลเกี่ยวกับการติดตั้งคอมโพเนนต์เหล่านี้ได้ที่ติดตั้งและกำหนดค่า NDK และ CMake

สร้างโปรเจ็กต์ใหม่ที่รองรับ C/C++

หากต้องการสร้างโปรเจ็กต์ใหม่ที่รองรับโค้ดแบบเนทีฟ กระบวนการจะคล้ายกับการสร้างโปรเจ็กต์ Android Studio อื่นๆ แต่มีขั้นตอนเพิ่มเติมดังนี้

  1. ในส่วนเลือกโปรเจ็กต์ของวิซาร์ด ให้เลือกประเภทโปรเจ็กต์ Native C++
  2. คลิกถัดไป
  3. กรอกข้อมูลในช่องอื่นๆ ทั้งหมดในส่วนถัดไปของวิซาร์ด
  4. คลิกถัดไป
  5. ในส่วนปรับแต่งการรองรับ C++ ของวิซาร์ด คุณสามารถปรับแต่งโปรเจ็กต์ด้วยช่อง C++ Standard ได้
    • ใช้รายการแบบเลื่อนลงเพื่อเลือกมาตรฐาน C++ ที่ต้องการใช้ การเลือกค่าเริ่มต้นของ Toolchain จะใช้การตั้งค่า CMake เริ่มต้น
  6. คลิกเสร็จสิ้น

หลังจาก Android Studio สร้างโปรเจ็กต์ใหม่เสร็จแล้ว ให้เปิดแผงโปรเจ็กต์จากด้านซ้ายของ IDE แล้วเลือกมุมมอง Android จากเมนู ดังที่แสดงในรูปที่ 1 Android Studio จะเพิ่มกลุ่ม cpp

รูปที่ 1 Android จะดูกลุ่มสำหรับแหล่งที่มาแบบเนทีฟและสคริปต์บิลด์ภายนอก

หมายเหตุ: มุมมองนี้ไม่ได้แสดงลำดับชั้นของไฟล์จริงในดิสก์ แต่จะจัดกลุ่มไฟล์ที่คล้ายกันเพื่อลดความซับซ้อนในการไปยังส่วนต่างๆ ของโปรเจ็กต์

กลุ่ม cpp คือที่ที่คุณจะพบไฟล์ต้นฉบับแบบเนทีฟ ส่วนหัว สคริปต์บิลด์สำหรับ CMake หรือ ndk-build และไลบรารีที่สร้างไว้ล่วงหน้าซึ่งเป็นส่วนหนึ่งของโปรเจ็กต์ สำหรับโปรเจ็กต์ใหม่ Android Studio จะสร้างไฟล์ต้นฉบับ C++ ตัวอย่างชื่อ native-lib.cpp และวางไว้ในไดเรกทอรี src/main/cpp/ ของโมดูลแอป โค้ดตัวอย่างนี้มีฟังก์ชัน C++ แบบง่าย stringFromJNI() ซึ่งจะแสดงผลสตริง "Hello from C++" ดูวิธีเพิ่มไฟล์ต้นฉบับอื่นๆ ลงในโปรเจ็กต์ได้ในส่วนเกี่ยวกับวิธีสร้างไฟล์ต้นฉบับแบบเนทีฟใหม่

CMake และ ndk-build ต้องใช้สคริปต์บิลด์เพื่อให้ทราบวิธีสร้างไลบรารีแบบเนทีฟ เช่นเดียวกับที่ไฟล์ build.gradle จะสั่งให้ Gradle สร้างแอป สำหรับโปรเจ็กต์ใหม่ Android Studio จะสร้างสคริปต์บิลด์ CMake CMakeLists.txt และวางไว้ในไดเรกทอรีรากของโมดูล ดูข้อมูลเพิ่มเติมเกี่ยวกับเนื้อหาของสคริปต์บิลด์นี้ได้ที่กำหนดค่า CMake

สร้างและเรียกใช้แอปตัวอย่าง

เมื่อคลิกเรียกใช้ เรียกใช้ แล้วเรียกใช้แอปจากแถบเมนู Android Studio จะสร้างและเปิดแอปที่แสดงข้อความ "Hello from C++" ในอุปกรณ์ Android หรือโปรแกรมจำลอง ภาพรวมต่อไปนี้อธิบายเหตุการณ์ที่เกิดขึ้นเพื่อสร้างและเรียกใช้แอปตัวอย่าง

  1. Gradle จะเรียกใช้สคริปต์บิลด์ภายนอก CMakeLists.txt
  2. CMake จะทำตามคำสั่งในสคริปต์บิลด์เพื่อคอมไพล์ไฟล์ซอร์สโค้ด C++ native-lib.cpp เป็นไลบรารีออบเจ็กต์ที่ใช้ร่วมกันและตั้งชื่อว่า libnative-lib.so จากนั้น Gradle จะรวมไฟล์ดังกล่าวไว้ในแอป
  3. ในระหว่างรันไทม์ MainActivity ของแอปจะโหลดไลบรารีแบบเนทีฟโดยใช้ System.loadLibrary() ตอนนี้แอปสามารถใช้ฟังก์ชันเนทีฟของไลบรารี stringFromJNI() ได้แล้ว
  4. MainActivity.onCreate() เรียกใช้ stringFromJNI() ซึ่งจะแสดงผล "Hello from C++" และใช้เพื่ออัปเดต TextView

หากต้องการยืนยันว่า Gradle จัดแพ็กเกจไลบรารีแบบเนทีฟในแอป ให้ใช้ตัววิเคราะห์ APK โดยทำดังนี้

  1. เลือก Build > Build Bundles(s) / APK(s) > Build APK(s)
  2. เลือก Build > Analyze APK
  3. เลือก APK หรือ AAB จากไดเรกทอรี app/build/outputs/ แล้วคลิกตกลง
  4. ดังที่แสดงในรูปที่ 2 คุณจะเห็น libnative-lib.so ในหน้าต่างตัววิเคราะห์ APK ในส่วน lib/<ABI>/

    รูปที่ 2 ค้นหาไลบรารีแบบเนทีฟโดยใช้ตัววิเคราะห์ APK

เคล็ดลับ: หากต้องการทดสอบกับแอป Android อื่นๆ ที่ใช้โค้ดแบบเนทีฟ ให้คลิกไฟล์ > ใหม่ > นำเข้าตัวอย่าง แล้วเลือกโปรเจ็กต์ตัวอย่างจากรายการ Ndk

สร้างไฟล์ต้นฉบับ C/C++ ใหม่

หากต้องการเพิ่มไฟล์ต้นฉบับ C/C++ ใหม่ลงในโปรเจ็กต์ที่มีอยู่ ให้ทำดังนี้

  1. หากยังไม่มีไดเรกทอรี cpp/ ในชุดซอร์สหลักของแอป ให้สร้างไดเรกทอรีโดยทำดังนี้
    1. เปิดแผงโปรเจ็กต์ทางด้านซ้ายของ IDE แล้วเลือกมุมมองโปรเจ็กต์จากเมนู
    2. ไปที่ your-module > src
    3. คลิกขวาที่ไดเรกทอรี main แล้วเลือก New > Directory
    4. ป้อน cpp เป็นชื่อไดเรกทอรี แล้วคลิกตกลง

  2. คลิกขวาที่ไดเรกทอรี cpp/ แล้วเลือกใหม่ > ไฟล์ต้นฉบับ C/C++
  3. ป้อนชื่อไฟล์ต้นฉบับ เช่น native-lib
  4. จากเมนูประเภท ให้เลือกนามสกุลไฟล์สำหรับไฟล์ต้นฉบับ เช่น .cpp
    • คลิกแก้ไขประเภทไฟล์ เพื่อเพิ่มประเภทไฟล์อื่นๆ ลงในเมนู เช่น .cxx หรือ .hxx ในกล่องโต้ตอบนามสกุลไฟล์ใหม่ที่ปรากฏขึ้น ให้เลือกนามสกุลไฟล์อื่นจากเมนูนามสกุลไฟล์ต้นฉบับและนามสกุลไฟล์ส่วนหัว แล้วคลิกตกลง
  5. หากต้องการสร้างไฟล์ส่วนหัว ให้เลือกช่องทำเครื่องหมายสร้างส่วนหัวที่เชื่อมโยง
  6. คลิกตกลง

หลังจากเพิ่มไฟล์ C/C++ ใหม่ลงในโปรเจ็กต์แล้ว คุณยังคงต้องกำหนดค่า CMake เพื่อรวมไฟล์ไว้ในไลบรารีแบบเนทีฟ