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

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

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

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

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

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

นำเข้าแพ็กเกจ Firebase เป็นชิ้นงาน

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

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

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

วิธีนำเข้าหลังจากดาวน์โหลด

  1. ในโปรเจ็กต์ Unity ที่เปิดอยู่ ให้ไปที่ Assets > Import Package > Custom Package

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

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

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

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

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

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

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

    1. เครื่องมือจัดการทรัพยากร Dependency ภายนอก (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. คลิกไอคอน + ที่มุมซ้ายบนของหน้าต่าง 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. เลือก Package Manager จากเมนู Window ในหน้าต่างPackage Manager ให้ตรวจสอบว่าได้เลือก "Packages: In Project" แล้ว
    2. จดบันทึกเวอร์ชันของแพ็กเกจ Firebase ที่นำเข้า
    3. คลิกชื่อแพ็กเกจแต่ละรายการ แล้วคลิกนำออก อย่าลืมนำแพ็กเกจ External Dependency Manager (.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 Package Manager

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

    UI ของ EDM4U

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

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

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

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

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