MSBuild Community Tasks Documentation

Question

¿Soy yo o la documentación de este proyecto es realmente escasa?

Estoy tratando de encontrar cómo usar el FtpCreateRemoteDirectory y la funcionalidad de FTP en general, pero no puedo encontrar nada.

googlear FtpCreateRemoteDirectory, sólo se muestra el código fuente del proyecto ...

Answer 1

La documentación es como usted dice muy escasa. El mejor que he encontrado es descargar el último código fuente aquí: https://github.com/loresoft/msbuildtasks

La documentación más reciente también se puede ver a través de GitHub directamente sin necesidad de descargar la fuente: https://github.com/loresoft/msbuildtasks/tree/master/Documentation

Si se instala utilizando el MSI, también se puede ver en el XSD que se encuentra en la carpeta de instalación (C: \ Archivos de programa (x86) \ MSBuild \ MSBuildCommunityTasks \ MSBuild.Community.Tasks.xsd) para al menos ver qué tareas están disponibles para usted y la documentación relacionada con ellas.

Answer 2

Puede usar el XSD para verificar también las opciones disponibles.

Saludos.

Answer 3

Las últimas versiones de Github no incluyen documentación (issue #24).

Las versiones anteriores de Tigris incluyen documentación en forma de archivo CHM: después de instalar MSBuild.Community.Tasks.msi desde project download page, la documentación se encuentra en la carpeta de instalación. La ruta típica es "C: \ Archivos de programa (x86) \ MSBuild \ MSBuildCommunityTasks \ MSBuild.Community.Tasks.chm".

Answer 4

Encontré esto porque estaba buscando la misma información, así que también puedo agregar un ejemplo de un objetivo MSBuild completo que crea una carpeta FTP y luego copia los contenidos en la nueva ubicación. NB: el ejemplo se carga en un sitio seguro, por lo que es posible que deba cambiar el número de puerto para adaptarlo a su situación.

<Project DefaultTargets="Build" xmlns="http://schemas.microsoft.com/developer/msbuild/2003"> 
<Import Project="$(MSBuildExtensionsPath)\MSBuildCommunityTasks\MSBuild.Community.Tasks.Targets" /> 

    <Target Name="MSBuildFTP">  

    <PropertyGroup> 
     <ftpHost>Your Host</ftpHost> 
     <ftpUser>Your username</ftpUser> 
     <ftpPass>you guessed it.. your password</ftpPass> 
    </PropertyGroup> 

    <Message Text="Create the directory if it does not exist - FtpUploadDirectoryContent fails if the dir does not exist" /> 
    <FtpCreateRemoteDirectory 
     ServerHost="$(ftpHost)" 
     Port="21" 
     Username="$(ftpUser)" 
     Password="$(ftpPass)" 
     RemoteDirectory="SSL/secure/" 
     /> 

    <Message Text="Copy the contents of our directory to the ftp location" /> 
    <FtpUploadDirectoryContent 
     ServerHost="$(ftpHost)" 
     Port="21" 
     Username="$(ftpUser)" 
     Password="$(ftpPass)" 
     LocalDirectory="deployment" 
     RemoteDirectory="SSL/secure" 
     Recursive="false" 
     /> 
    </Target> 
</Project> 

Answer 5

La documentación es sublime, pero falta por completo. Sin embargo, el código es realmente fácil de leer, al menos para conocer las tareas disponibles y sus entradas/salidas.

La manera de hacerlo:

1. Instalar un descompilador .NET como Jetbrains dotPeek (o algún otro clon libre de .NET Reflector).

2. PM> Install-Package MSBuildTasks (de VS) O
   > nuget install MSBuildTasks (de la línea cmd)

3. abierto slnDir\.build\MSBuild.Community.Tasks.dll en el dotPeek mencionado más arriba, navega al espacio de nombres MSBuild.Community.Tasks y haga doble clic en la tarea que le interesa.

4. ¡Beneficio!