ติดตั้งแพ็กเกจ Google สําหรับ Unity

แพ็กเกจ Google สําหรับ Unity แบ่งออกเป็น 2 รูปแบบ ดังนี้

  • แพ็กเกจเนื้อหา
    • มีส่วนขยาย .unitypackage
    • ติดตั้งในไดเรกทอรี Assets ของโปรเจ็กต์
    • นําเข้าได้ใน Unity 5 ขึ้นไป
    • โดยทั่วไปมักมีแพ็กเกจที่ต้องพึ่งพา
  • แพ็กเกจ Unity Package Manager (UPM)
    • มีส่วนขยาย .tgz
    • ติดตั้งในไดเรกทอรี Packages ของโปรเจ็กต์
    • นําเข้าได้ใน Unity 2018.4 ขึ้นไป
    • อ้างอิงถึงแพ็กเกจที่ต้องติดตั้งแยกต่างหาก

หน้าแพ็กเกจมีไฟล์ .unitypackage ล่าสุดสําหรับแพ็กเกจทั้งหมดที่มีอยู่

หน้าที่เก็บถาวรมีไฟล์ .unitypackage และ .tgz สําหรับแพ็กเกจทุกเวอร์ชัน

ด้านล่างนี้เป็นคําแนะนําเกี่ยวกับวิธีติดตั้งแพ็กเกจทั้ง 2 ประเภท พร้อมด้วยคําแนะนําในการย้ายข้อมูลตามประเภทไปยังประเภทอื่น

เมื่อคุ้นเคยกับตัวเลือกการติดตั้งเหล่านี้แล้ว โปรดดูวิธีการเฉพาะผลิตภัณฑ์สําหรับ Firebase เพิ่มเติม

กําลังนําเข้าแพ็กเกจเนื้อหาที่มี .unitypackage ไฟล์

นําเข้าไฟล์ .unitypackage โดยเลือกตัวเลือกเมนู Unity Assets > Import package > Custom Package และนําเข้ารายการทั้งหมด การดําเนินการนี้จะเพิ่มเนื้อหาแพ็กเกจลงในโปรเจ็กต์ภายใต้ไดเรกทอรี Assets

การนําเข้าแพ็กเกจ UPM ที่มี .tgz ไฟล์ (2018.4+)

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

ไฟล์ Manifest.json

  1. สร้างโฟลเดอร์ใหม่ข้างโฟลเดอร์ Packages ของโปรเจ็กต์ และตั้งชื่อ GooglePackages
  2. วางไฟล์ .tgz ลงในโฟลเดอร์นั้น
  3. ใช้เครื่องมือแก้ไขข้อความเพื่อเปิด Packages/manifest.json ใต้โฟลเดอร์โปรเจ็กต์ Unity
  4. เพิ่มรายการสําหรับแต่ละแพ็กเกจที่ต้องการติดตั้ง โดยแมปชื่อแพ็กเกจกับตําแหน่งในดิสก์ ซึ่งสัมพันธ์กับไฟล์ Packages/manifest.json ตรวจสอบว่าได้เพิ่ม 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. วางโฟลเดอร์ที่แยกออกมาในโฟลเดอร์ GooglePackages
  3. แก้ไข 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...
      }
    }
    

UI ของตัวจัดการแพ็กเกจ

  1. เปิดหน้าต่างตัวจัดการแพ็กเกจของ Unity&#39
  2. คลิกไอคอน + ที่มุมซ้ายบนของหน้าต่างตัวจัดการแพ็กเกจ แล้วเลือก Add package from tarball เพื่อเปิดเบราว์เซอร์ของไฟล์

    ภาพหน้าจอหน้าต่างตัวจัดการแพ็กเกจ Unity พร้อมรายการ "เพิ่มแพ็กเกจจาก tarball" เลือกรายการแบบเลื่อนลง

  3. เลือก tarball ที่ต้องการในเบราว์เซอร์ของไฟล์

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

  1. ยกเลิกการบีบอัดไฟล์ .tgz
  2. คลิกไอคอน + ที่มุมซ้ายบนของหน้าต่างตัวจัดการแพ็กเกจ แล้วเลือก Add package from disk เพื่อเปิดเบราว์เซอร์ของไฟล์

    ภาพหน้าจอหน้าต่างตัวจัดการแพ็กเกจ Unity พร้อมรายการ "เพิ่มแพ็กเกจจากรายการแบบเลื่อนลงของดิสก์ที่เลือก

  3. เลือกโฟลเดอร์ที่ดึงในเบราว์เซอร์ของเบราว์เซอร์

คุณจะต้องนําเข้าไฟล์ .tgz สําหรับทรัพยากร Dependency ของแพ็กเกจด้วย ซึ่งดูได้ในหน้าที่เก็บถาวรในส่วนแพ็กเกจที่ต้องการ

