diff options
Diffstat (limited to 'utils/rbutilqt/msvc/README')
-rw-r--r-- | utils/rbutilqt/msvc/README | 106 |
1 files changed, 106 insertions, 0 deletions
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 @@ | |||
1 | Rockbox Utility with Visual Studio | ||
2 | ================================== | ||
3 | |||
4 | This document describes how to build Rockbox Utility using Visual Studio. | ||
5 | |||
6 | *Note*: building with Visual Studio is only useful for debugging / development. | ||
7 | Since several parts used by Rockbox Utility can't be compiled using Visual | ||
8 | Studio at all using DLLs is required. For distributing we want a statically | ||
9 | linked binary, which does not work this way. Building with MinGW is much easier | ||
10 | in general, since using VS requires the use of MinGW as well. | ||
11 | |||
12 | All of the steps described below are to be performed in the folder this file is | ||
13 | located in on a command prompt (cmd.exe on Windows). All paths stated are the | ||
14 | default paths on an english Windows XP setup. You might need to adjust them to | ||
15 | your system. | ||
16 | |||
17 | Steps | ||
18 | ----- | ||
19 | Building with VS requires several steps: | ||
20 | 1. Prepare your build environment | ||
21 | 2. Build DLLs using MinGW for the parts that cannot be compiled with VS and | ||
22 | create LIB files from the DLLs. This requires using tools from VS. | ||
23 | 3. Create a VS project file | ||
24 | 4. Build the remaining code using VS. | ||
25 | |||
26 | Preparing the build environment | ||
27 | ------------------------------- | ||
28 | The DLLs can be cross compiled on Linux. Everything else has to be done on | ||
29 | Windows. If you decide to cross compile, you need to install: | ||
30 | - Linux | ||
31 | - MinGW toolchain | ||
32 | - Windows | ||
33 | - MinGW with (at least) the mingw32-make package. | ||
34 | - Visual Studio 2008 (other versions might work but are not tested. Express | ||
35 | version is sufficient). | ||
36 | - Windows Platform SDK (in case you're using the Express version of VS, | ||
37 | otherwise this is included in VS) | ||
38 | - Qt SDK for VS. | ||
39 | |||
40 | If you decide to not cross compile the DLLs you need to install additionally to | ||
41 | the programs listed above on Windows: | ||
42 | - MinGW with the following packages (and their dependencies): | ||
43 | - mingw32-gcc | ||
44 | - mingw32-make | ||
45 | - msys-coreutils | ||
46 | - msys-sed | ||
47 | - msys-bash | ||
48 | - msys-grep | ||
49 | |||
50 | On Windows, open a command prompt and set up your path: | ||
51 | |||
52 | set PATH=c:\MinGW\bin;c:\MinGW\msys\1.0\bin;%PATH% | ||
53 | c:\Program Files\Microsoft Visual Studio 9\Common7\Tools\vsvars.bat | ||
54 | |||
55 | |||
56 | Building DLLs and LIBs | ||
57 | ---------------------- | ||
58 | On Linux, run | ||
59 | |||
60 | make CROSS=i686-pc-mingw32- | ||
61 | |||
62 | Adjust the CROSS variable to the prefix of your cross compiler. This will | ||
63 | create the DLL files only. Copy the resulting DLL and DEF files to the Windows | ||
64 | machine, then proceed with the Windows instructions below. The Makefile will | ||
65 | not remake the DLLs if they are already present. | ||
66 | |||
67 | On Windows, run | ||
68 | |||
69 | mingw32-make | ||
70 | |||
71 | This will build the DLL files (if missing) and create LIB files from them. | ||
72 | |||
73 | |||
74 | Create translations | ||
75 | ------------------- | ||
76 | Create the translations .qm files. This is only necessary if qmake has been | ||
77 | called without -config dbg (in which case translations will be left out and not | ||
78 | compiled into the binary) | ||
79 | |||
80 | c:\QtSDK\Desktop\Qt\4.7.4\msvc2008\bin\lrelease.exe ..\rbutilqt.pro | ||
81 | |||
82 | |||
83 | Create a VS project file | ||
84 | ------------------------ | ||
85 | To create a project file for VS, run | ||
86 | |||
87 | c:\QtSDK\Desktop\Qt\4.7.4\msvc2008\bin\qmake.exe -tp vc .. | ||
88 | |||
89 | This creates a file RockboxUtility.vcproj. | ||
90 | |||
91 | |||
92 | Build using VS | ||
93 | -------------- | ||
94 | Open the generated project file and build as usual with VS. | ||
95 | |||
96 | |||
97 | LICENSE INFORMATION | ||
98 | =================== | ||
99 | This folder contains additional files necessary for building. | ||
100 | |||
101 | - stdbool.h: taken form clang 2.8 | ||
102 | - stdint.h, inttypes.h: taken from the msinttypes project | ||
103 | (http://code.google.com/p/msinttypes) r26. | ||
104 | |||
105 | See the source files for detailed license information. | ||
106 | |||