แพ็กเกจ 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
และนำเข้ารายการทั้งหมด
การดำเนินการนี้จะเพิ่มเนื้อหาแพ็กเกจลงในโปรเจ็กต์ภายใต้ไดเรกทอรี Asset
การนำเข้าแพ็กเกจ UPM ที่มี .tgz
ไฟล์ (2018.4 ขึ้นไป)
นำเข้า .tgz
ไฟล์ไปยังโปรเจ็กต์โดยใช้วิธีใดวิธีหนึ่งต่อไปนี้
manifest.json
- สร้างโฟลเดอร์ใหม่ข้างโฟลเดอร์
Packages
ของโปรเจ็กต์และตั้งชื่อว่าGooglePackages
- วางไฟล์
.tgz
ลงในโฟลเดอร์นั้น - ใช้เครื่องมือแก้ไขข้อความเพื่อเปิด
Packages/manifest.json
ภายใต้โฟลเดอร์โปรเจ็กต์ Unity เพิ่มรายการสำหรับแต่ละแพ็กเกจที่ต้องการติดตั้ง โดยแมปชื่อแพ็กเกจกับตำแหน่งในดิสก์โดยสัมพันธ์กับไฟล์
Packages/manifest.json
โปรดตรวจสอบว่าได้เพิ่ม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... } }
บันทึกไฟล์ Manifest.json
เมื่อ Unity กลับมาโฟกัสอีกครั้ง ระบบจะโหลดไฟล์ Manifest.json ซ้ำและนำเข้าแพ็กเกจที่เพิ่มเข้ามาใหม่
Unity เวอร์ชันเก่าบางเวอร์ชันไม่รองรับไฟล์ .tgz
ใน manifest.json
ในกรณีนี้ คุณควรทำดังนี้
- ยกเลิกการบีบอัดไฟล์
.tgz
- วางโฟลเดอร์ที่แยกออกมาไว้ในโฟลเดอร์
GooglePackages
แก้ไข 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 ตัวจัดการแพ็กเกจ
- เปิดหน้าต่างตัวจัดการแพ็กเกจของ Unity
คลิกไอคอน
+
ที่มุมซ้ายบนของหน้าต่างตัวจัดการแพ็กเกจ แล้วเลือกAdd package from tarball
เพื่อเปิดไฟล์เบราว์เซอร์เลือก tarball ที่ต้องการในโปรแกรมเรียกดูไฟล์
Unity เวอร์ชันเก่าบางเวอร์ชันไม่รองรับการเพิ่ม tarball โดยตรง ในกรณีนี้ คุณจะต้อง:
- ยกเลิกการบีบอัดไฟล์
.tgz
คลิกไอคอน
+
ที่มุมซ้ายบนของหน้าต่างตัวจัดการแพ็กเกจ แล้วเลือกAdd package from disk
เพื่อเปิดไฟล์เบราว์เซอร์เลือกโฟลเดอร์ที่แยกออกมาในโปรแกรมเรียกดูไฟล์
อย่าลืมนำเข้าไฟล์ .tgz
สำหรับทรัพยากร Dependency ของแพ็กเกจด้วย ซึ่งเข้าถึงได้ที่หน้าที่เก็บถาวรในส่วนของแพ็กเกจที่ต้องการ
ตัวอย่างเช่น หากจะติดตั้ง com.google.firebase.storage
คุณจะติดตั้งไฟล์ .tgz
ตามลำดับต่อไปนี้
- เครื่องมือจัดการการขึ้นต่อกันภายนอก (
com.google.external-dependency-manager
) - Firebase Core (
com.google.firebase.app
) - การตรวจสอบสิทธิ์ Firebase (
com.google.firebase.auth
) - พื้นที่เก็บข้อมูลของ Firebase (
com.google.firebase.storage
)
หากต้องการเพิ่มไฟล์ .tgz
ทั้งหมดพร้อมกันโดยไม่ต้องกังวลเรื่องคำสั่งซื้อ ให้ทำตามวิธีการในแท็บไฟล์ Manifest.json
การควบคุมเวอร์ชัน
หากคุณใช้ซอฟต์แวร์การควบคุมเวอร์ชันเพื่อจัดการไฟล์โปรเจ็กต์ เราขอแนะนำให้เพิ่มไฟล์ .tgz
ที่เกี่ยวข้องลงในการควบคุมเวอร์ชัน คุณแก้ไข manifest.json
ของโปรเจ็กต์ด้วยตนเองได้ (ดูวิธีการด้านบน) และอ้างอิงไฟล์ .tgz
ในเครื่องโดยใช้เส้นทางแบบสัมพัทธ์
หากคุณใช้ Git เราขอแนะนําให้ใช้ Git Large File Storage (LFS) สําหรับจัดการไฟล์ขนาดใหญ่ .tgz
รายการ
การย้ายข้อมูลจากแพ็กเกจ UPM ไปยังแพ็กเกจเนื้อหา
ในบางกรณี คุณอาจต้องเปลี่ยนจากการใช้เครื่องมือจัดการแพ็กเกจ Unity เพื่อจัดการแพ็กเกจ Google เป็นการติดตั้งแพ็กเกจภายใต้โฟลเดอร์เนื้อหา
ตรวจสอบว่าได้นำแพ็กเกจ Google ทั้งหมดออกจากตัวจัดการแพ็กเกจ Unity โดยใช้วิธีใดวิธีหนึ่งต่อไปนี้
UI ตัวจัดการแพ็กเกจ
- เปิดหน้าต่างตัวจัดการแพ็กเกจของ Unity
เลือก
In Project
ในเมนูแบบเลื่อนลงที่ด้านซ้ายบนพิมพ์
com.google
ในแถบค้นหาเพื่อกรองแพ็กเกจ Googleคลิกชื่อแพ็กเกจแต่ละรายการ แล้วคลิก
Remove
manifest.json
- ใช้เครื่องมือแก้ไขข้อความเพื่อเปิด
Packages/manifest.json
ภายใต้โฟลเดอร์โปรเจ็กต์ Unity - ตรวจสอบว่ามีแพ็กเกจจาก Google ภายใต้ "การขึ้นต่อกัน" หรือไม่ ชื่อแพ็กเกจควรขึ้นต้นด้วย "com.google" เช่น "com.google.firebase.app"
- ลบบรรทัดเหล่านั้นออกและบันทึกไฟล์ JSON
- เมื่อ Unity กลับมาโฟกัสอีกครั้ง ระบบจะโหลดไฟล์
manifest.json
ซ้ำและนำแพ็กเกจที่ลบไปแล้วออก
หลังจากที่ถอนการติดตั้งแพ็กเกจเหล่านั้นจาก Unity Package Manager แล้ว คุณจะดาวน์โหลดและนำเข้าไฟล์ .unitypackage
ทดแทนได้จากหน้าที่เก็บถาวร
การย้ายข้อมูลจากแพ็กเกจเนื้อหาไปยังแพ็กเกจ UPM
ในบางกรณี คุณอาจต้องเปลี่ยนจากการติดตั้งผลิตภัณฑ์ภายใต้โครงสร้างชิ้นงาน เป็นการติดตั้งและติดตามผลิตภัณฑ์ด้วย Unity Package Manager
หากไม่แน่ใจว่ากำลังใช้วิธีการติดตั้งใดอยู่ ให้ตรวจสอบว่าแพ็กเกจ Google ที่ต้องการปรากฏในแท็บ "โปรเจ็กต์" ใต้ชิ้นงานหรือไม่ใน Unity UI
วิธีย้ายข้อมูลไปยังแพ็กเกจ UPM
ตรวจสอบว่าได้นำแพ็กเกจ Google ทั้งหมดออกจากโฟลเดอร์เนื้อหาแล้ว
- หากต้องการถอนการติดตั้งแพ็กเกจ Firebase ให้ทำตามวิธีการเหล่านี้
- หากต้องการถอนการติดตั้งปลั๊กอิน Play สำหรับ Unity ให้ลบโฟลเดอร์
GooglePlayPlugins
ในส่วนAssets
ติดตั้งแพ็กเกจโดยใช้ Unity Package Manager ตามที่อธิบายไว้ ด้านบน
คำแนะนำการย้ายข้อมูลเฉพาะผลิตภัณฑ์
ดูวิธีการสำหรับ Firebase ที่นี่