Editing Compiling FileZilla 3 under macOS
From FileZilla Wiki
Jump to navigationJump to searchWarning: You are not logged in. Your IP address will be publicly visible if you make any edits. If you log in or create an account, your edits will be attributed to your username, along with other benefits.
The edit can be undone. Please check the comparison below to verify that this is what you want to do, and then save the changes below to finish undoing the edit.
Latest revision | Your text | ||
Line 1: | Line 1: | ||
− | This documentation explains how to setup a build environment for [[FileZilla 3]] and how to compile it under | + | This documentation explains how to setup a build environment for [[FileZilla 3]] and how to compile it under Mac OS X using [http://developer.apple.com/TOOLS/xcode/ Xcode]. These directions were written for and tested under Mac OS X Tiger Intel. They may or may not work with Panther, Leopard, or any other Mac Cats you have. |
+ | |||
__TOC__ | __TOC__ | ||
− | ==Xcode== | + | == Setting up the build environment == |
− | You need to | + | |
+ | This includes the compiler and the required tools to build FileZilla 3 and its dependancies. | ||
+ | |||
+ | === Xcode === | ||
+ | |||
+ | Download and install the latest Xcode package for your system. [http://connect.apple.com/cgi-bin/WebObjects/MemberSite.woa/wa/getSoftware?bundleID=19907 Xcode 2.5] is the right version for Tiger. | ||
+ | |||
+ | Be sure you Customize the install. You will need to make sure all options under "Command Line Support" are checked. | ||
+ | |||
+ | == Building the Dependencies == | ||
+ | |||
+ | FileZilla depends on the work of several open source projects. We must build them before we can build FileZilla. | ||
+ | |||
+ | The dependencies can take a long time to build. Instead of waiting for each project to build, you can start an additional Terminal Shell for each one and run them at the same time. However, you must have libgpg-error built before libgcrypt, and you must have libgcrypt built before GNU TLS. | ||
+ | |||
+ | If you have a multi-core machine, the build may go faster if you change "nice make" to "nice make -jN" where N equals the number of cores you have + 1 (e.g. dual-core: N = 3). | ||
+ | |||
+ | === wxWidgets === | ||
+ | |||
+ | Download [http://www.wxwidgets.org/downloads/ wxWidgets]. You will need version 2.8.9 or later. The current version for Mac is [http://prdownloads.sourceforge.net/wxwindows/wxMac-2.8.9.tar.gz wxMac-2.8.9.tar.gz]. | ||
+ | |||
+ | Start Terminal from the Applications/Utilities folder and enter the following commands: | ||
+ | |||
+ | cd /tmp | ||
+ | gzip -cd ~/Desktop/wxMac-2.8.9.tar.gz | tar x | ||
+ | mkdir build-wx | ||
+ | cd build-wx | ||
+ | ../wxMac-2.8.9/configure --disable-shared --disable-compat26 --enable-unicode \ | ||
+ | --prefix "$HOME/filezilla/wxMac-2.8.9" && nice make && make install | ||
+ | |||
+ | === GNU gettext === | ||
+ | |||
+ | Download [http://ftp.gnu.org/gnu/gettext/ GNU gettext]. The current version is [http://ftp.gnu.org/gnu/gettext/gettext-0.17.tar.gz gettext-0.17.tar.gz]. | ||
+ | |||
+ | Start Terminal from the Applications/Utilities folder and enter the following commands: | ||
+ | |||
+ | cd /tmp | ||
+ | gzip -cd ~/Desktop/gettext-0.17.tar.gz | tar x | ||
+ | cd gettext-0.17 | ||
+ | ./configure --prefix "$HOME/filezilla/gettext" && nice make && make install | ||
+ | |||
+ | === GNU libidn === | ||
+ | |||
+ | Download [http://ftp.gnu.org/gnu/libidn/ GNU libidn]. The current version is [http://ftp.gnu.org/gnu/libidn/libidn-1.11.tar.gz libidn-1.11.tar.gz]. | ||
+ | |||
+ | Start Terminal from the Applications/Utilities folder and enter the following commands: | ||
+ | |||
+ | cd /tmp | ||
+ | gzip -cd ~/Desktop/libidn-1.11.tar.gz | tar x | ||
+ | cd libidn-1.11 | ||
+ | ./configure --disable-shared --prefix "$HOME/filezilla/libidn" && nice make && make install | ||
+ | |||
+ | === libgpg-error === | ||
+ | |||
+ | Download [ftp://ftp.gnupg.org/gcrypt/libgpg-error/ libgpg-error]. The current version is [ftp://ftp.gnupg.org/gcrypt/libgpg-error/libgpg-error-1.7.tar.bz2 libgpg-error-1.7.tar.bz2]. | ||
+ | |||
+ | Start Terminal from the Applications/Utilities folder and enter the following commands: | ||
+ | |||
+ | cd /tmp | ||
+ | bzip2 -cd ~/Desktop/libgpg-error-1.7.tar.bz2 | tar x | ||
+ | cd libgpg-error-1.7 | ||
+ | ./configure --disable-shared --prefix "$HOME/filezilla/libgpg-error" && nice make && make install | ||
+ | |||
+ | === libgcrypt === | ||
+ | |||
+ | Download [ftp://ftp.gnupg.org/gcrypt/libgcrypt/ libgcrypt]. The current version is [ftp://ftp.gnupg.org/gcrypt/libgcrypt/libgcrypt-1.4.3.tar.bz2 libgcrypt-1.4.3.tar.bz2]. | ||
+ | |||
+ | Start Terminal from the Applications/Utilities folder and enter the following commands: | ||
+ | |||
+ | cd /tmp | ||
+ | bzip2 -cd ~/Desktop/libgcrypt-1.4.3.tar.bz2 | tar x | ||
+ | cd libgcrypt-1.4.3 | ||
+ | ./configure --disable-shared --prefix "$HOME/filezilla/libgcrypt" \ | ||
+ | --with-gpg-error-prefix="$HOME/filezilla/libgpg-error" && nice make && make install | ||
+ | |||
+ | === GNU TLS === | ||
+ | |||
+ | Download [http://ftp.gnu.org/gnu/gnutls/ GNU TLS]. The current version is [http://ftp.gnu.org/gnu/gnutls/gnutls-2.6.3.tar.bz2 gnutls-2.6.3.tar.bz2] | ||
+ | |||
+ | You also need to download [http://filezilla-project.org/codesquid/gnutls.patch gnutls.patch]. | ||
+ | |||
+ | Start Terminal from the Applications/Utilities folder and enter the following commands: | ||
+ | |||
+ | cd /tmp | ||
+ | bzip2 -cd ~/Desktop/gnutls-2.6.3.tar.bz2 | tar x | ||
+ | cd gnutls-2.6.3 | ||
+ | patch < ~/Desktop/gnutls.patch | ||
+ | ./configure --disable-shared --prefix "$HOME/filezilla/gnutls" \ | ||
+ | --with-libgcrypt-prefix="$HOME/filezilla/libgcrypt" && nice make && make install | ||
− | + | Now we need to fix a problem with libgnutls-config because it forgets it needs zlib. | |
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | + | Open the file "$HOME/filezilla/gnutls/bin/libgnutls-config" in TextEdit (or some other text editor). Look for a line near the top that resembles: | |
− | = | + | gnutls_libs="-L${exec_prefix}/lib -lgnutls -L/Users/'''x'''/filezilla/gnutls/lib -lgcrypt -lgpg-error " |
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | + | Add -lz at the end so that it looks more like: | |
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | = | + | gnutls_libs="-L${exec_prefix}/lib -lgnutls -L/Users/'''x'''/filezilla/gnutls/lib -lgcrypt -lgpg-error -lz " |
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | + | Please note the space between -lz and the closing quote; it '''must''' be present. | |
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | == | + | == Building [[FileZilla 3]] == |
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | + | Download the [http://filezilla-project.org/download.php?type=client FileZilla source]. The current version is [https://www.ohloh.net/projects/filezilla/download?filename=FileZilla_3.1.6_src.tar.bz2 FileZilla_3.1.6_src.tar.bz2]. | |
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | + | Start Terminal from the Applications/Utilities folder and enter the following commands: | |
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | + | cd /tmp | |
− | cd | + | bzip2 -cd ~/Desktop/FileZilla_3.1.6_src.tar.bz2 | tar x |
− | + | cd filezilla-3.1.6 | |
− | + | export PATH="$HOME/filezilla/wxMac-2.8.9/bin":"$HOME/filezilla/gettext/bin":$PATH | |
− | + | ./configure CPPFLAGS="-I\"$HOME/filezilla/libidn/include\"" \ | |
− | ./configure - | + | --with-idn-lib="$HOME/filezilla/libidn/lib/libidn.a" \ |
− | + | --with-libgnutls-prefix="$HOME/filezilla/gnutls" --disable-shared && nice make | |
− | + | cd FileZilla.app/Contents/MacOS | |
+ | strip filezilla fzputtygen fzsftp | ||
+ | cd - && mv FileZilla.app ~/Desktop | ||
− | == | + | == Troubleshooting == |
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | + | If you run into problems, please make sure you've followed each step exactly how it is explained and that you haven't missed any steps along the way. | |
− | |||
− | |||
− | |||
− | |||
− | |||
− |