ทรัพยากร Dependency ของระบบที่มีปลั๊กอิน Android Gradle

ไลบรารี AAR อาจมีทรัพยากร Dependency แบบเนทีฟที่ปลั๊กอิน Android Gradle สามารถใช้ได้ AGP ยังสามารถสร้าง AAR ที่แสดงไลบรารีแบบเนทีฟต่อผู้ใช้ได้ด้วย

การใช้ทรัพยากร Dependency แบบเนทีฟ

ตั้งแต่ปลั๊กอิน Android Gradle 4.0 เป็นต้นไป คุณสามารถนำเข้าทรัพยากร Dependency ของ C/C++ จาก AAR ที่ลิงก์ในไฟล์ build.gradle ได้ Gradle จะทำให้ไลบรารีและส่วนหัวเหล่านี้พร้อมใช้งานสำหรับระบบบิลด์แบบเนทีฟโดยอัตโนมัติ แต่คุณต้องกำหนดค่าระบบบิลด์เพื่อใช้ไลบรารีและส่วนหัวที่นำเข้า เนื่องจากทรัพยากร Dependency ของ C/C++ มีการเผยแพร่เป็น AAR ลิงก์ต่อไปนี้เกี่ยวกับ AAR ทั่วไปอาจเป็นประโยชน์

  • การสร้างไลบรารี Android สำหรับเอกสารประกอบ AAR ทั่วไปและวิธีผสานรวมเข้ากับโปรเจ็กต์ โดยเฉพาะเมื่อคุณต้องการใช้ AAR เป็นทรัพยากร Dependency ของ C/C++ ในเครื่อง
  • เพิ่มทรัพยากร Dependency ของบิลด์เพื่อดูข้อมูลเกี่ยวกับการเพิ่มทรัพยากร Dependency ลงในไฟล์ build.gradle โดยเฉพาะทรัพยากร Dependency ระยะไกล

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

ทรัพยากร Dependency แบบเนทีฟใน AAR

ทรัพยากร Dependency ของ AAR ของโมดูล Gradle สามารถแสดงไลบรารีแบบเนทีฟเพื่อให้แอปพลิเคชันของคุณใช้ได้ ภายใน AAR ไดเรกทอรี prefab จะมีแพ็กเกจ Prefab ซึ่งรวมถึงส่วนหัวและไลบรารีของทรัพยากร Dependency แบบเนทีฟ

ทรัพยากร Dependency แต่ละรายการจะแสดงแพ็กเกจ Prefab ได้สูงสุด 1 รายการ ซึ่งประกอบด้วยโมดูลอย่างน้อย 1 รายการ โมเดล Prefab เป็นไลบรารีเดียว ซึ่งอาจเป็นไลบรารีที่ใช้ร่วมกัน ไลบรารีแบบคงที่ หรือไลบรารีส่วนหัวเท่านั้นก็ได้

คุณต้องทราบชื่อแพ็กเกจและโมดูลเพื่อใช้ไลบรารี ตามแบบแผน ชื่อแพ็กเกจจะตรงกับชื่ออาร์ติแฟกต์ Maven และชื่อโมดูลจะตรงกับชื่อไลบรารี C/C++ แต่ไม่จำเป็นต้องเป็นเช่นนั้น โปรดดูเอกสารประกอบของทรัพยากร Dependency เพื่อดูชื่อที่ใช้

การกำหนดค่าระบบบิลด์

ต้องเปิดใช้ฟีเจอร์ prefab สำหรับโมดูล Android Gradle

โดยเพิ่มโค้ดต่อไปนี้ลงในบล็อก android ของไฟล์ build.gradle ของโมดูล

Kotlin

buildFeatures {
  prefab = true
}

ดึงดูด

buildFeatures {
  prefab true
}

กำหนดค่าเวอร์ชันในไฟล์ gradle.properties ของโปรเจ็กต์ (ไม่บังคับ) โดยทำดังนี้

android.prefabVersion=2.0.0

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

ระบบจะแสดงทรัพยากร Dependency ที่นำเข้าจาก AAR ต่อ CMake ผ่าน CMAKE_FIND_ROOT_PATH Gradle จะตั้งค่านี้โดยอัตโนมัติเมื่อเรียกใช้ CMake ดังนั้นหากบิลด์ของคุณแก้ไขตัวแปรนี้ โปรดตรวจสอบว่าได้ต่อท้ายแทนที่จะกำหนดค่าให้กับตัวแปร

ทรัพยากร Dependency แต่ละรายการจะแสดงแพ็กเกจไฟล์การกำหนดค่าต่อบิลด์ของคุณ โดยจะนำเข้าด้วยคำสั่ง find_package คำสั่งนี้จะค้นหาแพ็กเกจ config-file ที่ตรงกับชื่อและเวอร์ชันของแพ็กเกจที่ระบุ และแสดงเป้าหมายที่กำหนดไว้เพื่อใช้ในบิลด์ ตัวอย่างเช่น หากแอปพลิเคชันของคุณกำหนด libapp.so และใช้ curl CMakeLists.txt ควรมีข้อมูลต่อไปนี้

add_library(app SHARED app.cpp)

# Add these two lines.
find_package(curl REQUIRED CONFIG)
target_link_libraries(app curl::curl)

ตอนนี้ app.cpp สามารถ #include "curl/curl.h" ได้แล้ว libapp.so จะลิงก์กับ libcurl.so โดยอัตโนมัติเมื่อสร้าง และ libcurl.so จะรวมอยู่ในแอป

การเผยแพร่ไลบรารีแบบเนทีฟใน AAR

ความสามารถในการสร้าง AAR แบบเนทีฟได้รับการเพิ่มเป็นครั้งแรกใน AGP 4.1

หากต้องการส่งออกไลบรารีแบบเนทีฟ ให้เพิ่มโค้ดต่อไปนี้ลงในบล็อก android ของไฟล์ build.gradle.kts ของโปรเจ็กต์ไลบรารี

Kotlin

buildFeatures {
    prefabPublishing = true
}

prefab {
    create("mylibrary") {
      headers = "src/main/cpp/mylibrary/include"
    }

    create("myotherlibrary") {
        headers = "src/main/cpp/myotherlibrary/include"
    }
}

ดึงดูด

buildFeatures {
    prefabPublishing true
}

prefab {
    mylibrary {
      headers "src/main/cpp/mylibrary/include"
    }

    myotherlibrary {
        headers "src/main/cpp/myotherlibrary/include"
    }
}

ในตัวอย่างนี้ ไลบรารี mylibrary และ myotherlibrary จากบิลด์เนทีฟภายนอก ndk-build หรือ CMake จะได้รับการแพ็กเกจใน AAR ที่สร้างโดยบิลด์ของคุณ และแต่ละไลบรารีจะส่งออกส่วนหัวจากไดเรกทอรีที่ระบุไปยังทรัพยากรที่ขึ้นต่อกัน