Cette documentation est archivée et n’est pas conservée.

Déploiement et localisation 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 :

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

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

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

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, affectez la propriété Langue de publication de l'onglet Publier à la région souhaitée. Visual Studio inclura automatiquement l'assembly satellite requis 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 .NET Framework SDK Microsoft. Utilisez le bouton Populate sur l'onglet Files de votre manifeste d'application pour exclure tous les autres assemblys satellites du répertoire de l'application, puis définissez le champ Culture sur l'onglet Name pour votre manifeste de déploiement dans MageUI.exe. Non seulement ces étapes incluent l'assembly satellite correct, mais elles affectent également l'attribut language sur 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 dans un répertoire de serveur Web ou un répertoire de partage de fichiers différent à chaque fois, 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.

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.

Pour utiliser cette méthode, vous devez affecter la valeur par défaut à la culture de votre application, c'est-à-dire la valeur (Par défaut) dans Visual Studio et neutral dans MageUI.exe. Ensuite, vous devez inclure manuellement tous les assemblys satellites dans votre déploiement. Cette opération s'effectue dans Visual Studio à l'aide de la boîte de dialogue Fichiers d'application accessible via la page de propriétés Publier. Dans MageUI.exe, vous pouvez ajouter les assemblys satellites en utilisant le bouton Populate sur l'onglet Files 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 provoquer une dégradation modérée des performances pendant la mise à jour de l'application.

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 .NET Framework SDK 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
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 exécuter 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 Microsoft Global Development and Computing Portal (en anglais).

Voir aussi

Afficher: