Fork MediaPortal on GitHub
MediaPortal Windows Media Center
MediaPortal Wiki > MediaPortal 1 > Contribute > Development > Building MediaPortal from source > Build Prerequisites

Build Prerequisites

Was this page helpful?
Redirected from 1 MEDIAPORTAL 1/18 Contribute/4 Development/GITHub (GIT)/Git Installation

    Overview

    How to setup your system with the required software to access and use or contribute to the MediaPortal source code, particularly for compiling and building an installer..

    Introduction

    alert_icon.pngIn order to reduce the size of the MediaPortal Git repository and simplify merging branches and testing, C++ sourced binaries have been removed from the repository as of April, 2013.

    This change affects the way in which you setup your system to compile and build MediaPortal.

    This guide is written for anyone who wants access to our MediaPortal source code repository to compile and build individual branches for testing or development, using either Windows 7 or Windows 8.

    Note: You should have already installed the Required software for MediaPortal on the system where you install Git, see Requirements > System Components

    IDE

    Our source repository contains Microsoft Visual Studio 2010 solutions. However you should be able to use VS 2012 or 2013 too.

    VS 2012 is known to offer a better build and debug experience than VS 2010.

    Download

    Let's start with downloading the required software:

    • Git for Windows (get the latest Full Installer)
    • TortoiseGit (32bit or 64bit depends on your OS)
    • Visual Studio 2010 Express (If you don't have Visual Studio 2010, 2012 or 2013):
      1. Download Visual Studio Express edition ISO:  
      2. Install C++ & C# support
      3. ATL & MCF support:
        Note: Unfortunately Microsoft does not include ATL & MCF support in the Express edition of Visual Studio 2010. If you use the Express edition you must obtain the include and library files using one of the following methods:
      • Download and install the Driver Development Kit (DDK) - see How to compile MFC code in Visual C++ Express for instructions
      • Download and install a trial version of Visual Studio 2010 (not Express version), and use the headers & include files from there (after the trial ends the headers and libraries are still accessible).
    • YASM (32bit or 64bit depends on your OS)
    • NuGet Package Manager for Visual Studio (Managing Package for solution )
    • Windows SDK:
    • Direct X SDK:
    • NSIS (if you need to build an NSIS installer) (Use NSIS 2.46 version and not the latest one)

    Installation

    Git for Windows

    • Start the installation and follow the instructions.
    • at "Adjust your PATH environment" select "Run Git from Windows Command Prompt"

    Git Setup - Run from Windows Command Prompt.PNG

    • at "Configuring the line ending conversions" select "Checkout Windows-style, commit Unix-style line endings"

    Git Setup - Checkout Windows-style.PNG

     

    TortoiseGit

    • Start the installation and follow the instructions.
    • At "Choose SSH Client" select "OpenSSH, Git default SSH Client."

    TortoiseGit - OpenSSH.PNG
     

    YASM

    1. Unzip vsyasm.exe from the previously downloaded package (based on your OS) to your Visual Studio installation directory:
      32-bit OS: C:\Program Files\Microsoft Visual Studio 10.0\VC\bin
      64-bit OS: C:\Program Files (x86)\Microsoft Visual Studio 10.0\VC\bin
    2. Rename vsyasm.exe to yasm.exe

     

    NuGet Package Manager

    As of MediaPortal 1.6 Pre Release, you need the NuGet Package Manager in Visual Studio to compile.

    As an alternative you could first run the BuildInit.bat (located in the Git 'Build' directory) to download a package into your Git folder, which will be used instead of the VS add-on.

     

    NSIS

    Note: NSIS is only required if you wish to build an NSIS installer. You can clone, compile, build and run MP without NSIS.

    • Start the installation and follow the instructions (the default settings are fine).

    NSIS Setup - Default Settings.PNG

     

    Configuration

    .Net Framework 3.5

    Enable the (Microsoft) .NET Framework 3.5 feature if it is not already enabled:

    • Go to Control Panel -> Programs
    • Click on "Turn Windows features on or off"
      Turn Windows features on or off.PNG
      • Windows 8: Enable ".NET Framework 3.5 (includes .NET 2.0 and 3.0)"
        Enable Microsoft .NET Framework 3.5 (Win 8).PNG
         
      • Windows 7: Enable "Microsoft .NET Framework 3.5.1"
        Enable Microsoft .NET Framework 3.5.1 (Win 7).PNG

     

    Windows and DirectX SDK Environment Variables

    After the installation of the various Windows (and DirectX) SDKs, you should have the following Environment Variables:

    Windows SDK 7.1:

    WINDOWS_SDK C:\Program Files\Microsoft SDKs\Windows\v7.1\

    DirectX SDK:

    DXSDK_DIR C:\Program Files (x86)\Microsoft DirectX SDK (June 2010)\


    You can find the Environment Variables in Control Panel -> System -> Advanced System Settings and click on the button on the bottom.

    Environment Variables.PNG

     

    TortoiseGit

    • Right click anywhere (Explorer window or desktop) to open the context menu
    • Select TortoiseGIT -> Settings
    • On the Settings screen, you select Git from the menu on the left
    • Enter your Name and Email from your GitHub account

    TortoiseGit - Settings.PNG

    (Click image to enlarge)

     

    Note: The rest of the installed software doesn't need any special configuration.

    Next Steps

    Now that you've got everything setup and ready to go, take a look at the Git FAQ to learn:




    Tag page (Edit tags)
    • No tags
    Running the latest version?

    V1.8.0 - released July 2014
    Releasenews | Download
    Changelog
     | Requirements
    HTPC
    Team-MediaPortal
     
    About
    Contact |  Press
    Partners