Fix lỗi cài đặt Ruby Gem trên Windows

Không giống với Mac hay Linux việc cài đặt Ruby Gem trên Windows là một thử thách đối với không ít bạn lập trình viên khi liên tục gặp phải các lỗi không mong muốn. Rất nhiều bạn đã hoàn toàn bế tắc khi phải đối mặt với các lỗi trên. Trong bài viết này chúng ta sẽ tìm hiểu cách xử lý hai trong số các lỗi thường xuyên xuất hiện trên Windows khi cài đặt Ruby Gem.

Lỗi Encoding

Đây là lỗi rất thường gặp khi sử dụng chương trình Ruby Installer để cài đặt Ruby Gem trên Windows. Khi gặp phải lỗi này bạn sẽ thấy thông báo giống như dưới đây:

C:>gem install sass
ERROR:  While executing gem ... (Encoding::ConverterNotFoundError)
    code converter not found (UTF-16LE to Windows-1258)

Để fix lỗi trên bạn chỉ cần thay đổi code page cho chương trình Command Prompt về UTF-8 sử dụng câu lệnh sau:

C:>chcp 850

Trường hợp bạn sử dụng Cygwin thì câu lệnh cần sử dụng sẽ là:

regtool set /user/Console/CodePage 0xfde9

Lưu ý: Bạn cần tắt các cửa sổ Command Prompt khác được mở trước khi chạy câu lệnh trên (trừ cửa sổ hiện tại sử dụng để chạy câu lệnh) để đảm bảo việc thay đổi code page có hiệu lực.

Lỗi Thiếu Build Tools

Một lỗi khác mà nhiều người cũng thường xuyên gặp phải đó là thiếu build tools. Thông báo của lỗi này sẽ như sau:

C:> gem install jekyll
ERROR:  Error installing jekyll:
    The 'posix-spawn' native gem requires installed build tools.

Please update your PATH to include build tools or download the DevKit
from 'http://rubyinstaller.org/downloads' and follow the instructions
at 'http://github.com/oneclick/rubyinstaller/wiki/Development-Kit'

Lỗi này gặp phải khi các build tools cần thiết cho Ruby Installer vắng mặt trên hệ điều hành Windows. Để khắc phục lỗi này chúng ta cần cài đặt Development Kit hay DevKit. DevKit bao gồm các build tools cần dùng để thực hiện việc build (và sử dụng) các extension được viết bằng C/C++.

Bạn cần lưu ý chọn đúng phiên bản DevKit cho Ruby Installer được cài trên máy:

• Đối với Ruby Installer phiên bản 1.8.6 bạn cần sử dụng DevKit 3.4.5.
• Đối với Ruby Installer phiên bản 1.8.7, 1.9.2 và 1.9.3 bạn cần sử dụng DevKit 4.5.2.

Để thực hiện việc cài đặt build tools thì trước tiên bạn cần tải về chương trình cài đặt DevKit dành cho Windows. Click vào link tải DevKit và tìm phiên bản phù hợp với phiên bản Ruby Installer trên máy bạn. Click đúp lên file cài đặt để khởi động trình cài đặt DevKit dành cho Windows sau đó thực hiện tiếp các bước cài đặt DevKit như sau:

• Chọn thư mục giải nén các tập tin của chương trình DevKit (Thường đặt ở trong thư mục cài đặt Ruby, ví dụ: C:Ruby193DevKit)
• Mở Command Prompt và chạy di chuyển vào thư mục giải nén ở trên cd C:Ruby193DevKit.
• Chạy câu lệnh ruby dk.rb init để khởi tạo file config.xml sử dụng cho việc cài đặt.
• Chạy ruby dk.rb review để kiểm tra lại danh sách các phiên bản của Ruby được cài đặt bởi Ruby Installer.
• Chạy ruby dk.rb install để tích hợp DevKit cho từng phiên bản Ruby được cài đặt.

Sau khi kết thúc việc cài đặt DevKit trên bạn chạy lại câu lệnh cài đặt Gem.