adapt quodlibet's release scripts to gPodder

Author: elelay

.gitignore

@@ -1,2 +1,6 @@
 *~
 .DS_Store
+/_build
+/_bundler
+/_home
+/_jhbuild

README

@@ -1,57 +1,64 @@
+OS X Bundle Build Scripts
+=========================
+
+
 This is a collection of files required to build gPodder.app :
 gPodder as a native GTK+ Quartz application for Mac OS X 10.6 and 10.7
 
 I used them to build on a 10.6 X86_64 machine.
 
-# Instructions
+**Note:**
+    In case you want just want to run gPodder from source you can ignore
+    all this and use the released bundle as a development environment.
+    Download the official bundle, git clone the gPodder repo and do
+    `./gPodder.app/Contents/MacOS/run gpodder.py`.
+
 
-place into ~/mymodules
+Uses jhbuild [3] and the stable module set provided by gtk-osx [2] with a
+gPodder specific module set overlay to build all needed dependencies for gPodder.
+Everything will be downloaded/installed into this directory and your
+user directory will not be touched.
 
-copy dot_jhbuildrc-custom to ~/.jhbuildrc-custom or better, merge my modifications to your config file
+Builds upon the great scripts by Christoph Reiter to automate my previously
+tedious description.
 
-If you have MacPorts installed, you must ensure to remove it from the path,
-to only build against system libraries.
-It might also be a good idea to move it to some non standard location
-during the build: some configure scripts are a bit too clever and will use it even if it's not in the path.
+# Creating a Bundle
 
-Follow instructions in http://live.gnome.org/GTK%2B/OSX/Building
- - bootstrap
-   Be sure to skip building libiconv (see https://mail.gnome.org/archives/gtk-osx-users-list/2011-July/msg00001.html)
-   otherwise the resulting application will not run under 10.7.
-edit gtk-osx.modules to comment out gtk-osx-javascript.modules (would give an error as soon as one tries to build meta-gtk-osx-bootstrap) 
- - meta-gtk-osx-bootstrap
- - meta-gtk-osx-freetype (this is the key to getting pangoft2 and also fontconfig for librsvg)
- - meta-gtk-osx-core
- - python
- - meta-gtk-osx-python
+Prerequisites: `OS X` 10.6+ and a working `Xcode` [0] and `git` [1]
 
-chmod u+w ~/gtk/inst/lib/libpython2.7.dylib
-chmod u+w ~/gtk/inst/lib/libreadline.6.2.dylib 
+Verify that Xcode and git is installed and in your `$PATH` by invoking `git
+--version` and `gcc --version`. Also make sure that other package managers
+like homebrew or macports aren't in your `$PATH`. To be extra sure, move
+`/opt/local` away, because some configure scripts are clever enough to look
+for it by themselves.
 
-# Installing gPodder
-Latest version of gPodder is used, with a few custom patches (see postproc.sh)
+(Tested on OS X 10.6.8)
 
-jhbuild build gpodder (error checkout libproxy: missing patch 404, ignore and move on)
-jhbuild build meta-gtk-osx-themes
+1) Call `bootstrap.sh` to install jhbuild and set up dummy `$HOME` as base.
+2) Call `build.sh` to download and build all the dependencies.
+   I get an error with openssl, but it still installs correctly.
+   Simply choose `[2] ignore error` and move forward.
+3) Call `bundle.sh` to create the finished bundles for gPodder in
+   `_build`.
 
 
+# Development
 
-# Bundling gPodder
-install gtk-mac-bundler, following http://live.gnome.org/GTK%2B/OSX/Bundling
-cd mymodules/gpodder-bundle
-jhbuild shell
-~/.local/bin/gtk-mac-bundler gpodder.bundle && ./postproc.sh 
+* After `bootstrap.sh` has finished executing `source env.sh` will put you
+  in the build environment. After that jhbuild can be used directly.
+* `fetch_modules()` downloads the git master of the gtk-osx module set
+  and replaces the modules under "modulessets" and the
+  `misc/gtk-osx-jhbuildrc` file. Doing so so should ideally be followed by a
+  review of the gPodder module to reduce duplication and a rebuilt to verify
+  that everything still works.
 
-produces gPodder.app in Desktop
-test by double-clicking on gPodder.app
-test by moving ~/gtk/inst away and re-launching
 
 # Releasing
 
 Releasing on OS X
- 1. see *Bundling gPodder*
- 2. ./release.sh ~/gPodder.app version_buildnumber
- 3. ./release_deps.sh ~/gPodder.app version_buildnumber
+ 1. see *Creating a Bundle*
+ 2. `./release.sh _build/gPodder.app version_buildnumber`
+ 3. `./release_deps.sh _build/gPodder.app version_buildnumber`
 
 Releasing on Linux by patching deps:
  4. ./release_on_linux.sh ~/Downloads/gPodder-3.8.4_0.deps.zip /tmp/gpodder master f699341
@@ -63,4 +70,18 @@ See https://github.com/elelay/gpodder-osx-bundle
 # Using gPodder:
 
 See https://github.com/elelay/gpoder-osx-bundle/wiki/Using for instructions...
-And the official help guide http://gpodder.org/documentation
+And the official help guide http://gpodder.org/documentation
+
+
+
+# Content Description
+
+* `modulesets` contains the gtk-osx stable module set and a gpodder module
+  which adds new packages replaces existing ones.
+* `misc`: see each file or directory README for a description.
+
+
+| [0] https://developer.apple.com/xcode/downloads/
+| [1] https://git-scm.com/download/mac
+| [2] https://git.gnome.org/browse/gtk-osx/
+| [3] https://git.gnome.org/browse/jhbuild/

