Dépendances
Une dépendance est un assembly dont une cible a besoin : un assembly fusionné dans la cible, incorporé à celle-ci comme ressource, ou utilisé uniquement pour résoudre ses références.
Types de dépendances
Une dépendance relie un assembly source à une cible, et son type indique au moteur ce qu’il doit faire de l’assembly source.
| Type | Effet |
|---|---|
| Fusionner | L’assembly source est fusionné dans la cible et obfusqué avec elle, ce qui produit un seul assembly de sortie. Voir Fusion des assemblies. |
| Incorporer | L’assembly source est stocké comme ressource de la cible et chargé à l’exécution. Voir Incorporation des assemblies. |
| Référence | L’assembly source sert uniquement à résoudre les références de la cible. |
Une dépendance utilise toujours le fichier d’origine de l’assembly. Lorsque ce même assembly est aussi une cible du projet, la dépendance ne tient compte ni des paramètres ni de la sortie de cette cible, et elle ne modifie pas l’ordre d’exécution des cibles.
Relier une dépendance
Sur le canevas, le point d’ancrage supérieur d’une cible relie ses dépendances. Faites glisser du point d’ancrage inférieur de l’assembly source vers le point d’ancrage supérieur de la cible, ou cliquez sur les deux points l’un après l’autre. La source peut être un nœud de dépendance ou une autre cible. Esc annule une connexion en cours de tracé.
Babel Desktop choisit le type de la nouvelle dépendance. Si la cible référence l’identité exacte de l’assembly source (nom, version, culture et jeton de clé publique), la nouvelle dépendance est de type Fusionner ; sinon, elle est de type Référence.
Vous pouvez aussi ajouter des dépendances à partir d’un sélecteur de fichiers :
- Dans le menu du nœud d’une cible, ou avec + Ajouter une dépendance dans la barre d’outils : Ajouter des assemblies à fusionner…, Ajouter des assemblies à incorporer…, Ajouter des références d’assembly… et Ajouter une dépendance automatiquement….
- Dans la palette de commandes : Assembly : ajouter entrée de fusion…, Assembly : ajouter assembly incorporé…, Assembly : ajouter référence… et Assembly : ajouter une dépendance automatiquement… agissent sur la cible sélectionnée.
- Dans la grille, avec l’icône + de l’onglet Entrées, ou en déposant des assemblies sur une ligne. Voir Détails de la cible.
Un assembly utilisé comme entrée de fusion reste sur le canevas, mais il n’est pas obfusqué séparément, puisqu’il fait désormais partie de sa destination.
Changer le type
Cliquez sur une ligne de dépendance sur le canevas. Une fenêtre contextuelle affiche le fichier source, une remarque et une liste Type. Choisissez Fusionner, Incorporer ou Référence, puis cliquez sur Appliquer.
Changer le type d’une dépendance
Le menu d’un nœud de dépendance propose les trois mêmes types. Dans la grille, la liste Action de chaque entrée de l’onglet Entrées change le type.
Fusionner une cible dans une autre
Lorsqu’un assembly est déjà une cible du projet, Fusionner dans… et Incorporer dans…, dans le menu de son nœud, répertorient les autres cibles. Choisissez-en une : l’assembly devient une dépendance de fusion ou d’incorporation de celle-ci. Une cible fusionnée dans une autre conserve son nœud, n’est pas obfusquée seule et n’écrit pas de fichier de mappage des renommages ; la grille l’affiche dans l’onglet Entrées de la cible qui la fusionne et la compte dans l’en-tête, par exemple 3 cibles · 4 fusionnés.
Obfuscation : configurer la fusion dans l’assembly principal effectue cette opération pour toutes les cibles du projet à la fois. Voir Commandes de configuration.
Supprimer une dépendance
Cliquez sur une ligne de dépendance et appuyez sur Delete ou Backspace, ou choisissez Supprimer la dépendance dans le menu du nœud de dépendance. Dans la grille, cliquez sur la corbeille de l’entrée dans l’onglet Entrées.