הוספת קוד C ו-C++ לפרויקט

כדי להוסיף קוד C ו-C++‎ לפרויקט Android, צריך להציב את הקוד בספרייה cpp במודול הפרויקט. כשאתם יוצרים את הפרויקט, הקוד הזה עובר הידור לספריית Native ש-Gradle יכול לארוז עם האפליקציה. לאחר מכן, קוד ה-Java או ה-Kotlin יכול לקרוא לפונקציות בספריית ה-Native דרך ממשק Java Native‏ (JNI). בטיפים לשימוש ב-JNI ב-Android מוסבר איך משתמשים ב-framework של JNI.

‫Android Studio תומך ב-CMake, שמתאים לפרויקטים בפלטפורמות שונות. ‫Android Studio תומך גם ב-ndk-build, שיכול להיות מהיר יותר מ-CMake אבל תומך רק ב-Android. בשלב הזה, אי אפשר להשתמש גם ב-CMake וגם ב-ndk-build באותו מודול.

כדי לייבא ספריית ndk-build קיימת לפרויקט ב-Android Studio, אתם יכולים לקרוא איך לקשר את Gradle לפרויקט של ספריית Native.

בדף הזה מוסבר איך להגדיר את Android Studio עם כלי ה-build הנדרשים, ליצור פרויקט חדש עם תמיכה ב-C/C++‎ ולהוסיף קובצי C/C++‎ חדשים לפרויקט.

אם אתם רוצים להוסיף קוד Native לפרויקט קיים, בצעו את השלבים הבאים:

  1. יוצרים קובצי מקור מקוריים חדשים ומוסיפים אותם לפרויקט ב-Android Studio.
    • אם כבר יש לכם קוד Native או שאתם רוצים לייבא ספריית Native מוכנה מראש, אתם יכולים לדלג על השלב הזה.
  2. מגדירים את CMake כדי ליצור ספרייה מקוד המקור המקורי. סקריפט ה-build הזה נדרש אם אתם מייבאים ומקשרים לספריות שנוצרו מראש או לספריות של הפלטפורמה.
    • אם יש לכם ספריית Native קיימת שכבר יש לה סקריפט build של CMakeLists.txt או שמשתמשת ב-ndk-build וכוללת סקריפט build של Android.mk, דלגו על השלב הזה.
  3. מגדירים את Gradle על ידי ציון נתיב לקובץ הסקריפט של CMake או ndk-build. ‫Gradle משתמש בסקריפט ה-build כדי לייבא את קוד המקור לפרויקט ב-Android Studio ולארוז את ספריית ה-Native באפליקציה.

אחרי שמגדירים את הפרויקט, אפשר לגשת לפונקציות המקוריות מקוד Java או Kotlin באמצעות מסגרת JNI. כדי ליצור ולהריץ את האפליקציה, לוחצים על Run הפעלה ואז הפעלת האפליקציה מסרגל התפריטים.

הערה: אם בפרויקט הקיים שלכם נעשה שימוש בכלי ndkCompile שהוצא משימוש, עליכם לעבור לשימוש ב-CMake או ב-ndk-build.

הורדת ה-NDK וכלי הפיתוח

כדי לקמפל קוד Native ולנפות בו באגים באפליקציה, צריך את הרכיבים הבאים:

  • ערכת הכלים לפיתוח נייטיב (NDK) של Android: ערכת כלים שמאפשרת להשתמש בקוד C ו-C++‎ ב-Android. ‫NDK מספק ספריות פלטפורמה שמאפשרות לנהל פעילויות Native ולגשת לרכיבים פיזיים של המכשיר, כמו חיישנים וקלט מגע.
  • ‫CMake: כלי חיצוני ליצירת גרסאות build שפועל לצד Gradle כדי ליצור את ספריית ה-Native. אתם לא צריכים את הרכיב הזה אם אתם מתכננים להשתמש רק ב-ndk-build.
  • ‫LLDB: הכלי לניפוי באגים ב-Android Studio שמנפה באגים בקוד Native.

מידע על התקנת הרכיבים האלה זמין במאמר התקנה והגדרה של NDK ו-CMake.

יוצרים פרויקט חדש עם תמיכה ב-C/C++‎.

כדי ליצור פרויקט חדש עם תמיכה בקוד Native, התהליך דומה ליצירת כל פרויקט אחר ב-Android Studio, אבל עם שלב נוסף:

  1. בקטע Choose your project באשף, בוחרים את סוג הפרויקט Native C++‎.
  2. לוחצים על הבא.
  3. ממלאים את כל שאר השדות בקטע הבא של האשף.
  4. לוחצים על הבא.
  5. בקטע Customize C++ Support של האשף, אפשר להתאים אישית את הפרויקט באמצעות השדה C++ Standard.
    • ברשימה הנפתחת, בוחרים את התקן של C++‎ שבו רוצים להשתמש. אם בוחרים באפשרות Toolchain Default, המערכת משתמשת בהגדרת ברירת המחדל של CMake.
  6. לוחצים על סיום.

אחרי ש-Android Studio מסיים ליצור את הפרויקט החדש, פותחים את החלונית Project (פרויקט) מהצד הימני של סביבת הפיתוח המשולבת (IDE) ובוחרים בתצוגת Android מהתפריט. כמו שמוצג באיור 1, Android Studio מוסיף את הקבוצה cpp:

איור 1. קבוצות תצוגה של Android למקורות המקומיים ולסקריפטים של גרסאות build חיצוניות.

