Hướng dẫn Chuẩn bị Xây dựng iBrowe trên Windows

(Chuyển thể từ tài liệu của Chromium và Brave. Đã đổi thương hiệu và tái cấu trúc cho dự án iBrowe.)

⚙️ Thiết lập Ban đầu

Để chuẩn bị hệ thống của bạn cho việc biên dịch iBrowe trên Windows, hãy thực hiện theo các bước sau — dừng lại trước giai đoạn “Get the code” trong hướng dẫn chính thức của Chromium.

✅ Yêu cầu Hệ thống

Đảm bảo máy của bạn đáp ứng đầy đủ các điều kiện tiên quyết trong yêu cầu hệ thống của Chromium.

🛡️ Phần mềm Diệt Virus

Thêm các ngoại lệ (exclusions) cho thư mục làm việc được sử dụng trong quá trình biên dịch. Windows Defender được bật mặc định và có thể gây cản trở các công cụ build.

🛠️ Visual Studio

Cài đặt Visual Studio Community 2022, ưu tiên phiên bản 17.8.3. Các phiên bản mới hơn có thể hoạt động nhưng khả năng tương thích với Chromium là yếu tố then chốt.

Bắt buộc cài đặt các thành phần sau:

  • Desktop Development with C++
  • Windows 11 SDK (cũng tương thích với Windows 10)

Tham khảo tài liệu Omaha Build Guide để biết thêm chi tiết về khả năng tương thích.

🔄 Git

Cài đặt Git phiên bản 2.41 trở lên.

⚠️ Không sử dụng phiên bản Git đi kèm với depot_tools, vì không tương thích với hệ thống patch của iBrowe.

Sau khi cài đặt, làm theo hướng dẫn cấu hình Git trong phần “Get the Code” của Chromium, đặc biệt là các lệnh git config --global.

🌐 Node.js

Cài đặt Node.js phiên bản 20 LTS.

Đây là phiên bản duy nhất được hỗ trợ để build iBrowe.

🐍 Python

Cài đặt Python 3.x cho Windows.

Mặc dù depot_tools có bao gồm Python, nhưng:

  • Một số script cũ vẫn yêu cầu Python 2.7
  • Có thể xảy ra xung đột nếu biến PATH của hệ thống ưu tiên Python từ depot_tools

✅ Hoàn tất Thiết lập

Sau khi hoàn tất các bước trên, bạn có thể tiếp tục các bước build dành riêng cho iBrowe được ghi trong tài liệu nội bộ hoặc wiki của dự án.

🚀 Tăng tốc Quá trình Build

Các nhà phát triển nội bộ của iBrowe có thể cấu hình hệ thống build từ xa (remote build execution). Liên hệ nhóm hạ tầng build để nhận thông tin đăng nhập và hướng dẫn thiết lập.

⚙️ Cấu hình .env

Tham khảo file iBrowe/.env.build.example để thiết lập các biến môi trường và tùy chọn build theo từng kênh phân phối.

▶️ Chạy iBrowe

Luôn chạy các bản build của iBrowe thông qua cmd.exe hoặc File Explorer trên Windows. Tránh sử dụng các shell không tiêu chuẩn như Git Bash, Cygwin,… vì các bản build debug có thể bị lỗi khi ghi log qua stderr.

🛠️ Xử lý Sự cố

Tham khảo hướng dẫn chính thức của Chromium tại: https://chromium.googlesource.com/chromium/src/+/HEAD/docs/windows/_build/_instructions.md

Bao gồm các chủ đề như:

  • Tăng tốc build
  • Khắc phục build chậm
  • Các lỗi cấu hình phổ biến

📂 Lưu ý khi Clone Mã nguồn

Clone repository của iBrowe vào một thư mục nông như:

C:\iBrowe\

Tránh:

  • Đường dẫn thư mục quá sâu (> 256 ký tự)
  • Đường dẫn có khoảng trắng (ví dụ: C:\Users\John Doe\)

Những yếu tố này có thể khiến các script build của Chromium bị lỗi.

📚 Tài liệu Tham khảo

📝 Nguồn gốc: Tài liệu chuyển thể từ hướng dẫn build nội bộ của Brave trên Windows, nay được cấu trúc lại và đổi thương hiệu dành riêng cho dự án iBrowe.