Building the browser extension » History » Version 6
koszko, 10/14/2022 09:06 AM
update title
| 1 | 6 | koszko | # Building the browser extension |
|---|---|---|---|
| 2 | 3 | 0gitnick | There're currently 2 ways to build Haketilo. |
| 3 | 1 | jahoti | |
| 4 | 5 | koszko | ## 1. Simple stupid way - `build.sh` script |
| 5 | 3 | 0gitnick | You only need a POSIX-compliant environment for this (shell, awk, etc.). It is a viable option if you don't need to run the automated test suite. From project's root directory, using a POSIX shell, you type either: |
| 6 | ``` shell |
||
| 7 | ./build.sh mozilla # to build for Firefox-based browsers |
||
| 8 | ``` |
||
| 9 | or: |
||
| 10 | ``` shell |
||
| 11 | ./build.sh chromium # to build for Chromium-based browsers |
||
| 12 | ``` |
||
| 13 | The unpacked extension shall be generated under `./mozilla-unpacked/` or `./chromium-unpacked/`, respectively. You can then load it into your browser as a temporary extension or pack it into an xpi/crx/zip archive manually, e.g.: |
||
| 14 | ``` shell |
||
| 15 | 7z a -tzip haketilo.xpi -w mozilla-unpacked/. |
||
| 16 | ``` |
||
| 17 | |||
| 18 | 5 | koszko | ## 2. `configure`-based build |
| 19 | 3 | 0gitnick | This method assumes you have not only a POSIX environment but also a working Make tool and the zip command. From project's root directory, run the shell commands: |
| 20 | ``` shell |
||
| 21 | ./configure --host=mozilla # or analogically with --host=chromium |
||
| 22 | make |
||
| 23 | ``` |
||
| 24 | This would generate the unpacked extension under `./mozilla-unpacked/` and its zipped version under `./mozilla_build.zip` (which you can rename to .xpi if you want). |
||
| 25 | |||
| 26 | You can also perform an out-of-source build, for example: |
||
| 27 | ``` shell |
||
| 28 | mkdir /tmp/haketilo-build && cd /tmp/haketilo-build |
||
| 29 | /path/to/haketilo/sources/configure --host=chromium |
||
| 30 | make all # will generate both ./mozilla-build.zip and ./chromium-build.zip |
||
| 31 | ``` |