I "Makefile" ingår stöd för att bygga på ett Windows-system med MinGW/MSYS (https://sourceforge.net/projects/msys2/).

Många verktyg och bibliotek krävs för att bygga Rita med Tux. Pakethanteringssystemet "pacman" hjälper dig att installera dem automatiskt och lösa komplicerade beroenden.

ImageMagick är en samling kommandoradsverktyg för att skapa, redigera, komponera eller konvertera bitmappsbilder med stöd för ett stort antal bildformat. Rita med Tux använder två funktioner ("convert" och "composite") för att generera miniatyrbilder för startbilder och mallar under byggprocessen.

Att använda den officiella binära versionen som finns tillgänglig från"Windows Binary Release" rekommenderas, på grund av att kommandona installerade med "pacman" på MinGW / MSYS inte fungerar som förväntat!

Glöm inte att aktivera "Installera äldre verktyg (t.ex. convert)" när du installerar det, eftersom Rita med Tux's byggprocess använder dem.

Lägg till sökvägen till den katalog där ImageMagick är installerat längst upp i din miljövariabel "PATH". Till exempel: "PATH":

$ export PATH=/c/Program\ Files/ImageMagick-7.0.10-Q16-HDRI:$PATH

Du kan göra detta permanent genom att lägga till ovanstående i konfigurationsfilen för BASH-skalet, "~/.bash_profile".

Du kan kompilera 64-bitars binära filer med hjälp av skalet "MSYS2 64bit" respektive 32-bitars binära filer med hjälp av skalet "MSYS2 32bit".

• Välj "MSYS2 64bit" → "MSYS2 MinGW 64-bit" från "Start Menu" för att öppna 64bit-skalet.
• Välj "MSYS2 64bit" → "MSYS2 MinGW 32-bit" från "Start Menu" för att öppna 32bit-skalet.

Alla filer som behövs för att starta Rita med Tux (och Konfigurera Rita med Tux) finns samlade i katalogen för binär distribution "bdist" under "win32". Du kan starta dem genom att dubbelklicka på deras körbara (.exe) filer i katalogen "bdist".

Inno Setup används för att bygga ett körbart installationsprogram för Rita med Tux. Därför måste du installera det i första hand.

Inno Setup stöder officiellt översättningar för endast cirka 20 språk. En av de stora poängerna med Rita med Tux är dock att det stöder så många språk. Därför är installationsskriptet "tuxpaint.iss" för att bygga installationsprogrammet skrivet för att använda mycket fler översättningar inklusive inofficiella som finns tillgängliga på "InnoSetup Translations". Du måste ladda ner översättningsfilerna (.isl) som krävs och lägga dem i katalogen "Languages" under katalogen där Inno Setup är installerat.

Innan du bygger ett installationsprogram ska du redigera filen "tuxpaint.iss" och aktivera en av raderna som börjar med "#define BuildTarget=", beroende på arkitekturen för det installationsprogram du vill skapa.

Sedan kan du enkelt bygga ett körbart installationsprogram genom att högerklicka på ikonen "tuxpaint.iss" i katalogen "win32" och välja "Compile" i listan. Det kommer att köra ett tag och så småningom hittar du en "tuxpaint-X.Y.Z-windows-<arch>-installer.exe"-fil i samma katalog.

Dubbelklicka på den körbara installationsfilen för Rita med Tux (.EXE-filen) och följ instruktionerna.

Först kommer du att bli ombedd att läsa licensen. (Det är GNU General Public License (GPL), som också finns tillgänglig som "COPYING.txt")

Du kommer sedan att få frågan om du vill installera genvägar till Rita med Tux i Windows Startmeny och på Windows Skrivbord. (Båda alternativen är inställda som standard.)

Sedan kommer du att bli tillfrågad om var du vill installera Rita med Tux. Standardinställningen bör vara lämplig, så länge det finns ledigt utrymme. Annars väljer du en annan plats.

Vid denna punkt kan du klicka på "Installera" för att installera Rita med Tux!

💡 Installationsprogrammen för både Rita med Tux (plus Konfigurera Rita med Tux) (tuxpaint-X.Y.Z-windows-ARCH-installer.exe) och Rita med Tux Stamps (tuxpaint-stamps-YYYY.MM.DD-windows-installer.exe) accepterar kommandoradsalternativen "/SILENT" ("tyst") eller "/VERYSILENT" ("mycket tyst") som kan användas för att installera och avinstallera deras komponenter utan att använda ett interaktivt installationsfönster. Detta kan vara användbart för att automatisera installationen på en samling datorer, t.ex. med hjälp av Microsoft Intune molnbaserad lösning för slutpunktshantering (se https://learn.microsoft.com/mem/intune/).

Om du vill ändra programinställningarna högerklickar du på genvägen till TuxPaint och väljer "Egenskaper" (längst ner).

Kontrollera att fliken "Genväg" är markerad i det fönster som visas och undersök fältet "Mål:". Du bör se något liknande detta:

"C:\Programfiler\TuxPaint\TuxPaint.exe"

Du kan nu lägga till kommandoradsalternativ som aktiveras när du dubbelklickar på ikonen.

Till exempel, för att få spelet att köras i helskärmsläge, med enkla former (inget rotationsalternativ) och på franska, lägg till alternativen (efter "TuxPaint.exe"), så här:

"C:\Programfiler\TuxPaint\TuxPaint.exe" -f -s --lang french

(Se huvuddokumentationen för en fullständig lista över tillgängliga kommandoradsalternativ)

Om du gör ett misstag eller om allt försvinner, använd [Kontroll] + [Z] för att ångra eller tryck bara på [Esc] så stängs rutan utan att några ändringar har gjorts (om du inte tryckte på knappen "Apply"!).

När du är klar klickar du på "OK"

Om det inte händer något när du dubbelklickar på genvägen för att köra Rita med Tux beror det förmodligen på att några av kommandoradsalternativen är felaktiga. Öppna en Explorer och leta efter en fil som heter "stderr.txt" i din personliga sparmapp för TuxPaint, som normalt är "C:\Users\användarnamn\AppData\Roaming\TuxPaint\".

Det kommer att innehålla en beskrivning av vad som var fel. Vanligtvis beror det bara på felaktig teckenstorlek (stort "Z" i stället för litet "z") eller ett saknat (eller extra) "-" (bindestreck).

💡 Obs: Rita med Tux använder inte autoconf/automake, så det finns inget "./configure"-skript att köra. Kompileringen bör dock vara enkel, förutsatt att allt som Rita med Tux behöver är installerat.

För att kompilera programmet från källkoden kör du bara följande kommando från en shell-prompt (t.ex. "$"):

$ make

Om du vill inaktivera SVG-stödet (t.ex. om ditt system för närvarande inte stöds av Kairobiblioteket eller andra SVG-relaterade beroenden) kan du köra "make" med tillägget "SVG_LIB= SVG_CFLAGS= NOSVGFLAG=NOSVG":

$ make SVG_LIB= SVG_CFLAGS=

Om du inte har något ljudkort eller föredrar att bygga programmet utan ljudstöd (och därmed utan SDL_mixer-beroendet ) kan du köra "make" med "SDL_MIXER_LIB=" tillagt:

$ make SDL_MIXER_LIB=

Flera andra alternativ (t.ex. installationssökvägar) kan åsidosättas; se dem i "Makefile" för mer information.

Om du får några fel under kompileringstiden, kontrollera att du har installerat rätt bibliotek (se ovan). Om du använder paketerade versioner av biblioteken (t.ex. RPM:er under RedHat eller DEB:er under Debian), se till att du också får motsvarande "-dev"- eller "-devel"-paket, annars kommer du inte att kunna kompilera Rita med Tux (och andra program) från källan!

Förutsatt att inga fel inträffar kan du nu installera programmet så att det kan köras av användare i systemet. Som standard måste detta göras av användaren "root" ("superuser"). Byt till "root" genom att skriva kommandot:

$ su

Ange "root"s lösenord vid prompten. Du bör nu vara "root" (med en prompt som "#"). För att installera programmet och dess datafiler, skriv:

# make install

Slutligen kan du växla tillbaka till din vanliga användare genom att avsluta superanvändarläget:

# exit

Alternativt kan du kanske helt enkelt använda kommandot "sudo" (t.ex. på Ubuntu Linux):

$ sudo make install

💡 Obs: Som standard placeras "tuxpaint", det körbara programmet, i "/usr/local/bin/". Datafilerna (bilder, ljud, etc.) placeras i "/usr/local/share/tuxpaint/".

Även om Rita med Tux är byggt utan Xcode IDE krävs ändå Xcode för att bygga Rita med Tux. Ladda ner det från App Store och starta det en gång för att acceptera dess licensavtal. Du kan också behöva installera kommandoradsverktygen för Xcode med kommandot:

$ xcode-select --install

För att bygga Rita med Tux krävs också olika bibliotek. Vi installerar dem från MacPorts där det är möjligt, annars från källkoden. Installera MacPorts till standardsökvägen /opt/local enligt instruktionerna på deras webbplats: https://www.macports.org/

• ImageMagick
• cairo
• fribidi
• lbzip2
• libimagequant^*
• libpaper
• libpng
• librsvg
• libsdl2
• libsdl2_image
• libsdl2_mixer
• libsdl2_pango^*
• libsdl2_ttf
• libsdl2_gfx
• pkgconfig
• zlib

VARNING: Om du har någon UNIX-liknande verktygssats installerad på din Mac utöver MacPorts och Xcode, till exempel Fink eller Brew, kommer din appbunt inte att vara portabel. Se till att Fink och Brew inte är åtkomliga från din byggmiljö.

Helt enkelt, kör:

% make
% make install

Ytterligare steg krävs när du bygger en universell binär fil. Se "Bygga en universell binär fil" nedan.

• En macOS-binärfil som byggts på en specifik version av macOS körs bara på den versionen av macOS eller senare. För att säkerställa att Rita med Tux kan köras på den äldsta möjliga versionen av macOS, bygg den på den äldsta tillgängliga versionen av macOS. När detta skrivs vet vi att Rita med Tux inte kan byggas för att köras på macOS 10.7 eller tidigare.
  
  Se "Gamla versioner av macOS" nedan för bästa möjliga instruktioner om hur du skaffar, installerar och bygger Rita med Tux på en gammal version av macOS.
  
  Alternativt kan Rita med Tux och alla dess biblioteksberoenden kompileras med lämpliga alternativ för att kunna köras på äldre versioner av macOS. Dessa alternativ är redan inställda på Rita med Tux, så det är bara dess beroenden (från MacPorts) som behöver kompileras om. Se "Omkompilering av MacPorts" nedan för instruktioner.

Vissa gamla versioner av macOS kan laddas ner från Apples supportsida: https://support.apple.com/en-us/HT211683

macOS för Intel CPU tillåter dubbelstart av flera versioner av operativsystemet, men det är säkrare och enklare att installera det gamla macOS på ett USB-minne. Oavsett var du installerar det måste målenhetens partitioneringsschema och partitionstyp matcha vad det gamla macOS förväntar sig, så använd Diskverktyget för att partitionera och formatera flash-enheten i enlighet med detta.

Att dubbelstarta flera versioner av macOS för Apple Silicon har hittills inte fungerat. Istället för att installera en äldre version av macOS för Apple Silicon för att bygga Rita med Tux så att det kan köras på den gamla versionen av macOS för Apple Silicon, använd instruktionerna i avsnittet "Omkompilering av MacPorts" för att bygga Rita med Tux så att det kan köras på äldre versioner av macOS för Apple Silicon.

I skrivande stund är den äldsta versionen av macOS som finns på Apples supportsida Yosemite 10.10, som förväntar sig "GPT (GUID Partition Table)"-partitioneringsschema istället för det äldre MBR-schemat och "Mac OS Extended (Journaled)" som partitionstyp istället för den nyare APFS-partitionstypen.

Om du får en popup om att macOS är för gammalt eller nytt för att installeras när du startar installationsprogrammet kan du skapa ett startbart installationsprogram med hjälp av instruktionerna här: https://support.apple.com/en-mide/HT201372

När den gamla macOS är installerad kan du upptäcka att Xcode på App Store är för ny för att köras på versionen av den gamla macOS. Gamla versioner av Xcode kan hämtas från Apples webbplats för utvecklare i ett område som är tillgängligt med gratis registrering: https://developer.apple.com/download/more/

Listan över macOS-versioner och den senaste versionen av Xcode som är kompatibel med dem är snyggt upplagd på Wikipedia-sidan om Xcode: https://en.wikipedia.org/wiki/Xcode#Version_comparison_table

Eftersom Xcode installeras manuellt kan du hoppa över steget för att installera Xcodes kommandoradsverktyg (kör inte "xcode-select --install") men i övrigt bygga Rita med Tux med samma steg som beskrivs i den tidigare delen av det här dokumentet.

Om du vill kompilera om MacPorts så att den kan användas på äldre versioner av macOS ställer du in följande alternativ i /opt/local/etc/macports/macports.conf:

buildfromsource always
macosx_deployment_target 10.10

Avinstallera sedan alla MacPorts-paket:

$ sudo port -fp uninstall installed

Installera sedan om alla MacPorts-paket som behövs för Rita med Tux. Bygg även om libimagequant med hjälp av det uppdaterade Cargo-paketet från MacPorts.

I skrivande stund kan alla bibliotek som Rita med Tux kräver från MacPorts kompileras om på det här sättet för att köras på macOS 10.10 Yosemite och senare på Intel-processorer och macOS 11.0 Big Sur och senare på Apple Silicon. Även om MacPorts har möjlighet att aktivera byggandet av universella bibliotek, kan tyvärr flera bibliotek som Rita med Tux kräver inte byggas som universella bibliotek, så de kan bara byggas för att köras nativt på den maskinvara som de byggdes på. Se "Bygga en universell binärfil" nedan för instruktioner om hur du bygger Rita med Tux som en universell binärfil.

För att bygga Rita med Tux som en Universal Binary, kompilera först Rita med Tux för Intel CPU och Apple Silicon separat. Byt sedan namn på appbunten för Intel CPU till TuxPaint-x86_64.app och bunten för Apple Silicon till TuxPaint-arm64.app, kopiera appbunten från Intel-maskinen till Apple Silicon-maskinen och använd sedan det medföljande build-universal.sh-skriptet för att kombinera de två applikationsbuntarna enligt nedan. DMG-filen kan byggas i efterhand:

$ macos/build-universal.sh
$ make TuxPaint.dmg

Du kommer att behöva senaste versioner av:

• Gradle - verktyg för byggautomatisering
• Android Studio (Software Development Kit (SDK) ) - för att stödja utveckling av Android-appar (Java)
• Android Native Development Kit (NDK) - för att stödja inbyggd utveckling i C/C++

För att kompilera den senaste Rita med Tux måste man synkronisera huvud SourceForge-projektets tuxpaint Git-förvar med GitHub-projektets TuxPaint-Android Git-förvar. (Pere använder ett skalskript som säkerhetskopierar katalogen app/src/main/jni/tuxpaint i Tuxpaint-Android GitHub-arkivet och gör en byggnad av SourceForges tuxpaint för att generera översättningar och andra saker som inte autogenereras i Android-byggnaderna, och sedan kopierar SourceForge tuxpaint tillbaka till Tuxpaint-Android) (FIXME: Det bör checkas in någonstans. För tillfället, se https://sourceforge.net/p/tuxpaint/feature-requests/224/)

För att det ska fungera behöver du källorna tuxpaint och Tuxpaint-Android bredvid varandra och skriptet i den katalog som innehåller båda.

Fyll katalogen app/src/main/assets genom att köra cd app/src/main/jni/tuxpaint && ./mkzip_assets.sh

Gradle-bygget genererar några varianter: PlayStore, debugPlayStore, offPlayStore och debugoffPlayStore. Du måste signera de som inte är debuggar för att kunna installera dem. (FIXME: Länk till information om hur man signerar.) (Obs: "playStore"-varianterna är avsedda att laddas upp till Google Play; detta hanteras för närvarande av Terrence Sheflin - mars 2023. "offPlayStore" är den smak som vi distribuerar som APK-filer på Rita med Tux-webbplatsen och SourceForge-filhosting, och är den variant som byggs av F-Droid app. repository.)

För att utlösa en build från F-droid räcker det att tagga en commit och skjuta den till GitHub. Det garanterar dock inte att byggnaden kommer att lyckas, så Pere kör vanligtvis en lokal F-droid-server för att testa byggnaden och så småningom anpassa F-droids byggkvitto innan han skjuter taggen till GitHub.

De byggnader som Pere distribuerar är alla gjorda med den lokala F-droid-servern. Det har fördelen att packa källorna och loggarna och signera APK. Viktigast av allt, det använder samma verktyg som F-Droid kommer att använda för att bygga Rita med Tux, så att du kan upptäcka problem i förväg.

Det kvitto som Pere använder för F-Droid-byggnationer finns i metadatadirektiven på https://gitlab.com/fdroid/fdroiddata. F-Droid-serverkoden finns på https://gitlab.com/fdroid/fdroidserver. För att generera servern behöver du 1 GB ledigt på disken. Kör makebuildserver-verktyget de tillhandahåller, sedan, från roten till fdroiddata, kör ../fdroidserver/fdroid build --server org.tuxpaint:N NNN (NNNN = version, t. ex. 9288)

Installera de nödvändiga utvecklingspaketen i Terminal:

32-bitars:

pkgman install xcairo_x86_devel fribidi_x86_devel gdk_pixbuf_x86_devel libiconv_x86_devel libimagequant_x86_devel gettext_x86_libintl libpaper_x86_devel pango_x86_devel libpng16_x86_devel librsvg_x86_devel libsdl2_x86_devel sdl2_image_x86_devel sdl2_gfx_x86_devel sdl2_mixer_x86_devel sdl2_pango_x86_devel sdl2_ttf_x86_devel zlib_x86_devel

64-bitars:

pkgman install xcairo_devel fribidi_devel gdk_pixbuf_devel libiconv_devel libimagequant_devel gettext_libintl libpaper_devel pango_devel libpng16_devel librsvg_devel libsdl2_devel sdl2_image_devel sdl2_gfx_devel sdl2_mixer_devel sdl2_pango_devel sdl2_ttf_devel zlib_devel

För 32-bitars måste du byta till den nya kompilatorn (för närvarande gcc 11.2.0) med setarch x86

make PREFIX=/boot/home/config/non-packaged

make install-all DATA_PREFIX=/boot/home/config/non-packaged/share/tuxpaint/

Om du installerade genvägarna i Start-menyn (standard), gå till TuxPaint-mappen och välj "Avinstallera". En ruta visas som bekräftar att du är på väg att avinstallera Rita med Tux och om du är säker på att du vill ta bort Rita med Tux permanent klickar du på knappen "Avinstallera".

När det är klart klickar du på knappen Stäng.

Det är också möjligt att använda posten "TuxPaint (endast ta bort)" i avsnittet Lägg till / ta bort program i kontrollpanelen.