Catch up on everything announced at Firebase Summit, and learn how Firebase can help you accelerate app development and run your app with confidence. Learn More

ตัวเลือกการติดตั้ง Unity เพิ่มเติม

จัดทุกอย่างให้เป็นระเบียบอยู่เสมอด้วยคอลเล็กชัน บันทึกและจัดหมวดหมู่เนื้อหาตามค่ากำหนดของคุณ

แทนที่จะดาวน์โหลดไฟล์ .zip ขนาดใหญ่ที่มีไฟล์ . .unitypackage ทั้งหมดสำหรับทั้ง .NET 3.X และ .NET 4.X คุณสามารถดาวน์โหลดแต่ละแพ็คเกจได้จากเว็บไซต์ Google APIs สำหรับ Unity

เว็บไซต์ให้:

  • ไฟล์ .NET 4.X .unitypackage แต่ละรายการที่จะนำเข้าเป็นแพ็คเกจสินทรัพย์
  • ไฟล์เก็บถาวร .tgz แต่ละรายการเพื่อนำเข้าโดยใช้ Unity Package Manager

สิ่งนี้มีประโยชน์อย่างยิ่งเมื่อแอปของคุณใช้ผลิตภัณฑ์ Firebase เดียว เนื่องจากไฟล์ .unitypackage แต่ละไฟล์มีการพึ่งพาที่จำเป็นทั้งหมด และไฟล์ .tgz จะแสดงพร้อมกับไฟล์ .tgz ที่เกี่ยวข้องซึ่งไฟล์เหล่านั้นต้องพึ่งพา

หน้านี้ให้คำแนะนำเกี่ยวกับ Unity Package Manager ดังนั้นจึงควรเรียนรู้เกี่ยวกับเครื่องมือ จากเอกสารประกอบของ Unity

นำเข้าแพ็คเกจ Firebase เป็นสินทรัพย์

เมื่อนำเข้าผลิตภัณฑ์ Firebase จากไฟล์ .unitypackage ที่ดาวน์โหลดจาก Google APIs สำหรับไซต์ Unity โปรดคำนึงถึงสิ่งต่อไปนี้:

  • หากคุณใช้ผลิตภัณฑ์ Firebase หลายรายการในโปรเจ็กต์ คุณต้องดาวน์โหลดและอัปเกรดผลิตภัณฑ์ Firebase ทั้งหมดเป็นเวอร์ชันเดียวกัน

  • อย่าผสมวิธีการนำเข้าในโครงการเดียว กล่าวคือ ห้ามนำเข้าผลิตภัณฑ์ Firebase ด้วยโฟลว์แพ็กเกจเนื้อหาและใช้โฟลว์ Unity Package Manager

หลังจากดาวน์โหลดแล้ว ให้นำเข้า:

  1. ในโครงการ Unity ที่เปิดอยู่ ให้ไปที่ เนื้อหา > นำเข้าแพ็คเกจ > แพ็คเกจที่กำหนดเอง

  2. ในหน้าต่าง Import Unity Package ให้คลิก Import

นำเข้าแพ็คเกจ Firebase โดยใช้ Unity Package Manager

เมื่อนำเข้าผลิตภัณฑ์ Firebase จากไฟล์ .tgz ที่ดาวน์โหลดจาก Google APIs for Unity archive ให้คำนึงถึงสิ่งต่อไปนี้:

  • วิธีนี้ใช้ได้เฉพาะใน 2018.3+

  • หากคุณใช้ผลิตภัณฑ์ Firebase หลายรายการในโปรเจ็กต์ คุณต้องดาวน์โหลดและอัปเกรดผลิตภัณฑ์ Firebase ทั้งหมดเป็นเวอร์ชันเดียวกัน

  • อย่าผสมวิธีการนำเข้าในโครงการเดียว กล่าวคือ ห้ามนำเข้าผลิตภัณฑ์ Firebase ด้วยโฟลว์แพ็กเกจเนื้อหาและโฟลว์ Unity Package Manager

  • การขึ้นต่อกันสำหรับไฟล์ .tgz แต่ละผลิตภัณฑ์จะเชื่อมโยงกันในไฟล์ .tgz ของตนเอง คุณต้องดาวน์โหลดและนำเข้าไฟล์ .tgz ของผลิตภัณฑ์ และไฟล์การพึ่งพา .tgz ในลำดับที่ถูกต้อง:

    1. ตัวจัดการการพึ่งพาภายนอก ( com.google.external-dependency-manager )
    2. Firebase Core ( com.google.firebase.app )
    3. ผลิตภัณฑ์ Firebase ที่ใช้ในโครงการของคุณ หากคุณใช้ Realtime Database หรือ Cloud Storage ให้นำเข้า Authentication ( com.google.firebase.auth ) ก่อน

