要開發 XUL 或 Firefox 擴充功能,先理解標準的檔案結構會很有幫助。一個典型的擴充功能解壓後,通常會包含數個目錄與幾個關鍵檔案。
chrome:必備目錄,通常包含一個 JAR 檔,用來保存介面與邏輯相關資源。解壓後常見子目錄有 content、locale、skin。content:存放 XUL 檔與 JavaScript 檔,負責描述介面與處理互動。locale:存放不同語言的資源,例如 en-US、zh-CN。Mozilla 會依自身語言選擇最適合的目錄。skin:存放 CSS 與圖片等外觀資源,讓介面能套用不同主題。components:若有自訂 XPCOM 元件,會放在這裡;沒有時可以省略。defaults:存放預設設定或預設資料。install.rdf:以 RDF/XML 格式描述擴充功能的註冊資訊、版本、作者、相容範圍等。安裝時,Firefox 會讀取這個檔案。install.js:可選的安裝腳本。一般情況下 install.rdf 已足夠;若安裝時需要額外處理,才可能使用 XPInstall 機制。chrome.manifest:用來把擴充功能的 package 註冊到 Chrome 系統。這是 Gecko 1.8 之後常見的做法,可取代舊有的 contents.rdf。了解目錄結構後,除錯與維護都會更順暢。例如介面問題通常檢查 content 與 skin;多語言問題多半落在 locale;安裝或載入失敗則要優先檢查 install.rdf 與 chrome.manifest。