لاستخدام ملفات البيانات الموسّعة لحِزم APK، يجب استخدام Unity 2018.2
لتحسين وتيرة عرض اللقطات وقياسات وحدة معالجة الرسومات، يجب استخدام الإصدار 2019.3.14 من Unity أو إصدار أحدث.
لاستخدام ميزة "مشاهد قابلة للتوجيه"، يجب استخدام Unity 2019.3 أو إصدار أحدث وحزمة Addressables 1.19.4 أو إصدار أحدث.
تنزيل المكوّن الإضافي
نزِّل المكوّن الإضافي من
مستودع GitHub. انقر على
.unitypackage لتنزيل الملف.
استيراد المكوّن الإضافي
قبل استيراد المكوّن الإضافي، تأكَّد من أنّ مشروعك يستخدم الإصدار 4 .6 من.NET.
ينطبق ذلك على الإصدار 2018.4 من Unity والإصدارات الأقدم (تحتوي الإصدارات الأحدث من Unity على الإصدار 4 .6 من.NET فقط).
اختَر ملف (File) > إعدادات الإنشاء (Build Settings). تأكَّد من اختيار Android كنظام التشغيل الحالي.
انقر على الزر إعدادات المشغّل.
ضمن إعدادات أخرى، ابحث عن إصدار وقت تشغيل البرامج النصية واختَر
.NET 4.6.
يتم توفير المكوّن الإضافي كحزمة Unity يمكنك استيرادها في مشروعك.
اختَر مواد العرض > استيراد حزمة > حزمة مخصّصة واختَر ملف .unitypackage الذي نزّلته.
الإصدار 1.5.1 أو إصدار أحدث من أداة Android Performance Tuner مع Unity 2017
يتطلّب استخدام الإصدار 1.5.1 أو الإصدارات الأحدث من أداة Android Performance Tuner مع Unity 2017
اتّخاذ الخطوات الإضافية التالية عند استيراد المكوّن الإضافي:
انتقِل إلى المجلد Assets/AndroidPerformanceTuner/Editor.
انقر على الملف Google.Android.PerformanceTuner.Editor لفتحه في الفاحص.
انقر على مرجع التجميع المفقود، ثم انقر على - لإزالته.
انقر على الزر تطبيق.
الشكل 1. مرجع التجميع غير متوفّر.
انتقِل إلى المجلد Assets/AndroidPerformanceTuner/Runtime.
انقر على الملف Google.Android.PerformanceTuner لفتحه في
Inspector.
كرِّر الخطوة 3 لإزالة مرجعَي التجميع المفقودَين.
أعِد تشغيل Unity.
انتقِل إلى Window > AndroidPerformanceTuner > Setup وتأكَّد من عدم ظهور أي أخطاء.
إعادة استيراد المكوّن الإضافي بعد حذفه
إذا كنت تعيد استيراد المكوّن الإضافي بعد إزالته من المشروع، عليك إزالة
ANDROID_PERFORMANCE_TUNER_UTILITIES من
إعدادات المشغّل > رموز تعريف البرمجة النصية أولاً.
ضبط المكوّن الإضافي
لضبط الإضافة، اتّبِع الخطوات التالية:
بالنسبة إلى الإصدار 2019.3.14 من Unity أو الإصدارات الأحدث:
فعِّل مكتبة Android Frame Pacing. ستستخدم أداة Android Performance Tuner هذه المكتبة لقياس أداء لعبتك، بما في ذلك مقاييس أكثر تفصيلاً من تلك التي تقدّمها Unity وحدها.
اختَر ملف > إعدادات الإنشاء وانقر على زر إعدادات المشغّل.
ضِمن الدقة والعرض، ضَع علامة في مربّع الاختيار مزامنة اللقطات المحسّنة.
مزامنة عرض الإطار مع الفواصل العمودية
من "إعدادات المشغّل" (Player Settings)، اختَر علامة التبويب الجودة (Quality) وابحث عن قائمة عدد المزامنة العمودية (VSync Count). استخدِم أي خيار (باستثناء عدم المزامنة).
تتيح الخيارات الأخرى غير عدم المزامنة إجراء قياسات أكثر دقة بالاقتران مع مكتبة Frame Pacing لنظام التشغيل Android.
(بالنسبة إلى إصدارات Unity الأقدم من 2019) اضبط نظام التصميم على Gradle. اختَر
ملف (File) > إعدادات الإنشاء (Build Settings). ابحث عن نظام التصميم واختَر Gradle.
أضِف إذن الوصول إلى الإنترنت. ضمن إعدادات أخرى، ابحث عن
الوصول إلى الإنترنت وانقر على مطلوب.
أدخِل مفتاح واجهة برمجة التطبيقات. بعد تثبيت المكوّن الإضافي، يمكنك الوصول إليه من قائمة
Window > Android Performance Tuner > Setup. في مربّع الحوار هذا، انقر على علامة التبويب الإعدادات وأدخِل مفتاح واجهة برمجة التطبيقات من مشروعك على Google Cloud في الحقل مفتاح واجهة برمجة التطبيقات.
الشكل 2: علامة التبويب "الإعدادات" في المكوّن الإضافي
يخضع كل من المحتوى وعيّنات التعليمات البرمجية في هذه الصفحة للتراخيص الموضحّة في ترخيص استخدام المحتوى. إنّ Java وOpenJDK هما علامتان تجاريتان مسجَّلتان لشركة Oracle و/أو الشركات التابعة لها.
تاريخ التعديل الأخير: 2025-08-26 (حسب التوقيت العالمي المتفَّق عليه)
[[["يسهُل فهم المحتوى.","easyToUnderstand","thumb-up"],["ساعَدني المحتوى في حلّ مشكلتي.","solvedMyProblem","thumb-up"],["غير ذلك","otherUp","thumb-up"]],[["لا يحتوي على المعلومات التي أحتاج إليها.","missingTheInformationINeed","thumb-down"],["الخطوات معقدة للغاية / كثيرة جدًا.","tooComplicatedTooManySteps","thumb-down"],["المحتوى قديم.","outOfDate","thumb-down"],["ثمة مشكلة في الترجمة.","translationIssue","thumb-down"],["مشكلة في العيّنات / التعليمات البرمجية","samplesCodeIssue","thumb-down"],["غير ذلك","otherDown","thumb-down"]],["تاريخ التعديل الأخير: 2025-08-26 (حسب التوقيت العالمي المتفَّق عليه)"],[],[],null,["This page describes how to download, import, and configure the Unity plugin for\nAndroid Performance Tuner.\n\nRequirements\n\nTo use the plugin in your game, use a supported version of Unity:\n\n- Unity version 2017.4 or later and [.NET version 4.6](https://dotnet.microsoft.com/download/dotnet-framework/net46)\n- To use APK Expansion files, Unity 2018.2 is required\n- For improved frame pacing and GPU measurements, Unity version 2019.3.14 or later is required\n- For Addressables scenes support, Unity 2019.3 or later and [Addressables package 1.19.4](https://docs.unity3d.com/Packages/com.unity.addressables@0.8/manual/index.html) or later are required.\n\nDownload the plugin\n\nDownload the plugin from the\n[GitHub repository](https://github.com/android/tuningfork/releases). Select the\n`.unitypackage` file download.\n\nImport the plugin\n\nBefore importing the plugin, make sure your project is using .NET version 4.6.\nThis applies to Unity version 2018.4 and earlier (later versions of Unity\ncontain .NET version 4.6 only).\n\n1. Select **File \\\u003e Build Settings**. Make sure Android is selected as the current platform.\n2. Click the **Player Settings** button.\n3. Under **Other Settings** , find **Scripting Runtime Version** and select **.NET 4.6**.\n\nThe plugin is provided as a Unity Package that you can import in your project.\nSelect **Assets \\\u003e Import Package \\\u003e Custom Package** and select the\n`.unitypackage` file you downloaded.\n\nAndroid Performance Tuner version **1.5.1 or higher** with **Unity 2017**\n\nUsing Android Performance Tuner version **1.5.1 or higher** with **Unity 2017**\nrequires the following additional steps when importing the plugin:\n\n1. Go to the **Assets/AndroidPerformanceTuner/Editor** folder.\n2. Click the **Google.Android.PerformanceTuner.Editor** file to open it in the **Inspector**.\n3. Click the missing assembly reference and then click **-** to remove it.\n4. Click the **Apply** button.\n\n\n **Figure 1.** Missing assembly reference.\n5. Go to the **Assets/AndroidPerformanceTuner/Runtime** folder.\n\n6. Click the **Google.Android.PerformanceTuner** file to open it in the\n Inspector.\n\n7. Repeat **step 3** to remove the two missing assembly references.\n\n8. Restart Unity.\n\n9. Go to **Window \\\u003e AndroidPerformanceTuner \\\u003e Setup** and verify that no errors\n are displayed.\n\nRe-importing the plugin after deletion\n\nIf you're re-importing the plugin after removing it from the project, remove\n`ANDROID_PERFORMANCE_TUNER_UTILITIES` from\n**Player Settings \\\u003e Scripting Define Symbols** first.\n\nConfigure the plugin\n\nTo configure the plugin, do the following:\n\n1. For Unity version 2019.3.14 or later:\n\n - Enable the Android Frame Pacing library. Android Performance Tuner will use\n this library to measure the performance of your game, including more\n in-depth measures than what Unity alone reports.\n\n Select **File \\\u003e Build Settings** and click the **Player Settings** button.\n Under **Resolution and Presentation** , select the **Optimized Frame Pacing**\n checkbox.\n - Synchronize the frame rendering with vertical blanks.\n\n From the Player Settings, select the **Quality** tab and find the\n **VSync Count** menu. Use any selection (except **Don't Sync** ).\n Selections other than **Don't Sync** enable more precise measurements in\n conjunction with the Android Frame Pacing library.\n2. (For versions of Unity prior to 2019) Set the build system to Gradle. Select\n **File \\\u003e Build Settings** . Find **Build System** and select **Gradle**.\n\n3. Add the internet access permission. Under **Other Settings** , find\n **Internet Access** and select **Require**.\n\n4. Enter your API key. Once the plugin is installed, you can enter it from the\n **Window \\\u003e Android Performance Tuner \\\u003e Setup** menu. On this dialog, select the\n **Settings** tab and enter the\n [API key from your Google Cloud project](/games/sdk/performance-tuner/unity/enable-api)\n into the **API key** field.\n\n | **Note:** If you don't enter your API key, Android Performance Tuner won't send your game performance data to the Google Play Console. Android Performance Tuner logs this error, and you can see the error using `adb logcat`. (You will run `adb logcat` in the next section to confirm the proper operation of Android Performance Tuner.)\n\n\n **Figure 2.** Settings tab in the plugin"]]
الشكل 1. مرجع التجميع غير متوفّر.
الشكل 2: علامة التبويب "الإعدادات" في المكوّن الإضافي