1. Cài đặt môi trường phát triển
Extension việt hóa giao diện được đóng gói trong một file nén gọi là “Vi.xpi”. được đóng gói theo cấu trúc của một file cài đặt ngôn ngữ:
Vi.xpi:
install.rdf
chrome.manifest \chrome\
\chrome\vi.jar
Tạo một thư mục mới lấy tên là “Vi”, cho extension. Trong thư mục này tạo hai file văn bản gọi là chrome.manifest và file còn lại là install.rdf.
2. Tạo file cài đặt “install manifest”
Mở file install.rdf đã được tạo ra. File này có chức năng khai báo thông tin được cài đặt trong hệ thống và thông báo cho hệ thống biết là đang cài đặt cái gì.
install.rdf
<?xml version="1.0"?>
<RDF xmlns="http://www.w3.org/1999/02/22-rdf-syntax-ns#"
xmlns:em="http://www.mozilla.org/2004/em-rdf#">
<Description about="urn:mozilla:install-manifest"
em:id="langpack-vi@firefox.mozilla.org"
em:name="Vietnamese (vi) Language Pack"
em:version="2.0"
em:type="8"
em:creator="Vu Thanh Binh">
<em:targetApplication>
<Description>
<em:id>{ec8030f7-c20a-464f-9b0e-13a3a9e97384}</em:id>
<em:minVersion>1.5</em:minVersion>
<em:maxVersion>2.0.0.*</em:maxVersion>
</Description>
</em:targetApplication>
</Description>
</RDF>
- langpack-vi@firefox.mozilla.org – ID của extension. Đó là giá trị để nhận biết extension là duy nhất, giá trị này được định dạng theo email nhưng không phải là giá trị email thực tế của bạn.
- em:type="8" – Đây là giá trị cho biết extension của bạn thuộc loại nào. Với giá trị là 8, extension của bạn là một ”locale”, nếu là 4 thì đó là một “theme”.
- {ec8030f7-c20a-464f-9b0e-13a3a9e97384} – ID của ứng dụng Firefox.
- 1.5 – giới hạn nhỏ nhât của ứng dụng Mozilla Firefox mà extension của bạn có thể sử dụng, và cài đặt trên đó được.
- 2.0.0.* - giới hạn lớn nhất của phiên bản Firefox có thể làm việc được với extension.
3. Tạo một “Chrome Manifest”
Mở file chrome.manifest đã tạo ở trên trong thư mục “vi”, tạo danh sách những gói locale được đăng ký:
locale necko vi jar:chrome/vi.jar!/locale/vi/necko/
locale pippki vi jar:chrome/vi.jar!/locale/vi/pippki/
locale pipnss vi jar:chrome/vi.jar!/locale/vi/pipnss/
locale mozapps vi jar:chrome/vi.jar!/locale/vi/mozapps/
locale help vi jar:chrome/vi.jar!/locale/vi/help/
locale global vi jar:chrome/vi.jar!/locale/vi/global/
locale autoconfig vi jar:chrome/vi.jar!/locale/vi/autoconfig/
locale global-platform vi jar:chrome/vi.jar!/locale/vi/global-platform/
locale global-region vi jar:chrome/vi.jar!/locale/vi/global-region/
locale cookie vi jar:chrome/vi.jar!/locale/vi/cookie/
locale passwordmgr vi jar:chrome/vi.jar!/locale/vi/passwordmgr/
locale reporter vi jar:chrome/vi.jar!/locale/vi/reporter/
locale browser-region vi jar:chrome/vi.jar!/locale/browser-region/
locale browser vi jar:chrome/vi.jar!/locale/browser/
locale branding vi jar:chrome/vi.jar!/locale/branding/
Những đăng ký này sẽ đang ký một gói locale với trình duyệt khi phân giải tên đường dẫn URI. Chẳng hạn ta đăng ký gói locale với ngôn ngữ “vi”(mã cho từng vùng ngôn ngữ đươc đang ký để nhận diện, ở đây là việt nam) cho các gói “necko”, “browse”, … Nếu có nhiều hơn một ngôn ngữ được đăng ký, trình duyệt sẽ chọn một ngôn ngữ chỉ định thông qua tham chiếu cài đặt.
Tất cả các gói được đăng ký này được đặt trong một file “vi.jar”. file này có hệ thống và cấu trúc tương tự như file en-US.jar, và đã được việt hóa các file chứa bên trong nó.
5. Đóng gói và cài đặt
Trong thư mục “vi”, ta đưa tất cả vào một file nén bằng công cụ ZIP, chuyển phần mở rộng của file đó thành .XPI – định dạng cài đặt của extension trong Mozilla Firefox.
Ta có thể cài đặt bằng tay file này bằng cách chép vào thư mục “Mozilla Firefox\entension\ ” hệ thống sẽ tự nhận biết và cài đặt gói ngôn ngữ, với đăng ký trong Extension là:
langpack-vi@firefox.mozilla.org
và trong addon của Mozilla sẽ xuất hiện gói đăng ký ngôn ngữ:
Khởi động lại trình duyệt, để có thể sử dụng gói ngôn ngữ này.
Do có nhiều hơn một ngôn ngữ được sử trong Firefox, như ta thấy ở trên là:
English (GB) Language Pack 2.0 Francais Language Pack
Vietnamese (vi) Language Pack 2.0
Trong Firefox bạn cần phải chỉ định gói ngôn ngữ đang sử dụng, bạn có thể sử dụng lệnh about:config, său đó tìm đến thuộc tính general.useragent.locale và chuyển giá trị của nó từ “en” sang “vi” mã chỉ định ngôn ngữ cho từng vùng, lãnh thổ:
Khởi động lại trình duyệt Mozilla Firefox, ta sẽ thấy giao diện tiếng việt của trình duyệt hiển thị.
Ngoài ra, ta cũng có thể cài đặt tự động một extension từ một trang web sử dụng InstallTrigger trong đoạn mã javascript:
<script type="application/x-javascript">
<!--
function install (aEvent) {
var params = {
"Việt Nam": { URL: aEvent.target.href,
IconURL: aEvent.target.getAttribute("iconURL"), toString: function () { return this.URL; }
} };
InstallTrigger.install(params);
return false;
} -->
</script>
<a href="instalFile/VietnameseLanguagePack/vi.xpi"
iconURL="image/vi.png"
onclick="return install(event);">Install Extension!</a>
Khi đó Mozilla sẽ tự động đăng ký và cài đặt gói vi.xpi vào trình duyệt: