איך ליצור סמלי ניפוי באגים (Debug Symbols) עבור Godot ב-Windows להעלאה ל-Play Console

2. שכפול קוד המקור ובחירת גרסה תואמת

• שכפלו את מאגר Godot והיכנסו לתיקייה:

  bat

  git clone https://github.com/godotengine/godot.git
  cd godot

• בדקו לגרסה התואמת בדיוק לגרסת העורך/תבנית הייצוא שלכם :

  bat

  git checkout 4.x   # לדוגמה: 4.5.1-stable

3. הרצת SCons עם הדגלים הרצויים

הדגלים שציינתם (target=template_debug, generate_android_binaries=yes, debug_symbols=yes, gradle_do_not_strip=yes) מתאימים לבניית תבנית ניפוי. הפקודה המלאה:

הערה: יש לוודא שהדגל generate_android_binaries נתמך בגרסת Godot שלכם (הוא קיים בגרסאות מסוימות; אם לא, ייתכן שיידרש שימוש ב-Gradle ישירות). מסמכי Sentry מדגימים דגלים דומים:

scons platform=android arch=arm32 target=template_debug production=yes debug_symbols=yes separate_debug_symbols=yes

4. בנייה לשחרור (Production)

לשחרור בפועל ל-Play Console, מומלץ לבנות עם target=template_release (ולא template_debug). זהו ה-build הנכון להפצה .

הדגל separate_debug_symbols=yes יפיק קבצי סמלים נפרדים, אותם תוכלו להעלות ל-Play Console מבלי להגדיל את גודל ה-AAB/APK .

העלאת קבצי הסמלים ל-Play Console

• עליכם להעלות את קבצי הסמלים (בדרך כלל בפורמט ZIP) שמקורם ב-build הספציפי אותו אתם משחררים .
• אין לערבב סמלים מגרסאות שונות של Godot או תבניות שונות – הסמלים חייבים להתאים בדיוק ל-build שיוצא .
• אם בחרתם להשתמש בסמלים הרשמיים של Godot, יש לוודא שהם מגרסה זהה ל-export template הרשמי שבו השתמשתם .
• הערה חשובה: מסמכי Godot מציינים כי התמיכה בהפרדת סמלים ל-Google Play בעבר לא הייתה פשוטה וייתכן שתצטרכו לארוז את הקבצים באופן ידני . אין מידע מספק במקורות הקיימים לגבי מבנה ה-ZIP המדויק הנדרש על ידי Play Console.

טיפים חשובים

• תאימות: לעולם אל תערבבו סמלים מתבנית ייצוא אחת עם build מתבנית אחרת .
• בנייה עצמית: אם שיניתם את קוד המנוע, עליכם להשתמש בסמלים שיצרתם בעצמכם, לא בסמלים הרשמיים .
• מיקום קובץ הפלט: המקורות הקיימים אינם מספקים מידע מפורט על מיקום קובץ הפלט ב-Windows או על תהליך האריזה המדויק ל-Play Console. ייתכן שתצטרכו לחפש את הקבצים בתיקיית bin/ או בתיקיית הפלט של SCons.

סיכום

הפקת Native Debug Symbols עבור Godot ב-Windows להעלאה ל-Play Console אפשרית לחלוטין. השתמשו בדגלי debug_symbols=yes ו-separate_debug_symbols=yes עם scons, והקפידו על התאמה מוחלטת בין גרסת ה-build לסמלים. לאלו המשתמשים בתבניות רשמיות, ההורדה הישירה של קבצי הסמלים הרשמיים היא הפתרון הקל ביותר .