Difference between revisions of "Building MythFrontend on Mac OS X"

From MythTV Official Wiki
Jump to: navigation, search
(34 intermediate revisions by the same user not shown)
Line 1: Line 1:
−
{{Note box|This page is meant to help those who wish to build Mythfrontend.app v31 and later for MacOS.  Most users should visit [[MythTV on Mac OS X]] instead.  The script has been tested only on v31 on both High Sierra / Xcode 10.0 and Catalina / Xcode 11.3 and 11.4}}
+
These instructions will walk you through setting up your Mac to compile and generate a Mythfrontend.app and .dmg file for macOS.
  
  
−
= Building with Macports and Ansible =
+
= Building Mythfrontend with Macports and Ansible =
 +
{{Note box|This page is meant to help those who wish to build Mythfrontend.app v31 and later for MacOS.  Most users should visit [[MythTV on Mac OS X]] to download prebuilt binaries instead.  The script has been tested on:
 +
* v31 on High Sierra / intel / Xcode 10.0
 +
* v31 on Catalina / intel / Xcode 11.3 - 11.5
 +
* v31 on Big Sur / intel and arm64 / Xcode 12.2-12.4, 13.1
 +
* v31 on Monterey / intel and arm64 / Xcode 12.2-12.4, 13.0
 +
* v32 on High Sierra / intel  / Xcode 10.0
 +
* v32 on Catalina / intel / Xcode 11.5
 +
* v32 on Big Sur / intel and arm64 / Xcode 12.2-12.4, 13.1
 +
* v32 on Monterey / intel and arm64 / Xcode 13.1-13.3
 +
* master/v33 on Catalina / intel / Xcode 11.5
 +
* master/v33 on Monterey / intel and arm64 / Xcode 13.1-13.3}}}}
  
−
These instructions will walk you through setting up your Mac to compile and generate a .dmg file for MacOS.
+
== Install Xcode, Xcode Command Line Tools, and MacPorts ==
 +
 
 +
=== About MacPorts ===
 +
