From c876d3bbefe0dc00c27ca0c12d29da5874946962 Mon Sep 17 00:00:00 2001 From: Dominik Riebeling Date: Wed, 15 Dec 2021 21:04:28 +0100 Subject: rbutil: Merge rbutil with utils folder. rbutil uses several components from the utils folder, and can be considered part of utils too. Having it in a separate folder is an arbitrary split that doesn't help anymore these days, so merge them. This also allows other utils to easily use libtools.make without the need to navigate to a different folder. Change-Id: I3fc2f4de19e3e776553efb5dea5f779dfec0dc21 --- utils/rbutilqt/msvc/README | 106 +++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 106 insertions(+) create mode 100644 utils/rbutilqt/msvc/README (limited to 'utils/rbutilqt/msvc/README') diff --git a/utils/rbutilqt/msvc/README b/utils/rbutilqt/msvc/README new file mode 100644 index 0000000000..eedec271a1 --- /dev/null +++ b/utils/rbutilqt/msvc/README @@ -0,0 +1,106 @@ +Rockbox Utility with Visual Studio +================================== + +This document describes how to build Rockbox Utility using Visual Studio. + +*Note*: building with Visual Studio is only useful for debugging / development. +Since several parts used by Rockbox Utility can't be compiled using Visual +Studio at all using DLLs is required. For distributing we want a statically +linked binary, which does not work this way. Building with MinGW is much easier +in general, since using VS requires the use of MinGW as well. + +All of the steps described below are to be performed in the folder this file is +located in on a command prompt (cmd.exe on Windows). All paths stated are the +default paths on an english Windows XP setup. You might need to adjust them to +your system. + +Steps +----- +Building with VS requires several steps: +1. Prepare your build environment +2. Build DLLs using MinGW for the parts that cannot be compiled with VS and + create LIB files from the DLLs. This requires using tools from VS. +3. Create a VS project file +4. Build the remaining code using VS. + +Preparing the build environment +------------------------------- +The DLLs can be cross compiled on Linux. Everything else has to be done on +Windows. If you decide to cross compile, you need to install: +- Linux + - MinGW toolchain +- Windows + - MinGW with (at least) the mingw32-make package. + - Visual Studio 2008 (other versions might work but are not tested. Express + version is sufficient). + - Windows Platform SDK (in case you're using the Express version of VS, + otherwise this is included in VS) + - Qt SDK for VS. + +If you decide to not cross compile the DLLs you need to install additionally to +the programs listed above on Windows: +- MinGW with the following packages (and their dependencies): + - mingw32-gcc + - mingw32-make + - msys-coreutils + - msys-sed + - msys-bash + - msys-grep + +On Windows, open a command prompt and set up your path: + + set PATH=c:\MinGW\bin;c:\MinGW\msys\1.0\bin;%PATH% + c:\Program Files\Microsoft Visual Studio 9\Common7\Tools\vsvars.bat + + +Building DLLs and LIBs +---------------------- +On Linux, run + + make CROSS=i686-pc-mingw32- + +Adjust the CROSS variable to the prefix of your cross compiler. This will +create the DLL files only. Copy the resulting DLL and DEF files to the Windows +machine, then proceed with the Windows instructions below. The Makefile will +not remake the DLLs if they are already present. + +On Windows, run + + mingw32-make + +This will build the DLL files (if missing) and create LIB files from them. + + +Create translations +------------------- +Create the translations .qm files. This is only necessary if qmake has been +called without -config dbg (in which case translations will be left out and not +compiled into the binary) + + c:\QtSDK\Desktop\Qt\4.7.4\msvc2008\bin\lrelease.exe ..\rbutilqt.pro + + +Create a VS project file +------------------------ +To create a project file for VS, run + + c:\QtSDK\Desktop\Qt\4.7.4\msvc2008\bin\qmake.exe -tp vc .. + +This creates a file RockboxUtility.vcproj. + + +Build using VS +-------------- +Open the generated project file and build as usual with VS. + + +LICENSE INFORMATION +=================== +This folder contains additional files necessary for building. + +- stdbool.h: taken form clang 2.8 +- stdint.h, inttypes.h: taken from the msinttypes project + (http://code.google.com/p/msinttypes) r26. + +See the source files for detailed license information. + -- cgit v1.2.3