Quelles sont les règles concernant le nom de la classe principale dans Haxe ?

Question

Sur le page principale à haxe.org - il y a un jeu Rock Scissors Paper codé à l'intérieur d'une class Game .

J'ai téléchargé l'éditeur HaxeDevelop et créé un nouveau projet. Lorsque je suis allé dans le src/ de ce projet, il y avait un fichier Main.hx qui contenait ce squelette

package;

import js.Lib;

/**
 * ...
 * @author Terrence Brannon
 */
class Main 
{

    static function main() 
    {

    }

}

et je me demande si je dois changer la classe de Main a Game et où les règles pour nommer la classe d'entrée d'un projet Haxe sont documentées.

Answer 1

Les noms de classe doivent commencer par une majuscule et être suivis des lettres a-z ou A-Z (le trait de soulignement peut également être utilisé).

Vous définissez votre classe principale lorsque vous appelez la commande haxe depuis le terminal, suivie de paires de paramètres telles que le nom de la classe principale, -main Main

https://haxe.org/manual/compiler-usage.html

Vous pouvez placer votre classe dans un dossier et ajouter 'package folderName;' sur la ligne supérieure au-dessus de votre classe et ensuite vous pouvez l'appeler avec haxe.

haxe -main folderName.Main ...add other compiler property pairs.

Donc "Jeu" est un nom valide. Un détail important est que le programme Haxe nécessite une fonction statique de départ, toujours nommée 'main', qui peut être utilisée pour créer la classe.

class Game {
    static function main(){ new Game(); } // need a main static function.
    public function new(){
        // actual game class starts.
        trace( 'game started');
    }
}

Normalement, plutôt que d'écrire tous les paramètres du compilateur sur la ligne de commande, nous les mettons dans un fichier avec une extension .hxml, par exemple : compile.hxml.

https://haxe.org/manual/compiler-usage-hxml.html

Certaines boîtes à outils multiplateformes utilisent des définitions json ou xml à la place et parfois des outils pour les créer plutôt que d'exécuter directement le compilateur haxe, parce qu'ils font des choses supplémentaires comme placer tous vos actifs dans le dossier de sortie pour vous, et gérer des aspects comme les paramètres généraux pour cibler c++ ou js sans avoir à avoir différents fichiers hxml.

Par exemple, une bibliothèque graphique multiplateforme populaire pour les navigateurs, les ordinateurs de bureau et les téléphones mobiles est openfl ; elle décrit ses outils de construction ici :

https://lime.software/docs/command-line-tools/create-new-project/

Malheureusement, toutes les boîtes à outils pour jeux multi-cibles utilisent des processus de construction différents, mais les autres utilisateurs de haxe sont toujours heureux de vous expliquer.

Un bon endroit pour parler aux utilisateurs de Haxe est sur le serveur discord de Haxe, je pense que ce lien devrait probablement fonctionner :

https://discord.gg/Agt3sJA

La principale cible croisée - des boîtes à outils riches en graphiques (adaptées aux jeux) pour Haxe :

• https://www.openfl.org/ - Api similaire à flash ou avec son niveau inférieur https://lime.software/
• http://nmehost.com/ - Similaire à OpenFL mais avec des points forts différents.
• https://heaps.io/ - Le moteur original des auteurs de Haxe.
• http://kha.tech/ - approche de pipeline GPU de bas niveau.
• https://haxeflixel.com/ - Un moteur au sommet d'OpenFl
• https://armory3d.org/ - Un moteur 3D au-dessus de Kha qui fonctionne dans Blender.
• https://github.com/openfl/away3d Le célèbre moteur 3D de Flash est désormais disponible sur OpenFL
• https://github.com/BlackGoku36/Rice2D et de nombreux autres moteurs de jeux émergents..

Pour faire du développement web traditionnel, vous pouvez cibler directement les js, mais Haxe fournit également certains frameworks tels que :

• https://github.com/massiveinteractive/haxe-react
• https://github.com/MVCoconut/coconut.ui/

Et évidemment, vous pouvez utiliser Electron ( ou Krom voir Kha ) pour les applications nodejs. - https://github.com/tong/hxelectron

Je ne suis pas vraiment sûr des bibliothèques spécifiques PHP, Java, C#, Lua, Python à mentionner, mais des bibliothèques générales Haxe qui semblent être populaires et très utiles pour toutes les cibles :

• https://github.com/HaxeFoundation/format lecture/écriture de formats de fichiers
• https://github.com/polygonal/ds structures de données
• https://haxetink.github.io/tink_core/#/ outils macro
• haxeui.org/ composants
• https://github.com/armory3d/zui composants kha

Pas tout, mais un aperçu des liens utiles qui me viennent à l'esprit.

Pour des tutoriels généraux sur Haxe, il existe de nombreux endroits, mais un bon point de départ serait de travailler sur le livre de recettes.

• https://code.haxe.org/category/beginner/

Answer 2

Vous pouvez nommer votre classe de points d'entrée comme vous le souhaitez.

• Si votre fichier s'appelle Main.hx vous devez l'exécuter avec haxe -main Main .
• Si votre fichier s'appelle Game.hx, vous devez l'exécuter avec haxe -main Game .
• Si votre fichier s'appelle Test.hx, vous devez l'exécuter avec haxe -main Test .
• et cetera

Si vous utilisez FlashDevelop, vous devez définir ce fichier comme point d'entrée. Faites un clic droit dans le gestionnaire de projet et choisissez "Classe de document". Cela lui donnera aussi une icône différente (verdâtre).

Il n'existe pas de convention de dénomination standard, car cela peut dépendre de ce que fait votre application. J'ai vu Main, Application, Test mais aussi des noms plus fantaisistes.

https://haxe.org/manual/compiler-usage-hxml.html

Notez que vous ne pouvez pas utiliser un nom différent pour la fonction de point d'entrée statique à l'intérieur de la classe.
C'est toujours static function main() { } .