fb69c88d56c361011b3b14d594b92ae5c82e4dc7
[sigrok-util.git] / cross-compile / msys2 / README
1 -------------------------------------------------------------------------------
2 README
3 -------------------------------------------------------------------------------
4
5 This is a small script for compiling sigrok and its dependencies natively
6 on MSYS2/Windows systems.
7
8
9 Status
10 ------
11
12 NOT fully working! This is work in progress.
13
14
15 Requirements
16 ------------
17
18 See below for instructions on how to install the requirements.
19
20
21 Toolchain setup
22 ---------------
23
24 First, you need to install MSYS2 (use the 64bit installer, msys2-x86_64-*.exe):
25
26   http://www.msys2.org
27   https://github.com/msys2/msys2/wiki/MSYS2-installation
28
29 Then, perform the MSYS2 update procedure as per the documentation above.
30
31   $ pacman -Syu # If needed, close MSYS2, run it again from Start menu.
32   $ pacman -Su
33
34 Now close the shell and start an "MSYS2 MinGW 64-bit" or "MSYS2 MinGW 32-bit"
35 shell (do NOT use the "MSYS2 MSYS" shell). All other steps will always have to
36 be performed in an "MSYS2 MinGW 62-bit" or "MSYS2 MinGW 32-bit" shell.
37
38 Install the MSYS2 git package there:
39
40   $ pacman -Sy
41   $ pacman -S git
42
43 This is all that is needed to bootstrap your MSYS2 system. You can now use
44 our sigrok-native-msys2 script to install all other required MSYS2 packages:
45
46   $ ./sigrok-native-msys2 prepare
47
48
49 Building
50 --------
51
52  $ ./sigrok-native-msys2
53
54 Per default it will install the compiled packages in:
55
56  $HOME/sr_msys2_release_32
57
58 This depends on whether you're running the build in a "MSYS2 MinGW 64-bit" or
59 "MSYS2 MinGW 32-bit" shell, and whether you enabled debug builds or not.
60
61 Please edit the script if you want to change any settings.
62