Table of Contents

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

In 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 2013 solutions. We recommend using Visual Studio 2013 Community Edition but any commercial edition should work too.

Download

Let's start with downloading the required software:

Installation

Git for Windows

 

TortoiseGit


 

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 12.0\VC\bin
    64-bit OS: C:\Program Files (x86)\Microsoft Visual Studio 12.0\VC\bin
  2. Copy vsyasm.props , vsyasm.targets and vsyasm.xml to C:\Program Files (x86)\MSBuild\Microsoft.Cpp\v4.0\V120\BuildCustomizations\

 

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.

 

Configuration

.Net Framework 3.5

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

 

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.

 

TortoiseGit

(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:

Changelog

Change

Date

Release

Visual Studio 2013

2015/02/17

1.11.0