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

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

เว็บไซต์นี้ประกอบด้วย

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

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

หน้านี้มีคำแนะนำเกี่ยวกับตัวจัดการแพ็กเกจ Unity ดังนั้น การเรียนรู้เกี่ยวกับเครื่องมือจากเอกสารของ Unity จึงเป็นความคิดที่ดี

นำเข้าแพ็กเกจ Firebase เป็นเนื้อหา

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

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

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

หลังจากดาวน์โหลด ให้นำเข้าสิ่งต่อไปนี้

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

  2. คลิกนำเข้า ในหน้าต่างนำเข้าแพ็กเกจ Unity

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

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

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

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

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

  • ทรัพยากร Dependency สำหรับไฟล์ .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. คลิกไอคอน + ที่มุมซ้ายบนของหน้าต่างตัวจัดการแพ็กเกจ แล้วเลือก Add package from tarball เพื่อเปิดโปรแกรมเรียกดูไฟล์
  3. เลือก tarball ที่ต้องการในโปรแกรมเรียกดูไฟล์

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

  1. แตกไฟล์ .tgz
  2. คลิกไอคอน + ที่มุมซ้ายบนของหน้าต่างตัวจัดการแพ็กเกจ แล้วเลือก 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. จากเมนูหน้าต่าง เลือกตัวจัดการแพ็กเกจ ในหน้าต่างเครื่องมือจัดการแพ็กเกจ ตรวจสอบว่าได้เลือก "แพ็กเกจ: ในโปรเจ็กต์" แล้ว
    2. สังเกตเวอร์ชันของแพ็กเกจ Firebase ที่นำเข้า
    3. คลิกชื่อแพ็กเกจแต่ละชื่อ แล้วคลิกนำออก อย่าลืมนำแพ็กเกจเครื่องมือจัดการทรัพยากร Dependency ภายนอก (.com.google.external-dependency-manager) รวมถึงแพ็กเกจ Firebase ออก

  2. ดาวน์โหลดและนำเข้าไฟล์แทนที่ .unitypackage ไฟล์ คุณมีสองตัวเลือกดังนี้

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

ย้ายข้อมูลจากแพ็กเกจเนื้อหาไปยัง Unity Package Manager

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

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

วิธีย้ายข้อมูลไปยังตัวจัดการแพ็กเกจ Unity

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

    UI ของ EDM4U

    1. ในโปรเจ็กต์ Unity แบบเปิด ให้ไปที่ชิ้นงาน > เครื่องมือจัดการการขึ้นต่อกันภายนอก > เครื่องจัดการเวอร์ชัน > ถอนการติดตั้งแพ็กเกจที่มีการจัดการ
    2. เลือกแพ็กเกจ Firebase ทั้งหมดและ Dependency Manager ภายนอก
    3. คลิกถอนการติดตั้งแพ็กเกจที่เลือก

    การนำออกด้วยตนเอง

    ในการใช้เครื่องมือระบบไฟล์ ให้ลบโฟลเดอร์ต่อไปนี้ด้วยตนเอง

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

  2. นำเข้าแพ็กเกจโดยใช้ Unity Package Manager ตามที่อธิบายไว้ด้านบนในหน้านี้