Difference between revisions of "Compiling FileZilla 3 under macOS"

From FileZilla Wiki
Jump to navigationJump to search
m (added filezilla forums note)
(225 intermediate revisions by 74 users not shown)
Line 1: Line 1:
−
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 have been tested under Tiger and Leopard on an Intel Mac. Other Mac OS versions may or may not work.
+
This documentation explains how to setup a build environment for [[FileZilla 3]] and how to compile it under macOS using [https://developer.apple.com/xcode/ Xcode]. These directions have been tested under macOS 12 (Monterey) on an Intel Mac. Resulting binaries are for macOS 10.13 or later.
−
 
 
 
__TOC__
 
__TOC__
  
−
== Setting up the build environment ==
+
==Xcode==
−
 
+
You need to download and install the latest version of Xcode from https://developer.apple.com/xcode/download/
−
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. As of this writing (February 21, 2009), [http://connect.apple.com/cgi-bin/WebObjects/MemberSite.woa/300/wa/getSoftware?fileID=24283 Xcode 3.1.2 (24 Nov 2008)] is the current version for Leopard.
 
−
 
 
−
If you are using Xcode 2.5, you will need to customize the install. Ensure all options under "Command Line Support" are checked. In Xcode 3.1.2, this is not necessary.
 
−
 
 
−
== 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.10.tar.gz wxMac-2.8.10.tar.gz].
 
−
 
 
−
Start Terminal from the Applications/Utilities folder and enter the following commands:
 
−
 
 
−
cd /tmp
 
−
gzcat ~/Desktop/wxMac-2.8.10.tar.gz | tar x
 
−
mkdir build-wx
 
−
cd build-wx
 
−
../wxMac-2.8.10/configure --disable-shared --disable-compat26 --enable-unicode \
 
−
--prefix "$HOME/filezilla/wxMac-2.8.10" && nice make && make install
 
−
 
 
−
=== GNU gettext ===
 
−
 
 
−
Download [ftp://ftp.gnu.org/gnu/gettext/ GNU gettext]. The current version is [ftp://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
 
−
gzcat ~/Desktop/gettext-0.17.tar.gz | tar x
 
−
cd gettext-0.17
 
−
./configure --prefix "$HOME/filezilla/gettext" && nice make && make install
 
−
 
 
−
=== GNU libidn ===
 
−
 
 
−
Download [ftp://ftp.gnu.org/gnu/libidn/ GNU libidn]. The current version is [ftp://ftp.gnu.org/gnu/libidn/libidn-1.12.tar.gz libidn-1.12.tar.gz].
 
−
 
 
−
Start Terminal from the Applications/Utilities folder and enter the following commands:
 
−
 
 
−
cd /tmp
 
−
gzcat ~/Desktop/libidn-1.12.tar.gz | tar x
 
−
cd libidn-1.12
 
−
./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
 
−
bzcat ~/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.4.tar.bz2 libgcrypt-1.4.4.tar.bz2].
 
−
 
 
−
Start Terminal from the Applications/Utilities folder and enter the following commands:
 
−
 
 
−
cd /tmp
 
−
bzcat ~/Desktop/libgcrypt-1.4.4.tar.bz2 | tar x
 
−
cd libgcrypt-1.4.4
 
−
./configure --disable-shared --prefix "$HOME/filezilla/libgcrypt" \
 
−
--with-gpg-error-prefix="$HOME/filezilla/libgpg-error" && nice make && make install
 
−
 
 
−
=== GNU TLS ===
 
−
 
 
−
Download [ftp://ftp.gnu.org/gnu/gnutls/ GNU TLS]. The current version is [ftp://ftp.gnu.org/gnu/gnutls/gnutls-2.6.4.tar.bz2 gnutls-2.6.4.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
 
−
bzcat ~/Desktop/gnutls-2.6.4.tar.bz2 | tar x
 
−
cd gnutls-2.6.4
 
−
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  "
+
==Build environment==
 +
Open a Terminal and type the following:
 +
mkdir -p "$HOME/prefix"
 +
mkdir -p "$HOME/src"
 +
  export CC="clang -mmacosx-version-min=10.13"
 +
export CXX="clang++ -std=c++17 -stdlib=libc++ -mmacosx-version-min=10.13"
 +
export OBJC="clang -mmacosx-version-min=10.13"
 +
export OBJCXX="clang++ -std=c++17 -stdlib=libc++ -mmacosx-version-min=10.13"
 +
export AS="as -mmacosx-version-min=10.13"
 +
export LD="ld -macosx_version_min 10.13"
 +
export PATH="$HOME/prefix/bin:$PATH"
 +
export CPPFLAGS="-I$HOME/prefix/include"
 +
  export LDFLAGS="-L$HOME/prefix/lib"
 +
export LD_LIBRARY_PATH="$HOME/prefix/lib"
 +
export PKG_CONFIG_PATH="$HOME/prefix/lib/pkgconfig"
  
−
Add -lz at the end so that it looks more like:
+
If you ever close the terminal and reopen it, repeat the above steps before you continue.
  
−
gnutls_libs="-L${exec_prefix}/lib -lgnutls -L/Users/'''x'''/filezilla/gnutls/lib -lgcrypt -lgpg-error -lz "
+
==pkg-config==
 +
cd ~/src
 +
  curl -OL https://pkgconfig.freedesktop.org/releases/pkg-config-0.29.2.tar.gz
 +
tar xvf pkg-config-0.29.2.tar.gz
 +
cd pkg-config-0.29.2
 +
./configure --prefix="$HOME/prefix" --enable-shared --disable-static --with-internal-glib
 +
make
 +
make install
  
−
Please note the space between -lz and the closing quote; it '''must''' be present.
+
==libidn==
 +
cd ~/src
 +
curl -OL https://ftp.gnu.org/gnu/libidn/libidn-1.41.tar.gz
 +
tar xvzf libidn-1.41.tar.gz
 +
cd libidn-1.41
 +
./configure --prefix="$HOME/prefix" --enable-shared --disable-static
 +
make
 +
make install
  
−
== Building [[FileZilla 3]] ==
+
==GMP==
 +
cd ~/src
 +
curl -OL https://gmplib.org/download/gmp/gmp-6.3.0.tar.xz
 +
tar xvf gmp-6.3.0.tar.xz
 +
cd gmp-6.3.0
 +
./configure --prefix="$HOME/prefix" --enable-shared --disable-static --enable-fat
 +
make
 +
make install
  
−
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.2.3.1_src.tar.bz2 FileZilla_3.2.3.1_src.tar.bz2].
+
==Nettle==
 +
cd ~/src
 +
curl -OL https://ftp.gnu.org/gnu/nettle/nettle-3.9.1.tar.gz
 +
tar xvf nettle-3.9.1.tar.gz
 +
cd nettle-3.9.1
 +
./configure --prefix="$HOME/prefix" --enable-shared --disable-static --enable-fat
 +
make
 +
make install
  
−
Start Terminal from the Applications/Utilities folder and enter the following commands:
+
==GnuTLS==
 +
cd ~/src
 +
curl -OL https://www.gnupg.org/ftp/gcrypt/gnutls/v3.8/gnutls-3.8.4.tar.xz
 +
tar xvf gnutls-3.8.4.tar.xz
 +
cd gnutls-3.8.4
 +
./configure --prefix="$HOME/prefix" --enable-shared --disable-static --with-included-libtasn1 --without-p11-kit --disable-doc --enable-local-libopts --disable-nls --with-included-unistring --disable-guile --disable-cxx --without-brotli
 +
make
 +
make install
  
−
  cd /tmp
+
==Compile SQLite==
−
  bzcat ~/Desktop/FileZilla_3.2.3.1_src.tar.bz2 | tar x
+
  cd ~/src
−
  cd filezilla-3.2.3.1
+
  curl -OL https://sqlite.org/2023/sqlite-autoconf-3440200.tar.gz
−
  export PATH="$HOME/filezilla/wxMac-2.8.10/bin":"$HOME/filezilla/gettext/bin":$PATH
+
  tar xvzf sqlite-autoconf-3440200.tar.gz
−
  ./configure CPPFLAGS="-I\"$HOME/filezilla/libidn/include\"" \
+
  cd sqlite-autoconf-3440200
−
--with-idn-lib="$HOME/filezilla/libidn/lib/libidn.a" \
+
  ./configure --prefix="$HOME/prefix" --enable-shared --disable-static --disable-dynamic-extensions
−
--with-libgnutls-prefix="$HOME/filezilla/gnutls" --disable-shared && nice make
+
  make
−
  cd FileZilla.app/Contents/MacOS
+
  make install
−
  strip filezilla fzputtygen fzsftp
 
−
cd - && mv FileZilla.app ~/Desktop
 
  
−
If you get an error after "nice make", try this:
+
==gettext==
 +
cd ~/src
 +
curl -OL https://ftp.gnu.org/pub/gnu/gettext/gettext-0.22.4.tar.xz
 +
tar xvf gettext-0.22.4.tar.xz
 +
cd gettext-0.22.4
 +
./configure --prefix="$HOME/prefix" --enable-shared --disable-static
 +
make
 +
make install
  
−
  rm -rf FileZilla.app && nice make
+
==Compile wxWidgets==
 +
  cd ~/src
 +
curl -OL https://github.com/wxWidgets/wxWidgets/releases/download/v3.2.4/wxWidgets-3.2.4.tar.bz2
 +
tar xvf wxWidgets-3.2.4.tar.bz2
 +
cd wxWidgets-3.2.4
 +
./configure --prefix="$HOME/prefix" --enable-shared --without-libcurl --without-libtiff --with-macosx-version-min=10.13
 +
make
 +
make install
  
−
== Troubleshooting ==
+
==Compile libfilezilla==
 +
cd ~/src
 +
curl -OL https://download.filezilla-project.org/libfilezilla/libfilezilla-0.41.1.tar.bz2
 +
tar xf libfilezilla-0.41.1.tar.bz2
 +
cd libfilezilla-0.41.1
 +
./configure --prefix="$HOME/prefix" --enable-shared --disable-static
 +
make
 +
make install
  
−
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. Feel free to ask questions on the [http://forum.filezilla-project.org/ FileZilla forums].
+
==Compile FileZilla==
 +
cd ~/src
 +
curl -OL https://download.filezilla-project.org/client/FileZilla_3.63.2_src.tar.bz2
 +
tar xvjf FileZilla_3.63.2_src.tar.bz2
 +
cd filezilla-3.63.2
 +
./configure --with-pugixml=builtin
 +
make

Revision as of 16:08, 27 March 2024

This documentation explains how to setup a build environment for FileZilla 3 and how to compile it under macOS using Xcode. These directions have been tested under macOS 12 (Monterey) on an Intel Mac. Resulting binaries are for macOS 10.13 or later.

Xcode

You need to download and install the latest version of Xcode from https://developer.apple.com/xcode/download/

Build environment

Open a Terminal and type the following: 

mkdir -p "$HOME/prefix"
mkdir -p "$HOME/src"
export CC="clang -mmacosx-version-min=10.13"
export CXX="clang++ -std=c++17 -stdlib=libc++ -mmacosx-version-min=10.13"
export OBJC="clang -mmacosx-version-min=10.13"
export OBJCXX="clang++ -std=c++17 -stdlib=libc++ -mmacosx-version-min=10.13"
export AS="as -mmacosx-version-min=10.13"
export LD="ld -macosx_version_min 10.13"
export PATH="$HOME/prefix/bin:$PATH"
export CPPFLAGS="-I$HOME/prefix/include"
export LDFLAGS="-L$HOME/prefix/lib"
export LD_LIBRARY_PATH="$HOME/prefix/lib"
export PKG_CONFIG_PATH="$HOME/prefix/lib/pkgconfig"

If you ever close the terminal and reopen it, repeat the above steps before you continue.

pkg-config

cd ~/src
curl -OL https://pkgconfig.freedesktop.org/releases/pkg-config-0.29.2.tar.gz
tar xvf pkg-config-0.29.2.tar.gz
cd pkg-config-0.29.2
./configure --prefix="$HOME/prefix" --enable-shared --disable-static --with-internal-glib
make
make install

libidn

cd ~/src
curl -OL https://ftp.gnu.org/gnu/libidn/libidn-1.41.tar.gz
tar xvzf libidn-1.41.tar.gz
cd libidn-1.41
./configure --prefix="$HOME/prefix" --enable-shared --disable-static
make
make install

GMP

cd ~/src
curl -OL https://gmplib.org/download/gmp/gmp-6.3.0.tar.xz
tar xvf gmp-6.3.0.tar.xz
cd gmp-6.3.0
./configure --prefix="$HOME/prefix" --enable-shared --disable-static --enable-fat
make
make install

Nettle

cd ~/src
curl -OL https://ftp.gnu.org/gnu/nettle/nettle-3.9.1.tar.gz
tar xvf nettle-3.9.1.tar.gz
cd nettle-3.9.1
./configure --prefix="$HOME/prefix" --enable-shared --disable-static --enable-fat 
make
make install

GnuTLS

cd ~/src
curl -OL https://www.gnupg.org/ftp/gcrypt/gnutls/v3.8/gnutls-3.8.4.tar.xz
tar xvf gnutls-3.8.4.tar.xz
cd gnutls-3.8.4
./configure --prefix="$HOME/prefix" --enable-shared --disable-static --with-included-libtasn1 --without-p11-kit --disable-doc --enable-local-libopts --disable-nls --with-included-unistring --disable-guile --disable-cxx --without-brotli
make
make install

Compile SQLite

cd ~/src
curl -OL https://sqlite.org/2023/sqlite-autoconf-3440200.tar.gz
tar xvzf sqlite-autoconf-3440200.tar.gz
cd sqlite-autoconf-3440200
./configure --prefix="$HOME/prefix" --enable-shared --disable-static --disable-dynamic-extensions
make
make install

gettext

cd ~/src
curl -OL https://ftp.gnu.org/pub/gnu/gettext/gettext-0.22.4.tar.xz
tar xvf gettext-0.22.4.tar.xz
cd gettext-0.22.4
./configure --prefix="$HOME/prefix" --enable-shared --disable-static
make
make install

Compile wxWidgets

cd ~/src
curl -OL https://github.com/wxWidgets/wxWidgets/releases/download/v3.2.4/wxWidgets-3.2.4.tar.bz2
tar xvf wxWidgets-3.2.4.tar.bz2
cd wxWidgets-3.2.4
./configure --prefix="$HOME/prefix" --enable-shared --without-libcurl --without-libtiff --with-macosx-version-min=10.13
make
make install

Compile libfilezilla

cd ~/src
curl -OL https://download.filezilla-project.org/libfilezilla/libfilezilla-0.41.1.tar.bz2
tar xf libfilezilla-0.41.1.tar.bz2
cd libfilezilla-0.41.1
./configure --prefix="$HOME/prefix" --enable-shared --disable-static
make
make install

Compile FileZilla

cd ~/src
curl -OL https://download.filezilla-project.org/client/FileZilla_3.63.2_src.tar.bz2
tar xvjf FileZilla_3.63.2_src.tar.bz2
cd filezilla-3.63.2
./configure --with-pugixml=builtin
make
Retrieved from "https://wiki.filezilla-project.org/wiki/index.php?title=Compiling_FileZilla_3_under_macOS&oldid=53296"