Construire Des Châteaux De Sable De La Documentation Lors De La Construction De Projet Visual Studio
Je suis en utilisant le Sandcastle Help File Builder à la sortie de mon C#, XML, DOC fichier vers le Site web de format. Comment puis-je accomplir la samething à partir de la ligne de commande afin que je puisse l'ajouter comme un événement de construction dans Visual Studio lors de la construction de ce projet?
L'objectif final est d'avoir le site web de contenu de Fichier d'Aide intégré lorsque je construire le projet Visual Studio.
OriginalL'auteur John Chapman | 2011-10-24
Vous devez vous connecter pour publier un commentaire.
Que Scott Wylie indiqué, vous avez besoin de le préciser dans le post événement de construction de la ligne de commande dans Visual Studio propriétés du projet. Cependant, je suggère à l'aide de Sandcastle Help File Builder (SHFB) plutôt que de Châteaux de sable directement. Il fait l'appel en ligne de commande simple et court comme indiqué ci-dessous, mais notez que vous devez d'abord configurer le SHFB projet avec la SHFB GUI, ce qui crée un msbuild-compatible construire le fichier avec l' ".shfbproj" suffixe:
Cependant, noter que je prends le contre-pied de ce que vous faites: au lieu d'utiliser Visual Studio pour lancer une lancer un build et accessoires actions, j'utilise ant (nant) pour lancer un build de tout, qui comprend mes solutions Visual Studio et suivantes SHFB action. Donc, c'est vraiment la ligne de commande, appelez-je faire pour construire la documentation de Châteaux de sable:
Ma préférence est que l'intégralité de construire devrait être lancé depuis la ligne de commande, donc il n'y a pas d'interactions nécessaires (par exemple, le lancement de Visual Studio, etc.). Qui fournit la flexibilité nécessaire pour s'exécuter comme prévu tâche périodique ou à la demande de la coquille.
BTW, quand j'utilise l'Aide du Générateur de le compiler à la place de MSBuild, il faut environ 2 minutes. Ajouter à la post-construction a couru plus d'une heure à 100% d'utilisation CPU jusqu'à ce que je viens de l'a tué.
Qu'est-ce que cette "Aide Builder" dont vous parlez? Est-ce quelque chose inclus dans le SHFB paquet?
OriginalL'auteur Michael Sorens
On pourrait appeler de Châteaux de sable de l'événement post-construction de la ligne de commande, dans les Événements de construction de la section de vos propriétés du projet. Cela devrait fonctionner correctement si vous n'utilisez pas toute la génération automatique d'outil.
Comment faire concrètement? J'ai trouvé un moyen d'appeler MSBuild contre le château de sable fichier de projet, cependant, il commence de plus de 1000 séparé MSBuild processus et verrouille l'ordinateur (ne pas le faire lors de la construction de l'interface graphique).
OriginalL'auteur Scott Wylie
Si vous êtes à l'aide de MSBuild pour votre outil build c'est le tutoriel j'ai utilisé un certain temps en arrière.
Il y a aussi un script sur codeplex que vous pouvez regarder dans l'aide qui pourrait vous aider.
Espérons que cette aide!
OriginalL'auteur ajrawson
Je l'ai trouvé plus facile de simplement ajouter l' *.shfbproj projet à la solution. Il s'appuie très bien (bien qu'un peu lentement) à l'intérieur de VS 2010.
OriginalL'auteur Robert Bratton