В статье описывается местоположение исходных текстов и варианты сборки и запуска премров, демонстрирующих технологии использования российской криптографии в .Net Framework 3.0 и выше.

Исходные тексты и собранные модули

Исходные тексты примеров данной главы собраны в файле Simple35.zip, который устанавливается в подкаталоге Examples КриптоПро .NET SDK, по умолчанию директория %ProgramFiles(x86)%\Crypto Pro\.NET SDK\Examples. Большинство примеров данной главы реализованы на C#. Для работы с примерами необходимо распаковать файл с исходными текстами примеров в рабочую директорию (не рекомендуется использовать поддиректории %ProgramFiles(x86)%\Crypto Pro\.NET SDK). Примеры объеденены в каталоги по тематика.

В состав КриптоПро .NET SDK входит собранная в Release версии из исходных текстов на C# в виде одной сборки исполняемый файл тестов Simple35CS.exe; данный файл может быть установлен в подкаталог Examples КриптоПро .NET SDK, по умолчанию директория %ProgramFiles(x86)%\Crypto Pro\.NET SDK\Examples.

Сборка и запуск примеров

Существует два основных способа сборки примеров из этого раздела и два соответствующих способа запуска этих примеров:

  • Сборка одного примера. Сборка осуществляется явным вызовом компилятора с передачей ему в качестве параметра имени файла исходного примера, а так же дополнительных параметров компилятора. Например, для сборки примера Xps.Sign на CSharp необходимо перейти в католог Xps и выполнить

    csc.exe /r:ReachFramework.dll /r:WindowsBase.dll /out:Xps.Sign.exe Sign.cs

    Рекомендуется, но не обязательно, указывать имя выходного файла по аналогии с приведенным выше примером. Дополнительные инструкции по сборке конкретного примера можно найти в документации по конкретному примеры или в комментариях к этому примеру.

    Запуск примера осуществляется вызовом соответствующего исполняемого файла с передачей необходимых параметров, например:

    Xps.Sign.exe c:\doc.xps TestGostUser

    Список параметров, которые необходимо передать, указан в комментариях к этому примеру, и/или в документации на пример.

  • Сборка всех элементарных примеров из этой главы в единый исполняемый файл. Сборка может осуществляться вызовом программы msbuild.exe из состава .Net Framework 3.5 или .Net Framework 4.0 с передачей ему имени проекта. Например,

    %windir%\Microsoft.NET\Framework\v3.5\MSBuild.exe Simple35CS.35.csproj

    Для сборки примера можно использовать Microsoft Visual Studio как через файл проекта, так и через файл решения (solution). Решение Siple35.2008.sln или проект Simple35CS.35.csproj для Microsoft Visual Studio 2008; решения Siple35.2010.sln или проект Simple35CS.40.csproj для Microsoft Visual Studio 2010. При сборке через проект, как средствами msbuild так и средствами среды разработки, собранный исполняемый файл копируется в директорию bin\Debug (bin\Release при сборке Release конфигурации).

    Для запуска конкретного примера необходимо перейти в директорию с собранным исполняемым файлом, например bin\Debug, и передать собранной программе в качестве первого параметра полное имя класса (включая пространство имен) исполняемого примера и далее передать остальные параметры для этого примера. Например, для запуска примера Xps.Sign, необходимо выполнить

    Simple35CS.exe Simple35.Xps.Sign c:\doc.xps TestGostUser

    При указании поного имени класса корневое пространство имен Simple35 можно опустить.

    Список всех примеров входящих в сборку может быть получен запуском программы с передечей ему параметра -help, например так:

    Simple35CS.exe -help

См. также

Другие ресурсы