הערה: התצוגה הזו לא משקפת את היררכיית הקבצים בפועל בדיסק, אלא מקבצת קבצים דומים כדי לפשט את הניווט בפרויקט.

הקבוצה cpp היא המקום שבו אפשר למצוא את כל קובצי המקור המקוריים, הכותרות, הסקריפטים של ה-build ל-CMake או ל-ndk-build, והספריות שנבנו מראש שהן חלק מהפרויקט. בפרויקטים חדשים, Android Studio יוצר קובץ מקור לדוגמה ב-C++‎,‏ native-lib.cpp, וממקם אותו בספרייה src/main/cpp/ של מודול האפליקציה. הקוד לדוגמה הזה מספק פונקציית C++‎ פשוטה, stringFromJNI(), שמחזירה את המחרוזת "Hello from C++". בקטע יצירת קובצי מקור מקוריים חדשים מוסבר איך מוסיפים עוד קובצי מקור לפרויקט.

כמו שקובצי build.gradle מנחים את Gradle איך ליצור את האפליקציה, CMake ו-ndk-build דורשים סקריפט build כדי לדעת איך ליצור את ספריית ה-Native. בפרויקטים חדשים, Android Studio יוצר סקריפט build של CMake,‏ CMakeLists.txt, וממקם אותו בתיקיית השורש של המודול. למידע נוסף על התוכן של סקריפט ה-build הזה, קראו את המאמר הגדרת CMake.

פיתוח והפעלה של האפליקציה לדוגמה

כשלוחצים על Run הפעלה ואז הפעלת האפליקציה מסרגל התפריטים, Android Studio יוצר ומפעיל אפליקציה שמציגה את הטקסט "Hello from C++‎" במכשיר Android או באמולטור. בסקירה הכללית הבאה מתוארים האירועים שמתרחשים כדי ליצור ולהפעיל את האפליקציה לדוגמה:

  1. ‫Gradle מפעיל את סקריפט ה-build החיצוני, CMakeLists.txt.
  2. ‫CMake פועל לפי הפקודות בסקריפט ה-build כדי לקמפל קובץ מקור ב-C++‎,‏ native-lib.cpp, לספריית אובייקטים משותפת ונותן לה את השם libnative-lib.so. לאחר מכן, Gradle אורז את הקובץ באפליקציה.
  3. בזמן הריצה, ה-MainActivity של האפליקציה טוען את ספריית ה-Native באמצעות System.loadLibrary(). הפונקציה המקורית של הספרייה, stringFromJNI(), זמינה עכשיו לאפליקציה.
  4. ‫MainActivity.onCreate() קורא ל-stringFromJNI(), שמחזיר את "Hello from C++" ומשתמש בו כדי לעדכן את TextView.

כדי לוודא ש-Gradle אורז את ספריית ה-Native באפליקציה, משתמשים בכלי לניתוח APK:

  1. בוחרים באפשרות Build > Build Bundles(s) / APK(s) > Build APK(s) (יצירה > יצירת חבילות / קובצי APK > יצירת קובצי APK).
  2. בוחרים באפשרות Build > Analyze APK (פיתוח > ניתוח APK).
  3. בוחרים את קובץ ה-APK או ה-AAB מהספרייה app/build/outputs/ ולוחצים על אישור.
  4. כמו שמוצג באיור 2, אפשר לראות את libnative-lib.so בחלון של הכלי לניתוח APK בקטע lib/<ABI>/.

    איור 2. מאתרים ספריית Native באמצעות הכלי לניתוח APK.

טיפ: אם אתם רוצים להתנסות באפליקציות אחרות ל-Android שמשתמשות בקוד Native, לחצו על File > New > Import Sample ובחרו פרויקט לדוגמה מהרשימה Ndk.

יצירת קובצי מקור חדשים ב-C/C++‎

כדי להוסיף קובצי מקור חדשים ב-C/C++‎ לפרויקט קיים, פועלים לפי השלבים הבאים:

  1. אם עדיין אין לכם ספריית cpp/ בקבוצת המקורות הראשית של האפליקציה, אתם יכולים ליצור אותה באופן הבא:
    1. פותחים את החלונית Project בצד שמאל של ה-IDE ובוחרים בתצוגה Project מהתפריט.
    2. עוברים אל your-module > src.
    3. לוחצים לחיצה ימנית על הספרייה main ובוחרים באפשרות New > Directory.
    4. מזינים את cpp בתור שם הספרייה ולוחצים על OK.

  2. לוחצים לחיצה ימנית על הספרייה cpp/ ובוחרים באפשרות New > C/C++ Source File.
  3. נותנים שם לקובץ המקור, למשל native-lib.
  4. בתפריט Type, בוחרים את סיומת הקובץ של קובץ המקור, למשל .cpp.
    • לוחצים על עריכת סוגי קבצים כדי להוסיף סוגי קבצים אחרים לתפריט, כמו .cxx או .hxx. בתיבת הדו-שיח New File Extensions שמופיעה, בוחרים סיומת קובץ אחרת מהתפריטים Source Extension ו-Header Extension ולוחצים על OK.
  5. כדי ליצור קובץ כותרת, מסמנים את התיבה Create an associated header.
  6. לוחצים על אישור.

אחרי שמוסיפים קובצי C/C++‎ חדשים לפרויקט, עדיין צריך להגדיר את CMake כך שיכלול את הקבצים בספריית ה-Native.