שימוש ב-NDK עם מערכות פיתוח אחרות

הערה: התוכן שמתואר בדף הזה מחייב לפחות NDK r19. אם המיקום נעשה שימוש ב-NDK ישן יותר, כדאי לשקול לשדרג. אם אין לך אפשרות לשדרג, <NDK>/build/tools/make_standalone_toolchain.py.

ה-NDK כולל תמיכה רשמית עבור ndk-build ו-CMake. רוב המשתמשים צריכים עיינו באחד מהמדריכים האלה לפיתוח קוד אפליקציה. המטרה של במסמך הזה מתואר איך לבנות קוד קיים שמשתמש בגרסת build אחרת המערכות שלנו. לרוב המצב הזה קורה כשיש יחסי תלות של צד שלישי ספציפי ל-Android, כגון OpenSSL ו-libzip2.

פיתוח מתחזקי מערכות שמעוניינים להוסיף תמיכה NDK מותאמת ל-build שלהם במקום זאת, המערכות צריכות לקרוא את המדריך למתחזקי מערכות Build.

סקירה כללית

ניתן להשתמש במהדר (compiler) Clang ב-NDK עם הגדרות אישיות מינימליות בלבד שנדרש כדי להגדיר את סביבת היעד.

כדי לוודא שאתם יוצרים את הארכיטקטורה הנכונה, מעבירים את להשתמש ב--target כשמפעילים את Clang. לדוגמה, כדי להדר לפורמט של 64 סיביות ARM Android עם minSdkVersion מתוך 21, עליך לבצע את הפעולות הבאות:

$ $NDK/toolchains/llvm/prebuilt/$HOST_TAG/bin/clang++ \
    --target aarch64-linux-android21 foo.cpp

לחלופין, יש נקודות כניסה עם קידומת ליעד של Clang. האפשרויות האלה יכולות להיות קישורים סימבוליים או סקריפטים שמעבירים ל-clang, בהתאם לגרסת NDK. ומערכת ההפעלה המארחת. הפעלת Clang ישירות מול --target תהיה אמינה יותר, מכיוון זה תהליך העבודה שנבדק ביותר, ומדי פעם יש העברת ארגומנטים באגים בסקריפטים. ב-Windows, תוספת של CreateProcess שנדרשת כדי להעביר מהתסריט ועד למהדר (compiler) אמיתי, יכול להיות יש לכך השפעה שלילית על מהירות ה-build.

$ $NDK/toolchains/llvm/prebuilt/$HOST_TAG/bin/aarch64-linux-android21-clang++ \
    foo.cpp

בשני המקרים, צריך להחליף את $NDK בנתיב אל ה-NDK ואת $HOST_TAG להתאמה ה-NDK שהורדת בהתאם לטבלה הבאה:

וריאנט של מערכת הפעלה NDK	תג מארח
macOS	darwin-x86_64
Linux	linux-x86_64
Windows 64 סיביות	windows-x86_64

הערה: למרות התג x86_64 בשם Drwin, אלה קבצים בינאריים שמנים כולל תמיכה ב-M1. הנתיבים לא עודכנו בהתאם לתמיכה הזו, אם הם יעשו את זה, הם יגרמו לשיבושים בגרסאות build קיימות שמקודדות את הנתיבים האלה.

הפורמט של התחילית או ארגומנט היעד כאן הוא משולש היעד עם סיומת שמציינת את minSdkVersion. משתמשים בסיומת הזו רק עם clang/clang++; לכלים דו-כיווניים (כמו ar ו-strip) לא צריך הסיומת כי הן לא מושפעות על ידי minSdkVersion. תמיכה ב-Android שלשות היעד הן:

ABI	טריפל
Armeabi-v7a	armv7a-linux-androideabi
Arm64-v8a	aarch64-linux-android
x86	i686-linux-android
x86-64	x86_64-linux-android

הערה: ב-ARM 32 ביט, התחילית של המהדר היא armv7a-linux-androideabi, אך התחילית של כלי הבינוטילים היא arm-linux-androideabi. אפשרויות אחרות של הארכיטקטורות, הקידומות זהות בכל הכלים.