หลังจากดาวน์โหลดแล้ว ให้นำเข้าไฟล์ .tgz ลงในโปรเจ็กต์ของคุณโดยใช้วิธีใดวิธีหนึ่งต่อไปนี้:

Package Manager UI

  1. เปิดหน้าต่าง Package Manager ของ Unity
  2. คลิกไอคอน + ที่มุมบนซ้ายของหน้าต่าง Package Manager และเลือก Add package from tarball เพื่อเปิดไฟล์เบราว์เซอร์
  3. เลือก tarball ที่ต้องการในเบราว์เซอร์ไฟล์

Unity 2019 รุ่นเก่าบางรุ่นไม่รองรับการเพิ่ม tarballs โดยตรง ในกรณีนี้ คุณจะต้อง:

  1. แตกไฟล์ .tgz
  2. คลิกไอคอน + ที่มุมบนซ้ายของหน้าต่าง Package Manager และเลือก Add package from disk เพื่อเปิดไฟล์เบราว์เซอร์
  3. เลือกโฟลเดอร์ที่แยกออกมาในเบราว์เซอร์ไฟล์

manifest.json

  1. สร้างโฟลเดอร์ใหม่ถัดจากโฟลเดอร์ Packages ของโปรเจ็กต์ และตั้งชื่อเป็น GooglePackages
  2. วางไฟล์ .tgz ลงในโฟลเดอร์นั้น
  3. ใช้โปรแกรมแก้ไขข้อความเพื่อเปิด Packages/manifest.json ภายใต้โฟลเดอร์โครงการ Unity ของคุณ
  4. เพิ่มรายการสำหรับแต่ละแพ็คเกจที่คุณต้องการนำเข้า โดยจับคู่ชื่อแพ็คเกจกับตำแหน่งบนดิสก์ อย่าลืมต่อท้าย 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...
      }
    }
    
  5. บันทึกไฟล์ manifest.json

  6. เมื่อ Unity กลับมาโฟกัสอีกครั้ง มันจะโหลด manifest.json ใหม่และนำเข้าแพ็คเกจที่เพิ่มใหม่

Unity เวอร์ชันเก่าบางเวอร์ชันไม่รองรับไฟล์ .tgz ใน manifest.json ในกรณีนี้ คุณควร:

  1. แตกไฟล์ .tgz
  2. แก้ไข 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 package

ในบางกรณี คุณอาจต้องการเปลี่ยนจากการใช้ Unity Package Manager เพื่อติดตามผลิตภัณฑ์ Firebase เป็นการนำเข้าผลิตภัณฑ์ภายใต้โฟลเดอร์ Assets

หากคุณไม่แน่ใจว่ากำลังใช้วิธีการนำเข้าแบบใด ในโฟลเดอร์โครงการ Unity ของคุณ ให้เปิดไฟล์ Packages/manifest.json หากไฟล์มีรายการที่ขึ้นต้นด้วย com.google.firebase โปรเจ็กต์ของคุณใช้ Unity Package Manager ในการนำเข้า

ในการโยกย้ายไปยังแพ็คเกจสินทรัพย์:

  1. จดบันทึกเวอร์ชันแพ็คเกจ Firebase ปัจจุบันในโปรเจ็กต์ของคุณและนำออก

    1. จากเมนู Window ให้เลือก Package Manager ในหน้าต่าง Package Manager ตรวจสอบให้แน่ใจว่าได้เลือก "Packages: In Project" แล้ว
    2. สังเกตเวอร์ชันของแพ็คเกจ Firebase ที่นำเข้า
    3. คลิกที่ชื่อแพ็กเกจแต่ละอัน จากนั้นคลิก Remove อย่าลืมลบแพ็คเกจ External Dependency Manager ( .com.google.external-dependency-manager ) และแพ็คเกจ Firebase
  2. ดาวน์โหลดและนำเข้าไฟล์แทนที่ . .unitypackage คุณมีสองตัวเลือก:

    • หากคุณสามารถอัปเกรดเป็นเวอร์ชันล่าสุดของแต่ละแพ็คเกจได้ ให้ดาวน์โหลดไฟล์ zip Firebase Unity SDK และนำเข้าตามที่อธิบายไว้ใน Add Firebase ไปยังโปรเจ็กต์ Unity ของคุณ
    • หากคุณต้องการคงเวอร์ชัน .unitypackage ปัจจุบันไว้ คุณสามารถดาวน์โหลดและนำเข้าแต่ละแพ็คเกจตามที่อธิบายไว้ ข้างต้น ในหน้านี้

ย้ายจากแพ็คเกจสินทรัพย์ไปยัง 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 โดยใช้วิธีใดวิธีหนึ่งต่อไปนี้

    Package Manager UI

    1. ในโปรเจ็กต์ Unity ที่เปิดอยู่ ให้ไปที่ 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 ตามที่อธิบายไว้ ข้างต้น ในหน้านี้