Merging win32/buildwin.html contents into INSTALL
This commit is contained in:
parent
0bcad18c4b
commit
06e03d77e6
24 changed files with 2476 additions and 613 deletions
|
|
@ -5,7 +5,7 @@
|
|||
Copyright © 2002-2021 by various contributors; see AUTHORS.
|
||||
http://www.tuxpaint.org/
|
||||
|
||||
agosto 30, 2021
|
||||
agosto 31, 2021
|
||||
|
||||
----------------------------------------------------------------------
|
||||
|
||||
|
|
@ -143,47 +143,237 @@ Compiling and Installation
|
|||
|
||||
Windows Users
|
||||
|
||||
Compiling:
|
||||
Compiling Set-Up
|
||||
|
||||
As of February 2005 (starting with Tux Paint 0.9.15), the "Makefile"
|
||||
includes support for building on a Windows system using MinGW/MSYS
|
||||
(http://www.mingw.org/).
|
||||
(https://sourceforge.net/projects/msys2/).
|
||||
|
||||
After configuring the environment and building and installing all
|
||||
the dependencies, use these commands, in MSYS, to build, install and
|
||||
run:
|
||||
Many tools and libraries are required to build Tux Paint. The
|
||||
package management system "pacman" helps you install them
|
||||
automatically solving complicated dependencies.
|
||||
|
||||
Prior to version 0.9.20:
|
||||
Download the latest MSYS2 environment from
|
||||
https://sourceforge.net/projects/msys2/files/Base/ and install it
|
||||
where you'd like (the default is
|
||||
"https://sourceforge.net/projects/msys2/files/Base/")
|
||||
|
||||
$ make win32
|
||||
$ make install-win32
|
||||
$ tuxpaint
|
||||
Open the MSYS2 shell from the "Start Menu" -> "MSYS2 64bit" ->
|
||||
"MSYS2 MSYS" and execute following command (press [Enter] or
|
||||
[Return] to accept the defaults for all questions):
|
||||
|
||||
Version 0.9.20 and beyond:
|
||||
pacman -Syu
|
||||
|
||||
$ make
|
||||
$ make install
|
||||
$ tuxpaint
|
||||
This will update core system and the window will close
|
||||
automatically. Repeat the steps above one more time to finish the
|
||||
remaining update process.
|
||||
|
||||
Use the following command to build a version suitable for
|
||||
redistribution with the installer or in a zip-file:
|
||||
Within the MSYS2 shell, run the following command to install basic
|
||||
development tools:
|
||||
|
||||
pacman -S base-devel msys2-devel git
|
||||
|
||||
Proceed to the next "MinGW 64bit (x86_64) toolchains" section, or skip
|
||||
to the "MinGW 32bit (i686) toolchains" section if you need only a
|
||||
32bit build environment.
|
||||
|
||||
MinGW 64bit (x86_64) toolchains
|
||||
|
||||
Within the MSYS2 shell, run the following command to install basic
|
||||
64bit development tools:
|
||||
|
||||
pacman -S mingw-w64-x86_64-toolchain
|
||||
|
||||
64bit (x86_64) dependency libraries for Tux Paint
|
||||
|
||||
You can install tools and libraries required for compiling Tux Paint
|
||||
on MSYS2/MINGW using "pacman" except for SDL_Pango.
|
||||
|
||||
"ntldd" is a small tool which examine windows executable files to
|
||||
list Dynamic Link Library (.dll) files they depends on. Tux Paint's
|
||||
packaging process for binary distribution uses it to find required
|
||||
.dll files.
|
||||
|
||||
FLTK is a cross-platform GUI toolkit used by "Tux Paint Config.".
|
||||
You can skip installing it if you are only building "Tux Paint".
|
||||
|
||||
$ pacman -S mingw-w64-x86_64-SDL_{image,mixer,ttf}
|
||||
$ pacman -S mingw-w64-x86_64-librsvg
|
||||
$ pacman -S mingw-w64-x86_64-fribidi
|
||||
$ pacman -S mingw-w64-x86_64-libimagequant
|
||||
$ pacman -S mingw-w64-x86_64-fltk
|
||||
$ pacman -S mingw64/mingw-w64-x86_64-ntldd-git
|
||||
|
||||
Note: Close the shell before proceeding to the remaining process.
|
||||
|
||||
Install SDL_Pango and re-install SDL on the 64bit environment
|
||||
|
||||
SDL_Pango should be installed manually. In addition, you have to
|
||||
re-install SDL from the source code or you will see unnecessary
|
||||
blank window opens when starting Tux Paint.
|
||||
|
||||
This time, use the MinGW "64bit" shell. Open the shell from the
|
||||
"Start Menu" -> "MSYS2 64bit" -> "MSYS2 MinGW 64-bit"
|
||||
|
||||
SDL_Pango
|
||||
|
||||
At first, you have to prepare source tar-ball and a required patch
|
||||
in the same directory.
|
||||
|
||||
* Download source tar-ball of SDL_Pango-0.1.2 from SDL_Pango's
|
||||
page on Sourceforge.net.
|
||||
* Download a patch file from John Popplewell's "Tux Paint -
|
||||
MinGW/MSYS build instructions" webpage. (This adds some extra
|
||||
(required) functionality to SDL_Pango.)
|
||||
|
||||
Build and install SDL_Pango as follows.
|
||||
|
||||
$ tar zxvf SDL_Pango-0.1.2.tar.gz
|
||||
$ cd SDL_Pango-0.1.2/
|
||||
$ patch -p0 < ../SDL_Pango-configure-extra-api.patch
|
||||
$ ./configure --prefix=/mingw64 && make && make install
|
||||
|
||||
SDL
|
||||
|
||||
Download source tar-ball of SDL_1.2.15 from libsdl.org.
|
||||
|
||||
Re-install SDL as follows.
|
||||
|
||||
$ tar zxvf SDL-1.2.15.tar.gz
|
||||
$ cd SDL-1.2.15
|
||||
$ ./configure --prefix=/mingw64 && make && make install
|
||||
|
||||
Proceed to the next "MinGW 32bit (i686) toolchains" section, or skip
|
||||
to the "ImageMagick" section if you need only a 64bit build
|
||||
environment.
|
||||
|
||||
MinGW 32bit (i686) toolchains
|
||||
|
||||
Within the MSYS2 shell, run the following command to install basic
|
||||
32bit development tools:
|
||||
|
||||
pacman -S mingw-w64-i686-toolchain
|
||||
|
||||
32bit (i686) dependency libraries for Tux Paint
|
||||
|
||||
You can install tools and libraries required for compiling Tux Paint
|
||||
on MSYS2/MINGW using "pacman" except for SDL_Pango.
|
||||
|
||||
"ntldd" is a small tool which examine windows executable files to
|
||||
list Dynamic Link Library (.dll) files they depends on. Tux Paint's
|
||||
packaging process for binary distribution uses it to find required
|
||||
.dll files.
|
||||
|
||||
FLTK is a cross-platform GUI toolkit used by "Tux Paint Config.".
|
||||
You can skip installing it if you are only building "Tux Paint".
|
||||
|
||||
$ pacman -S mingw-w64-i686-SDL_{image,mixer,ttf}
|
||||
$ pacman -S mingw-w64-i686-librsvg
|
||||
$ pacman -S mingw-w64-i686-fribidi
|
||||
$ pacman -S mingw-w64-i686-libimagequant
|
||||
$ pacman -S mingw-w64-i686-fltk
|
||||
$ pacman -S mingw-w64-i686-ntldd-git
|
||||
|
||||
Note: Close the shell before proceeding to the remaining process.
|
||||
|
||||
Install SDL_Pango and re-install SDL on the 32bit environment
|
||||
|
||||
SDL_Pango should be installed manually. In addition, you have to
|
||||
re-install SDL from the source code or you will see unnecessary
|
||||
blank window opens when starting Tux Paint.
|
||||
|
||||
This time, use the MinGW "32bit" shell. Open the shell from the
|
||||
"Start Menu" -> "MSYS2 64bit" -> "MSYS2 MinGW 32-bit"
|
||||
|
||||
SDL_Pango
|
||||
|
||||
At first, you have to prepare source tar-ball and a required patch
|
||||
in the same directory.
|
||||
|
||||
* Download source tar-ball of SDL_Pango-0.1.2 from SDL_Pango's
|
||||
page on Sourceforge.net.
|
||||
* Download a patch file from John Popplewell's "Tux Paint -
|
||||
MinGW/MSYS build instructions" webpage. (This adds some extra
|
||||
(required) functionality to SDL_Pango.)
|
||||
|
||||
Build and install SDL_Pango as follows.
|
||||
|
||||
$ tar zxvf SDL_Pango-0.1.2.tar.gz
|
||||
$ cd SDL_Pango-0.1.2/
|
||||
$ patch -p0 < ../SDL_Pango-configure-extra-api.patch
|
||||
$ ./configure --prefix=/mingw32 && make && make install
|
||||
|
||||
SDL
|
||||
|
||||
Download source tar-ball of SDL_1.2.15 from libsdl.org.
|
||||
|
||||
Re-install SDL as follows.
|
||||
|
||||
$ tar zxvf SDL-1.2.15.tar.gz
|
||||
$ cd SDL-1.2.15
|
||||
$ ./configure --prefix=/mingw32 && make && make install
|
||||
|
||||
ImageMagick
|
||||
|
||||
ImageMagick is a compilation of command line tools to create, edit,
|
||||
compose, or convert bitmap images supporting quite a large number of
|
||||
image formats. Tux Paint uses two functions ("convert" and
|
||||
"composite") in it to generate thumbnails for startar images and
|
||||
templates during the build process.
|
||||
|
||||
Using official binary release available from "Windows Binary
|
||||
Release" is recommended, due to the commands installed with "pacman"
|
||||
on MinGW/MSYS not working as expected!
|
||||
|
||||
Do not forget to enable "Install legacy utilities (e.g. convert)"
|
||||
while installing it, because Tux Paint's build process uses them.
|
||||
|
||||
Add the path to the directory in which ImageMagick is installed at
|
||||
the top of your "PATH" environment variable. For example:
|
||||
|
||||
$ export PATH=/c/Program\ Files/ImageMagick-7.0.10-Q16-HDRI:$PATH
|
||||
|
||||
You can make this permanent by adding the above to your the BASH
|
||||
shell configuration file, "~/.bash_profile".
|
||||
|
||||
Tux Paint
|
||||
|
||||
You can compile 64bit binaries using MSYS2 64bit shell, and 32bit
|
||||
binaries using MSYS2 32bit shell, respectively.
|
||||
|
||||
* Select "MSYS2 64bit" -> "MSYS2 MinGW 64-bit" from the "Start
|
||||
Menu" to open the 64bit shell.
|
||||
* Select "MSYS2 64bit" -> "MSYS2 MinGW 32-bit" from the "Start
|
||||
Menu" to open the 32bit shell.
|
||||
|
||||
Compile Tux Paint with the following command:
|
||||
|
||||
$ make bdist-win32
|
||||
|
||||
Or if building for Win9x/ME:
|
||||
Note: At this point, you will want to build "Tux Paint Config." for
|
||||
Windows, so it can be included along with "Tux Paint", if you're
|
||||
making an official (or test) release. The build process will look
|
||||
for it in a directory named "tuxpaint-config" (with no version
|
||||
number, e.g., "tuxpaint-config-X.Y.Z"). See "Tux Paint Config."'s
|
||||
INSTALL.txt documentation for details.
|
||||
|
||||
$ BDIST_WIN9X=1 make bdist-win32
|
||||
All the files needed for starting Tux Paint (and Tux Paint Config.)
|
||||
are collected in the directory for binary distribution "bdist"
|
||||
directory under "win32". You can start them by double-clicking their
|
||||
executable (.exe) files in the "bdist" directory.
|
||||
|
||||
Before any of the above will work, you need to configure the
|
||||
environment and build or install the libraries that Tux Paint
|
||||
depends upon. John Popplewell put together some instructions for
|
||||
doing that here:
|
||||
Building the Tux Paint Windows Installer:
|
||||
|
||||
http://www.johnnypops.co.uk/tuxpaint/
|
||||
Inno Setup is used to build executable installer for Tux Paint.
|
||||
Therefore you have to install it in the first place.
|
||||
|
||||
Read the relevant notes if building for Win9X/ME.
|
||||
Then, you can easily build an executable installer by right-clicking
|
||||
on the "tuxpaint.iss" icon in the "win32" directory and selecting
|
||||
"Compile" on the list. It will run for a while, and eventually you
|
||||
will find a "tuxpaint-X.Y.Z-win32-installer.exe" file in the same
|
||||
directory.
|
||||
|
||||
Running the Installer:
|
||||
Running the Tux Paint Windows Installer:
|
||||
|
||||
Double-click the Tux Paint installer executable (.EXE file) and
|
||||
follow the instructions.
|
||||
|
|
|
|||
Loading…
Add table
Add a link
Reference in a new issue