שדרוג של Gradle ל-Android

ל-Google Mobile Ads Android SDK 22.4.0 נוספו רכיבים מסוג <property> במניפסט של Android. כדי לבנות לגרסה הזו או לגרסה מתקדמת יותר, צריך להשתמש ב-Gradle בגרסה 6.7.1 ואילך וב-Android Gradle plugin בגרסה 4.2.0 ואילך. במדריך הזה מוסבר איך לוודא שעורך Unity תואם.

דרישות מוקדמות

קוראים את המדריך לתחילת העבודה. חשוב לוודא:

• מגדירים את רמת ה-API המינימלית ל-21
• מגדירים את רמת ה-API לטירגוט כ-33 ואילך
• מפעילים את ההגדרות Custom Main Gradle Template ו-Custom Gradle Properties Template.

Unity 2022.2 ואילך

הגרסאות החדשות יותר של Gradle ל-Android מגיעות כברירת מחדל ב-Unity 2022.2 ואילך. אין צורך לבצע פעולה נוספת כדי לתמוך ב-Google Mobile Ads SDK לגרסה 22.4.0 ל-Android.

Unity 2022.1 וגרסאות קודמות

ב-Unity 2022.2 וגרסאות קודמות נעשה שימוש בגרסה ישנה יותר של Gradle for Android, שלא נתמכת על ידי Google Mobile Ads Android SDK 22.4.0. השלבים הבאים מראים איך לשדרג לגרסה המינימלית הנדרשת של Gradle בהתאם לתהליך ה-build:

חשוב: לפני שמתחילים, צריך להסיר קבצים ישנים מסוג Assets/Plugins/Android/*.gradle. בגרסאות שונות של Gradle נעשה שימוש בפורמטים שונים לקבצים האלה. הדבר עלול לגרום לבעיות בזמן ה-build של פרויקט Unity.

1. הפעלת תבניות Gradle בהתאמה אישית

   עוברים אל Project Settings (הגדרות הפרויקט)‏ > Player (נגן)‏ > Android (Android)‏ > Publishing Settings (הגדרות פרסום)‏ > Build (גרסה) ובוחרים באפשרות:

   • תבנית בסיסית מותאמת אישית של Gradle

   

2. שינוי התבנית הבסיסית של Gradle

   פותחים את הקובץ Assets/Plugins/Android/baseProjectTemplate.gradle ומגדירים את יחסי התלות כך שישתמשו בכלי ה-build של Gradle בגרסה 4.2.0.

     allprojects {
         buildscript {
             dependencies {
                 classpath 'com.android.tools.build:gradle:4.2.0'
                 **BUILD_SCRIPT_DEPS**
             }
         }
     }
     ...
   

3. עדכון Gradle

   מעדכנים את גרסת Gradle ל-6.7.1. השלבים לביצוע הפעולה הזו משתנים מעט בהתאם לכך שאתם מייצאים את הפרויקט כפרויקט של Android Studio כחלק מתהליך ה-build.

   גרסאות build משולבות של Unity

   התקנת Gradle

   מורידים את Gradle בגרסה 6.7.1.

   הגדרת הנתיב של Gradle ב-Unity

   ב-Unity, פותחים את Unity Preferences > External Tools ומגדירים את הנתיב המותאם אישית של Gradle.

   

   נקודת מפתח: מומלץ להשתמש ב-Gradle 6.7.1 כדי למזער את הסיכוי שעדכון Gradle יגרום לשגיאות build אחרות בפרויקט.

   גרסאות build של Android Studio

   ייצוא הפרויקט ב-Android Studio

   פותחים את התפריט File > Build Settings, מסמנים את האפשרות Export Project ומסמנים את התיבה שלה, ואז לוחצים על הלחצן Export. אחרי הייצוא, פותחים את הפרויקט ב-Android Studio.

   עדכון ה-wrapper של Gradle

   פותחים את הקובץ ‎./gradle/wrapper/gradle-wrapper.properties ומגדירים את distributionUrl כך שישתמש ב-Gradle 6.7.1.

   distributionBase=GRADLE_USER_HOME
   distributionPath=wrapper/dists
   zipStoreBase=GRADLE_USER_HOME
   zipStorePath=wrapper/dists
   distributionUrl=https\://services.gradle.org/distributions/gradle-6.7.1-bin.zip
   

   נקודת מפתח: מומלץ להשתמש ב-Gradle 6.7.1 כדי למזער את הסיכוי שעדכון Gradle יוביל לשגיאות build אחרות בפרויקט.