[http://www.macports.org MacPorts] is a stable and mature system for bringing open-source software to the Mac platform.  Changes are tested and reviewed before being committed to MacPorts.  MacPorts operates several build slaves which automatically build the default variant of each port.  All this means that if you decide to try building with MacPorts, there is a strong likelihood that it will just work. And, if it doesn't, there is an active support system working to resolve any problems.
  
−
== Install Xcode, Xcode Command Line Tools, and MacPorts ==
 
  
 
Follow MacPorts' directions for installing MacPorts for your respective version of MacOS.  These instructions will walk you through installing Xcode, the Xcode Command Line Tools, and MacPorts.
 
Follow MacPorts' directions for installing MacPorts for your respective version of MacOS.  These instructions will walk you through installing Xcode, the Xcode Command Line Tools, and MacPorts.
Line 16: Line 29:
  
 
Save the following script to your system as "compileMythFrontendAnsible.zsh" and make executable.
 
Save the following script to your system as "compileMythFrontendAnsible.zsh" and make executable.
 +
 +
The script is now available in mythtv's packaging repo and can now be downloaded from here: [https://github.com/MythTV/packaging/tree/master/OSX/build/macports_ansible compile script download]
 +
 +
{{Note box| In order to install packages via macports and ansible, this script must be run by a user with sudo privileges.  When prompted for either a "Password;" or "BECOME password:" you'll need to enter your sudo password.}}
 +
  
 
The script automatically performs the following steps:
 
The script automatically performs the following steps:
 
# Sets up the build directory structure (tries to mirror the mythtv dev team's structure)
 
# Sets up the build directory structure (tries to mirror the mythtv dev team's structure)
−
# Installs via MacPorts ansible-playbook  
+
# Installs ansible-playbook via MacPorts
 
# Clones the MythTV ansible git repository
 
# Clones the MythTV ansible git repository
 
# Installs MythTV compile requirements and their dependencies via ansible/macports
 
# Installs MythTV compile requirements and their dependencies via ansible/macports
Line 30: Line 48:
 
# Packages mythfrontend.app into a .dmg file
 
# Packages mythfrontend.app into a .dmg file
  
−
{{Code box| compileMythFrontendAnsible.zsh|
+
== Optionally Upload to Sourceforge ==
 +
After building and testing you copy of mythfronend.app, please consider uploading it to here:
 +
* [https://sourceforge.net/projects/mythtvformacosx MythTVForMacOSX on Sourceforge]
 +
 
 +
{{Code box| bash or zsh|
 
<pre>
 
<pre>
−
#!/bin/zsh
+
rsync -avP -e ssh $APP_DIR/$VOL_NAME.dmg YOUR_USER_NAME_HERE,mythtvformacosx@frs.sourceforge.net:/home/frs/project/m/my/mythtvformacosx/
 +
</pre>
 +
}}
  
−
# Note - macports must be installed on your system for this script to work!!!!!
 
−
if ! [ -x "$(command -v port)" ]; then
 
−
  echo 'Error: Macports is not installed.' >&2
 
−
  exit 1
 
−
fi
 
  
−
show_help(){
+
{{Note box| Please remember to thoroughly test your application before uploading}}
−
    cat <<EOF
 
−
Usage: compileMythtvAnsible.sh [options]
 
−
Options: [defaults in brackets after descriptions]
 
  
−
Standard options:
+
= Pre-built Application =
−
  --help                                Print this message
+
For those who would prefer to just download a pre-built application, these files can be found on the MythTVForMacOSX site.
−
  --build-plugins=BUILD_PLUGINS          Build Mythtvplugins (false)
+
These files are updated sporadically by the mythtv mac using community.
−
  --python-version=PYTHON_VERS          Desired Python 3 Version (38)
+
* [https://sourceforge.net/projects/mythtvformacosx/files/ Download from Sourceforge]
−
  --version=MYTHTV_VERS                  Requested mythtv git repo (fixes/31)
 
−
Build Options
 
−
  --update-git=UPDATE_GIT                Update git repositories to latest (true)
 
−
Patch Options
 
−
  --apply-patches=APPLY_PATCHES          Apply patches specified in additional arguments (false)
 
−
  --mythtv-patch-dir=MYTHTV_PATCH_DIR    Directory containing patch files to be applied to Mythtv
 
−
  --packaging-patch-dir=PACK_PATCH_DIR  Directory containing patch files to be applied to Packaging
 
−
  --plugins-patch-dir=PLUGINS_PATCH_DR  Directory containing patch files to be applied to Mythplugins
 
−
Support Ports Options
 
−
  --skip-ansible=SKIP_ANSIBLE            Skip downloading ports with ansible (false)
 
−
                                        NOTE: Only do this if you are sure you have installed ALL dependencies
 
−
  --update-ports=UPDATE_PORTS            Update macports (false)
 
−
EOF
 
  
−
  exit 0
+
= Why MacPorts? =
−
}
+
Currently, for MythTV builds, MacPorts has all of the necessary dependencies for compiling MythTV in it's repository. For this reason alone, it significantly simplifies getting all of the dependencies installed and working without the need to maintain countless download links and specific to macOS patches.
  
−
# setup default variables
+
In the past I tried to build MythTV using both manual downloads and Homebrew. The manual install process was cumbersome and filled with too many macOS related patches that it was nearly impossible to keep under control.
−
BUILD_PLUGINS=false
 
−
PYTHON_VERS="38"
 
−
UPDATE_PORTS=false
 
−
MYTHTV_VERS="fixes/31"
 
−
UPDATE_GIT=true
 
−
SKIP_ANSIBLE=false
 
−
APPLY_PATCHES=false
 
−
MYTHTV_PATCH_DIR=""
 
−
PACK_PATCH_DIR=""
 
−
PLUGINS_PATCH_DIR=""
 
  
−
# parse user inputs into variables
+
This lead me to use a macOS package manager. First I tried Homebew. Unfortunately, Homebrew's default QT install was missing Webkit (requiring a customer QT compile and install) and had mixed compatibility with some of the python mysql pieces.
−
for i in "$@"
 
−
do
 
−
  case $i in
 
−
      -h|--help)
 
−
        show_help
 
−
        exit 0
 
−
      ;;
 
−
      --build-plugins=*)
 
−
        BUILD_PLUGINS="${i#*=}"
 
−
      ;;
 
−
      --python-version=*)
 
−
        PYTHON_VERS="${i#*=}"
 
−
      ;;
 
−
      --update-ports=*)
 
−
        UPDATE_PORTS="${i#*=}"
 
−
      ;;
 
−
      --skip-ansible=*)
 
−
        SKIP_ANSIBLE="${i#*=}"
 
−
      ;;
 
−
      --version=*)
 
−
        MYTHTV_VERS="${i#*=}"
 
−
      ;;
 
−
      --update-git*)
 
