ساخت یونیتی برای اندروید

ویرایشگر یونیتی به یک نسخه خاص از Gradle قفل شده است. نسخه‌های قبلی ویرایشگر یونیتی از نسخه‌های قدیمی‌تر Gradle استفاده می‌کنند که با آخرین نسخه Google Mobile Ads سازگار نیستند.

برای ساخت اندروید، نسخه ویرایشگر یونیتی مورد نظر خود را انتخاب کنید:

۲۰۲۳.۱ یا بالاتر

فعال کردن پیش‌پردازنده‌ی ساخت Gradle

پیش‌پردازنده‌ی ساخت Gradle به طور پیش‌فرض در Unity Editor نسخه‌های 2021.3.41f1 و بالاتر فعال است. این پردازنده به طور خودکار تمام تنظیمات لازم Gradle و player را برای پشتیبانی از جدیدترین Google Mobile Ads Unity Plugin در نسخه‌های قبلی Unity Editor اعمال می‌کند.

فعال کردن پیش‌پردازنده ساخت Gradle

تنظیمات اندروید و گریدل را به صورت دستی پیکربندی کنید

فعال کردن قالب‌های سفارشی Gradle

به تنظیمات پروژه > پخش‌کننده > اندروید > تنظیمات انتشار > ساخت بروید و Custom Main Gradle Template و Custom Gradle Properties Template را فعال کنید.

فعال کردن قالب‌های سفارشی Gradle

تنظیم سطح API هدف

از منوی اصلی ، مسیر Edit > Project Settings > Player > Android > Other Settings را باز کنید و Target API Level را روی API Level 23 یا بالاتر تنظیم کنید.

‎۲۰۲۱.۳.۴۱f۱ - ۲۰۲۲.۳

فعال کردن پیش‌پردازنده‌ی ساخت Gradle

پیش‌پردازنده‌ی ساخت Gradle به طور پیش‌فرض در Unity Editor نسخه‌های 2021.3.41f1 و بالاتر فعال است. این پردازنده به طور خودکار تمام تنظیمات لازم Gradle و player را برای پشتیبانی از جدیدترین Google Mobile Ads Unity Plugin در نسخه‌های قبلی Unity Editor اعمال می‌کند.

فعال کردن پیش‌پردازنده ساخت Gradle

تنظیمات اندروید و گریدل را به صورت دستی پیکربندی کنید

فعال کردن قالب‌های سفارشی Gradle

به تنظیمات پروژه > پخش‌کننده > اندروید > تنظیمات انتشار > ساخت بروید و Custom Main Gradle Template و Custom Gradle Properties Template را فعال کنید.

فعال کردن قالب‌های سفارشی Gradle

تنظیم سطح API هدف

از منوی اصلی ، مسیر Edit > Project Settings > Player > Android > Other Settings را باز کنید و Target API Level را روی API Level 23 یا بالاتر تنظیم کنید.

لیست نادیده گرفتن jetifier را به `gradleTemplate.properties` اضافه کنید

Assets/Plugins/Android/gradleTemplate.properties را ویرایش کرده و خط زیر را به آن اضافه کنید:

  android.jetifier.ignorelist=annotation-experimental-1.4.0.aar

فایل `minSDKVersion` را از `AndroidManifest.xml` حذف کنید.

Assets/Plugins/Android/GoogleMobileAdsPlugin.androidlib/AndroidManifest.xml را ویرایش کنید و android:minSdkVersion="21" را از گره uses-sdk حذف کنید. AndroidManifest.xml شما باید به شکل زیر باشد:

<?xml version="1.0" encoding="utf-8"?>
<manifest xmlns:android="http://schemas.android.com/apk/res/android"
    package="com.google.unity.ads"
    android:versionName="1.0"
    android:versionCode="1">
  <uses-sdk />
  <application>
    <uses-library android:required="false" android:name="org.apache.http.legacy"/>
  </application>
</manifest>

۲۰۱۹.۴ - ۲۰۲۱.۳.۳۷f۱

پیش‌نیازها

قبل از ادامه، مطمئن شوید که موارد زیر را دارید:

فعال کردن قالب‌های سفارشی Gradle

به تنظیمات پروژه > پخش‌کننده > اندروید > تنظیمات انتشار > ساخت بروید و Custom Main Gradle Template و Custom Gradle Properties Template را فعال کنید.

فعال کردن قالب‌های سفارشی Gradle

تنظیم سطح API هدف

از منوی اصلی ، مسیر Edit > Project Settings > Player > Android > Other Settings را باز کنید و سطح API هدف را روی API Level 35 یا بالاتر تنظیم کنید.

اکسپورت به اندروید استودیو

تنظیمات ساخت اندروید را با انتخاب File (یا Unity Editor در MacOS) > Build Settings تغییر دهید و Export Project را تیک بزنید:

پروژه صادرات

اگر هشداری مبنی بر فقدان API سطح ۳۵ پلتفرم SDK اندروید دریافت کردید، گزینه «به‌روزرسانی SDK اندروید» را انتخاب کنید.

اندروید استودیو را باز کنید

این بخش شامل مراحلی است که در اندروید استودیو انجام می‌شوند.

پیکربندی Gradle JDK را به‌روزرسانی کنید

تنظیمات Gradle را از مسیر File (یا Android Studio در MacOS) > Settings > Build > Execution > Deployment > Build Tools > Gradle باز کنید. منوی کشویی Gradle JDK را پیدا کنید و Gradle JDK را روی استفاده از JDK 17 یا بالاتر تنظیم کنید.

پیکربندی Gradle JDK را به‌روزرسانی کنید

اگر JDK 17 را نصب ندارید، گزینه‌های دانلود JDK را از نوار منوی Gradle JDK انتخاب کرده و یک نسخه سازگار را دانلود کنید. ما JetBrains runtime vendor با پشتیبانی aarch64 را توصیه می‌کنیم تا با آنچه اندروید استودیو توزیع می‌کند، مطابقت داشته باشد.

به‌روزرسانی build.gradle در سطح پروژه

نسخه ابزار Gradle را روی 8.1.1 یا جدیدتر تنظیم کنید.

plugins {
    id 'com.android.application' version '8.1.1' apply false
    id 'com.android.library' version '8.1.1' apply false
}

task clean(type: Delete) {
    delete rootProject.buildDir
}

به‌روزرسانی /gradle/gradle-wrapper.properties

distributionUrl طوری تنظیم کنید که از Gradle 8.1.1 یا جدیدتر استفاده کند.

distributionUrl=https\://services.gradle.org/distributions/gradle-8.1.1-bin.zip

به‌روزرسانی launcher/build.gradle

  • ویژگی namespace را با استفاده از مقدار ویژگی package از launcher/AndroidManifest.xml تنظیم کنید.
  • تنظیم sourceCompatibility و targetCompatibility روی جاوا ۱۷
apply plugin: 'com