פועלים לפי ההוראות שבדף הזה כדי לבנות את Android.
הגדרה של סביבת ה-build
בספריית העבודה, מגדירים את סביבת ה-build באמצעות הסקריפט envsetup.sh:
source build/envsetup.sh
הסקריפט הזה מייבא כמה פקודות שמאפשרות לעבוד עם קוד המקור של Android, כולל הפקודות שבהן נעשה שימוש בדף הזה. כדי לראות את המקור של הסקריפט, אפשר לעיין במאמר platform/build/envsetup.sh.
כדי להציג את העזרה המובנית, מקלידים hmm.
בחירת יעד
לפני שיוצרים את Android, צריך לזהות יעד שרוצים ליצור. היעד משקף את פלטפורמת היעד שאליה אתם מפתחים. כדי לזהות את היעד ל-build, משתמשים בפקודה lunch ואחריה מחרוזת שמייצגת את היעד. לדוגמה:
lunch aosp_cf_x86_64_phone-trunk_staging-userdebug
אמור להופיע סיכום של היעד וסביבת ה-build:
============================================
PLATFORM_VERSION_CODENAME=VanillaIceCream
PLATFORM_VERSION=VanillaIceCream
PRODUCT_INCLUDE_TAGS=com.android.mainline
TARGET_PRODUCT=aosp_arm
TARGET_BUILD_VARIANT=eng
TARGET_ARCH=arm
TARGET_ARCH_VARIANT=armv7-a-neon
TARGET_CPU_VARIANT=generic
HOST_OS=linux
HOST_OS_EXTRA=Linux-6.5.13-1rodete2-amd64-x86_64-Debian-GNU/Linux-rodete
HOST_CROSS_OS=windows
BUILD_ID=AOSP.MAIN
OUT_DIR=out
============================================
המחרוזת שמייצגת את היעד היא בפורמט הבא:
lunch product_name-release-build_variant
הרכיבים במחרוזת הזו הם:
product_nameהוא שם המוצר שרוצים ליצור, למשלaosp_cf_x86_64_phoneאוaosp_husky. ה-product_nameהספציפי שלכם יכול להיות בפורמט של המכשיר שלכם, אבל הפורמט שבו Google משתמשת במכשירים שלה כולל את הרכיבים הבאים:aospמתייחס לפלטפורמת הקוד הפתוח של Android.- (אופציונלי)
cfנכלל כאשר היעד מיועד להרצה במהלך הדמיה של Cuttlefish. - ארכיטקטורה וחומרה (שם קוד), כמו
x86_64_phoneאוhuskyשהוא שם הקוד של Pixel 8 Pro. לרשימת שמות הקוד של מכשירי Google, ראו שמות הקוד של המכשירים.
השדה
releaseמוגדר לערךtrunk_staging.החלק
build_variantבמחרוזת יכול להיות אחד משלושת הערכים בטבלה הבאה:build_variantתיאור userגרסת ה-build הזו מספקת גישה מוגבלת לאבטחה והיא מתאימה לסביבת הייצור. userdebugגרסת ה-build הזו עוזרת למפתחי המכשירים להבין את הביצועים והעוצמה של גרסאות שעדיין נמצאות בפיתוח. כשמפתחים עם build של userdebug, פועלים לפי ההנחיות ל-userdebug.engלגרסת ה-build הזו יש זמן build מהיר יותר, והיא מתאימה במיוחד לפיתוח יומיומי אם לא אכפת לכם מהביצועים והעוצמה.
אם מריצים את lunch ללא ארגומנטים, מוצגת רשימה של יעדים נפוצים.
אפשר גם ליצור מחרוזות יעד משלכם על ידי חיבור הרכיבים של מחרוזת היעד באמצעות המידע שבדף הזה והשמות הקודמים שמייצגים חומרה ספציפית של Google במאמר שמות קוד למכשירים.
הצגת היעד הנוכחי
כדי לראות את ההגדרות הנוכחיות של ארוחת הצהריים, מריצים את הפקודה:
$ echo "$TARGET_PRODUCT-$TARGET_BUILD_VARIANT"
פיתוח הקוד
מריצים את הפקודה הבאה כדי ליצור את היעד. בהתאם למפרט של תחנת העבודה, ה-build הראשון עשוי להימשך פחות משעה עד כמה שעות. הזמן הנדרש ליצירת גרסאות build הבאות יהיה קצר בהרבה.
m
הפלט של ה-build יופיע ב-$OUT_DIR. אם תיצרו יעדים שונים, כל build של יעד יופיע ב-$OUT_DIR.
הפקודה m מבוססת על החלק העליון של העץ, כך שאפשר להריץ את m מתוך ספריות משנה. אם משתנה הסביבה TOP מוגדר, הפקודה m משתמשת בו. אם המדיניות TOP לא מוגדרת, הפקודה m מחפשת את העץ מהספרייה הנוכחית ומנסה למצוא את החלק העליון של העץ.
הפקודה m יכולה לטפל במשימות מקבילות באמצעות ארגומנט -jN. אם לא תספקו את הארגומנט -j, מערכת ה-build תבחר באופן אוטומטי את מספר המשימות המקבילות שהיא חושבת שהן אופטימליות למערכת שלכם.
כדי ליצור מודולים ספציפיים במקום את התמונה המלאה של המכשיר, אפשר לרשום את שמות המודולים בשורת הפקודה m. בנוסף, הפקודה m מספקת כמה יעדי פסאודו שנקראים יעדים. לדוגמה, הפקודה m nothing לא יוצרת שום דבר, אלא מבצעת ניתוח ותיקוף של מבנה ה-build. כדי לקבל רשימה של מטרות עסקיות חוקיות, מקלידים m help.
פתרון בעיות בשגיאות build (גרסה 8.0 ואילך)
אם אתם מפתחים את AOSP 8 ואילך, יכול להיות שהפעלת m תבוטל אם תופיע בעיה בגרסה של Java. לדוגמה, יכול להיות שתתקבל ההודעה הבאה:
************************************************************
You are attempting to build with the incorrect version
of java.
Your version is: WRONG_VERSION.
The correct version is: RIGHT_VERSION.
Please follow the machine setup instructions at
https://source.android.com/source/initializing.html
************************************************************
הנה הסיבות והפתרונות האפשריים:
- לא הצלחתם להתקין את JDK הנכון כפי שמפורט בקטעים של JDK במאמר הגדרה לפיתוח AOSP (2.3 עד 8.0) .
- יש JDK אחר שהותקן בעבר שמופיע בנתיבים. מוסיפים את ה-JDK הנכון בתחילת הנתיב או מסירים את ה-JDK הבעייתי.