OLD | NEW |
1 Adblock Plus for Internet Explorer | 1 Adblock Plus for Internet Explorer |
2 ================================== | 2 ================================== |
3 | 3 |
4 This combines a Browser Helper Object with a singleton engine process to block | 4 This combines a Browser Helper Object with a singleton engine process to block |
5 ads in Internet Explorer. The engine process embeds libadblockplus. | 5 ads in Internet Explorer. The engine process embeds libadblockplus. |
6 | 6 |
7 Building | 7 Building |
8 -------- | 8 -------- |
9 | 9 |
10 You need Microsoft Visual C++ (Express is sufficient) 2012 and Python 2.6. Make | 10 You need Microsoft Visual C++ (Express is sufficient) 2012 and Python 2.6. Make |
11 sure that `python.exe` is on your `PATH`. When building with Express Edition | 11 sure that `python.exe` is on your `PATH`. When building with Express Edition |
12 you also need Windows 7.1 Device Kit (*not* version 8) to satisfy the ATL | 12 you also need Windows 7.1 Device Kit (*not* version 8) to satisfy the ATL |
13 dependency, set `WINDDKDIR` environment variable to the installation directory | 13 dependency, set `WINDDKDIR` environment variable to the installation directory |
14 of the Device Kit. | 14 of the Device Kit. |
15 | 15 |
16 * Execute `createsolution.bat` to generate project files, this will create | 16 * Execute `createsolution.bat` to generate project files, this will create |
17 `build\ia32\adblockplus.sln` (solution for the 32 bit build) and | 17 `build\ia32\adblockplus.sln` (solution for the 32 bit build) and |
18 `build\x64\adblockplus.sln` (solution for the 64 bit build). Unfortunately, | 18 `build\x64\adblockplus.sln` (solution for the 64 bit build). Unfortunately, |
19 V8 (which is used by libadblockplus) doesn't support creating both from the | 19 V8 (which is used by libadblockplus) doesn't support creating both from the |
20 same project files. | 20 same project files. |
21 * Open `build\ia32\adblockplus.sln` or `build\x64\adblockplus.sln` in | 21 * Open `build\ia32\adblockplus.sln` or `build\x64\adblockplus.sln` in |
22 Visual Studio and build the solution there. Alternatively you can use the | 22 Visual Studio and build the solution there. Alternatively you can use the |
23 `msbuild` command line tool, e.g. run `msbuild /m build\ia32\adblockplus.sln` | 23 `msbuild` command line tool, e.g. run `msbuild /m build\ia32\adblockplus.sln` |
24 from the Visual Studio Developer Command Prompt to create a 32 bit debug build. | 24 from the Visual Studio Developer Command Prompt to create a 32 bit debug build. |
25 | 25 |
| 26 Running |
| 27 ------- |
| 28 |
| 29 In order to test the extension, you need to register the Browser |
| 30 Helper Object with IE. You can do this by locating _AdblockPlus.dll_ |
| 31 (e.g. in _build\ia32\Debug_) and running (with elevated privileges): |
| 32 |
| 33 regsvr32 AdblockPlus.dll |
| 34 |
| 35 For the UI to work, you also need to copy the _html_ and _locale_ |
| 36 directories to the same directory _AdblockPlus.dll_ is in. |
| 37 |
26 Building the installer | 38 Building the installer |
27 ---------------------- | 39 ---------------------- |
28 * Execture Installer\createsolutions.bat to generate installer project files, | 40 * Execture Installer\createsolutions.bat to generate installer project files, |
29 this will create a bunch of project files in installer\build\ia32 and | 41 this will create a bunch of project files in installer\build\ia32 and |
30 installer\build\x64 folders. | 42 installer\build\x64 folders. |
31 * Open 'installer\build\ia32\installer.sln' and then 'installer\build\x64\instal
ler.sln' | 43 * Open 'installer\build\ia32\installer.sln' and then 'installer\build\x64\instal
ler.sln' |
32 in Visual Studio and build both solutions. Alternatively you can use the 'msbuil
d' | 44 in Visual Studio and build both solutions. Alternatively you can use the 'msbuil
d' |
33 command line tool, e.g. run 'msibuild /m installer\build\ia32\adblockplus.sln' a
nd | 45 command line tool, e.g. run 'msibuild /m installer\build\ia32\adblockplus.sln' a
nd |
34 'msibuild /m installer\build\x64\adblockplus.sln' | 46 'msibuild /m installer\build\x64\adblockplus.sln' |
35 * Make sure you have InnoSetup installed. Either open and compile | 47 * Make sure you have InnoSetup installed. Either open and compile |
36 'installer\src\innosetup-exe\64BitTwoArch.iss' in InnoSetup or run | 48 'installer\src\innosetup-exe\64BitTwoArch.iss' in InnoSetup or run |
37 'iscc.exe installer\src\innosetup-exe\64bitTwoArch.iss' | 49 'iscc.exe installer\src\innosetup-exe\64bitTwoArch.iss' |
38 | |
39 Development environment | |
40 ----------------------- | |
41 | |
42 TODO: Describe how to test your build | |
OLD | NEW |