notgne2/tuxpaint-pencil-sharpener
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions

Add macOS compile/install instructions to INSTALL

Browse source
This commit is contained in:
Bill Kendrick 2021-08-31 22:37:18 -07:00
parent 6407bec2a2
commit 987b2c1cc3
12 changed files with 1643 additions and 149 deletions
Download patch file Download diff file Expand all files Collapse all files

165
docs/fr_FR.UTF-8/INSTALL.txt
View file

@ -18,6 +18,7 @@
| * Compiling and Installation |
| * Utilisateurs de Windows |
| * Utilisateurs de Linux/Unix |
| * Utilisateurs de macOS |
| * Debugging |
| * Uninstalling Tux Paint |
| * Windows |
@ -180,6 +181,8 @@ Compiling and Installation
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
@ -250,6 +253,8 @@ Compiling and Installation
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
@ -316,6 +321,8 @@ Compiling and Installation
$ cd SDL-1.2.15
$ ./configure --prefix=/mingw32 && make && make install
-------------------------------------------------------
ImageMagick
ImageMagick is a compilation of command line tools to create, edit,
@ -339,6 +346,8 @@ Compiling and Installation
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
@ -365,6 +374,8 @@ Compiling and Installation
directory under "win32". You can start them by double-clicking their
executable (.exe) files in the "bdist" directory.
-------------------------------------------------------
Building the Tux Paint Windows Installer:
Inno Setup is used to build executable installer for Tux Paint.
@ -376,6 +387,8 @@ Compiling and Installation
will find a "tuxpaint-X.Y.Z-win32-installer.exe" file in the same
directory.
-------------------------------------------------------
Running the Tux Paint Windows Installer:
Double-cliquez sur l'exécutable du programme d'installation de Tux
@ -396,6 +409,8 @@ Compiling and Installation
À ce stade, vous pouvez cliquer sur «Installer» pour installer Tux
Paint !
-------------------------------------------------------
Modification des paramètres à l'aide du raccourci :
Pour modifier les paramètres du programme, cliquez avec le bouton
@ -427,6 +442,8 @@ Compiling and Installation
Quand vous avez fini, appuyez sur "OK".
-------------------------------------------------------
Si quelque chose ne va pas :
Si, lorsque vous double-cliquez sur le raccourci pour lancer le jeu,
@ -440,6 +457,8 @@ Compiling and Installation
incorrecte (majuscule 'Z' à la place de 'z' minuscule) ou un '-'
(tiret) manquant (en trop).
----------------------------------------------------------------------
Utilisateurs de Linux/Unix
Compilation :
@ -454,6 +473,8 @@ Compiling and Installation
$ make
-------------------------------------------------------
Désactivation du support SVG (donc des dépendances Cairo, libSVG, et
svg-cairo)
@ -464,6 +485,8 @@ Compiling and Installation
$ make SVG_LIB= SVG_CFLAGS=
-------------------------------------------------------
Désactivation du support Pango (donc des dépendances Pango, Cairo, etc ...)
Avant la version 0.9.18, Tuxpaint utilisait la bibliothèque
@ -475,6 +498,8 @@ Compiling and Installation
$ make SDL_PANGO_LIB=
-------------------------------------------------------
Désactiver le son lors de la compilation :
Si vous n'avez pas de carte son ou si vous préférez créer le
@ -483,11 +508,15 @@ Compiling and Installation
$ make SDL_MIXER_LIB=
-------------------------------------------------------
Autres options :
Diverses autres options (par exemple, les dossiers d'installation)
peuvent être remplacées; voir dans "Makefile" pour plus de détails.
-------------------------------------------------------
Si vous obtenez des erreurs :
Si vous avez des erreurs lors de la compilation, assurez-vous
@ -498,6 +527,8 @@ Compiling and Installation
correspondants, sinon vous ne pourrez pas compiler Tux Paint (et
d'autres programmes) provenant des sources !
-------------------------------------------------------
Installation :
En supposant qu'aucune erreur fatale ne s'est produite, vous pouvez
@ -576,6 +607,138 @@ Compiling and Installation
----------------------------------------------------------------------
Utilisateurs de macOS
septembre 21, 2021 Mark K. Kim <markuskimius@gmail.com>
Tux Paint 0.9.22 and earlier required building Tux Paint from the
Xcode IDE. Starting with 0.9.23, however, Tux Paint for macOS is built
as though it were a Linux application.
Prerequisites
Although Tux Paint is built without the Xcode IDE, Xcode itself is
still required to build Tux Paint. Download it from the App Store,
and launch it once to accept its license agreements. You may also
need to install the Xcode command line tools using the command:
xcode-select --install
Building Tux Paint also requires various libraries. We install them
from MacPorts where possible, source code otherwise. Install
MacPorts to the default /opt/local path according to the
instructions found on their website: https://www.macports.org/
* ImageMagick
* cairo
* fribidi
* lbzip2
* libimagequant^*
* libpaper
* libpng
* librsvg
* libsdl
* libsdl_image
* libsdl_mixer
* libsdl_pango
* libsdl_ttf
* pkgconfig
* zlib
... but you should install any package that is required by the
latest version of Tux Paint.
^* Not available from MacPorts as of this writing, see below.
libimagequant
libimagequant is not available from MacPorts as of this writing.
It can be installed from the source code as follows. It should be
installed to /opt/local (same as MacPorts) for the library to be
included in TuxPaint.dmg.
$ git clone https://github.com/ImageOptim/libimagequant.git
$ cd libimagequant
$ ./configure --prefix=/opt/local
$ make
$ sudo make install
WARNING: Having any UNIX-like toolset installed on your Mac besides
MacPorts and Xcode, such as Fink or Brew, will prevent your app
bundle from being portable. Be sure Fink and Brew are not accessible
from your build environment.
-------------------------------------------------------
How to Build
Simply, run:
% make
% make install
... to create the TuxPaint.app application bundle that can be run
in-place or copied to /Applications. It also creates TuxPaint.dmg
for distribution.
-------------------------------------------------------
Known Issues
* A macOS binary built on a specific version of macOS only runs on
that version of macOS or later. To ensure Tux Paint can run on
the oldest version of macOS possible, build it on the oldest
version of macOS available. As of this writing we know Tux Paint
cannot be built to run on macOS 10.7 or earlier.
See "Old Versions of macOS" below for best-effort instructions
on how to obtain, install, and build Tux Paint on an old version
of macOS.
-------------------------------------------------------
Old Versions of macOS
Some old versions of macOS can be downloaded from Apple's support
page: https://support.apple.com/en-us/HT211683
macOS does allow dual booting of multiple versions of the OS, but
it's safer and easier to install the old macOS onto a flash drive.
Wherever you're installing it, the target drive's partitioniong
scheme and partition type must match what the old macOS expects, so
use the Disk Utility to partition and format the flash drive
accordingly.
As of this writing, the oldest version of macOS available on Apple's
support site is Yosemite 10.10, which expects "GPT (GUID Partition
Table)" partitioning scheme instead of the older MBR scheme, and
"Mac OS Extended (Journaled)" as the partition type instead of the
newer APFS partition type.
Upon launching the installer, if you get a popup about macOS being
too old or new to be installed, a bootable installer can be created
using the instructions found here:
https://support.apple.com/en-mide/HT201372
It has been found that macOS can be installed onto the bootable
media itself, so you can make the flash drive into a bootable
installer then install the old macOS onto the same flash drive.
Once the old macOS is installed, you may find the Xcode on the App
Store is too new to run on the version of the old macOS. Old
versions of Xcode can be downloaded from Apple's Developer site in
an area accessible with free registration:
https://developer.apple.com/download/more/
The list of macOS versions and the last version of Xcode compatible
with them are laid out nicely on the Wikipedia page on Xcode:
https://en.wikipedia.org/wiki/Xcode#Version_comparison_table
And because Xcode is being installed manually, you can skip the step
to install the Xcode command line tools (do not run "xcode-select
--install") but otherwise build Tux Paint using the same steps
described in the earlier part of this document.
----------------------------------------------------------------------
Debugging
Le débogage (vers "STDOUT", par exemple le terminal, ou vers un fichier
@ -605,6 +768,8 @@ Uninstalling Tux Paint
uniquement)" dans la Section Ajout / Suppression de programmes du
Panneau de configuration.
----------------------------------------------------------------------
Linux
Dans le répertoire source de Tux Paint (où vous avez compilé Tux