This repository has been archived by the owner on Jan 19, 2022. It is now read-only.
-
Notifications
You must be signed in to change notification settings - Fork 66
/
building.html
109 lines (96 loc) · 4.25 KB
/
building.html
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
<!-- This Source Code Form is subject to the terms of the Mozilla Public
- License, v. 2.0. If a copy of the MPL was not distributed with this file,
- You can obtain one at http://mozilla.org/MPL/2.0/. -->
<html lang="en">
<head>
<meta http-equiv="Content-Type" content="text/html;charset=utf-8">
<title>Building Valence</title>
<style type="text/css">
.path {
font-family: monospace;
}
dt {
font-weight: bold;
}
</style>
<link rel="stylesheet" href="chrome://global/skin/about.css" type="text/css">
</head>
<body id="lic-info" class="aboutPageWideContainer">
<h1><a id="top"></a>Building Valence</h1>
<div>
<p>
Building Valence is easy. It requires the complete
<a href="https://ftp.mozilla.org/pub/mozilla.org/labs/valence/sources/valence-latest-sources.zip">sources</a>
that are available in the same location as the add-on XPI binary. Older
versions of both sources and binaries can also be found
<a href="https://ftp.mozilla.org/pub/mozilla.org/labs/valence/">there</a>.
</p>
<h2>Quick Build</h2>
<p>
First of all the zip file needs to be downloaded and decompressed. Then,
if only a quick build using the bundled iOS proxy binaries is required, a
simple <code>make</code> in the <code>valence</code> directory will suffice.
The command will create XPI files in that directory for every platform.
</p>
<p>
In order to build the iOS proxy binaries from source, the process is a
bit more involved and different for each platform.
</p>
<h2>Linux</h2>
<p>
To build <code>ios-webkit-debug-proxy</code> on Linux, follow the
instructions in the <code>ios-webkit-debug-proxy/README.md</code> file. It
mentions that you first need to install its dependencies: <code>libplist,
libusbmuxd, libimobiledevice</code>. For each one of these you have to
follow the instructions in the README files of the respective directories.
The process for each one in a nutshell is:
<ul>
<li><code>./autogen.sh</code></li>
<li><code>./configure</code> (only for ios-webkit-debug-proxy)</li>
<li><code>make</code></li>
<li><code>sudo make install</code></li>
</ul>
Then, copy the binary compilation artifacts back to
<code>valence/tools/linux{32,64}</code> (depending on the platform you are
on), overwriting the existing versions. Everything is now ready for
running <code>make</code> in the <code>valence</code> directory to get the
XPI file.
</p>
<h2>Mac</h2>
<p>
To build <code>ios-webkit-debug-proxy</code> on Mac, the Linux instructions
above can be followed with 2 more additional dependencies, OpenSSL and
libxml2. The build instructions for OpenSSL can be found in
<code>openssl/INSTALL</code> and the process in a nutshell is:
<ul>
<li><code>./config</code></li>
<li><code>make</code></li>
<li><code>sudo make install</code></li>
</ul>
The commands to build libxml2 can be found in <code>libxml2/README</code>
and they are the same as for <code>ios-webkit-debug-proxy</code>:
<ul>
<li><code>./autogen.sh</code></li>
<li><code>./configure</code></li>
<li><code>make</code></li>
<li><code>sudo make install</code></li>
</ul>
All resulting compilation artifacts should be copied to the
<code>valence/tools/mac64</code> directory, replacing the existing ones.
Running <code>make</code> will then create the XPI file in the same
directory.
</p>
<h2>Windows</h2>
<p>
To build <code>ios-webkit-debug-proxy.exe</code> on Windows, the process is
simpler, but Visual Studio 2012 or 2013 is required (Community is fine).
Open the <code>ios-webkit-debug-proxy-win32/iwdp-solution.sln</code>
solution file in Visual Studio and then build it. Once it is done, copy
the binary artifacts from the <code>Release</code> directory to the
<code>valence/tools/win32</code> directory. Then, just run <code>make</code>
to get an XPI file suitable for installation through the Firefox Addon
Manager.
</p>
<p><a href="#top">Return to top</a>.</p>
</body>
</html>