แก้ปัญหา: การติดตั้งและ Build

แก้ไขปัญหาการติดตั้ง 1DevTool หรือเปิดครั้งแรก

macOS: "Cannot Be Opened Because Developer Cannot Be Verified"

macOS บล็อกแอปที่ดาวน์โหลดจากนอก App Store โดยค่าเริ่มต้น นี่เป็นคำเตือน Gatekeeper ไม่ใช่สัญญาณว่าอะไรผิดกับ 1DevTool

แก้ไขโดยใช้ System Settings:

  1. เปิด System Settings → Privacy & Security
  2. เลื่อนลงไปที่ส่วน Security
  3. คุณควรเห็นข้อความที่บอกว่า "1DevTool was blocked from use because it is not from an identified developer"
  4. คลิก Open Anyway
  5. ยืนยันใน dialog ที่ปรากฏ

แก้ไขทางเลือกโดยใช้ Terminal:

bash
xattr -d com.apple.quarantine /Applications/1DevTool.app

รันคำสั่งนี้ครั้งเดียวใน Terminal แล้วเปิด 1DevTool ปกติ คุณจะไม่ถูก prompt อีก

Windows: Antivirus บล็อกการติดตั้ง

โปรแกรม antivirus บางตัวflag installers ใหม่หรือไม่ได้ลงนามว่าน่าสงสัยและบล็อกพวกมันระหว่างการติดตั้ง

วิธีแก้ไข:

  1. ปิด real-time protection ชั่วคราวในซอฟต์แวร์ antivirus ของคุณ
  2. รันตัวติดตั้ง 1DevTool
  3. เปิด real-time protection ใหม่หลังการติดตั้งเสร็จสิ้น

เพื่อหลีกเลี่ยงการปิดการป้องกันทั้งหมด คุณสามารถเพิ่ม exception สำหรับไฟล์ติดตั้ง 1DevTool (โดยทั่วไป 1DevTool-Setup.exe) หรือสำหรับไดเรกทอรีการติดตั้ง (C:\Users\<you>\AppData\Local\1DevTool) ขั้นตอนต่างกันตาม antivirus — หา "Exclusions" หรือ "Exceptions" ในการตั้งค่า antivirus ของคุณ

Linux: AppImage ไม่เปิด

หากดับเบิลคลิก AppImage ไม่มีอะไรเกิดขึ้น หรือมันปิดทันที ลองแก้ไขเหล่านี้ตามลำดับ:

ทำให้ไฟล์ executable AppImages ต้องการอนุญาต execute ก่อนที่จะรัน:

bash
chmod +x 1DevTool-*.AppImage

ติดตั้ง FUSE AppImages ใช้ FUSE (Filesystem in Userspace) เพื่อ mount ตัวเอง การติดตั้ง Linux มินิมอลจำนวนมากไม่รวมมัน:

bash
sudo apt install libfuse2

บน Fedora/RHEL: sudo dnf install fuse

รันจาก Terminal เพื่อดู error output หากมันยังล้มเหลว เปิดมันจาก terminal เพื่อให้คุณอ่านข้อความ error:

bash
./1DevTool-*.AppImage --no-sandbox

Flag --no-sandbox บางครั้งต้องการในสภาพแวดล้อมที่จำกัดเช่นการตั้งค่า Linux ของบริษัทบางแห่งหรือ containers

แอปเปิดแต่ค้างว่าง

อาการ: 1DevTool เปิดและหน้าต่างปรากฏ แต่อินเทอร์เฟซไม่โหลด — เพียงหน้าจอว่างขาวหรือเทา

สาเหตุ: ไฟล์ cache ของแอปที่เสียหายจากการติดตั้งก่อนหน้าหรืออัปเดตที่ล้มเหลว

แก้ไข — ลบ cache:

  • macOS:
    bash
    rm -rf ~/Library/Application\ Support/1DevTool/Cache
  • Windows: นำทางไปยัง %APPDATA%\1DevTool\Cache ใน File Explorer และลบโฟลเดอร์ Cache
  • Linux: rm -rf ~/.config/1DevTool/Cache

หลังลบ cache รีสตาร์ท 1DevTool Cache สร้างตัวเองใหม่อัตโนมัติ

tmux Not Found ตอนเริ่ม

1DevTool ใช้ tmux เพื่อรักษา terminal sessions ให้存活เมื่อคุณสลับ panels หรือย่อแอป หาก tmux ไม่ติดตั้ง คุณจะเห็นคำเตือนตอนเริ่มและ terminals จะไม่ persist

ติดตั้ง tmux:

  • macOS: brew install tmux
  • Linux (Debian/Ubuntu): sudo apt install tmux
  • Linux (Fedora/RHEL): sudo yum install tmux หรือ sudo dnf install tmux

หลังติดตั้ง ออกจาก 1DevTool โดยสมบูรณ์และเปิดใหม่ หากคุณใช้ shell แบบกำหนดเองหรือ PATH ที่ไม่มาตรฐาน ตรวจสอบว่าไดเรกทอรีที่มี tmux (โดยทั่วไป /usr/local/bin หรือ /usr/bin) รวมอยู่ในตัวแปร PATH ของ shell ของคุณ