Localisation des applications ClickOnce

La localisation est le processus qui consiste à adapter votre application à une culture spécifique. Ce processus implique la traduction du texte de l'interface utilisateur (IU) dans une langue spécifique à une région, l'utilisation de la mise en forme correcte de la date et de la devise, l'ajustement de la taille des contrôles sur un formulaire et l'utilisation de la mise en miroir des contrôles de droite à gauche si nécessaire.

La localisation de votre application entraîne la création d'un ou de plusieurs assemblys satellites. Chaque assembly contient des chaînes de l'interface utilisateur, des images et d'autres ressources spécifiques à une culture donnée. (Le fichier exécutable principal de votre application contient les chaînes pour la culture par défaut de votre application.)

Cette rubrique décrit trois façons de déployer une application ClickOnce pour d'autres cultures :

  • inclure tous les assemblys satellites dans un seul déploiement ;

  • générer un déploiement pour chaque culture, en incluant un seul assembly satellite dans chacun d'entre eux ;

  • télécharger les assemblys satellites à la demande.

Inclure tous les assemblys satellites dans un déploiement

Au lieu de publier plusieurs déploiements ClickOnce, vous pouvez publier un seul déploiement ClickOnce contenant tous les assemblys satellites.

Cette méthode est utilisée par défaut dans Visual Studio. Pour l'utiliser dans Visual Studio, vous n'avez aucun travail supplémentaire à effectuer.

Pour utiliser cette méthode avec MageUI.exe, vous devez affecter à la culture de votre application la valeur Neutre dans MageUI.exe. Ensuite, vous devez inclure manuellement tous les assemblys satellites dans votre déploiement. Dans MageUI.exe, vous pouvez ajouter les assemblys satellites en utilisant le bouton Remplir sous l'onglet Fichier de votre manifeste d'application.

Cette approche a pour avantage de créer un seul déploiement et de simplifier votre opération de déploiement localisé. Au moment de l'exécution, l'assembly satellite approprié sera utilisé, selon la culture par défaut du système d'exploitation Windows de l'utilisateur. Cette approche a pour inconvénient de télécharger tous les assemblys satellites chaque fois que l'application est installée ou mise à jour sur un ordinateur client. Si votre application compte de nombreuses chaînes ou si la connexion réseau de vos clients est lente, ce processus peut affecter les performances pendant la mise à jour de l'application.

Générer un déploiement pour chaque culture

Dans cette stratégie de déploiement, vous générez plusieurs déploiements. Dans chaque déploiement, vous incluez uniquement l'assembly satellite nécessaire pour une culture spécifique, et vous marquez le déploiement comme étant spécifique à cette culture.

Pour utiliser cette méthode dans Visual Studio, définissez la propriété Langue de publication figurant dans l'onglet Publier sur la région souhaitée. Visual Studio inclura automatiquement l'assembly satellite obligatoire pour la région sélectionnée et exclura tous les autres assemblys satellites du déploiement.

Vous pouvez obtenir le même résultat en utilisant l'outil MageUI.exe dans le Kit de développement logiciel Windows Microsoft. Utilisez le bouton Remplir sous l'onglet Fichiers du manifeste de l'application pour exclure tous les autres assemblys satellites du répertoire de l'application, puis définissez le champ Culture sous l'onglet Nom du manifeste de déploiement dans MageUI.exe. Ces étapes n'incluent pas seulement l'assembly satellite correct, mais elles affectent également à l'attribut language de l'élément assemblyIdentity de votre manifeste de déploiement la culture correspondante.

Après avoir publié l'application, vous devez répéter cette étape pour chaque culture supplémentaire prise en charge par votre application. Vous devez veiller à publier systématiquement dans un répertoire de serveur Web ou un répertoire de partage de fichiers différent, car chaque manifeste d'application référencera un assembly satellite différent et chaque manifeste de déploiement aura une valeur différente pour l'attribut language.

Télécharger les assemblys satellites à la demande

Si vous décidez d'inclure tous les assemblys satellites dans un seul déploiement, vous pouvez améliorer les performances à l'aide du téléchargement à la demande, qui vous permet de marquer des assemblys comme facultatifs. Les assemblys marqués ne seront pas téléchargés lors de l'installation ou de la mise à jour de l'application. Vous pouvez installer les assemblys lorsque vous en avez besoin en appelant la méthode DownloadFileGroup sur la classe ApplicationDeployment.

Le téléchargement d'assemblys satellites à la demande diffère légèrement du téléchargement d'autres types d'assemblys à la demande. Pour obtenir des informations supplémentaires ainsi que des exemples de code sur l'activation de ce scénario à l'aide des outils du Kit de développement logiciel Windows pour ClickOnce, consultez Procédure pas à pas : téléchargement d'assemblys satellites à la demande avec l'API du déploiement ClickOnce.

Vous pouvez également activer ce scénario dans Visual Studio. Procédure pas à pas : téléchargement d'assemblys satellites à la demande avec l'API du déploiement ClickOnce à l'aide du concepteur
Procédure pas à pas : téléchargement d'assemblys satellites à la demande avec l'API du déploiement ClickOnce à l'aide du concepteur
Procédure pas à pas : téléchargement d'assemblys satellites à la demande avec l'API du déploiement ClickOnce à l'aide du concepteur
Procédure pas à pas : téléchargement d'assemblys satellites à la demande avec l'API du déploiement ClickOnce à l'aide du concepteur

Test d'applications ClickOnce localisées avant le déploiement

Un assembly satellite sera utilisé pour une application Windows Forms uniquement si la propriété CurrentUICulture pour le thread principal de l'application a pour valeur la culture de l'assembly satellite. Les clients des marchés locaux exécuteront probablement déjà une version localisée de Windows avec la valeur par défaut appropriée pour leur culture.

Trois options sont disponibles pour tester les déploiements localisés avant de rendre votre application accessible aux clients :

  • Vous pouvez lancer votre application ClickOnce sur les versions localisées appropriées de Windows.

  • Vous pouvez définir par programme la propriété CurrentUICulture dans votre application. (Cette propriété doit être définie avant d'appeler la méthode Run.)

  • Vous pouvez basculer entre les cultures sur votre système d'exploitation si vous avez installé le Pack d'interface utilisateur multilingue de Windows. Toutefois, l'interface utilisateur multilingue prend uniquement en charge un sous-ensemble de toutes les cultures possibles ; il se peut donc que cette option ne s'applique pas à votre projet.

    Pour plus d'informations sur l'interface utilisateur multilingue, consultez le portail sur l'informatique et le développement mondial Microsoft (en anglais).

    Notes

    Dans Windows Vista, vous pouvez changer de culture sans installer de packs d'interface utilisateur multilingue.

Voir aussi

Référence

<assemblyIdentity>, élément (Déploiement ClickOnce)

Concepts

Sécurité et déploiement ClickOnce

Autres ressources

Globalisation des Windows Forms