55 lines
4.3 KiB
Markdown
55 lines
4.3 KiB
Markdown
# 🧰 สัญญาทางเทคนิค: ระบบจัดการ Portable MinGit Runtime
|
|
|
|
เอกสารนี้อธิบายกลไกของ **Portable MinGit** ใน G-Launcher ซึ่งช่วยให้ระบบสามารถรันคำสั่ง Git (เช่น Git Clone, Git Fetch, Git Checkout) ได้บนคอมพิวเตอร์ของผู้ใช้ทั่วไป แม้ว่าในเครื่องจะไม่ได้ติดตั้งโปรแกรม Git หรือไม่มีสิทธิ์ Administrator ก็ตาม
|
|
|
|
---
|
|
|
|
## 1. ที่มาและปัญหาเดิม (Background & Problem Statement)
|
|
|
|
1. ผู้เล่นเกมทั่วไปส่วนใหญ่ไม่มีโปรแกรม Git สำหรับนักพัฒนาติดตั้งอยู่ในเครื่อง
|
|
2. ตัวติดตั้ง Git for Windows ปกติต้องการสิทธิ์ Administrator (UAC Prompt) ซึ่งสร้างความยุ่งยากให้แก่ผู้ใช้งาน
|
|
3. ตัวอัปเดต Launcher และระบบดาวน์โหลดเซิร์ฟเวอร์/พร็อกซี จำเป็นต้องใช้ Git ในการดึงข้อมูล
|
|
|
|
---
|
|
|
|
## 2. ลำดับการตรวจสอบและเตรียม Git Runtime (Discovery Order)
|
|
|
|
ใน [`internal/git-service/git_runtime.go`](../internal/git-service/git_runtime.go) ฟังก์ชัน `ensureGit()` ทำงานตามลำดับความสำคัญดังนี้:
|
|
|
|
```
|
|
[ร้องขอ Git Executable]
|
|
│
|
|
▼
|
|
1. ตรวจสอบ System PATH (exec.LookPath("git"))
|
|
├── พบ -> คืนพาธของ Git ในเครื่องทันที (เช่น C:\Program Files\Git\cmd\git.exe)
|
|
│
|
|
└── ไม่พบ -> เข้าสู่ขั้นตอนที่ 2
|
|
│
|
|
▼
|
|
2. ตรวจสอบโฟลเดอร์พกพาภายใน (tools/mingit/cmd/git.exe)
|
|
├── พบ -> นำพาธนี้ไปใช้งานทันที
|
|
│
|
|
└── ไม่พบ -> เข้าสู่ขั้นตอนที่ 3
|
|
│
|
|
▼
|
|
3. ดาวน์โหลด Portable MinGit x64 อัตโนมัติ
|
|
├── ดึงข้อมูล Release ล่าสุดจาก GitHub API:
|
|
│ https://api.github.com/repos/git-for-windows/git/releases/latest
|
|
├── กรองหาไฟล์แพ็กเกจ: MinGit-*-64-bit.zip
|
|
├── ดาวน์โหลดลงไฟล์ชั่วคราว os.CreateTemp
|
|
├── แตกไฟล์ Zip ลงโฟลเดอร์เป้าหมาย
|
|
└── คืนค่าพาธ git.exe พร้อมใช้งาน
|
|
```
|
|
|
|
---
|
|
|
|
## 3. การป้องกัน Terminal Freeze (Non-Interactive Terminal Execution)
|
|
|
|
เมื่อโปรแกรม Launcher หรือสคริปต์อัตโนมัติเรียกใช้คำสั่ง Git หาก Git ตรวจพบว่าต้องการรหัสผ่านหรือการยืนยันตัวตน มันจะพยายามเปิด Interactive TTY Prompt ซึ่งส่งผลให้โปรเซสของ Launcher **ค้างอย่างถาวร (Hang/Freeze)**:
|
|
|
|
### แนวทางป้องกันที่นำมาใช้:
|
|
1. **ตั้งค่าตัวแปรสภาพแวดล้อม:**
|
|
* ใน Go Backend: `cmd.Env = append(os.Environ(), "GIT_TERMINAL_PROMPT=0")`
|
|
* ใน PowerShell: `$env:GIT_TERMINAL_PROMPT = "0"`
|
|
2. **ผลลัพธ์:** หาก Git ต้องการการยืนยันตัวตนแต่ไม่สามารถทำได้ Git จะ Return Error ออกมาทันทีแทนที่จะค้าง ทำให้ระบบสามารถดักจับและส่ง Error ไปแจ้งเตือนบน UI ได้อย่างถูกต้อง
|