Bauen Sandburgen Dokumentation Beim Bau Visual Studio-Projekt
Ich bin mit dem Sandcastle Help File Builder an output meines C# - XML-DOC-Datei auf der Website format. Wie kann ich erreichen das samething von der Kommandozeile aus, so dass ich hinzufügen kann, diese als ein Ereignis in Visual Studio, wenn der Aufbau der eigentlichen Projekt?
Ziel ist es, die website Hilfe des Datei-Inhalts gebaut beim erstellen der Visual Studio-Projekt.
Du musst angemeldet sein, um einen Kommentar abzugeben.
Als Scott Wylie angegeben, müssen Sie dieses in der post-build event command line in Visual Studio die Projekteigenschaften. Jedoch, ich würde vorschlagen, mit Sandcastle Help File Builder (SHFB), anstatt Sandburgen direkt. Es macht die Kommandozeile kurz und einfach, wie unten dargestellt, beachten Sie aber, dass Sie zunächst konfigurieren Sie die SHFB Projekt mit der SHFB GUI, das schafft ein msbuild-compatible build-Datei mit der ".shfbproj" suffix:
Beachten Sie jedoch, dass ich die gegenteilige Ansatz von dem, was Sie tun: statt mit Visual Studio interaktiv starten einen build-und Zusatz-Aktionen, ich benutze ant (nant) starten einen build von allem, was beinhaltet mein Visual Studio-Lösungen und die anschließende SHFB Aktion. Also das ist wirklich der Befehl-Linie nennen, die ich machen zum erstellen der Dokumentation mit Sandcastle:
Meine Präferenz ist, dass der gesamte Aufbau sein sollte, gestartet von der Kommandozeile aus, so gibt es keine Interaktionen benötigen (z.B. das starten von Visual Studio, etc.). Das bietet die Flexibilität, um entweder als geplante wiederkehrende Aufgabe oder on-demand aus der Schale.
Könnten Sie anrufen SandCastle aus der post-build event command line, in der Build Events-Abschnitt in Ihrem Projekt Eigenschaften. Dies sollte gut funktionieren, wenn Sie nicht mit einem automatisierten build-tool.
Wenn Sie MSBuild für euer build-tool dies ist die tutorial ich benutzte eine Weile zurück.
Gibt es auch ein Skript auf codeplex, dass Sie Aussehen kann in der Verwendung, die Ihnen helfen könnten, aus.
Hoffe, das hilft!
Ich fand es am einfachsten, einfach die *.shfbproj Projekt auf die Lösung. Es baut feine (wenn auch ein wenig langsam) innerhalb von VS 2010.