scripts: create-uninstalled-setup: re-use existing master branch if it exists
[platform/upstream/gstreamer.git] / scripts / create-uninstalled-setup.sh
1 #!/bin/sh
2 # ----------------------------------------------------------------------------
3 #
4 # create-uninstalled-setup.sh
5 #
6 # Little shell script that creates a fresh GStreamer uninstalled setup in
7 # your home directory.
8 #
9 # ----------------------------------------------------------------------------
10 #
11 # Copyright (C) 2011-2012 Tim-Philipp Muller <tim centricular net>
12 #
13 # This script is free software; you can redistribute it and/or
14 # modify it under the terms of the GNU Library General Public
15 # License as published by the Free Software Foundation; either
16 # version 2 of the License, or (at your option) any later version.
17 #
18 # This library is distributed in the hope that it will be useful,
19 # but WITHOUT ANY WARRANTY; without even the implied warranty of
20 # MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
21 # Library General Public License for more details.
22 #
23 # You should have received a copy of the GNU Library General Public
24 # License along with this library; if not, write to the
25 # Free Software Foundation, Inc., 51 Franklin St, Fifth Floor,
26 # Boston, MA 02110-1301, USA.
27 #
28 # ----------------------------------------------------------------------------
29
30 set -e
31
32 # set BRANCH to e.g. "1.2" to track the stable 1.2 branch instead of master
33 BRANCH="master"
34
35 # set to "ssh" if you have a developer account and ssh access
36 GIT_ACCESS="anongit"
37
38 # re-use and reference local master branch checkout if one already exists
39 # (saves network bandwidth)
40 REUSE_EXISTING_MASTER_CHECKOUT="true"
41
42 # git modules to clone
43 MODULES="gstreamer gst-plugins-base gst-plugins-good gst-plugins-ugly gst-plugins-bad"
44
45 if test "$BRANCH" != "0.10"; then
46   MODULES="$MODULES gst-libav"
47 else
48   MODULES="$MODULES gst-ffmpeg"
49 fi
50
51 # note: we use ~/gst because that's what the gst-uninstalled script
52 # uses by default, so don't just change that to something else
53 UNINSTALLED_ROOT=~/gst
54
55 echo "==========================================================================================="
56 echo "Creating new GStreamer uninstalled environment for branch $BRANCH in $UNINSTALLED_ROOT ... "
57 echo "==========================================================================================="
58
59 mkdir -p $UNINSTALLED_ROOT
60 mkdir -p $UNINSTALLED_ROOT/$BRANCH
61
62 mkdir -p $UNINSTALLED_ROOT/$BRANCH/prefix
63
64
65 echo ""
66 echo "Checking basic build tools and dependencies are installed..."
67 echo ""
68
69 if ! pkg-config --version 2>/dev/null >/dev/null; then
70   DEPS_OK="no"
71 elif ! pkg-config --exists glib-2.0 orc-0.4 2>/dev/null >/dev/null; then
72   DEPS_OK="no"
73 elif ! bison --version 2>/dev/null >/dev/null; then
74   DEPS_OK="no"
75 elif ! flex --version 2>/dev/null >/dev/null; then
76   DEPS_OK="no"
77 else
78   DEPS_OK="yes"
79 fi
80
81 if test "$DEPS_OK" != "yes"; then
82 echo "==========================================================================================="
83 echo ""
84 echo "  Some very basic build tools or dependencies are missing."
85 echo ""
86 echo "  Please visit"
87 echo ""
88 echo "      http://gstreamer.freedesktop.org/wiki/BuildDependenciesDebianUbuntu"
89 echo ""
90 echo "         or"
91 echo ""
92 echo "      http://gstreamer.freedesktop.org/wiki/Fedora"
93 echo ""
94 echo "  for instructions how to install them."
95 echo ""
96 echo "==========================================================================================="
97 fi
98
99
100 cd $UNINSTALLED_ROOT/$BRANCH
101
102 for m in $MODULES
103 do
104   REF=""
105   if test "$BRANCH" != "master" \
106     -a "x$REUSE_EXISTING_MASTER_CHECKOUT" = "xtrue" \
107     -a -d ../master/$m; then
108       REF="--reference=../master/$m"
109   fi
110
111   if test "$GIT_ACCESS" = "ssh"; then
112     git clone $REF ssh://git.freedesktop.org/git/gstreamer/$m
113   else
114     git clone $REF git://anongit.freedesktop.org/gstreamer/$m
115   fi
116
117   cd $m
118   if test "$BRANCH" != "master"; then
119     git checkout -b $BRANCH origin/$BRANCH
120   fi
121   cd ..
122 done
123
124 cd $UNINSTALLED_ROOT
125 ln -s $BRANCH/gstreamer/scripts/gst-uninstalled gst-$BRANCH
126 chmod +x gst-$BRANCH
127
128 cd ~
129
130 echo "==========================================================================================="
131 echo
132 echo "Done. Created new GStreamer uninstalled environment for branch $BRANCH in $UNINSTALLED_ROOT"
133 echo
134 echo "To enter the uninstalled environment do: cd $UNINSTALLED_ROOT; ./gst-$BRANCH"
135 echo
136 echo "To leave the uninstalled environment do: exit"
137 echo
138 echo "To check the uninstalled environment do: printenv | grep GST"
139 echo "    (loads of output = you're in the uninstalled environment)"
140 echo
141 echo "==========================================================================================="
142 echo
143 echo "Now compile all GStreamer modules one by one by first switching into"
144 echo "the uninstalled environment and then doing:"
145 echo
146 echo "    cd <MODULE>; ./autogen.sh; make"
147 echo
148 echo "First gstreamer, then gst-plugins-base, then the other modules."
149 echo "You do not need to do 'make install'"
150 echo
151 echo "==========================================================================================="
152 echo
153 echo "If your system GLib is too old, you can install a newer version"
154 echo "into --prefix=$UNINSTALLED_ROOT/$BRANCH/prefix and it should be picked up"
155 echo "by autogen.sh/configure"
156 echo
157 echo "==========================================================================================="
158 echo
159 echo "Also see http://gstreamer.freedesktop.org/wiki/UninstalledSetup"
160 echo
161 echo "==========================================================================================="
162