Internationalisation / Localisation

À partir de la version 3.5.0 du Wrapper, le code a été internationalisé et peut s'exécuter de manière localisée. Dans un premier temps, les langues disponibles sont l'anglais, l'allemand et le japonais, mais nous espérons fournir progressivement de plus en plus de localisations.

Fichiers de localisation

Le Wrapper chargera le fichier de localisation au démarrage, en fonction de la langue du système d'exploitation. Il est également possible de charger une langue explicitement spécifiée dans la propriété wrapper.lang. Si le Wrapper ne prend pas en charge une langue, c'est-à-dire si les fichiers de localisation n'ont pas été trouvés, le Wrapper tentera de se rabattre, d'abord, sur la langue du système d'exploitation ; si cela échoue également, il se rabattra ensuite sur l'anglais.

Afin de pouvoir exécuter le Wrapper entièrement localisé, 2 fichiers de ressources sont nécessaires : Les fichiers se trouvent dans le répertoire [wrapper]\lang.

  • Fichier « wrapper_XX.mo » :

    Ce fichier contient les messages localisés du binaire du Wrapper (par ex. wrapper.exe)

  • Fichier « wrapperjni_XX.mo » :

    Ce fichier contient les messages localisés de la bibliothèque Wrapper (par ex. wrapper.dll) et de l'API Java du Wrapper (par ex. wrapper.jar)

Le « XX » dans les noms de fichiers est l'abréviation de la langue (valeurs possibles par exemple en, ja, de, etc.).

Fichier « wrapperTestApp_XX.mo » :

Outre les fichiers de ressources wrapper_XX et wrapperjni_XX, vous remarquerez peut-être qu'il existe un 3e fichier mo appelé wrapperTestApp_XX.mo. Ce fichier contient les messages localisés de l'application d'exemple TestWrapper et de l'application DemoApp. Ce fichier n'est pas nécessaire si vous exécutez vos propres applications avec le Wrapper, et il est donc possible de le supprimer sans risque lors du déploiement. Les applications TestWrapper et DemoApp utilisent la classe WrapperResources. Cette API est publique et peut être utilisée pour n'importe quelle application Java. Pour plus d'informations sur l'utilisation du Wrapper afin de localiser votre application Java, veuillez consulter la page « API de localisation ».

NOTE

Depuis la version 3.5.38 du Wrapper, le Wrapper continuera silencieusement si un fichier mo n'a pas été trouvé dans le répertoire lang spécifié. Cela permet à l'utilisateur d'ignorer la localisation en supprimant simplement les fichiers de langue indésirables. On peut également souhaiter localiser uniquement les messages de l'application Java, ou uniquement les messages du Wrapper, en conservant les fichiers de langue appropriés.

Encodage dans les fichiers de configuration

Le Wrapper lit le fichier de configuration en utilisant l'encodage déclaré sur la première ligne du fichier. Lors de l'utilisation de caractères non ASCII, veuillez vous assurer qu'ils sont pris en charge par le jeu de caractères spécifié. Il est conseillé d'utiliser UTF-8, qui prend en charge un large éventail de caractères de différentes localisations.

Exemple : (Définition de l'encodage du fichier de configuration sur UTF-8) 
@encoding=UTF-8
# Configuration files must begin with a line specifying the encoding
#  of the file.

Jusqu'à présent, les encodages pris en charge pour le fichier de configuration sont :

NOTE

Si l'en-tête @encoding n'a pas été défini, le Wrapper n'essaiera pas de convertir les caractères et lira le fichier de configuration dans l'encodage système actuel dans lequel le Wrapper s'exécute.