mirror of
https://github.com/mozilla/gecko-dev.git
synced 2024-10-17 15:25:52 +00:00
0d3162b8a7
Also take the opportunity to add specific instructions about how to rebuild 7zSD.sfx. --HG-- extra : source : b661b49403a54fa36d2f1e04c0fa7ea7c53764c7
63 lines
4.0 KiB
Plaintext
63 lines
4.0 KiB
Plaintext
This directory contains the LZMA SDK code used in building the self-extracting
|
|
Windows installer.
|
|
|
|
The src/ directory contains an almost-unmodified copy of the 7-zip source code
|
|
version 18.05, as downloaded from https://www.7-zip.org/a/lzma1805.7z (linked
|
|
from https://www.7-zip.org/sdk.html) on August 30, 2018. As stated in
|
|
DOC/lzma-sdk.txt and on the web page, this code is in the public domain. A few
|
|
modifications have been made to this copy of the source code. Those
|
|
modifications are contained in mozilla_customizations.diff, which should be
|
|
found in the same directory as this file.
|
|
|
|
The firefox/ directory contains 7zSD.sfx, a 32-bit Windows executable built
|
|
from the Visual C++ 6 project found in the src/CPP/7zip/Bundles/SFXSetup/
|
|
directory. The "ReleaseD" configuration was used. Including a compiled binary
|
|
in the source tree is certainly not preferred, but is necessary in this case
|
|
because the code does not build cleanly under more recent compilers. Using an
|
|
older toolchain also allows us to keep this executable running on older Windows
|
|
versions which are no longer supported by the build system used for the main
|
|
application; that means we can show an error message specifically informing
|
|
users that their OS is too old, instead of the generic "not a valid Win32
|
|
application" error that Windows would generate if we used the newer toolchain
|
|
and that isn't very helpful to most users. Using a precompiled binary also
|
|
allows the installer build procedure to work without a compiler toolchain
|
|
being configured (e.g., for artifact builds).
|
|
|
|
The firefox/ directory also contains an icon and a manifest which were edited
|
|
into 7zSD.sfx's resources after build time. The icon had to be added this way
|
|
as opposed to just replacing the included 7-zip icon because the resource
|
|
compiler included with VC6 does not support the 128x128 PNG image included in
|
|
our icon file. Similarly, the manifest had to be edited in because the older
|
|
resource compiler does not support manifests (and the 7-zip build files do not
|
|
try to use any).
|
|
|
|
The version info in the compiled binary was also edited after build time. There
|
|
isn't a technical reason why the version info changes couldn't be included at
|
|
build time, but since the goal is just to avoid confusing users about the origin
|
|
of the Firefox installer, not to appear to be making the claim that we wrote the
|
|
LZMA SDK, a more targeted change is appropriate.
|
|
|
|
Step-by-step instructions for generating 7zSD.sfx:
|
|
1) Install Microsoft Visual C++ 6 Professional or Enterprise edition (the
|
|
Standard edition does not include the optimizing compiler, so it should
|
|
not be used). You'll likely want a virtual machine running Windows XP,
|
|
because running VC6 under more modern Windows versions is tricky.
|
|
2) Install an appropriate Windows SDK version. The Windows XP Service Pack 2 SDK
|
|
is known to work well, but that particular version appears to only be
|
|
available from archive.org:
|
|
https://web.archive.org/web/20080209175723/http://www.microsoft.com:80/msdownload/platformsdk/sdkupdate/XPSP2FULLInstall.htm
|
|
3) Run the tool included with the SDK that configures Visual C++ to use it.
|
|
4) If using a fresh copy of the LZMA SDK sources, apply the patch in
|
|
mozilla_customizations.diff. The copy in the Firefox source tree already
|
|
has these changes applied.
|
|
5) Open the workspace file at src\CPP\7zip\Bundles\SFXSetup\SFXSetup.dsw and
|
|
build it using the "SFXSetup - Win32 ReleaseD" configuration. The output
|
|
executable should be at the path ReleaseD\7zSD.sfx relative to SFXSetup.dsw.
|
|
6) Use Resource Hacker (available from http://angusj.com/resourcehacker/) to
|
|
replace the existing icon on 7zSD.sfx and to add the manifest as a new
|
|
resource. Also edit the version info resource to replace CompanyName and
|
|
LegalCopyright with "Mozilla" (or appropriate vendor name) and
|
|
FileDescription and ProductName with "Firefox" (or appropriate product name).
|
|
Be sure to recompile the resources using the green "play" button in the
|
|
toolbar (or by pressing F5) before saving the file.
|