Unity
คู่มือการติดตั้ง Hercules Unity Package¶
สามารถติดตั้ง Hercules ผ่าน Unity Package Manager (UPM) ได้
เลือกวิธีใดวิธีหนึ่งจากสองวิธีต่อไปนี้เพื่อเพิ่มรีจิสทรีและแพ็กเกจ Hercules
วิธีที่ 1. ติดตั้งโดยแก้ไขไฟล์ manifest.json โดยตรง¶
เปิดไฟล์ต่อไปนี้ในโปรเจกต์ Unity
เพิ่มเนื้อหาต่อไปนี้ที่ระดับรากของ manifest.json หรือรวมเข้ากับการตั้งค่าที่มีอยู่
{
"scopedRegistries": [
{
"name": "Com2uS Platform Security Repo",
"url": "https://aas-auth.withhive.com/upm",
"scopes": [
"com.com2us.security"
]
}
],
"dependencies": {
"com.com2us.security.hercules": "26.9.8",
...
}
}
Warning
หากมีรายการ scopedRegistries หรือ dependencies อยู่แล้ว อย่าลบหรือเขียนทับรายการเดิม ให้เพิ่มเนื้อหาข้างต้นลงในรายการที่มีอยู่
หลังจากบันทึกการตั้งค่าแล้ว เมื่อเปิดโปรเจกต์ Unity ระบบจะติดตั้งแพ็กเกจ Hercules โดยอัตโนมัติ
เปลี่ยนเวอร์ชัน¶
เปลี่ยนเวอร์ชันที่ระบุใน dependencies เพื่ออัปเดต Hercules เป็นเวอร์ชันที่ต้องการ
นำแพ็กเกจออก¶
ลบรายการต่อไปนี้ออกจาก dependencies เพื่อนำแพ็กเกจ Hercules ออก
หากไม่ได้ใช้ Hercules อีกต่อไป สามารถลบ Com2uS Platform Security Repo ที่เคยเพิ่มไว้ใน scopedRegistries ได้ด้วย
ดูรายละเอียดเพิ่มเติมเกี่ยวกับการแก้ไข manifest.json ได้ในเอกสารทางการของ Unity
วิธีที่ 2. ติดตั้งผ่าน Unity Editor¶
1. เพิ่ม Scoped Registry¶
เปิดโปรเจกต์ Unity แล้วไปที่เมนูต่อไปนี้
เพิ่มรีจิสทรีต่อไปนี้ใน Scoped Registries
| รายการ | ค่า |
|---|---|
| Name | Com2uS Platform Security Repo |
| URL | https://aas-auth.withhive.com/upm |
| Scope(s) | com.com2us.security |
2. เพิ่มแพ็กเกจ Hercules¶
เปิดเมนูต่อไปนี้
คลิกปุ่ม + ที่มุมซ้ายบนของ Package Manager แล้วเลือก Add package by name...
ป้อนข้อมูลต่อไปนี้
| รายการ | ค่า |
|---|---|
| Name | com.com2us.security.hercules |
| Version | เวอร์ชันของ Hercules ที่ต้องการติดตั้ง (ไม่บังคับ) |
หากไม่ระบุ Version ระบบจะเลือกเวอร์ชันล่าสุด
เมื่อติดตั้งเสร็จแล้ว สามารถตรวจสอบแพ็กเกจ Hercules ได้ใน Package Manager
เปลี่ยนเวอร์ชันหรือนำแพ็กเกจออก¶
หลังจากติดตั้งแล้ว สามารถเปลี่ยนเวอร์ชันของ Hercules หรือนำแพ็กเกจออกได้ใน Unity Package Manager
หากนำ Hercules ออกและไม่ได้ใช้รีจิสทรีนั้นอีกต่อไป ให้ลบ Scoped Registry ที่เคยเพิ่มไว้จากตำแหน่งต่อไปนี้ด้วย
วิธีแก้ไขแพ็กเกจ Hercules โดยตรงเพื่อใช้งาน¶
หากต้องการแก้ไขแพ็กเกจ Hercules ที่ติดตั้งไว้โดยตรงเพื่อใช้งาน ให้เปลี่ยนแพ็กเกจเป็น Embedded package
ในหน้าต่าง Project ของ Unity Editor ให้คลิกขวาที่แพ็กเกจ Hercules ที่ติดตั้งไว้ แล้วเลือก Show in Explorer (Windows) หรือ Reveal in Finder (macOS)
คัดลอกโฟลเดอร์แพ็กเกจ Hercules ที่เปิดขึ้นไปยังโฟลเดอร์ Packages ของโปรเจกต์ แล้วลบส่วน @<fingerprint> ที่ต่อท้ายชื่อโฟลเดอร์ออก
ตัวอย่างเช่น หากแพ็กเกจที่ติดตั้งอยู่ที่ตำแหน่งต่อไปนี้:
จัดโครงสร้างให้เป็นดังต่อไปนี้
ระบบจะตรวจพบแพ็กเกจที่คัดลอกมาเป็น Embedded package ที่รวมอยู่ในโปรเจกต์ Unity จากนั้นสามารถแก้ไขและใช้ไฟล์ในโฟลเดอร์ Packages/com.com2us.security.hercules ได้โดยตรง
ดูรายละเอียดเพิ่มเติมเกี่ยวกับ Embedded package ได้ในเอกสารทางการของ Unity


