ספריות AAR יכולות להכיל תלויות מקוריות שהפלאגין של Android Gradle יכול לצרוך. AGP יכול גם ליצור קובצי AAR שחושפים ספריות Native לצרכנים שלהן.
שימוש ביחסי תלות מקומיים
החל מגרסה 4.0 של הפלאגין של Android Gradle, אפשר לייבא יחסי תלות של C/C++ מקובצי AAR שמקושרים לקובץ build.gradle. Gradle יהפוך אותם באופן אוטומטי לזמינים למערכת ה-build המקורית, אבל צריך להגדיר את מערכת ה-build כך שתשתמש בספריות ובכותרות המיובאות. מכיוון שיחסי התלות של C/C++ מופצים כקובצי AAR, הקישורים הבאים לגבי קובצי AAR כלליים עשויים לעזור:
- יצירת ספריית Android למסמכי תיעוד כלליים של AAR, ואיך לשלב אותה בפרויקט, במיוחד כשרוצים להשתמש ב-AAR כתלות מקומית ב-C/C++.
- הוספת יחסי תלות ב-build: מידע על הוספת יחסי תלות לקובץ
build.gradle, במיוחד ליחסי תלות מרוחקים.
המסמך הזה מתמקד בהגדרה של מערכת ה-build המקורית, ומניח שכבר הוספתם קובץ AAR של יחסי תלות ב-C/C++ לסביבת ה-build של Gradle בפרויקט.
יחסי תלות מקוריים בקובצי AAR
תלויות AAR של מודולי Gradle יכולות לחשוף ספריות Native לשימוש באפליקציה. בתוך ה-AAR, הספרייה prefab מכילה חבילת Prefab, שכוללת את הכותרות והספריות של התלות המקורית.
כל יחסי תלות יכולים לחשוף לכל היותר חבילת Prefab אחת, שמורכבת ממודול אחד או יותר. מודול Prefab הוא ספרייה אחת, שיכולה להיות ספרייה משותפת, סטטית או ספריית כותרות בלבד.
כדי להשתמש בספריות, צריך לדעת את שמות החבילות והמודולים. מקובל ששם החבילה יהיה זהה לשם של פריט המידע שנוצר ב-Maven, וששם המודול יהיה זהה לשם של ספריית C/C++, אבל זה לא חובה. כדי לדעת באילו שמות משתמשים, צריך לעיין במסמכי התיעוד של התלות.
הגדרת מערכת ה-build
התכונה prefab חייבת להיות מופעלת במודול של Android Gradle.
כדי לעשות את זה, מוסיפים את הקוד הבא לבלוק android בקובץ build.gradle של המודול:
Kotlin
buildFeatures { prefab = true }
מגניב
buildFeatures { prefab true }
אפשר גם להגדיר גרסה בקובץ gradle.properties של הפרויקט:
android.prefabVersion=2.0.0
בדרך כלל, גרסת ברירת המחדל של AGP תתאים לצרכים שלכם. צריך לבחור גרסה אחרת רק אם יש באג שצריך לעקוף או תכונה חדשה שרוצים להשתמש בה.
יחסי תלות שיובאו מ-AAR נחשפים ל-CMake דרך CMAKE_FIND_ROOT_PATH. הערך הזה יוגדר באופן אוטומטי על ידי Gradle כש-CMake יופעל, אז אם ה-build שלכם משנה את המשתנה הזה, הקפידו להוסיף לו ולא להקצות לו.
כל תלות חושפת חבילת קובץ תצורה ל-build. הם מיובאים באמצעות הפקודה find_package. הפקודה הזו מחפשת חבילות של קובצי תצורה שתואמות לשם ולגרסה של החבילה שצוינה, וחושפת את היעדים שהיא מגדירה לשימוש ב-build. לדוגמה, אם האפליקציה מגדירה את 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 ייכלל באפליקציה.
פרסום ספריות Native בקובצי AAR
היכולת ליצור קובצי AAR מקוריים נוספה לראשונה ב-AGP 4.1.
כדי לייצא את ספריות ה-Native, מוסיפים את הקוד הבא לבלוק 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 של ה-build המקורי החיצוני ייארזו ב-AAR שנוצר על ידי ה-build, וכל אחת מהן תייצא את הכותרות מהספרייה שצוינה אל התלויות שלהן.