گزینه های اضافی نصب Unity
با مجموعهها، منظم بمانید
ذخیره و طبقهبندی محتوا براساس اولویتهای شما.
به جای دانلود یک فایل .zip بزرگ حاوی همه فایلهای .unitypackage برای NET 3.X و NET 4.X، می‌توانید بسته‌های جداگانه را از سایت Google APIs for Unity دانلود کنید.
سایت ارائه می دهد:
- فایلهای
.unitypackage .NET 4.X برای وارد کردن به عنوان بسته‌های دارایی. - بایگانی‌های
.tgz فردی برای وارد کردن با استفاده از Unity Package Manager.
این به ویژه زمانی مفید است که برنامه شما از یک محصول Firebase استفاده می‌کند، زیرا فایلهای .unitypackage منفرد حاوی تمام وابستگی‌های مورد نیاز هستند و فایلهای .tgz در کنار فایلهای .tgz مرتبط فهرست شده‌اند که به آنها وابسته هستند.
این صفحه دستورالعمل های مربوط به Unity Package Manager را ارائه می دهد، بنابراین ایده خوبی است که در مورد ابزار از مستندات Unity بیاموزید.
بسته های Firebase را به عنوان دارایی وارد کنید
هنگام وارد کردن محصولات Firebase از فایلهای .unitypackage دانلود شده از Google APIs for Unity ، موارد زیر را در نظر داشته باشید:
اگر از چندین محصول Firebase در پروژه خود استفاده می کنید، باید همه محصولات Firebase را دانلود و به یک نسخه ارتقا دهید.
روش های واردات را در یک پروژه مخلوط نکنید. یعنی محصولات Firebase را با جریان بسته Asset و با استفاده از جریان Unity Package Manager وارد نکنید.
پس از بارگیری ، برای واردات:
در پروژه Unity باز خود، به Assets > Import Package > Custom Package بروید.
در پنجره Import Unity Package ، روی Import کلیک کنید.
بسته های Firebase را با استفاده از Unity Package Manager وارد کنید
هنگام وارد کردن محصولات Firebase از فایلهای .tgz دانلود شده از Google APIs for Unity ، موارد زیر را در نظر داشته باشید:
این روش فقط در سال 2018.3+ موجود است.
اگر از چندین محصول Firebase در پروژه خود استفاده می کنید، باید همه محصولات Firebase را دانلود و به یک نسخه ارتقا دهید.
روش های واردات را در یک پروژه مخلوط نکنید. یعنی محصولات Firebase را با جریان بسته Asset و با جریان Unity Package Manager وارد نکنید.
وابستگی‌های هر فایل .tgz محصول در کنار فایلهای .tgz مربوط به خودشان پیوند داده شده‌اند. باید فایل .tgz محصول و فایل های .tgz وابستگی را به ترتیب صحیح دانلود و وارد کنید:
- مدیر وابستگی خارجی (
com.google.external-dependency-manager ) - Firebase Core (
com.google.firebase.app ) - محصولات Firebase مورد استفاده در پروژه شما. اگر از Realtime Database یا Cloud Storage استفاده می‌کنید، ابتدا Authentication (
com.google.firebase.auth ) را وارد کنید.
پس از دانلود، فایلهای .tgz را با استفاده از یکی از روش‌های زیر وارد پروژه خود کنید:
UI مدیر بسته
- پنجره مدیر بسته Unity را باز کنید.
- روی نماد
+ در گوشه سمت چپ بالای پنجره Package Manager کلیک کنید و Add package from tarball را انتخاب کنید تا مرورگر فایل باز شود. - تربال مورد نظر را در مرورگر فایل انتخاب کنید.
برخی از نسخه‌های قدیمی‌تر Unity 2019 از افزودن مستقیم تاربال پشتیبانی نمی‌کنند. در این مورد، شما نیاز دارید:
- فایل
.tgz را از حالت فشرده خارج کنید. - روی نماد
+ در گوشه سمت چپ بالای پنجره Package Manager کلیک کنید و Add package from disk را انتخاب کنید تا مرورگر فایل باز شود. - پوشه استخراج شده را در مرورگر فایل انتخاب کنید.
manifest.json
- یک پوشه جدید در کنار پوشه
Packages پروژه خود ایجاد کنید و نام آن را GooglePackages بگذارید. - پرونده های
.tgz را در آن پوشه قرار دهید. - از یک ویرایشگر متن برای باز کردن
Packages/manifest.json در پوشه پروژه Unity خود استفاده کنید. برای هر بسته ای که می خواهید وارد کنید یک ورودی اضافه کنید و نام بسته را به مکان روی دیسک نگاشت کنید. حتماً file: به مسیر پرونده .tgz . به عنوان مثال، اگر شما com.google.firebase.storage و وابستگی های آن را وارد می کردید، manifest.json شما به شکل زیر خواهد بود:
{
"dependencies": {
"com.google.external-dependency-manager": "file:../GooglePackages/com.google.external-dependency-manager-1.2.164.tgz",
"com.google.firebase.app": "file:../GooglePackages/com.google.firebase.app-7.1.0.tgz",
"com.google.firebase.auth": "file:../GooglePackages/com.google.firebase.auth-7.1.0.tgz",
"com.google.firebase.storage": "file:../GooglePackages/com.google.firebase.storage-7.1.0.tgz",
// com.unity package entries...
}
}
فایل manifest.json را ذخیره کنید.
هنگامی که یونیتی فوکوس خود را به دست آورد، manifest.json را دوباره بارگیری می کند و بسته های تازه اضافه شده را وارد می کند.
برخی از نسخه‌های قدیمی‌تر Unity از فایلهای .tgz در manifest.json پشتیبانی نمی‌کنند. در این صورت باید:
- فایل
.tgz را از حالت فشرده خارج کنید. manifest.json خود را ویرایش کنید تا به جای فایل .tgz از مسیر پوشه استخراج شده استفاده کنید، مانند این:
{
"dependencies": {
"com.google.external-dependency-manager": "file:../GooglePackages/com.google.external-dependency-manager-1.2.164",
"com.google.firebase.app": "file:../GooglePackages/com.google.firebase.app-7.1.0",
"com.google.firebase.auth": "file:../GooglePackages/com.google.firebase.auth-7.1.0",
"com.google.firebase.storage": "file:../GooglePackages/com.google.firebase.storage-7.1.0",
// com.unity package entries...
}
}
از Unity Package Manager به بسته های Asset مهاجرت کنید
در برخی موارد، ممکن است بخواهید از استفاده از Unity Package Manager برای ردیابی محصولات Firebase به وارد کردن محصولات در پوشه Assets تغییر دهید.
اگر مطمئن نیستید که از کدام روش واردات استفاده می‌کنید، در پوشه پروژه Unity، فایل Packages/manifest.json را باز کنید. اگر فایل حاوی ورودی‌هایی است که با com.google.firebase شروع می‌شوند، پروژه شما از Unity Package Manager برای وارد کردن استفاده می‌کند.
برای مهاجرت به بسته های دارایی:
به نسخه های فعلی بسته Firebase در پروژه خود توجه کنید و آنها را حذف کنید.
- از منوی پنجره ، Package Manager را انتخاب کنید. در پنجره Package Manager ، مطمئن شوید که "Packages: In Project" انتخاب شده است.
- به نسخه های بسته های Firebase وارد شده توجه کنید.
- روی نام هر بسته کلیک کنید، سپس روی حذف کلیک کنید. حتماً بسته External Dependency Manager (
.com.google.external-dependency-manager ) و همچنین بسته های Firebase را حذف کنید.
فایلهای جایگزین .unitypackage را بارگیری و وارد کنید. شما دو گزینه دارید:
- اگر می‌توانید به آخرین نسخه هر بسته ارتقا دهید، فایل فشرده Firebase Unity SDK را دانلود کرده و همانطور که در افزودن Firebase به پروژه Unity خود توضیح داده شده است، وارد کنید.
- اگر نیاز به حفظ نسخه‌های
.unitypackage فعلی دارید، می‌توانید بسته‌های جداگانه را همانطور که در بالا در این صفحه توضیح داده شد دانلود و وارد کنید.
از بسته‌های Asset به Unity Package Manager مهاجرت کنید
در برخی موارد، ممکن است بخواهید از وارد کردن محصولات در پوشه Assets به واردات و ردیابی محصولات با Unity Package Manager بروید.
اگر مطمئن نیستید که از کدام روش واردات استفاده می‌کنید، در پوشه پروژه Unity، فایل Packages/manifest.json را باز کنید. اگر فایل حاوی ورودی‌هایی است که با com.google.firebase شروع می‌شوند، پروژه شما در حال حاضر از Unity Package Manager برای وارد کردن استفاده می‌کند.
برای مهاجرت به Unity Package Manager:
مطمئن شوید که تمام بسته‌های Firebase و بسته External Dependency Manager با استفاده از یکی از روش‌های زیر از پوشه Assets حذف شده‌اند.
رابط کاربری EDM4U
- در پروژه Unity باز خود، به Assets > External Dependency Manager > Version Handler > Uninstall Managed Packages بروید.
- همه بسته های Firebase و External Dependency Manager را انتخاب کنید.
- روی Uninstall Selected Package کلیک کنید.
حذف دستی
با استفاده از ابزارهای سیستم فایل، پوشه های زیر را به صورت دستی حذف کنید:
-
Assets/Editor Default Resources/Firebase -
Assets/ExternalDependencyManager -
Assets/Firebase -
Assets/Parse -
Assets/Plugins/iOS/Firebase
بسته ها را با استفاده از Unity Package Manager وارد کنید، همانطور که در بالا در این صفحه توضیح داده شد.
جز در مواردی که غیر از این ذکر شده باشد،محتوای این صفحه تحت مجوز Creative Commons Attribution 4.0 License است. نمونه کدها نیز دارای مجوز Apache 2.0 License است. برای اطلاع از جزئیات، به خطمشیهای سایت Google Developers مراجعه کنید. جاوا علامت تجاری ثبتشده Oracle و/یا شرکتهای وابسته به آن است.
تاریخ آخرین بهروزرسانی 2025-08-08 بهوقت ساعت هماهنگ جهانی.
[null,null,["تاریخ آخرین بهروزرسانی 2025-08-08 بهوقت ساعت هماهنگ جهانی."],[],[],null,["\u003cbr /\u003e\n\nRather than downloading a large `.zip` file containing all `.unitypackage`\nfiles for both .NET 3.X and .NET 4.X, you can download individual packages from\nthe [Google APIs for Unity site](https://developers.google.com/unity/packages).\n\nThe site provides:\n\n- Individual .NET 4.X `.unitypackage` files to import as Asset packages.\n- Individual `.tgz` archives to import using Unity Package Manager.\n\nThis is especially useful when your app uses a single Firebase product, since\nthe individual `.unitypackage` files contain all needed dependencies, and the\n`.tgz` files are listed alongside related `.tgz` files on which they depend.\n\nThis page provides instructions involving Unity Package Manager, so it's a good\nidea to learn about the tool [from the Unity documentation](https://docs.unity3d.com/Manual/Packages.html).\n| **Note:** If you still need to use .NET 3.x, download the entire Firebase SDK as described in [Add Firebase to your Unity project](/docs/unity/setup#add-sdks).\n\nImport Firebase packages as Assets\n\nWhen importing Firebase products from `.unitypackage` files downloaded from\n[Google APIs for Unity site](https://developers.google.com/unity/packages),\nkeep the following in mind:\n\n- If you are using multiple Firebase products in your project, you must download\n and upgrade all Firebase products to the same version.\n\n- Do not mix import methods in one project. That is, do not import\n Firebase products with the Asset package flow and using the Unity Package\n Manager flow.\n\nAfter downloading, to import:\n\n1. In your open Unity project, navigate to **Assets** \\\u003e **Import Package** \\\u003e\n **Custom Package**.\n\n2. In the *Import Unity Package* window, click **Import**.\n\nImport Firebase packages using Unity Package Manager\n\nWhen importing Firebase products from `.tgz` files downloaded from the [Google APIs for Unity archive](https://developers.google.com/unity/archive), keep the following in mind:\n\n- This method is only available in 2018.3+.\n\n- If you are using multiple Firebase products in your project, you must download\n and upgrade all Firebase products to the same version.\n\n- Do not mix import methods in one project. That is, do not import\n Firebase products with the Asset package flow and with the Unity Package Manager\n flow.\n\n- Dependencies for each product `.tgz` file are linked alongside in their own\n `.tgz` files. You must download and import the product `.tgz` file and\n dependency `.tgz` files, in the correct order:\n\n 1. External Dependency Manager (`com.google.external-dependency-manager`)\n 2. Firebase Core (`com.google.firebase.app`)\n 3. Firebase products used in your project. If you use Realtime Database or Cloud Storage, import Authentication (`com.google.firebase.auth`) first.\n\nAfter downloading, import `.tgz` files into your project using one of the\nfollowing methods: \n\nPackage Manager UI\n\n1. Open Unity's Package Manager window.\n2. Click the `+` icon in the top-left corner of the Package Manager window and select `Add package from tarball` to open the file browser.\n3. Select the desired tarball in the file browser.\n\nSome older versions of Unity 2019 do not support adding tarballs directly.\nIn this case, you will need to:\n\n1. Unzip the `.tgz` file.\n2. Click the `+` icon in the top-left corner of the Package Manager window and select `Add package from disk` to open the file browser.\n3. Select the extracted folder in the file browser.\n\nmanifest.json\n\n1. Create a new folder next to your project's `Packages` folder and name it `GooglePackages`.\n2. Place the `.tgz` files into that folder.\n3. Use a text editor to open `Packages/manifest.json` under your Unity project folder.\n4. Add an entry for each package you want to import, mapping the package name\n to the location on disk. Be sure to append `file:` to the `.tgz` file path. For\n example, if you were importing `com.google.firebase.storage` and its\n dependency's, your `manifest.json` would look like this:\n\n {\n \"dependencies\": {\n \"com.google.external-dependency-manager\": \"file:../GooglePackages/com.google.external-dependency-manager-1.2.164.tgz\",\n \"com.google.firebase.app\": \"file:../GooglePackages/com.google.firebase.app-7.1.0.tgz\",\n \"com.google.firebase.auth\": \"file:../GooglePackages/com.google.firebase.auth-7.1.0.tgz\",\n \"com.google.firebase.storage\": \"file:../GooglePackages/com.google.firebase.storage-7.1.0.tgz\",\n // com.unity package entries...\n }\n }\n\n5. Save the `manifest.json` file.\n\n6. When Unity regains focus it will reload the `manifest.json` and import the\n newly-added packages.\n\nSome older versions of Unity do not support `.tgz` files in the `manifest.json`.\nIn this case, you should:\n\n1. Unzip the `.tgz` file.\n2. Edit your `manifest.json` to use the path to the extracted folder, instead\n of the `.tgz` file, like so:\n\n {\n \"dependencies\": {\n \"com.google.external-dependency-manager\": \"file:../GooglePackages/com.google.external-dependency-manager-1.2.164\",\n \"com.google.firebase.app\": \"file:../GooglePackages/com.google.firebase.app-7.1.0\",\n \"com.google.firebase.auth\": \"file:../GooglePackages/com.google.firebase.auth-7.1.0\",\n \"com.google.firebase.storage\": \"file:../GooglePackages/com.google.firebase.storage-7.1.0\",\n // com.unity package entries...\n }\n }\n\nMigrate from Unity Package Manager to Asset packages\n\nIn some cases, you might want to switch from using Unity Package Manager to\ntrack Firebase products, to importing products under the `Assets` folder.\n\nIf you're not sure which import method you're using, in your Unity project\nfolder, open the file `Packages/manifest.json`. If the file contains entries\nstarting with `com.google.firebase`, your project used Unity Package Manager for\nimport.\n\nTo migrate to Asset packages:\n\n1. Note current Firebase package versions in your project and remove them.\n\n 1. From the **Window** menu, select **Package Manager** . In the *Package\n Manager* window, make sure \"Packages: In Project\" is selected.\n 2. Note the versions of imported Firebase packages.\n 3. Click on each package name, then click **Remove** . Be sure to remove the External Dependency Manager package (`.com.google.external-dependency-manager`) as well as Firebase packages.\n2. Download and import replacement `.unitypackage` files. You have two options:\n\n - If you can upgrade to the latest version of each package, download the Firebase Unity SDK zip file and import as described in [Add Firebase to\n your Unity project](/docs/unity/setup#add-sdks).\n - If you need to preserve current `.unitypackage` versions, you can download and import individual packages as described [above](#alternative_individual_unitypackages) on this page.\n\nMigrate from Asset packages to Unity Package Manager\n\nIn some cases, you might want to switch from importing products under the\n`Assets` folder to importing and tracking products with Unity Package Manager.\n\nIf you're not sure which import method you're using, in your Unity project\nfolder, open the file `Packages/manifest.json`. If the file contains entries\nstarting with `com.google.firebase` your project is already using Unity Package\nManager for import.\n\nTo migrate to Unity Package Manager:\n\n1. Make sure all Firebase packages and the External Dependency Manager package\n are removed from the `Assets` folder, using either of the following methods.\n\n EDM4U UI\n\n\n 1. In your open Unity project, navigate to **Assets \\\u003e External\n Dependency Manager \\\u003e Version Handler \\\u003e Uninstall Managed\n Packages**.\n 2. Select all Firebase packages and External Dependency Manager.\n 3. Click **Uninstall Selected Package**.\n\n \u003cbr /\u003e\n\n Manual removal\n\n Using file system tools, manually delete the following folders:\n - `Assets/Editor Default Resources/Firebase`\n - `Assets/ExternalDependencyManager`\n - `Assets/Firebase`\n - `Assets/Parse`\n - `Assets/Plugins/iOS/Firebase`\n2. Import packages using Unity Package Manager, as described [above](#alternative_unity_package_manager)\n on this page."]]