−
        UPDATE_GIT="${i#*=}"
 
−
      ;;
 
−
      --apply-patches=*)
 
−
        APPLY_PATCHES="${i#*=}"
 
−
      ;;
 
−
      --mythtv-patch-dir=*)
 
−
        MYTHTV_PATCH_DIR="${i#*=}"
 
−
      ;;
 
−
      --packaging-patch-dir=*)
 
−
        PACK_PATCH_DIR="${i#*=}"
 
−
      ;;
 
−
      --plugins-patch-dir=*)
 
−
        PLUGINS_PATCH_DIR="${i#*=}"
 
  
−
      ;;
+
After much sunk time spent trying to get MythTV to compile on Homebrew, I switched over to MacPorts and got the dependencies installed in very short order. Seriously - they just worked. 
−
      *)
 
−
        echo "Unknown option $i"
 
−
              # unknown option
 
−
        exit 1
 
−
      ;;
 
−
  esac
 
−
done
 
  
−
# Specify mythtv version to pull from git
+
If anyone is interested in trying the Homebrew route please do so. If you are successful - please make suggestions on how to update the compile script and ansible. The best way to do this is to use the [http://lists.mythtv.org/mailman/listinfo/mythtv-users mythtv users mailing list] or [https://forum.mythtv.org/ forums].
−
VERS=${MYTHTV_VERS: -2}
 
−
REPO_DIR=~/mythtv-$VERS
 
−
INSTALL_DIR=$REPO_DIR/$VERS-osx-64bit
 
−
PYTHON_DOT_VERS="${PYTHON_VERS:0:1}.${PYTHON_VERS:1:4}"
 
−
ANSIBLE_PLAYBOOK="ansible-playbook-$PYTHON_DOT_VERS"
 
  
−
# setup some paths to make the following commands easier to understand
+
= Problems? =
−
SRC_DIR=$REPO_DIR/mythtv/mythtv
+
If you have any problems installing packages via ansible, please post to the mythtv-users mailing list or mythtv forums.  If necessary, please file a bug with the mythtv Trac.
−
APP_DIR=$SRC_DIR/programs/mythfrontend
 
−
PLUGINS_DIR=$REPO_DIR/mythtv/mythplugins
 
−
THEME_DIR=$REPO_DIR/mythtv/myththemes
 
−
PKGING_DIR=$REPO_DIR/mythtv/packaging/
 
−
OSX_PKGING_DIR=$PKGING_DIR/OSX/build/
 
−
PKG_CONFIG_SYSTEM_INCLUDE_PATH=/opt/local/include
 
−
export PATH=/opt/local/lib/mysql57/bin:$PATH
 
−
OS_VERS=$(/usr/bin/sw_vers -productVersion)
 
  
−
echo "------------ Setting Up Directory Structure ------------"
+
If you have any problems building MythTV via MacPorts, please post to the macports-users mailing list.  If necessary, please file a bug with the MacPorts bug tracker.
−
# setup the working directory structure
 
−
mkdir -p $REPO_DIR
 
−
cd $REPO_DIR
 
−
# create the install temporary directory
 
−
mkdir -p $INSTALL_DIR
 
  
−
# install and configure ansible and gsed
+
MacPorts-users mailing list == https://lists.macosforge.org/mailman/listinfo/macports-users
−
# ansible to install the missing required ports,
 
−
# gsed for the plist update later
 
−
echo "------------ Setting Up Initial Ports for Ansible ------------"
 
−
if $UPDATE_PORTS; then
 
−
  # tell macport to retrieve the latest repo
 
−
  sudo port selfupdate
 
−
  % upgrade all outdated ports
 
−
  sudo port upgrade
 
−
fi
 
−
# check if ansible_playbook is installed, if not install it
 
−
if ! [ -x "$(command -v $ANSIBLE_PLAYBOOK)" ]; then
 
−
  echo Installing python and ansilble
 
−
  sudo port -N install py$PYTHON_VERS-ansible
 
−
  sudo port select --set python python$PYTHON_VERS
 
−
  sudo port select --set python3 python$PYTHON_VERS
 
−
  sudo port select --set ansible py$PYTHON_VERS-ansible
 
−
else
 
−
  echo "skipping ansible install - it is already installed"
 
−
fi
 
  
−
# check is gsed is installed (for patching the .plist file)
+
MacPorts ticket system == http://guide.macports.org/#project.tickets
−
if ! [ -x "$(command -v gsed)" ]; then
 
−
  sudo port -N install gsed
 
−
else
 
−
    echo "skipping gsed install - it is already installed"
 
−
fi
 
−
 
 
−
echo "------------ Running Ansible ------------"
 
−
if $SKIP_ANSIBLE; then
 
−
  echo "Skipping port installation via ansible"
 
−
else
 
−
  # get mythtv's ansible playbooks, and install required ports
 
−
  # if the repo exists, update (assume the flag is set)
 
−
  if [ -d "$REPO_DIR/ansible" ]; then
 
−
    echo "updating mythtv-anisble git repo"
 
−
    cd $REPO_DIR/ansible
 
−
    if $UPDATE_GIT; then
 
−
      echo "Updating ansible git repo"
 
−
      git pull
 
−
    else
 
−
      echo "Skipping ansible git repo update"
 
−
    fi
 
−
  # pull down a fresh repo if none exist
 
−
  else
 
−
    echo "cloning mythtv-anisble git repo"
 
−
    git clone https://github.com/MythTV/ansible.git
 
−
  fi
 
−
  cd $REPO_DIR/ansible
 
−
  export ANSIBLE_DISPLAY_SKIPPED_HOSTS=false
 
−
  $ANSIBLE_PLAYBOOK qt5.yml --ask-become-pass
 
−
fi
 
−
 
 
−
echo "------------ Cloning / Updating Mythtv Git Repository ------------"
 
−
# setup mythtv source from git
 
−
cd $REPO_DIR
 
−
# if the repo exists, update it (assuming the flag is set)
 
−
if [ -d "$REPO_DIR/mythtv" ]; then
 
−
  cd $REPO_DIR/mythtv
 
−
  if $UPDATE_GIT; then
 
−
    echo "Updateing mythtv/mythplugins git repo"
 
−
    git pull
 
−
  else
 
−
      echo "Skipping mythtv/mythplugins git repo update"
 
−
  fi
 
−
# else pull down a fresh copy of the repo from github
 
−
else
 
−
  echo "cloning mythtv git repo"
 
−
  git clone -b $MYTHTV_VERS git://github.com/MythTV/mythtv.git
 
−
fi
 
−
# apply specified patches
 
−
if [ $APPLY_PATCHES ] && [ ! -z $MYTHTV_PATCH_DIR ]; then
 
−
  cd $REPO_DIR/mythtv
 
−
  for file in $MYTHTV_PATCH_DIR/*
 
−
    do
 
−
    if [ -f "$file" ]; then
 
−
      echo "Applying Mythtv patch: $file"
 
−
      patch -p1 < $file
 
−
    fi
 
−
  done
 
−
fi
 
−
echo "------------ Cloning / Updating Packaging Git Repository ------------"
 
−
# get packaging
 
−
cd $REPO_DIR/mythtv
 
−
# check if the repo exists and update (if the flag is set)
 
−
if [ -d $PKGING_DIR ]; then
 
−
  cd $PKGING_DIR
 
−
  if $UPDATE_GIT; then
 
−
    echo "Update packaging git repo"
 
−
    git pull
 
−
  else
 
−
    echo "Skipping packaging git repo update"
 
−
  fi
 
−
# else pull down a fresh copy of the repo from github
 
−
else
 
−
  echo "cloning mythtv-packaging git repo"
 
−
  git clone -b $MYTHTV_VERS https://github.com/MythTV/packaging.git
 
−
fi
 
−
 
 
−
# apply any user specified patches if the flag is set
 
−
if [ $APPLY_PATCHES ] && [ ! -z $PACK_PATCH_DIR ]; then
 
−
  cd $PKGING_DIR
 
−
  for file in $PACK_PATCH_DIR/*
 
−
    do
 
−
    if [ -f "$file" ]; then
 
−
      echo "Applying Packaging patch: $file"
 
−
      patch -p1 < $file
 
−
    fi
 
−
  done
 
−
fi
 
−
 
 
−
echo "------------ Configuring Mythtv ------------"
 
−
# configure mythfrontend
 
−
cd $SRC_DIR
 
−
GIT_VERS=$(git rev-parse --short HEAD)
 
−
./configure --prefix=$INSTALL_DIR \
 
−
--runprefix=../Resources \
 
−
--enable-mac-bundle \
 
−
--qmake=/opt/local/libexec/qt5/bin/qmake \
 
−
--cc=clang \
 
−
--cxx=clang++ \
 
−
--extra-cxxflags=-I/opt/local/include \
 
−
--extra-ldflags=-L/opt/local/lib \
 
−
--disable-backend \
 
−
--disable-distcc \
 
−
--disable-firewire \
 
−
--enable-libmp3lame \
 
−
--enable-libxvid \
 
−
--enable-libx264 \
 
−
--enable-libx265 \
 
−
--enable-libvpx \
 
−
--enable-bdjava \
 
−
--python=/opt/local/bin/python3.8
 
−
 
 
−
echo "------------ Compiling Mythtv ------------"
 
−
#compile mythfrontend
 
−
make
 
−
echo "------------ Installing Mythtv ------------"
 
−
# need to do a make install or macdeployqt will not copy everything in and makebundle.sh will fail.
 
−
make install
 
−
 
 
−
if $BUILD_PLUGINS; then
 
−
  echo "------------ Configuring Mythplugins ------------"
 
−
  # apply specified patches if flag is set
 
−
  if [ $APPLY_PATCHES ] && [ ! -z $PLUGINS_PATCH_DIR ]; then
 
−
    cd $PLUGINS_DIR
 
−
    for file in $PLUGINS_PATCH_DIR/*
 
−
      do
 
−
      if [ -f "$file" ]; then
 
−
        echo "Applying Plugins patch: $file"
 
−
        patch -p1 < $file
 
−
      fi
 
−
    done
 
−
  fi
 
−
 
 
−
  # configure plugins
 
−
  cd $PLUGINS_DIR
 
−
  ./configure --prefix=$INSTALL_DIR \
 
−
  --runprefix=../Resources \
 
−
  --qmake=/opt/local/libexec/qt5/bin/qmake \
 
−
  --cc=clang \
 
−
  --cxx=clang++ \
 
−
  --enable-mythgame \
 
−
  --enable-mythmusic \
 
−
  --enable-fftw \
 
−
  --enable-cdio \
 
−
  --enable-mythnews \
 
−
  --enable-mythweather \
 
−
  --disable-mytharchive \
 
−
  --disable-mythnetvision \
 
−
  --disable-mythzoneminder \
 
−
  --disable-mythzmserver \
 
−
  --python=/opt/local/bin/python3.8
 
−
 
 
−
  echo "------------ Compiling Mythplugins ------------"
 
−
  #compile mythfrontend
 
−
  /opt/local/libexec/qt5/bin/qmake  mythplugins.pro
 
−
  make
 
−
  echo "------------ Installing Mythplugins ------------"
 
−
  make install
 
−
else
 
−
  echo "------------ Skipping Mythplugins Compile ------------"
 
−
fi
 
−
 
 
−
echo "------------ Deploying QT to Mythfrontend Executable ------------"
 
−
# Package up the executable
 
−
# change directory to the mythfrontend app directory for makebundle.sh will work
 
−
cd $APP_DIR
 
−
# run macdeployqt
 
−
/opt/local/libexec/qt5/bin/macdeployqt $APP_DIR/mythfrontend.app
 
−
 
 
−
echo "------------ Update Mythfrontend.app to use internal dylibs ------------"
 
−
# run makebundle to copy all of the libraries into the bundle as Frameworks
 
−
# we will need to run this utility multiple more time for any plugins and helper apps installed
 
−
$OSX_PKGING_DIR/makebundle.sh $APP_DIR/mythfrontend.app
 
−
 
 
−
echo "------------ Installing libcec into Mythfrontend.app ------------"
 
−
# copy in libcec (missing for some reason...)
 
−
cp /opt/local/lib/libcec.4.*.dylib $APP_DIR/mythfrontend.app/Contents/Frameworks/
 
−
install_name_tool -add_rpath "@executable_path/../Frameworks/libcec.4.0.5.dylib" $APP_DIR/mythfrontend.app/Contents/MacOS/mythfrontend
 
−
cp /opt/local/lib/libcec.4.dylib $APP_DIR/mythfrontend.app/Contents/Frameworks/
 
−
install_name_tool -add_rpath "@executable_path/../Frameworks/libcec.4.dylib" $APP_DIR/mythfrontend.app/Contents/MacOS/mythfrontend
 
−
cp /opt/local/lib/libcec.dylib $APP_DIR/mythfrontend.app/Contents/Frameworks/
 
−
install_name_tool -add_rpath "@executable_path/../Resources/libcec.dylib" $APP_DIR/mythfrontend.app/Contents/MacOS/mythfrontend
 
−
 
 
−
echo "------------ Installing additional mythtv utility executables into Mythfrontend.app  ------------"
 
−
# loop over the compiler apps copying in the desired ones for mythfrontend
 
−
for helperBinPath in $INSTALL_DIR/bin/*.app
 
−
do
 
−
  case $helperBinPath in
 
−
    *mythmetadatalookup*|*mythreplex*|*mythutil*|*mythpreviewgen*|*mythavtest*)
 
−
      # extract the filename from the path
 
−
      helperBinFile=$(basename $helperBinPath)
 
−
      helperBinFile=${helperBinFile%.app}
 
−
      echo "installing $helperBinFile into app"
 
−
      # copy into the app
 
−
      cp -r $helperBinPath/Contents/MacOS/$helperBinFile $APP_DIR/mythfrontend.app/Contents/MacOS
 
−
      # run osx-bundler.pl to setup and copy support libraries into app framework
 
−
      $OSX_PKGING_DIR/osx-bundler.pl  $APP_DIR/mythfrontend.app/Contents/MacOS/$helperBinFile
 
−
    ;;
 
−
    *)
 
−
      continue
 
−
    ;;
 
−
  esac
 
−
done
 
−
 
 
−
if $BUILD_PLUGINS; then
 
−
  echo "------------ Copying Mythplugins dylibs into app ------------"
 
−
      #*libmythpostproc*|*libmythavdevice*|*libmythavfilter*|*libmythpostproc*|*libmythprotoserver*|*libmythswscale*)
 
−
  #done
 
−
 
 
−
  # Now we need to make the plugin dylibs use the dylibs copied into the app's Framework
 
−
  # to do this, we're going to copy them into the app's PlugIns dir and the use makebundle to point them to the
 
−
  # app frameworks' versions
 
−
  for plugFilePath in $INSTALL_DIR/lib/mythtv/plugins/*.dylib
 
−
  do
 
−
      plugFileName=$(basename $plugFilePath)
 
−
      echo "installing $plugFileName into app"
 
−
      cp $plugFilePath $APP_DIR/mythfrontend.app/Contents/PlugIns/
 
−
      # run osx-bundler.pl to setup and copy support libraries into app framework
 
−
      $OSX_PKGING_DIR/osx-bundler.pl  $APP_DIR/mythfrontend.app/Contents/PlugIns/$plugFileName $INSTALL_DIR/libs
 
−
  done
 
−
fi
 
−
 
 
−
echo "------------ Copying mythtv share directory into executable  ------------"
 
−
# copy in i18n, fonts, themes, plugin resources, etc from the install directory (share)
 
−
mkdir -p $APP_DIR/mythfrontend.app/Contents/Resources/share/mythtv
 
−
cp -r $INSTALL_DIR/share/mythtv/* $APP_DIR/mythfrontend.app/Contents/Resources/share/mythtv/
 
−
 
 
−
echo "------------ Copying in dejavu and liberation fonts into Mythfrontend.app  ------------"
 
−
# copy in missing fonts
 
−
cp /opt/local/share/fonts/dejavu-fonts/*.ttf $APP_DIR/mythfrontend.app/Contents/Resources/share/mythtv/fonts/
 
−
cp /opt/local/share/fonts/liberation-fonts/*.ttf $APP_DIR/mythfrontend.app/Contents/Resources/share/mythtv/fonts/
 
−
 
 
−
echo "------------ Copying in Mythfrontend.app icon  ------------"
 
−
# copy in the icon
 
−
cp mythfrontend.icns $APP_DIR/mythfrontend.app/Contents/Resources/application.icns
 
−
 
 
−
echo "------------ Add symbolic link structure for copied in files  ------------"
 
−
# make some symbolic links to match past working copies
 
−
cd $APP_DIR/mythfrontend.app/Contents/MacOS
 
−
if $BUILD_PLUGINS; then
 
−
  ln -s ../PlugIns/sqldrivers .
 
−
fi
 
−
cd $APP_DIR/mythfrontend.app/Contents/Resources
 
−
ln -s ../MacOS bin
 
−
if $BUILD_PLUGINS; then
 
−
  mkdir -p $APP_DIR/mythfrontend.app/Contents/Resources/lib/mythtv
 
−
  cd $APP_DIR/mythfrontend.app/Contents/Resources/lib/mythtv
 
−
  ln -s ../../../PlugIns plugins
 
−
fi
 
−
 
 
−
echo "------------ Updating application plist  ------------"
 
−
# Update the plist
 
−
gsed -i "8c\ <string>application.icns</string>" $APP_DIR/mythfrontend.app/Contents/Info.plist
 
−
gsed -i "10c\ <string>org.osx-bundler.mythfrontend</string>\n <key>CFBundleInfoDictionaryVersion</key>\n <string>6.0</string>" $APP_DIR/mythfrontend.app/Contents/Info.plist
 
−
gsed -i "14a\ <key>CFBundleShortVersionString</key>\n <string>31</string>" $APP_DIR/mythfrontend.app/Contents/Info.plist
 
−
gsed -i "18c\ <string>osx-bundler</string>\n <key>NSAppleScriptEnabled</key>\n <string>NO</string>\n <key>CFBundleGetInfoString</key>\n <string></string>\n <key>CFBundleVersion</key>\n <string>1.0</string>\n <key>NSHumanReadableCopyright</key>\n <string>MythTV Team</string>" $APP_DIR/mythfrontend.app/Contents/Info.plist
 
−
 
 
−
echo "------------ Generating .dmg file  ------------"
 
−
# Package up the build
 
−
cd $APP_DIR
 
−
if $BUILD_PLUGINS; then
 
−
    VOL_NAME=MythFrontend-$VERS-intel-$OS_VERS-v$VERS-$GIT_VERS-with-plugins
 
−
else
 
−
    VOL_NAME=MythFrontend-$VERS-intel-$OS_VERS-v$VERS-$GIT_VERS
 
−
fi
 
−
if [ -f $APP_DIR/$VOL_NAME.dmg ] ; then
 
−
    mv $APP_DIR/$VOL_NAME.dmg $APP_DIR/$VOL_NAME$(date +'%d%m%Y%H%M%S').dmg
 
−
fi
 
−
hdiutil create $APP_DIR/$VOL_NAME.dmg -fs HFS+ -srcfolder $APP_DIR/Mythfrontend.app -volname $VOL_NAME
 
−
</pre>
 
−
}}
 
−
 
 
−
== Optionally Upload to Sourceforge ==
 
−
After building and testing you copy of mythfronend.app, please consider uploading it to here:
 
−
* [https://sourceforge.net/projects/mythtvformacosx MythTVForMacOSX on Sourceforge]
 
−
{{Code  box| bash or zsh|
 
−
<pre>
 
−
rsync -avP -e ssh $APP_DIR/$VOL_NAME.dmg YOUR_USER_NAME_HERE,mythtvformacosx@frs.sourceforge.net:/home/frs/project/m/my/mythtvformacosx/
 
−
</pre>
 
−
}}
 
−
 
 
−
{{Note box| Please remember to thoroughly test your application before uploading}}
 
  
 +
[[Category:MacOS]]
 +
[[Category:MacPorts]]
 +
[[Category:Ansible]]
 
[[Category:Distribution_Specific_Install_Guides]]
 
[[Category:Distribution_Specific_Install_Guides]]
−
[[Category:MacOS]]
 

Revision as of 23:05, 20 March 2022

These instructions will walk you through setting up your Mac to compile and generate a Mythfrontend.app and .dmg file for macOS.


Building Mythfrontend with Macports and Ansible

Important.png Note: This page is meant to help those who wish to build Mythfrontend.app v31 and later for MacOS. Most users should visit MythTV on Mac OS X to download prebuilt binaries instead. The script has been tested on:

  • v31 on High Sierra / intel / Xcode 10.0
  • v31 on Catalina / intel / Xcode 11.3 - 11.5
  • v31 on Big Sur / intel and arm64 / Xcode 12.2-12.4, 13.1
  • v31 on Monterey / intel and arm64 / Xcode 12.2-12.4, 13.0
  • v32 on High Sierra / intel / Xcode 10.0
  • v32 on Catalina / intel / Xcode 11.5
  • v32 on Big Sur / intel and arm64 / Xcode 12.2-12.4, 13.1
  • v32 on Monterey / intel and arm64 / Xcode 13.1-13.3
  • master/v33 on Catalina / intel / Xcode 11.5
  • master/v33 on Monterey / intel and arm64 / Xcode 13.1-13.3
}}

Install Xcode, Xcode Command Line Tools, and MacPorts

About MacPorts

MacPorts is a stable and mature system for bringing open-source software to the Mac platform. Changes are tested and reviewed before being committed to MacPorts. MacPorts operates several build slaves which automatically build the default variant of each port. All this means that if you decide to try building with MacPorts, there is a strong likelihood that it will just work. And, if it doesn't, there is an active support system working to resolve any problems.


Follow MacPorts' directions for installing MacPorts for your respective version of MacOS. These instructions will walk you through installing Xcode, the Xcode Command Line Tools, and MacPorts.


Important.png Note: Remember to run "sudo port -v selfupdate" after installing MacPorts to update the MacPorts repositories

Run the compileMythFrontendAnsible.zsh Script

Save the following script to your system as "compileMythFrontendAnsible.zsh" and make executable.

The script is now available in mythtv's packaging repo and can now be downloaded from here: compile script download


Important.png Note: In order to install packages via macports and ansible, this script must be run by a user with sudo privileges. When prompted for either a "Password;" or "BECOME password:" you'll need to enter your sudo password.


The script automatically performs the following steps:

  1. Sets up the build directory structure (tries to mirror the mythtv dev team's structure)
  2. Installs ansible-playbook via MacPorts
  3. Clones the MythTV ansible git repository
  4. Installs MythTV compile requirements and their dependencies via ansible/macports
  5. Clones the MythTV git repository, applying any user specified patches to mythtv or plugins
  6. Clones the MythTV Packaging git repository, applying any user specified patches
  7. Configures, builds, and installs MythTV to a temp directory
  8. Optionally Configures, builds, and installs MythPlugins to a temp directory
  9. Deploys QT to the compiled mythfrontend.app
  10. Copies the required dylibs, support data, and fonts into the app linking
  11. Packages mythfrontend.app into a .dmg file

Optionally Upload to Sourceforge

After building and testing you copy of mythfronend.app, please consider uploading it to here:


Script.png bash or zsh 

rsync -avP -e ssh $APP_DIR/$VOL_NAME.dmg YOUR_USER_NAME_HERE,mythtvformacosx@frs.sourceforge.net:/home/frs/project/m/my/mythtvformacosx/


Important.png Note: Please remember to thoroughly test your application before uploading

Pre-built Application

For those who would prefer to just download a pre-built application, these files can be found on the MythTVForMacOSX site. These files are updated sporadically by the mythtv mac using community.

Why MacPorts?

Currently, for MythTV builds, MacPorts has all of the necessary dependencies for compiling MythTV in it's repository. For this reason alone, it significantly simplifies getting all of the dependencies installed and working without the need to maintain countless download links and specific to macOS patches.

In the past I tried to build MythTV using both manual downloads and Homebrew. The manual install process was cumbersome and filled with too many macOS related patches that it was nearly impossible to keep under control.

This lead me to use a macOS package manager. First I tried Homebew. Unfortunately, Homebrew's default QT install was missing Webkit (requiring a customer QT compile and install) and had mixed compatibility with some of the python mysql pieces.

After much sunk time spent trying to get MythTV to compile on Homebrew, I switched over to MacPorts and got the dependencies installed in very short order. Seriously - they just worked.

If anyone is interested in trying the Homebrew route please do so. If you are successful - please make suggestions on how to update the compile script and ansible. The best way to do this is to use the mythtv users mailing list or forums.

Problems?

If you have any problems installing packages via ansible, please post to the mythtv-users mailing list or mythtv forums. If necessary, please file a bug with the mythtv Trac.

If you have any problems building MythTV via MacPorts, please post to the macports-users mailing list. If necessary, please file a bug with the MacPorts bug tracker.

MacPorts-users mailing list == https://lists.macosforge.org/mailman/listinfo/macports-users

MacPorts ticket system == http://guide.macports.org/#project.tickets

Retrieved from "http://www.mythtv.org/wiki?title=Building_MythFrontend_on_Mac_OS_X&oldid=66147"