ไลบรารี 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 ที่สร้างโดยบิลด์ของคุณ และแต่ละไลบรารีจะส่งออกส่วนหัวจากไดเรกทอรีที่ระบุไปยังทรัพยากรที่ขึ้นต่อกัน