Il n'est pas rare lorsqu'on développe une application d'avoir besoin d'un fichier de configuration, de données XML, ou d'autres type de ressources textuelles. En Haxe, vous pouvez utiliser une API spécifique à chaque plateforme pour accéder à ces ressources :

• en les chargeant avec l'API du navigateur en JavaScript
• en les chargeant avec l'objet LoadVars en Flash
• en les lisant sur le disque avec la classe neko.File sur le serveur

Toutefois, dans le cas du chargement de l'application, il est souvent nécessaire de travailler de manière asynchrone, cela implique de démarrer le processus de chargement, afficher un message, attendre que le chargement soit terminé, puis revenir à l'execution de l'application. Si cela est utile pour des grosses ressources, vous pourriez avoir besoin d'une meilleure API pour des petits fichiers de configuration ou des données XML.

Les ressources Haxe sont un moyen de stocker le contenu des fichiers externes directement dans le code compilé/généré lors de la compilation. Vous pouvez utiliser le paramètre de commande -res pour lier un fichier ressource. Par exemple, imaginons que vous avez un fichier message_bienvenue.txt qui contient le texte suivant :

Bonjour, ceci est un message de bienvenue !

Vous pouvez ajouter le paramètre suivant dans votre fichier HXML :

-resource message_bienvenue.txt@bienvenue

Un identifiant de ressource est ajouter au nom de fichier, séparé par un arobase (@). Dans votre code, vous pouvez utiliser la classe Resource pour retrouver le contenu du fichier :

class App {
    static function main() {
        trace(haxe.Resource.getString("bienvenue"));
    }
}

Ce code va afficher le contenu du fichier message_bienvenue.txt au moment ou le code à été compilé. Avec cette méthode, vous n'avez pas besoin de distribuer les fichiers externes qui sont liés à l'application.