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

แพ็กเกจ Google สำหรับ Unity จะแจกจ่ายใน 2 รูปแบบที่ต่างกัน ได้แก่

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

หน้าแพ็กเกจมีไฟล์ .unitypackage ล่าสุด แพ็กเกจที่ใช้ได้ทั้งหมด และ .tgz ไฟล์สำหรับบางแพ็กเกจ

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

คุณสามารถดูคำแนะนำการติดตั้งแพ็กเกจทั้ง 2 ประเภทได้ที่ด้านล่าง พร้อมคำแนะนำการย้ายข้อมูลเพื่อเปลี่ยนจากประเภทเป็นอีกประเภท

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

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

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

หมายเหตุ: หากคุณติดตั้งแพ็กเกจโดยใช้แพ็กเกจของ Unity แล้ว หน้าต่างเครื่องมือจัดการ ให้ถอนการติดตั้งแพ็กเกจเวอร์ชันเก่าก่อน เพื่อนำเข้ารายการใหม่ ดูด้านล่าง เพื่อดูวิธีการ

การนำเข้าแพ็กเกจ 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. เปิดหน้าต่าง Package Manager ของ Unity

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

   

3. เลือก tarball ที่ต้องการในโปรแกรมเรียกดูไฟล์

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

1. คลายไฟล์ .tgz

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

   

   หมายเหตุ: Unity 2018 จะวางไอคอน + ที่มุมล่างซ้ายของรายการแพ็กเกจ แผง

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 ทั้งหมดพร้อมกันโดยไม่ต้องกังวล เกี่ยวกับคำสั่งซื้อ คุณสามารถทำตามวิธีการใน แท็บmanifest.json

หมายเหตุ: หากคุณได้ติดตั้งแพ็กเกจที่มี .unitypackage แล้ว อย่าลืมลบแพ็กเกจเวอร์ชันนั้นก่อน เพิ่มรายการใหม่ ดูด้านล่าง เพื่อดูวิธีการ

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

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

หากคุณใช้ Git เราขอแนะนำให้ใช้ พื้นที่เก็บข้อมูลไฟล์ขนาดใหญ่ (LFS) สำหรับการจัดการไฟล์ .tgz ขนาดใหญ่

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

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

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

UI ของผู้จัดการแพ็กเกจ

1. เปิดหน้าต่าง Package Manager ของ Unity

2. เลือก In Project ในเมนูแบบเลื่อนลงที่ด้านซ้ายบน

   

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

   

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 Package Manager แล้ว คุณสามารถทำสิ่งต่อไปนี้ ดาวน์โหลดและนำเข้าไฟล์ที่จะแทนที่ .unitypackage ไฟล์จากที่เก็บถาวร

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

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

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

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

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

   • วิธีถอนการติดตั้งแพ็กเกจ Firebase วิธีการเหล่านี้
   • หากต้องการถอนการติดตั้งปลั๊กอิน Play สำหรับ Unity ให้ลบโฟลเดอร์ GooglePlayPlugins ภายใต้ Assets

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

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

ดูวิธีการสำหรับ Firebase ที่นี่