原始碼

取得原始碼

Adblock Plus 原始碼可以經由 HG web interface 網頁介面檢視。可以執行這條指令並下載一份本機端的副本:

hg clone https://hg.adblockplus.org/adblockplus/

Element Hiding HelperDiagnostics for Adblock Plus也有建置相似的套件庫。執行這條指令可以還原本機端副本至剛發布的狀態:

hg up -r 1.0.1

(將 1.0.1 置換為所需要的版本編號)。

另外,您也可以 下載最新發布的原始碼

這份 Adblock Plus 原始碼文件 提供一份該套件的內部概論。

HG 用戶端及文件連結

建立一個 Adblock Plus 版本

要建立一個開發版,可以進入 "adblockplus" 資料夾(您的本機端副本),並執行這條指令:

python build.py build

該指令會以 adblockplus-1.2.3.4+.nnnn.xpi 這樣的形式來建立一個新的開發中板本。 這個檔案會包含目前套件庫中的原始碼與所有可取得的語言包。

備註:您需要 Python 2.xJinja2 模組 來建置版本。 執行這條指令可以在 Python 中安裝 Jinja2 :

easy_install Jinja2

測試您更動的部分

要簡化測試變更的流程,可在瀏覽器中安裝 Extension Auto-Installer 。 假設 Extension Auto-Installer 設定為使用連接埠 8888 (預設值),您可以執行下列指令加入欲變更的部分

  python build.py autoinstall 8888

若有需要,瀏覽器將自動重新啟動。

執行單元測試

您可以使用現有的 單元測試套件 來檢驗修改的部分。 單元測試是一個獨立於 Adblock Plus 的擴充套件。 您可以安裝現有的 單元測試版本 ,或者複製套件庫之後建立您自己的版本。 安裝單元測試套件後開啟 chrome://adblockplustests/content/index.html 即可開始執行。