Документация по задачам сообщества MSBuild [закрыта]

Мне кажется, или документации по этому проекту действительно мало?

Я пытаюсь найти, как использовать FtpCreateRemoteDirectory и функции FTP в целом, но ничего не могу найти.

Поиск в Google FtpCreateRemoteDirectory показывает только исходный код проекта...


person Bertvan    schedule 21.09.2010    source источник


Ответы (5)


Документация, как вы говорите, очень скудная. Лучшее, что я нашел, это загрузить последний исходный код здесь: https://github.com/loresoft/msbuildtasks

Последнюю документацию также можно просмотреть напрямую через GitHub, не загружая исходный код: https://github.com/loresoft/msbuildtasks/tree/master/Documentation

Если вы установили с помощью MSI, вы также можете посмотреть XSD, найденный в папке установки (C:\Program Files (x86)\MSBuild\MSBuildCommunityTasks\MSBuild.Community.Tasks.xsd), чтобы хотя бы увидеть, какие задачи вам доступны. и связанная с ними документация.

person Benjamin Baumann    schedule 21.09.2010
comment
даже поиск по FtpCreateRemoteDirectory в .chm не дает результатов :( - person Bertvan; 21.09.2010
comment
Но на самом деле, исходный код - это то, что нужно :), спасибо! - person Bertvan; 22.09.2010
comment
ИМХО Это все должно быть на веб-странице. Слишком сложно отслеживать файлы .chm. Не могу найти файл .chm в Google. - person NealWalters; 11.01.2012
comment
Возможно, кто-то мог бы написать задачу MSBuild, которая не позволяла бы людям добавлять задачи MSBuild, не имеющие документации? :-) Конечно, это будет страдать от парадокса курицы/яйца, но неважно! - person Steve L; 22.07.2014
comment
Ссылка на последний Overview.html - person Geoff; 12.08.2015

Последние выпуски на Github не включают документацию (issue #24).

Старые выпуски Tigris содержат документацию в виде файла CHM: После установки MSBuild.Community.Tasks.msi из страница загрузки проекта, документация находится в папке установки. Типичный путь — «C:\Program Files (x86)\MSBuild\MSBuildCommunityTasks\MSBuild.Community.Tasks.chm».

person Edward Brey    schedule 08.02.2012
comment
В последних выпусках продукта файл справки НЕ находится в том месте, на которое вы ссылаетесь. Я бы предложил удалить ваш ответ или изменить его на правильное место. - person bsara; 25.04.2013
comment
@Brandon: установка для версии 1.2.0.306 (последняя) по-прежнему включает документацию в том же месте. Что нужно проверить: 1. Загрузите двоичный файл, а не исходный код (т. е. пакет без номера версии в названии). 2. Убедитесь, что функция документации включена во время установки (по умолчанию включена). 3. Папка установки зависит от системы (например, в типичной 32 ОС она находится в папке C:\Program Files\MSBuild). - person Edward Brey; 26.04.2013
comment
Установил 1.4.0.72 из .msi, без .chm. - person Per Lundberg; 22.05.2014
comment
@PerLundberg: К сожалению, открытая проблема с новыми выпусками GitHub заключается в том, что они не т включить документацию. - person Edward Brey; 22.05.2014

Документация великолепна, но отсутствует полностью. Тем не менее, код действительно легко читается — по крайней мере, для поиска доступных задач и их входов/выходов.

Как я это делаю:

  1. Установите декомпилятор .NET, например Jetbrains dotPeek (или любой другой бесплатный клон .NET Reflector).

  2. PM> Install-Package MSBuildTasks (из VS) ИЛИ
    > nuget install MSBuildTasks (из строки cmd)

  3. Откройте slnDir\.build\MSBuild.Community.Tasks.dll в вышеупомянутом dotPeek, перейдите в пространство имен MSBuild.Community.Tasks и дважды щелкните интересующую вас задачу.

  4. Выгода!

введите здесь описание изображения

person Cristian Diaconescu    schedule 04.04.2013
comment
Это действительно работает, но, поскольку это открытый исходный код, вы также можете просто посмотреть исходный код, как указано в ответе? (stackoverflow.com/a/3762871/65087) - person Bertvan; 04.04.2013
comment
В этом случае я считаю, что быстрее всего просто декомпилировать. Все части уже есть в моей системе (декомпилятор и сборка). Достаточно двойного щелчка, и я в знакомом интерфейсе, готовом читать код. Мне все труднее и медленнее добраться до того же фрагмента кода в Интернете (где находится домашняя страница проекта? Где теперь размещен код? Где кнопка «Обзор исходного кода» для Github/Codeplex/Bitbucket/и т. д.? Теперь, где этот файл, который я необходимость?) - person Cristian Diaconescu; 05.04.2013
comment
Хорошая точка зрения. Голосую за вас :) - person Bertvan; 05.04.2013

Наткнулся на это, когда искал ту же информацию, поэтому могу также добавить пример полной цели MSBuild, которая создает папку FTP, а затем копирует содержимое в новое место. Обратите внимание, что пример загружается на безопасный сайт, поэтому вам может потребоваться изменить номер порта в соответствии с вашей ситуацией.

<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>
person Fetchez la vache    schedule 25.01.2013

Вы также можете использовать XSD для проверки доступных параметров.

Ваше здоровье.

person Eddietec    schedule 02.05.2011
comment
какой ксд? В пакете Nuget для сообщества MSBuild их нет. - person Cristian Diaconescu; 04.04.2013
comment
Вам нужно добавить следующую строку в C:\program files\Microsoft Visual Studio 10.0\Xml\Schemas\1033\Microsoft.Build.xsd ‹xs:include schemaLocation=MSBuild\MSBuild.Community.Tasks.xsd/> Это должно быть поставить в конец файла перед ‹/xs:schema› - person Alex Klaus; 21.05.2014