Catch up on highlights from Firebase at Google I/O 2023. 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 สำหรับ 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 ให้นำเข้าการตรวจสอบสิทธิ์ ( com.google.firebase.auth ) ก่อน

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

UI ตัวจัดการแพ็คเกจ

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

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

  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 ไปยังแพ็คเกจสินทรัพย์

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

หากคุณไม่แน่ใจว่าคุณกำลังใช้วิธีนำเข้าแบบใด ให้เปิดไฟล์ Packages/manifest.json ในโฟลเดอร์โปรเจ็กต์ Unity หากไฟล์มีรายการที่ขึ้นต้นด้วย 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 ทดแทน คุณมีสองทางเลือก:

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

โอนย้ายจากแพ็คเกจสินทรัพย์ไปยัง Unity Package Manager

ในบางกรณี คุณอาจต้องการเปลี่ยนจากการนำเข้าสินค้าในโฟลเดอร์ Assets เป็นการนำเข้าและติดตามสินค้าด้วย Unity Package Manager

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

ในการโยกย้ายไปยัง Unity Package Manager:

  1. ตรวจสอบให้แน่ใจว่าได้ลบแพ็คเกจ Firebase และแพ็คเกจ External Dependency Manager ออกจากโฟลเดอร์ Assets แล้ว โดยใช้วิธีใดวิธีหนึ่งต่อไปนี้

    EDM4U ยูไอ

    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 ตามที่อธิบาย ไว้ข้างต้น ในหน้านี้