forked from len0rd/rockbox
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
This commit is contained in:
parent
6c6f0757d7
commit
c876d3bbef
494 changed files with 13 additions and 13 deletions
106
utils/rbutilqt/msvc/README
Normal file
106
utils/rbutilqt/msvc/README
Normal file
|
|
@ -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.
|
||||
|
||||
Loading…
Add table
Add a link
Reference in a new issue