TUER

TUER : Truly Unusual Experience of Revolution® (Expérience de révolution vraiment inhabituelle)

Jeu de tir en vue subjective gratuit et libre (à des fins non commerciales) écrit en Java par Julien Gouesse

Accueil Blog Documentation Jouer Images Vidéos Projet Contact

Sommaire:

Comment générer et lancer le jeu
JNDT: Java Native Deployment Toolkit

Comment générer et lancer le jeu

Logiciels requis

Vous avez besoin de ces programmes pour utiliser mon jeu à des fins de développement :

Kit de développement Java 21 ou supérieur : ici, ici ou dans le dépôt officiel de votre distribution GNU Linux
Git
Gradle: ici (déjà supporté et livré avec les EDI majeurs tel qu'Eclipse et Netbeans)
ANT: ici (déjà supporté et livré avec les EDI majeurs tel qu'Eclipse et Netbeans)

Dépôts du code source

Ce sont les URIs des dépôts Git pour toutes les versions :

accès en lecture seule
- https://git.code.sf.net/p/tuer/git/alpha/ (version alpha abandonnée qui utilise mon propre moteur)
- https://git.code.sf.net/p/tuer/git/tuer/ (version pré-bêta abandonnée qui utilise JMonkeyEngine 2.0)
- https://git.code.sf.net/p/tuer/git/pre_beta/ (version pré-bêta courante qui utilise JogAmp's Ardor3D Continuation)
accès en lecture/écriture (réservé aux contributeurs du projet)
- https://gouessej@git.code.sf.net/p/tuer/git/alpha/ (version alpha abandonnée qui utilise mon propre moteur)
- https://gouessej@git.code.sf.net/p/tuer/git/tuer/ (version pré-bêta abandonnée qui utilise JMonkeyEngine 2.0)
- https://gouessej@git.code.sf.net/p/tuer/git/pre_beta/ (version pré-bêta courante qui utilise JogAmp's Ardor3D Continuation)

Étapes de génération

Tapez ceci quand vous êtes dans le répertoire d'ANT pour télécharger les JARs requis par quelques têches optionnelles : ./bin/ant networking -f fetch.xml -Ddest=system

Veuillez suivre une de ces méthodes :

En ligne de commande, suivez ces étapes :
- tapez ceci pour obtenir le code source : git clone URL_du_dépôt_Git
- tapez ceci pour construire le projet avec Ant : ant build
- tapez ceci pour lancer le jeu avec Ant : ant run-game
- tapez ceci pour construire le projet avec Gradle : gradle build
- tapez ceci pour lancer le jeu avec Gradle : gradle run
- tapez ceci pour lancer l'éditeur avec Gradle : gradle runEditor
Dans Eclipse (version 4.15.0 ou supérieure), avec Subclipse (version 1.6.0 ou supérieure), suivez ces étapes :
- Faites un clic droit dans la zone de paquetage
- Sélectionnez "Import projects..."
- Ouvrez le répertoire "Git"
- Sélectionnez "Projects from Git (with smart import)"
- Cliquez sur "Next"
- Sélectionnez "Clone URI"
- Cliquez sur "Next"
- Entrez l'URI du dépôt Git dans le champ de texte "URI"
- Cliquez sur "Next"
- Sélectionnez la branche nommée "master"
- Cliquez sur "Next"
- Sélectionnez un répertoire de destination
- Cliquez sur "Next"
- Cliquez sur "Finish"
- Suivez ces étapes pour construire le projet avec Ant dans Eclipse :
  - Allez dans le menu "Window" → "Show view" → "Ant"
  - Glissez et déposez le fichier build.xml dans la vue ANT
  - Faites un doucle clic sur la cible "build" dans cette vue pour construire le projet
  - Faites un doucle clic sur la cible "run-game" dans cette vue pour lancer le jeu
Dans Netbeans (version 11.0 ou supérieure), suivez ces étapes :
- Allez dans le menu "Team" → "Subversion" → "Checkout..."
- Entrez l'URL du dépôt Git en tant que "Repository URL"
- Cliquez sur "Next"
- Cliquez sur "Finish"
- Attendez un moment
- Un popup titré "Checkout Completed" apparait, cliquez sur "Create Project..."
- Sélectionnez "Java Project with Existing Sources"
- Cliquez sur "Next"
- Entrez un nom de projet et cliquez sur "Next"
- Dans la section "Source Package Folders", cliquez sur "Add Folder..." et sélectionnez le seul répertoire
- Cliquez sur "Next"
- Cliquez sur "Finish"
- Dans l'onglet "project", sélectionnez le noeud "Libraries" → "Add JAR/Folder" et sélectionnez tous les JARs de tous les sous-répertoires du répertoire "lib"
- Allez dans l'onglet "project" → "Source packages" → "default package" → build.xml → build → "Run Target" pour construire le projet
- Allez dans l'onglet "project" → "Source packages" → "default package" → build.xml → run-game → "Run Target" pour lancer le jeu
Dans les autres EDIs, débrouillez-vous, je n'ai pas de temps à perdre avec les EDIs propriétaires et ceux avec une audience confidentielle

Code source des dépendances

Vous pouvez obtenir le code source de toutes les dépendances ici :

TUER requiert moins de 32 Mo (la dernière version peut requérir plus de 64 Mo) mais quelques programmes utilisés pour précalculer ses données requièrent 1 Go voire même 2 Go. N'essayez pas de construire le jeu à partir du code source si votre ordinateur n'a pas assez de RAM. Utilisez l'argument de la machine virtuelle "-Xmx" si une carte particulière a besoin de plus de mémoire.

JNDT: Java Native Deployment Toolkit

Introduction

JNDT est utilisé pour générer les paquets applicatifs natifs autonomes du projet. Il fait à partir d'un "fat JAR" des bundles faciles à déployer et à installer. Il génère à la fois des installeurs natifs pratiques avec une intégration complète dans le bureau et des archives comme solutions de repli.

C'est un empaqueteur multi-plateforme, c'est-à-dire qu'il est à la fois capable de tourner sous plusieurs systèmes d'exploitation et de générer des paquets natifs pour un système d'exploitation différent de celui sur lequel il s'exécute.

N.B : JNDT supporte Java 9 et supérieur. Comme il utilise une licence virale (GPL version 2) et comme il injecte un bout de son propre code source dans les paquets, son utilisation est permise uniquement aux programmes utilisant une licence compatible.

Code source

Le code source de JNDT est dans un seul fichier de bibliothèque Ant ici.

Configuration

Les dépendances de JNDT sont ici, vous devez les copier dans un répertoire et renseigner la valeur de la propriété Ant "jndtlibdir" avec ce chemin ("lib/ant" dans l'exemple ci-dessous) :

<property name="jndt-version" value="0.0.0"/>
<property name="jndt-release" value="0"/>
<property name="jndt-jar-filename" value="jndt-${jndt-version}-${jndt-release}.jar"/>
<property name="jndtlibdir" value="lib/ant"/>
<taskdef resource="jndt/antlib.xml" classpath="${jndtlibdir}/${jndt-jar-filename}"/>

Nullsoft Scriptable Install System (NSIS), disponible dans de nombreuses distributions GNU Linux, sous Microsoft Windows et sous Mac OS X, doit être installé séparément pour générer un installeur pour Microsoft Windows.

Manuel des tâches Ant

JNDT est composé des 4 tâches Ant ci-dessous:

create-app-dir

Crée le répertoire de l'application, c'est-à-dire le répertoire contenant les fichiers nécessaires pour lancer l'application, son JAR, ses ressources (optionnelles), son JRE (optionnel), le lanceur natif ou le script de démarrage et les fichiers pour l'intégration native dans le bureau (l'icône, ...).

Attribut	Description	Requis
os	Un parmi Linux, Mac OS X, Windows (similaire à l'attribut 'os' de la balise 'resources' en JNLP)	Oui
arch	Un parmi i386, amd64, universal, arm, none (similaire à l'attribut 'arch' de la balise 'resources' en JNLP mais simplifié). 'none' est supporté seulement avec jdk mis à ''	Oui
executable	nom du script, sans extension telle que .bat et .sh	Oui
linuxpackageshscriptenabled	crée un script shell simplifié portable utilisé en tant que lanceur pour n'importe quel paquetage GNU Linux si "true" et si "os" est mis à 'Linux'	Non, par défaut à "false"
appjar	emplacement du fichier JAR à empaqueter	Oui
appname	nom de l'application, obligatoire pour construire le nom de paquetage si "linuxpackageshscriptenabled" est mis à "true"	Non, à moins que linuxpackageshscriptenabled soit "true", par défaut à ""
outdir	répertoire de sortie	Oui
vmargs	liste d'arguments pour la JVM, séparés par ';', par exemple -Xmx1G	Non, par défaut à ";"
jdk	emplacement du fichier ZIP ou URL du build d'OpenJDK contenant le JRE, peut être vide pour utiliser le JRE du système	Oui
resources	liste des fichiers et des répertoires à empaqueter à côté du script, séparés par ';'	Non, par défaut à ";"
bundleidentifier	identifiant du bundle similaire à un nom de paquetage Java	Non, par défaut à "com.yourcompany.identifier"
iconsfile	fichier d'icônes (obligatoirement .png pour GNU Linux, .ico pour Windows, .icns pour Mac)	Non, par défaut à ""
useserverjre	utilise le JRE serveur si "true", sinon utilise le JRE client	Non, par défaut à "true"

create-linux-app-bundles

Crée un paquetage RPM, un paquetage DEB et une archive pour GNU Linux.

Attribut	Description	Requis
executable	nom du script, sans extension telle que .sh	Oui
packageexecutabledir	directory containing the executable after the install of a RPM or DEB package	Non, par défaut à "/usr/bin"
packageshscriptenabled	creates a simplified portable two-line shell script used as a launcher for any GNU Linux package if true	Non, par défaut à "true"
appjar	emplacement du fichier JAR à empaqueter	Oui
appname	nom de l'application	Oui
outdir	répertoire de sortie	Oui
vmargs	liste d'arguments pour la JVM, séparés par ';', par exemple -Xmx1G	Non, par défaut à ";"
jdk	emplacement du fichier ZIP ou URL du build d'OpenJDK contenant le JRE, peut être vide pour utiliser le JRE du système	Oui
resources	liste des fichiers et des répertoires à empaqueter à côté du script, séparés par ';'	Non, par défaut à ";"
bundleidentifier	identifiant du bundle similaire à un nom de paquetage Java	Non, par défaut à "com.yourcompany.identifier"
iconsfile	fichier d'icônes (obligatoirement au format .png)	Non, par défaut à ""
useserverjre	utilise le JRE serveur si "true", sinon utilise le JRE client	Non, par défaut à "true"
arch	Un parmi i386, amd64, arm, none (similaire à l'attribut 'arch' de la balise 'resources' en JNLP mais simplifié). 'none' est supporté seulement avec jdk mis à ''	Oui
categories	liste de catégories séparées par ";", utilisée pour mettre le raccourci dans le menu de démarrage, voir https://standards.freedesktop.org/menu-spec/latest/apa.html	Non, par défaut à ""
comment	commentaire du raccourci	Non, par défaut à ""
vendor	organisation qui distribue le logiciel	Non, par défaut à ""
packager	organisation qui a empaqueté le logiciel	Non, par défaut à ""
license	licence	Non, par défaut à ""
summary	description courte du logiciel empaqueté (généralement sur une seule ligne)	Non, par défaut à ""
description	description détaillée du logiciel empaqueté (peut prendre plus d'une ligne)	Non, par défaut à ""
group	chaine composée d'une série de mots séparés par des slashes qui définit comment le logiciel empaqueté devrait être groupé avec les autres paquetages	Non, par défaut à "Applications"
section	classifieur de l'application pour le paquet Debian, voir https://www.debian.org/doc/debian-policy/ch-archive.html#s-subsections	Non, par défaut à "java"
version	version	Non, par défaut à "0.0"
release	release	Non, par défaut à "0"
host	hôte (codebase)	Non, par défaut à ""
url	URL de la page d'accueil, généralement pointant vers la documentation du logiciel en train d'être empaqueté	Non, par défaut à ""
email	email	Non, par défaut à ""
distribution	distribution GNU Linux cible	Non, par défaut à "unknown"
priority	l'importance pour l'utilisateur d'avoir ce paquet installé : required, important, standard, optional ou extra	Non, par défaut à "optional"
urgency	l'importance d'upgrader vers cette version depuis la précédente : low, medium, high, emergency, ou critical suivi d'un commentaire optionnel	Non, par défaut à "low"
essential	si le système de gestion des paquets refusera de supprimer le paquetage	Non, par défaut à "no"
debdepends	dépendances du paquet Debian, peut finir par ':any' (voir 'multiarch')	Non, par défaut à ""
multiarch	support de multiple architectures, voir https://wiki.ubuntu.com/MultiarchSpec	Non, par défaut à "no"
docdir	répertoire contenant la documentation	Non, par défaut à ""
docdirincludes	filtre d'inclusion du répertoire de la documentation	Non, par défaut à "*"
archivefileformat	format de fichier d'archive, avec ou sans compression: zip, gzip, bzip2, tar	Non, par défaut à "gzip"

create-os-x-app-bundle

Crée un fichier APP compressé pour Mac OS X.

Attribut	Description	Requis
arch	Un parmi universal, none (similaire à l'attribut 'arch' de la balise 'resources' en JNLP mais simplifié). 'none' est supporté seulement avec jdk mis à ''	Non, par défaut à "universal"
executable	nom du script, sans extension telle que .sh	Oui
appjar	emplacement du fichier JAR à empaqueter	Oui
appname	nom de l'application	Oui
outdir	répertoire de sortie	Oui
vmargs	liste d'arguments pour la JVM, séparés par ';', par exemple -Xmx1G	Non, par défaut à ";"
jdk	emplacement du fichier ZIP ou URL du build d'OpenJDK contenant le JRE, peut être vide pour utiliser le JRE du système	Oui
resources	liste des fichiers et des répertoires à empaqueter à côté du script, séparés par ';'	Non, par défaut à ";"
bundleidentifier	identifiant du bundle similaire à un nom de paquetage Java	Non, par défaut à "com.yourcompany.identifier"
iconsfile	fichier d'icônes (obligatoirement au format .icns)	Non, par défaut à ""
useserverjre	utilise le JRE serveur si "true", sinon utilise le JRE client	Non, par défaut à "true"
version	version	Non, par défaut à "0.0"
release	release	Non, par défaut à "0"
docdir	répertoire contenant la documentation	Non, par défaut à ""
docdirincludes	filtre d'inclusion du répertoire de la documentation	Non, par défaut à "*"
archivefileformat	format de fichier d'archive, avec ou sans compression: zip, gzip, bzip2, tar	Non, par défaut à "bzip2"

create-windows-app-bundles

Crée une archive d'application compressée et un installeur pour Microsoft Windows.

Attribut	Description	Requis
executable	nom du script, sans extension telle que .bat	Oui
appjar	emplacement du fichier JAR à empaqueter	Oui
appname	nom de l'application	Oui
outdir	répertoire de sortie	Oui
vmargs	liste d'arguments pour la JVM, séparés par ';', par exemple -Xmx1G	Non, par défaut à ";"
jdk	emplacement du fichier ZIP ou URL du build d'OpenJDK contenant le JRE, peut être vide pour utiliser le JRE du système	Oui
resources	liste des fichiers et des répertoires à empaqueter à côté du script, séparés par ';'	Non, par défaut à ";"
bundleidentifier	identifiant du bundle similaire à un nom de paquetage Java	Non, par défaut à "com.yourcompany.identifier"
iconsfile	fichier d'icônes (obligatoirement au format .ico)	Non, par défaut à ""
useserverjre	utilise le JRE serveur si "true", sinon utilise le JRE client	Non, par défaut à "true"
version	version	Non, par défaut à "0.0"
release	release	Non, par défaut à "0"
arch	Un parmi i386, amd64, arm, none (similaire à l'attribut 'arch' de la balise 'resources' en JNLP mais simplifié). 'none' est supporté seulement avec jdk mis à ''	Oui
docdir	répertoire contenant la documentation	Non, par défaut à ""
docdirincludes	filtre d'inclusion du répertoire de la documentation	Non, par défaut à "*"
archivefileformat	format de fichier d'archive, avec ou sans compression: zip, gzip, bzip2, tar	Non, par défaut à "bzip2"
licensefile	Fichier texte (.txt ou .rtf) contenant les termes de licence affichés durant l'installation, seulement utilisé par l'installeur	Non, par défaut à ""