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

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

เว็บไซต์นี้มีข้อมูลต่อไปนี้

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

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

หน้านี้มีวิธีการที่เกี่ยวข้องกับ Unity Package Manager ดังนั้นคุณควรศึกษาข้อมูลเกี่ยวกับเครื่องมือนี้จากเอกสารประกอบของ Unity

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

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

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

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

หลังจากดาวน์โหลดแล้ว ให้ทำตามขั้นตอนต่อไปนี้เพื่อนำเข้า

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

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

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

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

  • วิธีนี้ใช้ได้ใน Unity เวอร์ชัน 2018.3 ขึ้นไปเท่านั้น

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

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

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

    1. External Dependency Manager (com.google.external-dependency-manager)
    2. Firebase Core (com.google.firebase.app)
    3. ผลิตภัณฑ์ Firebase ที่ใช้ในโปรเจ็กต์ หากใช้ Realtime Database หรือ Cloud Storage ให้นำเข้า Authentication (com.google.firebase.auth) ก่อน

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

UI ของ Package Manager

  1. เปิดหน้าต่าง Package Manager ของ Unity
  2. คลิกไอคอน + ที่มุมซ้ายบนของหน้าต่าง Package Manager แล้วเลือก 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 และทรัพยากร Dependency ของแพ็กเกจดังกล่าว ไฟล์ 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 Pack

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

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

วิธีย้ายข้อมูลไปยัง Asset Pack

  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 ที่จะใช้แทน คุณมี 2 ตัวเลือกดังนี้

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

ย้ายข้อมูลจาก Asset Pack ไปยัง 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 แล้ว โดยใช้วิธีใดวิธีหนึ่งต่อไปนี้

    UI ของ EDM4U

    1. ในโปรเจ็กต์ Unity แบบเปิด ให้ไปที่ เนื้อหา > External Dependency Manager > Version Handler > Uninstall Managed Packages
    2. เลือกแพ็กเกจ Firebase ทั้งหมดและ External Dependency Manager
    3. คลิกUninstall Selected Package

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

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

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

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