ตัวอย่างเช่น หากจะติดตั้ง com.google.firebase.storage คุณจะต้องติดตั้งไฟล์ .tgz ต่อไปนี้ตามลําดับ

  1. ผู้จัดการการอ้างอิงภายนอก (com.google.external-dependency-manager)
  2. Firebase Core (com.google.firebase.app)
  3. การตรวจสอบสิทธิ์ Firebase (com.google.firebase.auth)
  4. พื้นที่เก็บข้อมูลของ Firebase (com.google.firebase.storage)

หากคุณต้องการเพิ่มไฟล์ .tgz ทั้งหมดพร้อมกันโดยไม่ต้องกังวลเกี่ยวกับคําสั่งซื้อ ก็ทําตามวิธีการในแท็บ ififest.json

การควบคุมเวอร์ชัน

หากคุณใช้ซอฟต์แวร์การควบคุมเวอร์ชันเพื่อจัดการไฟล์โปรเจ็กต์ เราขอแนะนําให้เพิ่มไฟล์ .tgz ที่เกี่ยวข้องลงในการควบคุมเวอร์ชัน คุณแก้ไข manifest.json ของโปรเจ็กต์ด้วยตนเองได้ (ดูวิธีการด้านบน) และอ้างอิงไฟล์ .tgz ในเครื่องโดยใช้เส้นทางที่เกี่ยวข้อง

หากใช้ Git เราขอแนะนําให้ใช้ Git Large File Storage (LFS) สําหรับการจัดการไฟล์ .tgz ขนาดใหญ่

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

ในบางกรณี คุณอาจต้องเปลี่ยนจากการใช้ตัวจัดการแพ็กเกจ Unity เพื่อจัดการแพ็กเกจของ Google เป็นการติดตั้งแพ็กเกจในโฟลเดอร์เนื้อหา

ตรวจสอบว่าได้นําแพ็กเกจทั้งหมดของ Google ออกจาก Unity Package Manager แล้วโดยใช้วิธีใดวิธีหนึ่งต่อไปนี้

UI ของตัวจัดการแพ็กเกจ

  1. เปิดหน้าต่างตัวจัดการแพ็กเกจของ Unity&#39
  2. เลือก In Project ในเมนูแบบเลื่อนลงด้านซ้ายบน

    ภาพหน้าจอหน้าต่างตัวจัดการแพ็กเกจ Unity พร้อมรายการแบบเลื่อนลง "&" ในโปรเจ็กต์ที่เลือก

  3. พิมพ์ com.google ในแถบค้นหาเพื่อกรองแพ็กเกจ Google

    ภาพหน้าจอหน้าต่างตัวจัดการแพ็กเกจ Unity พร้อม "com.google" ในแถบค้นหาพร้อมแผงด้านซ้ายที่มีเฉพาะแพ็กเกจ Goaogle เท่านั้น

  4. คลิกชื่อแพ็กเกจแต่ละชื่อแล้วคลิก Remove

ไฟล์ Manifest.json

  1. ใช้เครื่องมือแก้ไขข้อความเพื่อเปิด Packages/manifest.json ใต้โฟลเดอร์โปรเจ็กต์ Unity
  2. ตรวจสอบว่ามีแพ็กเกจจาก Google ใน "dependencies" หรือไม่ ชื่อแพ็กเกจควรขึ้นต้นด้วย "com.google" เช่น "com.google.firebase.app"
  3. ลบบรรทัดเหล่านั้นและบันทึกไฟล์ JSON
  4. เมื่อ Unity กลับมาโฟกัสอีกครั้ง ระบบจะโหลดไฟล์ manifest.json ซ้ําและนําแพ็กเกจที่ลบไปแล้วออก

เมื่อถอนการติดตั้งแพ็กเกจเหล่านั้นจากตัวจัดการแพ็กเกจ Unity แล้ว คุณจะดาวน์โหลดและนําเข้าไฟล์ทดแทน .unitypackage จากหน้าที่เก็บถาวรได้

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

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

หากไม่แน่ใจว่ากําลังใช้วิธีการติดตั้งแบบใดใน UI ของ Unity ให้ตรวจสอบว่าแพ็กเกจ Google ที่ต้องการปรากฏในแท็บ "โปรเจ็กต์" ในส่วน "เนื้อหา" หรือไม่

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

  1. ตรวจสอบว่านําแพ็กเกจ Google ทั้งหมดออกจากโฟลเดอร์เนื้อหาแล้ว

    • หากต้องการถอนการติดตั้งแพ็กเกจ Firebase ให้ทําตามวิธีการเหล่านี้
    • หากต้องการถอนการติดตั้งปลั๊กอิน Play สําหรับ Unity ให้ลบโฟลเดอร์ GooglePlayPlugins ในส่วน Assets
  2. ติดตั้งแพ็กเกจโดยใช้ Unity Package Manager ตามที่อธิบายไว้ด้านบน

คําแนะนําในการย้ายข้อมูลเฉพาะผลิตภัณฑ์

ดูวิธีการของ Firebase ที่นี่