|
|
(78 intermediate revisions by the same user not shown)
|
| Line 1: |
Line 1: |
| − | This wiki explains how to install a compilation environment (based on MinGW) to build GIMX.<br/> | + | <languages /> |
| − | It also explains how to install Eclipse CDT (with SVN) and perform a checkout.<br/> | + | <translate><!--T:1--> |
| | + | This wiki explains how to install a compilation environment (based on Msys2/mingw64) to build GIMX.<br /> |
| | + | It also explains how to install Eclipse CDT and perform a checkout.<br /> |
| | Unless otherwise specified, perform a default installation (default directories, etc). | | Unless otherwise specified, perform a default installation (default directories, etc). |
| | | | |
| − | ==MinGW/MSYS== | + | ==Msys2/MinGW64== <!--T:2--> |
| | | | |
| − | This part explains how to install the compilation toolchain.<br/>
| + | <!--T:28--> |
| − | Download and run [http://sourceforge.net/projects/mingw/files/Installer/mingw-get-inst/mingw-get-inst-20120426/mingw-get-inst-20120426.exe/download Mingw 20120426].<br/> | + | Download and install [https://msys2.github.io/ Msys2].<br /> |
| − | The only thing to configure during the installation process: in the "Select Components" panel, select "C++ Compiler" and "MSYS Basic System".
| + | Make sure to follow the instructions from the Msys2 wiki. |
| | | | |
| − | http://www.gimx.fr/img/wiki/MinGW.jpg
| + | <!--T:29--> |
| | + | If you are running a 32-bit Windows, install the i686 version.<br /> |
| | + | If you are running a 64-bit Windows, install the x84_64 version. |
| | | | |
| − | Append ";C:\MinGW\bin;C:\MinGW\msys\1.0\bin" (without quotes, don't forget the first semicolon) to your system PATH (Control Panel > System > Advanced > Environment Variables > System variables > Path > Edit).
| + | ==Checkout installation and build tools== <!--T:33--> |
| | | | |
| − | http://www.gimx.fr/img/wiki/System.jpg
| + | '''Run "MSYS2 MSYS" from Start menu, and type:''' |
| | | | |
| − | http://www.gimx.fr/img/wiki/SystemProperties.jpg
| + | <!--T:34--> |
| | + | pacman --noconfirm -S git |
| | + | git clone <nowiki>https://github.com/matlo/GIMX-build.git</nowiki> |
| | | | |
| − | http://www.gimx.fr/img/wiki/EnvVar.jpg
| + | ==Development tools== <!--T:30--> |
| | | | |
| − | http://www.gimx.fr/img/wiki/Path.jpg
| + | <!--T:31--> |
| | + | '''Run "MSYS MinGW 64-bit" from Start menu, and type:''' |
| | | | |
| − | ==Libraries==
| + | <!--T:32--> |
| | + | cd GIMX-build/windows |
| | + | ./install.sh |
| | | | |
| − | This part explains how to install the required libraries (libiconv, SDL, wxWidgets, libxml, zlib).<br/>
| + | On 32-bit Windows run Run "MSYS2 MinGW 32-bit" from Start menu instead. |
| − | Run C:\MinGW\msys\1.0\msys.bat<br/> | |
| − | Install wget:
| |
| | | | |
| − | mingw-get install msys-wget
| + | ==Inno setup== <!--T:35--> |
| | | | |
| − | Download and run the install.sh script: | + | <!--T:36--> |
| | + | Download and install [http://www.jrsoftware.org/isdl.php Inno setup]. |
| | | | |
| − | wget http://diyps3controller.googlecode.com/svn/trunk/build/win/install.sh
| + | ==Automated command-line build== <!--T:15--> |
| − | ./install.sh
| |
| | | | |
| − | ==Automated command-line build==
| + | <!--T:16--> |
| | + | '''Run "MSYS2 MinGW 64-bit" from Start menu, and type:''' |
| | | | |
| − | This part explains how to checkout and build GIMX from the command-line.<br/>
| + | <!--T:17--> |
| − | Run C:\MinGW\msys\1.0\msys.bat<br/>
| + | cd GIMX-build/windows |
| − | Download and run the build.sh script:
| + | ./build.sh |
| | | | |
| − | wget http://diyps3controller.googlecode.com/svn/trunk/build/win/build.sh
| + | <!--T:18--> |
| − | ./build.sh
| + | All binaries are copied into <path to msys>\home\<username>\GIMX\setup, e.g. C:\msys32\home\matlo\GIMX\setup.<br /> |
| | + | A setup file is also created. |
| | | | |
| − | All binaries are copied into C:\MinGW\msys\1.0\home\username\GIMX\setup. Binaries gimx-config, gimx-fpsconfig and gimx-serial can be launched from that folder as it contains all required libraries and configuration files.
| + | On 32-bit Windows run Run "MSYS2 MinGW 32-bit" from Start menu instead. |
| | | | |
| − | ==Eclipse IDE== | + | ==Eclipse IDE== <!--T:19--> |
| | | | |
| − | Eclipse is an IDE that can be stacked onto the MinGW/MSYS compilation toolchain.<br/> | + | <!--T:20--> |
| − | Be sure to have a <a href="http://www.oracle.com/technetwork/java/javase/downloads/index.html">java JRE</a> installed on your system.<br/> | + | This part is only useful in case you intend to modify the source code. If you only want to build GIMX, you can skip it.<br /> |
| − | Download <a href="http://www.eclipse.org/downloads/">Eclipse IDE for C/C++ Developers</a>. Unzip it to wherever you want.<br/> | + | Eclipse is an IDE that can be stacked onto the Msys2/MinGW64 compilation toolchain.<br /> |
| − | Run eclipse.exe. | + | Be sure to have a [http://www.oracle.com/technetwork/java/javase/downloads/index.html java JRE] installed on your system.<br /> |
| | + | Download [https://www.eclipse.org/downloads/download.php?file=/technology/epp/downloads/release/2018-12/R/eclipse-cpp-2018-12-R-win32-x86_64.zip Eclipse CDT 2018-12]. Unzip it to wherever you want.<br /> |
| | + | Run eclipse.exe.<br /> |
| | + | Use default workspace folder.<br /> |
| | | | |
| − | ===SVN Plugin=== | + | ===Cloning project=== |
| | | | |
| − | Help>Install New Software<br/>
| + | Copy the following URL: <nowiki>https://github.com/matlo/GIMX.git</nowiki><br /> |
| − | Work with: select your eclipse release name (as of this writing, Indigo).<br/>
| + | Click on "Window > Show View > Other...", select "Git repositories", and click on "Open".<br /> |
| − | type filter text: svn<br/>
| + | Type Ctrl+V. A "Clone Git Repository" window should appear.<br /> |
| − | Select "Subversive SVN Integration for the Mylyn Project" and "Subversive SVN Team Provider".<br/> | + | First step defines the repository to import. Click on "Next".<br /> |
| − | Proceed to installation (select latest SVN Kit - as of this writing, 1.3.5), and restart eclipse.
| + | Second step defines the branch selection. Select the branches you are interested in. "master" branch contains latest stable source code. Click on "Next".<br /> |
| | + | Third step defines local destination. A standard value for "Directory" is "C:\Users\<username>\git\GIMX". Make sure to select "Clone submodules". Click on "Finish". |
| | | | |
| − | ===Project checkout=== | + | ===Importing project=== |
| | | | |
| − | Project Explorer view, right click, New>Other.<br/>
| + | In the "Git Repositories" view, right click on the cloned git repository, and click on "Import Projects...". Select the project folder (for example "GIMX") and click on "Finish".<br /> |
| − | Select SVN>Project from SVN, click next.<br/>
| + | |
| − | Enter URL: https://diyps3controller.googlecode.com/svn/trunk/sixaxis-emu<br/>
| + | ===Building project=== |
| − | Click next, Click no (do not nomalize URL), and click "Trust Always" (googlecode certificate).<br/>
| + | |
| − | Click Head Revision, and click Finish.<br/>
| + | In the "Project Explorer" view, right-click on the project, and click on "Build Project".<br /> |
| − | Check out as: Select "Check out as a project configured using the New Project Wizard", select "Head Revision", and click finish.<br/>
| + | If the build fails at finding make or gcc : |
| − | Select a wizard: Select "C project" and click next.<br/>
| + | * in the "Project Explorer" view, right-click on the project, and click on "Properties" |
| − | Enter a Project name, and select "Makefile Project > Empty Project", and click next.<br/>
| + | * unfold "C/C++ Build", and click on "Environment" |
| − | Click on "Advanced Settings", click on "C/C++ build", uncheck "Use default build command", and write "make -f Makefile.win" as "Build command".<br/>
| + | * make sure msys2 and mingw64 bin folders are present in the PATH variable |
| − | Click on the "Behaviour" panel, check "Use parallel build" and set the "Use parallel jobs" to the right number of CPU cores.<br/>
| + | ** for example, if you used default installation folder for msys2 (C:\msys64), you should have this at the end of the PATH variable: C:\msys64\usr\bin;C:\msys64\mingw64\bin |
| − | Click Finish.<br/>
| + | ** it is not a good idea to change PATH at the system level, as this could lead to other apps malfunctioning |
| − | Check out is performed, and the new project appears in the Project Explorer view. The project is build automatically.
| + | |
| | + | ===Debug build=== |
| | + | |
| | + | * in the "Project Explorer" view, right-click on the project, and click on "Properties" |
| | + | * in "C/C++ Build", uncheck "Use default build command" |
| | + | * enter "make -j 4 DEBUG=1 VERBOSE=1" without quotes as "Build command" (replace 4 with your number of CPU cores) |
| | + | * in the "Project Explorer" view, right-click on the project, and click on "Clean project" |
| | + | * in the "Project Explorer" view, right-click on the project, and click on "Build project" |
| | + | |
| | + | ===Notes=== |
| | + | |
| | + | The build system does not detect changes in headers. Clean and rebuild project after modifying a header. |
| | + | |
| | + | </translate> |
This wiki explains how to install a compilation environment (based on Msys2/mingw64) to build GIMX.
It also explains how to install Eclipse CDT and perform a checkout.
Unless otherwise specified, perform a default installation (default directories, etc).
Msys2/MinGW64
Download and install Msys2.
Make sure to follow the instructions from the Msys2 wiki.
If you are running a 32-bit Windows, install the i686 version.
If you are running a 64-bit Windows, install the x84_64 version.
Checkout installation and build tools
Run "MSYS2 MSYS" from Start menu, and type:
pacman --noconfirm -S git
git clone https://github.com/matlo/GIMX-build.git
Development tools
Run "MSYS MinGW 64-bit" from Start menu, and type:
cd GIMX-build/windows
./install.sh
On 32-bit Windows run Run "MSYS2 MinGW 32-bit" from Start menu instead.
Inno setup
Download and install Inno setup.
Automated command-line build
Run "MSYS2 MinGW 64-bit" from Start menu, and type:
cd GIMX-build/windows
./build.sh
All binaries are copied into <path to msys>\home\<username>\GIMX\setup, e.g. C:\msys32\home\matlo\GIMX\setup.
A setup file is also created.
On 32-bit Windows run Run "MSYS2 MinGW 32-bit" from Start menu instead.
Eclipse IDE
This part is only useful in case you intend to modify the source code. If you only want to build GIMX, you can skip it.
Eclipse is an IDE that can be stacked onto the Msys2/MinGW64 compilation toolchain.
Be sure to have a java JRE installed on your system.
Download Eclipse CDT 2018-12. Unzip it to wherever you want.
Run eclipse.exe.
Use default workspace folder.
Cloning project
Copy the following URL: https://github.com/matlo/GIMX.git
Click on "Window > Show View > Other...", select "Git repositories", and click on "Open".
Type Ctrl+V. A "Clone Git Repository" window should appear.
First step defines the repository to import. Click on "Next".
Second step defines the branch selection. Select the branches you are interested in. "master" branch contains latest stable source code. Click on "Next".
Third step defines local destination. A standard value for "Directory" is "C:\Users\<username>\git\GIMX". Make sure to select "Clone submodules". Click on "Finish".
Importing project
In the "Git Repositories" view, right click on the cloned git repository, and click on "Import Projects...". Select the project folder (for example "GIMX") and click on "Finish".
Building project
In the "Project Explorer" view, right-click on the project, and click on "Build Project".
If the build fails at finding make or gcc :
- in the "Project Explorer" view, right-click on the project, and click on "Properties"
- unfold "C/C++ Build", and click on "Environment"
- make sure msys2 and mingw64 bin folders are present in the PATH variable
- for example, if you used default installation folder for msys2 (C:\msys64), you should have this at the end of the PATH variable: C:\msys64\usr\bin;C:\msys64\mingw64\bin
- it is not a good idea to change PATH at the system level, as this could lead to other apps malfunctioning
Debug build
- in the "Project Explorer" view, right-click on the project, and click on "Properties"
- in "C/C++ Build", uncheck "Use default build command"
- enter "make -j 4 DEBUG=1 VERBOSE=1" without quotes as "Build command" (replace 4 with your number of CPU cores)
- in the "Project Explorer" view, right-click on the project, and click on "Clean project"
- in the "Project Explorer" view, right-click on the project, and click on "Build project"
Notes
The build system does not detect changes in headers. Clean and rebuild project after modifying a header.
