คู่มือเตรียมการ Build iBrowe บน Windows

ดัดแปลงมาจากเอกสารของ Chromium และ Brave ปรับปรุงและรีแบรนด์ให้เหมาะกับโครงการ iBrowe

🔧 การตั้งค่าเริ่มต้น (Initial Setup) เพื่อเตรียมเครื่องของคุณสำหรับการ Build iBrowe บน Windows ให้ทำตามขั้นตอนเหล่านี้ โดยหยุดก่อนถึงขั้นตอน “Get the code” ตามคู่มือ Build ของ Chromium

✅ ข้อกำหนดของระบบ (System Requirements) ตรวจสอบให้แน่ใจว่าเครื่องของคุณตรงตามเงื่อนไขที่ระบุไว้ในระบบข้อกำหนดของ Chromium

🛡️ โปรแกรม Antivirus เพิ่ม ข้อยกเว้น (exclusions) ให้กับโฟลเดอร์ทำงาน (working directories) ที่ใช้ระหว่างกระบวนการ Build เพราะ Windows Defender ซึ่งเปิดใช้งานตามค่าเริ่มต้น อาจรบกวนการทำงานของเครื่องมือ Build ได้

🛠️ Visual Studio ติดตั้ง Visual Studio Community 2022 (แนะนำเวอร์ชัน 17.8.3)

• เวอร์ชันใหม่กว่านี้อาจใช้งานได้ แต่ต้องตรวจสอบความเข้ากันได้กับ Chromium ซึ่งมีความสำคัญมาก

ควรเลือกติดตั้ง:

• Desktop Development with C++
• Windows 11 SDK (สามารถใช้กับ Windows 10 ได้เช่นกัน)

สำหรับรายละเอียดความเข้ากันได้เพิ่มเติม ดูได้จาก Omaha Build Guide

🔄 Git ติดตั้ง Git เวอร์ชัน 2.41 ขึ้นไป ⚠️ ห้ามใช้ Git ที่มากับ depot_tools เพราะจะไม่สามารถใช้งานร่วมกับระบบ patch ของ iBrowe ได้

หลังติดตั้ง ให้ทำตามขั้นตอนการตั้งค่า Git ของ Chromium ในส่วน “Get the Code” (โดยเฉพาะคำสั่ง git config --global)

🌐 Node.js ติดตั้ง Node.js เวอร์ชัน 20 LTS → นี่เป็นเวอร์ชันเดียวที่รองรับการ Build iBrowe ในปัจจุบัน

🐍 Python ติดตั้ง Python 3.x สำหรับ Windows แม้ Python จะมากับ depot_tools แต่:

• สคริปต์รุ่นเก่าบางตัวต้องใช้ Python 2.7
• อาจเกิดความขัดแย้งหาก PATH ของระบบไปเรียกใช้ Python ใน depot_tools ก่อน

✅ การตั้งค่าเสร็จสมบูรณ์ (Setup Complete) เมื่อทำตามขั้นตอนข้างต้นแล้ว คุณก็พร้อมเข้าสู่ขั้นตอนการ Build เฉพาะของ iBrowe ตามที่ระบุในเอกสารภายในหรือ wiki

🚀 การเร่งความเร็วการ Build (Build Acceleration) นักพัฒนา iBrowe ภายในอาจเลือกใช้ ระบบ Build ระยะไกล (remote build execution) ได้ตามต้องการ ติดต่อทีม build infrastructure เพื่อขอรับ credential และขั้นตอนการตั้งค่า

⚙️ ไฟล์ .env Configuration ดูตัวอย่างการตั้งค่า environment variables และตัวเลือกการ Build ตาม channel ได้ที่ไฟล์: iBrowe/.env.build.example

▶️ การรัน iBrowe (Running iBrowe)

• ควรรัน iBrowe จาก cmd.exe หรือผ่าน Windows Explorer
• หลีกเลี่ยงการใช้ shell เช่น Git Bash, Cygwin หรือ terminal ที่ไม่ใช่มาตรฐาน เพราะ อาจทำให้ Debug Builds ล้มเหลว เนื่องจากปัญหาการจัดการ log ผ่าน stderr

🛠️ การแก้ไขปัญหา (Troubleshooting) ดูคู่มืออย่างเป็นทางการของ Chromium สำหรับ Windows ได้ที่: https://chromium.googlesource.com/chromium/src/+/HEAD/docs/windows_build_instructions.md

หัวข้อที่ครอบคลุม เช่น:

• การเร่งความเร็วการ Build
• การแก้ปัญหา Build ช้า
• การแก้ปัญหาการตั้งค่าทั่วไป

📂 เคล็ดลับการโคลนโปรเจกต์ (Cloning Tips) ควรโคลน repository ของ iBrowe ไปที่ path ตื้น ๆ เช่น: C:\iBrowe\

หลีกเลี่ยง:

• โฟลเดอร์ที่ลึกเกินไป (>256 ตัวอักษร)
• Path ที่มีช่องว่าง เช่น C:\Users\John Doe
  ปัญหาเหล่านี้อาจทำให้สคริปต์ build ของ Chromium ล้มเหลวได้

📚 เอกสารที่เกี่ยวข้อง (Related Resources)

• Chromium Build Docs
• Omaha Build Setup
• Git Downloads
• Node.js Downloads
• Python Downloads

📝 ที่มา: ดัดแปลงจากเอกสารการ Build ภายในของ Brave และปรับโครงสร้างใหม่ให้เหมาะกับโครงการ iBrowe