bootstrap.sh

@@ -0,0 +1,11 @@
+#!/bin/sh
+
+source env.sh
+
+mkdir -p "$HOME"
+git clone git://git.gnome.org/jhbuild _jhbuild
+(cd _jhbuild && ./autogen.sh && make -f Makefile.plain DISABLE_GETTEXT=1 install >/dev/null)
+cp misc/gtk-osx-jhbuildrc "$HOME/.jhbuildrc"
+cp misc/jhbuildrc-custom "$HOME/.jhbuildrc-custom"
+git clone git://git.gnome.org/gtk-mac-bundler _bundler
+(cd _bundler && make install)

build.sh

@@ -0,0 +1,9 @@
+#!/bin/sh
+
+source env.sh
+
+jhbuild build autoconf --nodeps
+jhbuild bootstrap
+jhbuild build python
+jhbuild build meta-gtk-osx-bootstrap
+jhbuild build gpodder

bundle.sh

@@ -0,0 +1,58 @@
+#!/bin/sh
+
+set -e
+
+source env.sh
+
+jhbuild run gtk-mac-bundler misc/bundle/gpodder.bundle
+
+APP="$QL_OSXBUNDLE_BUNDLE_DEST/gPodder.app"
+APP_PREFIX="$APP"/Contents/Resources
+JHBUILD_PREFIX="$HOME/jhbuild_prefix"
+mydir=`pwd`
+
+# change case of gPodder.app
+mv "$QL_OSXBUNDLE_BUNDLE_DEST/gpodder.app" "$QL_OSXBUNDLE_BUNDLE_DEST/app.app"
+mv "$QL_OSXBUNDLE_BUNDLE_DEST/app.app" "$APP"
+
+# launcher scripts
+mv "$APP"/Contents/MacOS/{gPodder,_launcher}
+(cd "$APP"/Contents/MacOS/ && ln -s _launcher gpodder)
+(cd "$APP"/Contents/MacOS/ && ln -s _launcher gpodder-migrate2tres)
+(cd "$APP"/Contents/MacOS/ && ln -s _launcher run)
+
+# Set the version and copyright automatically (before removing *.pyc)
+"$APP"/Contents/MacOS/run "$mydir/misc/fixup_info.py" "$APP"/Contents/Info.plist
+
+# kill some useless files
+rm -Rf "$APP_PREFIX"/lib/python2.7/test
+rm -Rf "$APP_PREFIX"/lib/python2.7/unittest
+rm -Rvf "$APP_PREFIX"/lib/python2.7/*/test
+rm -f "$APP_PREFIX"/lib/python2.7/config/libpython2.7.a
+find "$APP_PREFIX"/lib/python2.7 -name '*.pyc' -delete
+find "$APP_PREFIX"/lib/python2.7 -name '*.pyo' -delete
+rm -f "$APP"/Contents/MacOS/gPodder-bin
+rm -Rf "$APP_PREFIX"/share/gpodder/ui/qml
+rm -Rf "$APP_PREFIX"/lib/python2.7/site-packages/gpodder/{qmlui,webui}
+
+# replace copy with symlink
+rm "$APP_PREFIX"/lib/libicudata.55.dylib
+ln -s libicudata.55.1.dylib "$APP_PREFIX"/lib/libicudata.55.dylib
+
+# remove the check for DISPLAY variable since it's not used AND it's not
+# available on Mavericks (see bug #1855)
+(cd "$APP_PREFIX" && patch -p0 < "$mydir/modulesets/patches/dont_check_display.patch")
+
+# Command-XX shortcuts in gPodder menus 
+/usr/bin/xsltproc -o gpodder.ui.tmp $mydir/misc/adjust-modifiers.xsl "$APP_PREFIX"/share/gpodder/ui/gtk/gpodder.ui
+mv gpodder.ui.tmp "$APP_PREFIX"/share/gpodder/ui/gtk/gpodder.ui
+
+# localization of Quit and other menu items controlled by gtk-mac-integration
+cp -R "$JHBUILD_PREFIX"/share/strings/*.lproj "$APP_PREFIX"
+
+# check for dynamic linking consistency : nothing should reference gtk/inst
+find "$APP_PREFIX" -name '*.so' -and -print -and  -exec sh -c 'otool -L $1 | grep /gtk/inst' '{}' '{}' ';'
+
+# list the provenance of every file in the bundle
+$mydir/misc/provenance.pl "$JHBUILD_PREFIX" "$APP" > "$QL_OSXBUNDLE_BUNDLE_DEST"/gPodder.contents
+

dot_jhbuildrc-custom

@@ -0,0 +1,10 @@
+#!/bin/sh
+
+DIR="$(cd "$( dirname "${BASH_SOURCE[0]}" )" && pwd)"
+cd "$DIR"
+
+export HOME="$DIR/_home"
+export PATH="$PATH:$HOME/.local/bin:$HOME/jhbuild_prefix/bin"
+export QL_OSXBUNDLE_MODULESETS_DIR="$DIR/modulesets"
+export QL_OSXBUNDLE_BUNDLE_DEST="$DIR/_build"
+alias jhbuild="python2.7 `which jhbuild`"