源代码

获取源代码

  您可以通过 Adblock Plus 的 HG 网页界面查看它的源代码,或通过在命令行中运行以下命令下载源代码的副本到本地:

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

  与此相似的版本库还包括 Element Hiding Helper 以及 Diagnostics 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.x 并搭配 Jinja2 模块 。 要安装 Jinja2 到 Python 请运行以下命令:

easy_install Jinja2

测试所做的修改

  要简化测试流程您可以在浏览器中安装 Extension Auto-Installer 扩展。 假定 Extension Auto-Installer 配置为使用 8888 端口(默认值),您可以通过运行以下命令将您所做的修改应用到浏览器:

  python build.py autoinstall 8888

  必要时浏览器会自动重新启动。

运行单元测试

  要验证所做的修改您可以使用现有的 单元测试套装。 单元测试是一个额外安装到 Adblock Plus 的单独扩展。 您既可以安装 现有的单元测试版本 ,也可以克隆版本库来创建您自己的版本。 安装完该扩展请到 chrome://adblockplustests/content/index.html 运行单元测试。