ترقية Gradle لنظام التشغيل Android

أضافت حزمة تطوير البرامج (SDK) لنظام التشغيل Android SDK 22.4.0 لإعلانات Google على الأجهزة الجوّالة عنصرًا <property> في بيان Android الخاص بها. ويتطلب إنشاء الإصدار المتوافق مع هذا الإصدار أو الإصدارات الأحدث استخدام الإصدار 6.7.1 من Gradle أو إصدار أحدث والمكوّن الإضافي لنظام Gradle المتوافق مع Android الإصدار 4.2.0 أو الإصدارات الأحدث. يقدّم لك هذا الدليل إرشادات حول كيفية التأكّد من توافق أداة تعديل الرموز Unity.

المتطلبات الأساسية

أكمل دليل البدء. تأكد مما يلي:

  • ضبط الحد الأدنى لمستوى واجهة برمجة التطبيقات على 21
  • ضبط مستوى واجهة برمجة التطبيقات المستهدَف على 33 أو أعلى
  • تفعيل إعدادات نموذج التصميم الرئيسي المخصّص ونموذج خصائص Gradle المخصّصة

Unity 2022.2 والإصدارات الأحدث

يتضمّن الإصدار Unity 2022.2 أو الإصدارات الأحدث إصدارات أحدث من Gradle for Android بشكل تلقائي. لا يلزم اتخاذ أي إجراء إضافي لدعم الإصدار 22.4.0 من حزمة SDK لإعلانات Google على الأجهزة الجوّالة.

Unity 2022.1 والإصدارات الأقدم

يستخدم Unity 2022.2 والإصدارات الأقدم إصدارًا قديمًا من Gradle for Android لا يتوافق مع الإصدار 22.4.0 من حزمة تطوير البرامج (SDK) لإعلانات Google على الأجهزة الجوّالة لنظام التشغيل Android. توضِّح الخطوات التالية كيفية الترقية إلى إصدار Gradle الأدنى المطلوب وفقًا لعملية التصميم:

  1. تفعيل نماذج Gradle المخصّصة

    انتقِل إلى إعدادات المشروع > المشغّل > Android > إعدادات النشر > الإصدار، واختَر:

    • نموذج مخصَّص لسمات القاعدة الأساسية

  2. تعديل نموذج لوحة القاعدة الأساسية

    افتح ملف Assets/Plugins/Android/baseProjectTemplate.gradle وعيِّن التبعيات لاستخدام أدوات إصدار 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 كجزء من عملية التصميم.

    إصدارات Unity المتكاملة

    تثبيت Gradle

    تنزيل Gradle، الإصدار 6.7.1

    ضبط مسار Gradle في Unity

    في برنامج Unity، افتح تفضيلات Unity > الأدوات الخارجية واضبط مسار Gradle المخصّص.

    إصدارات "استوديو Android"

    تصدير مشروع "استوديو Android"

    افتح القائمة ملف > إعدادات الإصدار، وفعِّل خيار تصدير المشروع مع اختيار، واضغط على الزر تصدير. بعد تصدير الملف، افتح المشروع في "استوديو Android"

    تعديل برنامج تضمين 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