ملفات .NET 4.X الفردية .unitypackage التي سيتم استيرادها كحِزم مواد عرض
أرشيفات .tgz الفردية التي سيتم استيرادها باستخدام "مدير حِزم Unity"
ويكون ذلك مفيدًا بشكل خاص عندما يستخدم تطبيقك منتجًا واحدًا من Firebase، لأنّ ملفات .unitypackage الفردية تحتوي على جميع التبعيات اللازمة، ويتم إدراج ملفات .tgz بجانب ملفات .tgz ذات الصلة التي تعتمد عليها.
تقدّم هذه الصفحة تعليمات تتضمّن استخدام Unity Package Manager، لذا من المفيد التعرّف على الأداة من مستندات Unity.
استيراد حِزم Firebase كأصول
عند استيراد منتجات Firebase من ملفات .unitypackage تم تنزيلها من
موقع Google APIs for Unity،
يُرجى مراعاة ما يلي:
إذا كنت تستخدم منتجات متعددة من Firebase في مشروعك، عليك تنزيل جميع منتجات Firebase وترقيتها إلى الإصدار نفسه.
لا تخلط بين طُرق الاستيراد في مشروع واحد. أي لا تستورِد منتجات Firebase باستخدام مسار حزمة مواد العرض ومسار Unity Package Manager.
بعد التنزيل، اتّبِع الخطوات التالية للاستيراد:
في مشروع Unity المفتوح، انتقِل إلى الأصول (Assets) > استيراد حزمة (Import Package) > حزمة مخصّصة (Custom Package).
في نافذة استيراد حزمة Unity، انقر على استيراد.
استيراد حِزم Firebase باستخدام Unity Package Manager
منتجات Firebase المستخدَمة في مشروعك إذا كنت تستخدم Realtime Database أو Cloud Storage، استورِد Authentication (com.google.firebase.auth) أولاً.
بعد التنزيل، استورِد ملفات .tgz إلى مشروعك باستخدام إحدى الطرق التالية:
واجهة مستخدم أداة إدارة الحِزم
افتح نافذة "أداة إدارة الحِزم" في Unity.
انقر على رمز + في أعلى يمين نافذة "إدارة الحِزم" واختَر Add package from tarball لفتح مستعرض الملفات.
اختَر حزمة tar المطلوبة في مستعرض الملفات.
لا تتيح بعض الإصدارات القديمة من Unity 2019 إضافة ملفات tarball مباشرةً.
في هذه الحالة، عليك إجراء ما يلي:
فكّ ضغط الملف .tgz.
انقر على الرمز + في أعلى يمين نافذة "إدارة الحِزم" (Package Manager) واختَر Add package from disk لفتح مستعرض الملفات.
اختَر المجلد الذي تم استخراجه في متصفّح الملفات.
manifest.json
أنشئ مجلدًا جديدًا بجانب مجلد Packages الخاص بمشروعك وسمِّه
GooglePackages.
ضَع ملفات .tgz في هذا المجلد.
استخدِم محرِّر نصوص لفتح Packages/manifest.json ضمن مجلد مشروع Unity.
أضِف إدخالاً لكل حزمة تريد استيرادها، مع ربط اسم الحزمة بالموقع الجغرافي على القرص. احرص على إضافة file: إلى مسار ملف .tgz. على سبيل المثال، إذا كنت تستورد com.google.firebase.storage والملفات التابعة له، سيبدو manifest.json على النحو التالي:
نقل البيانات من "مدير حِزم Unity" إلى حِزم مواد العرض
في بعض الحالات، قد تحتاج إلى التبديل من استخدام Unity Package Manager لتتبُّع منتجات Firebase إلى استيراد المنتجات ضمن المجلد Assets.
إذا لم تكن متأكّدًا من طريقة الاستيراد التي تستخدمها، افتح الملف Packages/manifest.json في مجلد مشروع Unity. إذا كان الملف يحتوي على إدخالات تبدأ بـ com.google.firebase، يعني ذلك أنّ مشروعك استخدم "مدير حزم Unity" للاستيراد.
للانتقال إلى "حِزم مواد العرض"، اتّبِع الخطوات التالية:
دوِّن إصدارات حِزم Firebase الحالية في مشروعك وأزِلها.
من قائمة Window (نافذة)، اختَر Package Manager (إدارة الحِزم). في نافذة إدارة الحِزم، تأكَّد من اختيار "الحِزم: في المشروع".
دوِّن إصدارات حِزم Firebase التي تم استيرادها.
انقر على اسم كل حزمة، ثم انقر على إزالة. احرص على إزالة حزمة External Dependency Manager (.com.google.external-dependency-manager) بالإضافة إلى حِزم Firebase.
نزِّل ملفات .unitypackage بديلة واستوردها. ويكون أمامك خياران:
إذا كان بإمكانك الترقية إلى أحدث إصدار من كل حزمة، نزِّل ملف zip الخاص بحزمة Firebase Unity SDK واستورِده كما هو موضّح في إضافة Firebase إلى مشروع Unity.
إذا كنت بحاجة إلى الاحتفاظ بإصدارات .unitypackage الحالية، يمكنك تنزيل الحِزم الفردية واستيرادها كما هو موضّح أعلاه في هذه الصفحة.
نقل البيانات من حِزم مواد العرض إلى "مدير حِزم Unity"
في بعض الحالات، قد تحتاج إلى التبديل من استيراد المنتجات ضمن المجلد Assets إلى استيراد المنتجات وتتبُّعها باستخدام Unity Package Manager.
إذا لم تكن متأكّدًا من طريقة الاستيراد التي تستخدمها، افتح الملف Packages/manifest.json في مجلد مشروع Unity. إذا كان الملف يتضمّن إدخالات تبدأ بـ com.google.firebase، يعني ذلك أنّ مشروعك يستخدم حاليًا Unity Package Manager للاستيراد.
للانتقال إلى "مدير حِزم Unity"، اتّبِع الخطوات التالية:
تأكَّد من إزالة جميع حِزم Firebase وحزمة External Dependency Manager من المجلد Assets، وذلك باستخدام إحدى الطريقتَين التاليتَين.
EDM4U UI
في مشروع Unity المفتوح، انتقِل إلى Assets > External
Dependency Manager > Version Handler > Uninstall Managed
Packages.
اختَر جميع حِزم Firebase وExternal Dependency Manager.
انقر على إلغاء تثبيت الحزمة المحدّدة.
الإزالة اليدوية
باستخدام أدوات نظام الملفات، احذف المجلدات التالية يدويًا:
Assets/Editor Default Resources/Firebase
Assets/ExternalDependencyManager
Assets/Firebase
Assets/Parse
Assets/Plugins/iOS/Firebase
استورِد الحِزم باستخدام "أداة إدارة حِزم Unity"، كما هو موضّح أعلاه
في هذه الصفحة.
تاريخ التعديل الأخير: 2025-09-03 (حسب التوقيت العالمي المتفَّق عليه)
[[["يسهُل فهم المحتوى.","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-09-03 (حسب التوقيت العالمي المتفَّق عليه)"],[],[],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."]]