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

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

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

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

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

หน้านี้มีวิธีการเกี่ยวกับ Unity Package Manager ซึ่งเป็นที่ดี เรียนรู้เกี่ยวกับเครื่องมือนี้จากเอกสารเกี่ยวกับ Unity

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

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

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

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

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

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

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

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

เมื่อนำเข้าผลิตภัณฑ์ Firebase จาก .tgz ไฟล์ที่ดาวน์โหลดจากที่เก็บถาวรของ Google API สำหรับ 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 ให้นําเข้า Authentication (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 และ ของ 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 ไปยังแพ็กเกจเนื้อหา

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

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

วิธีย้ายข้อมูลไปยังแพ็กเกจเนื้อหา

  1. บันทึกเวอร์ชันแพ็กเกจ Firebase ปัจจุบันในโปรเจ็กต์ แล้วนำออก

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

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

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

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

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

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

วิธีย้ายข้อมูลไปยังตัวจัดการแพ็กเกจ 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 ตามที่อธิบายไว้ด้านบน ในหน้านี้