של פרויקטים רבים סקריפטים של build יצפו למהדרים מוצלבים בסגנון GCC, כאשר כל מהדר מטרגט רק שילוב אחד של מערכת הפעלה וארכיטקטורה, לכן יכול להיות שהוא לא יטפל -target נקייה. במקרים כאלה, אפשר בדרך כלל לכלול את -target כחלק מהגדרת המהדר (למשל CC="clang -target aarch64-linux-android21). במקרים נדירים שבהם מערכת ה-build שבה משתמשים ולא יוכלו להשתמש בטופס הזה, השתמשו בקבצים הבינאריים של Clang עם קידומת משולשת.

ניהול אוטומטי

זהירות: בדרך כלל אי אפשר ליצור פרויקטים של Autoconf ב-Windows. משתמשי Windows יכולים לפתח את הפרויקטים האלה באמצעות Linux NDK ב-VM של Linux. גם מערכת המשנה של Windows ל-Linux עשויה לפעול, אבל לא באופן רשמי. ידוע ש-WSL1 לא עובד.

פרויקטים של Autoconf מאפשרים לציין את 'צרור הכלים' לשימוש עם הסביבה משתנים. למשל, בסרטון הבא מוסבר איך לפתח את libpng ל-Android x86-64 עם minSdkVersion של רמת API: 21 ב-Linux.

# Check out the source.
git clone https://github.com/glennrp/libpng -b v1.6.37
cd libpng
# Only choose one of these, depending on your build machine...
export TOOLCHAIN=$NDK/toolchains/llvm/prebuilt/darwin-x86_64
export TOOLCHAIN=$NDK/toolchains/llvm/prebuilt/linux-x86_64
# Only choose one of these, depending on your device...
export TARGET=aarch64-linux-android
export TARGET=armv7a-linux-androideabi
export TARGET=i686-linux-android
export TARGET=x86_64-linux-android
# Set this to your minSdkVersion.
export API=21
# Configure and build.
export AR=$TOOLCHAIN/bin/llvm-ar
export CC="$TOOLCHAIN/bin/clang --target=$TARGET$API"
export AS=$CC
export CXX="$TOOLCHAIN/bin/clang++ --target=$TARGET$API"
export LD=$TOOLCHAIN/bin/ld
export RANLIB=$TOOLCHAIN/bin/llvm-ranlib
export STRIP=$TOOLCHAIN/bin/llvm-strip
./configure --host $TARGET
make

הכלים שנבחרו בדוגמה הזו מתאימים ל-NDK r22 ואילך. קבוצות NDK ישנות יותר עשויים לדרוש כלים אחרים.

יצירת פרויקטים ללא שיחות אוטומטיות

זהירות: לא כל הפרויקטים תומכים בהידור בתחומים שונים, ולא כולם תומכים בכך כמעט באותה הדרך. סביר להניח שהפרויקט לא יבנה מבלי שינויים. במקרים כאלה, יש לעיין במדריך למתחזקי מערכות Build עבור הוראות לניוד ה-build ל-Android.

חלק מהפרויקטים של makefile מאפשרים הידור (compilation) אחר על ידי שינוי של אותם משתנים שהייתם עושים בפרויקט של שיחת ועידה אוטומטית. הדוגמה הבאה מראה איך כדי לבנות את libbzip2 ל-Android x86-64 עם minSdkVersion של 21.

# Check out the source.
git clone https://gitlab.com/bzip/bzip2.git
cd bzip2

# Only choose one of these, depending on your build machine...
export TOOLCHAIN=$NDK/toolchains/llvm/prebuilt/darwin-x86_64
export TOOLCHAIN=$NDK/toolchains/llvm/prebuilt/linux-x86_64

# Only choose one of these, depending on your device...
export TARGET=aarch64-linux-android
export TARGET=armv7a-linux-androideabi
export TARGET=i686-linux-android
export TARGET=x86_64-linux-android

# Set this to your minSdkVersion.
export API=21

# Build.
make \
    CC="$TOOLCHAIN/bin/clang --target=$TARGET$API" \
    AR=$TOOLCHAIN/bin/llvm-ar \
    RANLIB=$TOOLCHAIN/bin/llvm-ranlib \
    bzip2

הכלים שנבחרו בדוגמה הזו מתאימים ל-NDK r22 ואילך. קבוצות NDK ישנות יותר עשויים לדרוש כלים אחרים.