mirror of
https://github.com/codex-storage/deluge.git
synced 2025-01-11 12:04:10 +00:00
fff75b51ce
On Mavericks the application path passed to scripts only has single leading slash compared to previous double slash. Renamed and changed shebang to bash to prevent any issues. Updated README to rst format for display in trac wiki.
128 lines
3.7 KiB
ReStructuredText
128 lines
3.7 KiB
ReStructuredText
====================================
|
|
Instructions for building Deluge.app
|
|
====================================
|
|
|
|
1. Compiler
|
|
-----------
|
|
|
|
- To build deluge and the gtk osx modules, you must use `gcc`
|
|
- This has been successfully working with :
|
|
- gcc 4.2.1 - Xcode 4.1 - Mac OSX Lion (10.7.2)
|
|
- llvm-gcc 4.2.1 - Xcode 4.3.1 (With Command line utilities) - Mac OSX Lion (10.7.3)
|
|
- Check your version of gcc using `gcc -v`
|
|
|
|
2. GTK-OSX jhbuild environment
|
|
------------------------------
|
|
|
|
Quick how-to *(from the full GTK-OSX building instructions)* [1]_, [2]_
|
|
|
|
a. Create a dedicated user account and use it for all the next steps::
|
|
|
|
sudo su - gtk
|
|
cat << EOF > ~/.profile
|
|
export PATH=~/.local/bin:~/bin:/bin:/usr/bin:/sbin:/usr/sbin:/usr/local/git/bin
|
|
EOF
|
|
. ~/.profile
|
|
|
|
*Note*: I'm using `gtk` login with `/opt/gtk` as home an jhbuild prefix.
|
|
|
|
b. Download and run the gtk-osx-build-setup [3]_ script to install jhbuild::
|
|
|
|
curl -O https://raw.github.com/jralls/gtk-osx-build/master/gtk-osx-build-setup.sh
|
|
sh gtk-osx-build-setup.sh
|
|
|
|
c. Link or copy deluge osx jhbuildrc-custom::
|
|
|
|
ln -sf deluge/osx/jhbuildrc-custom ~/.jhbuildrc-custom
|
|
|
|
*Note*: This setup builds only for `x86_64` arch to `/opt/gtk` prefix, feel free to edit.
|
|
|
|
d. Build jhbuild and its modulesets: *(takes a while...)*::
|
|
|
|
jhbuild bootstrap && jhbuild
|
|
|
|
*Note*: If you encounter an error while building `glib` like::
|
|
|
|
gconvert.c:65:2: error: #error GNU libiconv not in use but included iconv.h is from libiconv
|
|
|
|
Start a shell from jhbuild, edit the file `vim glib/gconvert.c +65` to delete the
|
|
section raising error, which is irrelevant. *(Lion iconv.h looks like gnu one, but it is not)*
|
|
Then exit the shell and resume build.
|
|
|
|
5. Build the deluge moduleset: *(takes a while...)*::
|
|
|
|
jhbuild -m deluge/osx/deluge.modules build deluge
|
|
|
|
*Note*: This jhbuild moduleset *should* build and install all deluge dependencies not available in gtk-osx.
|
|
|
|
3. Build Deluge.app
|
|
-------------------
|
|
|
|
a. Always do your custom build operations under a jhbuild shell::
|
|
|
|
jhbuild shell
|
|
|
|
b. Cleanup::
|
|
|
|
python setup.py clean -a
|
|
|
|
c. Build and install::
|
|
|
|
python setup.py py2app
|
|
python setup.py install
|
|
|
|
d. Build app to `deluge/osx/app/Deluge.app`::
|
|
|
|
cd osx
|
|
./make-app
|
|
|
|
You *should* now have a working Deluge.app
|
|
|
|
i386 Notes
|
|
----------
|
|
|
|
- Uncomment the relevant sections of :
|
|
- jhbuildrc-custom
|
|
- deluge.modules
|
|
- setup.cfg
|
|
- deluge egg has to be named without the -macosx-10.6-intel suffix
|
|
- To build for i386 under a x64 arch libtorrent python bindings have to be
|
|
patched manually to set correct arch see macports package patch
|
|
|
|
Issues
|
|
------
|
|
|
|
If Deluge.app doesn't work or crash the first thing to do is to check OSX
|
|
Console for logs and/or crash reports.
|
|
|
|
You can enable logging by passing the usual log command switches via console::
|
|
|
|
/Applications/Deluge.app/Contents/MacOS/Deluge -L debug -l debug.log
|
|
|
|
Recent jhbuild issues:
|
|
|
|
- Some jhbuild modules fails to build, freetype and gtk-mac-integration,
|
|
strangely configure is not called before build/install.
|
|
- If that happens, just force rebuild with something like:
|
|
|
|
jhbuild build -cf gtk-mac-integration-python
|
|
|
|
- Interrupt while building with Ctrl+C and wipe to start over if configure missing
|
|
|
|
Known issues
|
|
------------
|
|
|
|
- **i386**: libtorrent crash
|
|
- **i18n**: English only for now
|
|
- **Magnet URLs**: Not currently supported by GTK-OSX
|
|
|
|
Reference
|
|
---------
|
|
|
|
.. [1] http://live.gnome.org/Jhbuild
|
|
.. [2] http://live.gnome.org/GTK%2B/OSX/Building
|
|
.. [3] http://github.com/jralls/gtk-osx-build
|
|
.. [4] http://winswitch.org/dev/macosx.html
|
|
.. [5] http://mail.python.org/pipermail/pythonmac-sig/
|
|
.. [6] https://github.com/jralls/gtk-mac-integration
|