گزینه های اضافی نصب Unity

Rather than downloading a large .zip file containing all .unitypackage files for both .NET 3.X and .NET 4.X, you can download individual packages from the Google APIs for Unity site .

سایت ارائه می‌دهد:

  • فایل‌های .NET 4.X .unitypackage تکی برای وارد کردن به عنوان بسته‌های Asset.
  • فایل‌های آرشیو .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 ایمپورت نکنید.

بعد از دانلود، برای وارد کردن:

  1. در پروژه باز Unity خود، به مسیر Assets > Import Package > Custom Package بروید.

  2. در پنجره‌ی «وارد کردن بسته‌ی یونیتی» ، روی «وارد کردن» کلیک کنید.

وارد کردن بسته‌های Firebase با استفاده از Unity Package Manager

هنگام وارد کردن محصولات Firebase از فایل‌های .tgz که از آرشیو Google APIs for Unity دانلود شده‌اند، موارد زیر را در نظر داشته باشید:

  • این روش فقط در نسخه‌های ۲۰۱۸.۳ به بالا در دسترس است.

  • اگر در پروژه خود از چندین محصول Firebase استفاده می‌کنید، باید همه محصولات Firebase را دانلود و به نسخه یکسانی ارتقا دهید.

  • روش‌های ایمپورت را در یک پروژه با هم ترکیب نکنید. یعنی محصولات Firebase را با جریان بسته Asset و با جریان بسته Unity Package Manager ایمپورت نکنید.

  • وابستگی‌های هر محصول با پسوند .tgz در فایل‌های .tgz مخصوص به خود لینک شده‌اند. شما باید فایل .tgz محصول و فایل‌های وابستگی .tgz را به ترتیب صحیح دانلود و وارد کنید:

    1. مدیر وابستگی خارجی ( com.google.external-dependency-manager )
    2. هسته فایربیس ( com.google.firebase.app )
    3. محصولات Firebase که در پروژه شما استفاده می‌شوند. اگر Realtime Database یا Cloud Storage استفاده می‌کنید، ابتدا Authentication ( com.google.firebase.auth ) را وارد کنید.

پس از دانلود، فایل‌های .tgz را با استفاده از یکی از روش‌های زیر به پروژه خود وارد کنید:

رابط کاربری مدیریت بسته‌ها

  1. پنجره‌ی Package Manager در یونیتی را باز کنید.
  2. روی آیکون + در گوشه سمت چپ بالای پنجره Package Manager کلیک کنید و گزینه Add package from tarball انتخاب کنید تا مرورگر فایل باز شود.
  3. فایل tarball مورد نظر را در مرورگر فایل انتخاب کنید.

برخی از نسخه‌های قدیمی‌تر یونیتی ۲۰۱۹ از اضافه کردن مستقیم tarballها پشتیبانی نمی‌کنند. در این صورت، شما باید:

  1. فایل .tgz را از حالت فشرده خارج کنید.
  2. Click the + icon in the top-left corner of the Package Manager window and select Add package from disk to open the file browser.
  3. پوشه استخراج شده را در مرورگر فایل انتخاب کنید.

مانیفست.json

  1. یک پوشه جدید در کنار پوشه Packages پروژه خود ایجاد کنید و نام آن را GooglePackages بگذارید.
  2. فایل‌های .tgz را در آن پوشه قرار دهید.
  3. با استفاده از یک ویرایشگر متن، Packages/manifest.json را در پوشه پروژه Unity خود باز کنید.

  4. Add an entry for each package you want to import, mapping the package name to the location on disk. Be sure to append file: to the .tgz file path. For example, if you were importing com.google.firebase.storage and its dependency's, your manifest.json would look like this:

    {
  "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...
  }
}

  5. فایل manifest.json را ذخیره کنید.

  6. وقتی یونیتی دوباره فوکوس را به دست بگیرد، فایل manifest.json را مجدداً بارگذاری کرده و بسته‌های تازه اضافه شده را وارد می‌کند.

برخی از نسخه‌های قدیمی‌تر Unity از فایل‌های .tgz در manifest.json پشتیبانی نمی‌کنند. در این صورت، باید:

  1. فایل .tgz را از حالت فشرده خارج کنید.

  2. Edit your manifest.json to use the path to the extracted folder, instead of the .tgz file, like so:

    {
  "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

In some cases, you might want to switch from using Unity Package Manager to track Firebase products, to importing products under the Assets folder.

اگر مطمئن نیستید از کدام روش ایمپورت استفاده می‌کنید، در پوشه پروژه Unity خود، فایل Packages/manifest.json را باز کنید. اگر فایل حاوی ورودی‌هایی است که با com.google.firebase شروع می‌شوند، پروژه شما از Unity Package Manager برای ایمپورت استفاده کرده است.

برای مهاجرت به بسته‌های دارایی:

  1. نسخه‌های فعلی بسته‌های Firebase را در پروژه خود یادداشت کنید و آنها را حذف کنید.

    1. از منوی Window ، گزینه Package Manager را انتخاب کنید. در پنجره Package Manager ، مطمئن شوید که گزینه "Packages: In Project" انتخاب شده است.
    2. به نسخه‌های بسته‌های Firebase وارد شده توجه کنید.
    3. روی نام هر بسته کلیک کنید، سپس روی حذف کلیک کنید. حتماً بسته‌ی External Dependency Manager ( .com.google.external-dependency-manager ) و همچنین بسته‌های Firebase را حذف کنید.

  2. فایل‌های جایگزین .unitypackage را دانلود و وارد کنید. شما دو گزینه دارید:

    • اگر می‌توانید هر بسته را به آخرین نسخه ارتقا دهید، فایل فشرده Firebase Unity SDK را دانلود کنید و همانطور که در بخش «افزودن Firebase به پروژه Unity خود» توضیح داده شده است، آن را وارد کنید.
    • If you need to preserve current .unitypackage versions, you can download and import individual packages as described above on this page.

مهاجرت از بسته‌های Asset به Unity Package Manager

در برخی موارد، ممکن است بخواهید از وارد کردن محصولات از طریق پوشه Assets به وارد کردن و ردیابی محصولات با Unity Package Manager تغییر دهید.

اگر مطمئن نیستید از کدام روش ایمپورت استفاده می‌کنید، در پوشه پروژه Unity خود، فایل Packages/manifest.json را باز کنید. اگر فایل شامل ورودی‌هایی است که با com.google.firebase شروع می‌شوند، پروژه شما از قبل از Unity Package Manager برای ایمپورت استفاده می‌کند.

برای مهاجرت به Unity Package Manager:

  1. مطمئن شوید که تمام بسته‌های Firebase و بسته‌ی External Dependency Manager با استفاده از یکی از روش‌های زیر از پوشه‌ی Assets حذف شده‌اند.

    رابط کاربری EDM4U

    1. در پروژه یونیتی که باز کرده‌اید، به مسیر Assets > External Dependency Manager > Version Handler > Uninstall Managed Packages بروید.
    2. همه بسته‌های Firebase و External Dependency Manager را انتخاب کنید.
    3. روی حذف نصب بسته انتخاب شده کلیک کنید.

    حذف دستی

    با استفاده از ابزارهای سیستم فایل، پوشه‌های زیر را به صورت دستی حذف کنید:

    • Assets/Editor Default Resources/Firebase
    • Assets/ExternalDependencyManager
    • Assets/Firebase
    • Assets/Parse
    • Assets/Plugins/iOS/Firebase

  2. بسته‌ها را با استفاده از Unity Package Manager، همانطور که در بالا در این صفحه توضیح داده شده است، وارد کنید.