ข้ามไปที่เนื้อหา

Unity

คู่มือการติดตั้ง Hercules Unity Package

สามารถติดตั้ง Hercules ผ่าน Unity Package Manager (UPM) ได้

เลือกวิธีใดวิธีหนึ่งจากสองวิธีต่อไปนี้เพื่อเพิ่มรีจิสทรีและแพ็กเกจ Hercules


วิธีที่ 1. ติดตั้งโดยแก้ไขไฟล์ manifest.json โดยตรง

เปิดไฟล์ต่อไปนี้ในโปรเจกต์ Unity

<พาธโปรเจกต์ Unity>/Packages/manifest.json

เพิ่มเนื้อหาต่อไปนี้ที่ระดับรากของ 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 เป็นเวอร์ชันที่ต้องการ

"com.com2us.security.hercules": "26.9.8"

นำแพ็กเกจออก

ลบรายการต่อไปนี้ออกจาก dependencies เพื่อนำแพ็กเกจ Hercules ออก

"com.com2us.security.hercules": "26.9.8"

หากไม่ได้ใช้ Hercules อีกต่อไป สามารถลบ Com2uS Platform Security Repo ที่เคยเพิ่มไว้ใน scopedRegistries ได้ด้วย

ดูรายละเอียดเพิ่มเติมเกี่ยวกับการแก้ไข manifest.json ได้ในเอกสารทางการของ Unity


วิธีที่ 2. ติดตั้งผ่าน Unity Editor

1. เพิ่ม Scoped Registry

เปิดโปรเจกต์ Unity แล้วไปที่เมนูต่อไปนี้

Edit > Project Settings > Package Manager

เพิ่มรีจิสทรีต่อไปนี้ใน Scoped Registries

รายการ ค่า
Name Com2uS Platform Security Repo
URL https://aas-auth.withhive.com/upm
Scope(s) com.com2us.security

2. เพิ่มแพ็กเกจ Hercules

เปิดเมนูต่อไปนี้

Window > Package Manager

คลิกปุ่ม + ที่มุมซ้ายบนของ Package Manager แล้วเลือก Add package by name...

ป้อนข้อมูลต่อไปนี้

รายการ ค่า
Name com.com2us.security.hercules
Version เวอร์ชันของ Hercules ที่ต้องการติดตั้ง (ไม่บังคับ)

หากไม่ระบุ Version ระบบจะเลือกเวอร์ชันล่าสุด

เมื่อติดตั้งเสร็จแล้ว สามารถตรวจสอบแพ็กเกจ Hercules ได้ใน Package Manager

เปลี่ยนเวอร์ชันหรือนำแพ็กเกจออก

หลังจากติดตั้งแล้ว สามารถเปลี่ยนเวอร์ชันของ Hercules หรือนำแพ็กเกจออกได้ใน Unity Package Manager

หากนำ Hercules ออกและไม่ได้ใช้รีจิสทรีนั้นอีกต่อไป ให้ลบ Scoped Registry ที่เคยเพิ่มไว้จากตำแหน่งต่อไปนี้ด้วย

Edit > Project Settings > Package Manager > Scoped Registries

วิธีแก้ไขแพ็กเกจ Hercules โดยตรงเพื่อใช้งาน

หากต้องการแก้ไขแพ็กเกจ Hercules ที่ติดตั้งไว้โดยตรงเพื่อใช้งาน ให้เปลี่ยนแพ็กเกจเป็น Embedded package

ในหน้าต่าง Project ของ Unity Editor ให้คลิกขวาที่แพ็กเกจ Hercules ที่ติดตั้งไว้ แล้วเลือก Show in Explorer (Windows) หรือ Reveal in Finder (macOS)

คัดลอกโฟลเดอร์แพ็กเกจ Hercules ที่เปิดขึ้นไปยังโฟลเดอร์ Packages ของโปรเจกต์ แล้วลบส่วน @<fingerprint> ที่ต่อท้ายชื่อโฟลเดอร์ออก

ตัวอย่างเช่น หากแพ็กเกจที่ติดตั้งอยู่ที่ตำแหน่งต่อไปนี้:

Library/PackageCache/com.com2us.security.hercules@26.9.8

จัดโครงสร้างให้เป็นดังต่อไปนี้

Packages/com.com2us.security.hercules

ระบบจะตรวจพบแพ็กเกจที่คัดลอกมาเป็น Embedded package ที่รวมอยู่ในโปรเจกต์ Unity จากนั้นสามารถแก้ไขและใช้ไฟล์ในโฟลเดอร์ Packages/com.com2us.security.hercules ได้โดยตรง

ดูรายละเอียดเพิ่มเติมเกี่ยวกับ Embedded package ได้ในเอกสารทางการของ Unity