如何调试NuGet包的install.ps1脚本

Question

如何调试NuGet包的install.ps1脚本

c#visual-studiopowershellnuget

43

我们可以在NuGet包中包含安装/卸载PowerShell脚本。我尝试过，但我的 install.ps1 脚本无法正常工作。是否有可能找出原因？调试、记录日志还是其他方法？

更新

请注意，该脚本作为NuGet包的安装过程的一部分执行。它可能非常与NuGet相关。

- dkl

5个回答

8

以下是我如何使用PowerShell ISE逐步执行install.ps1的方法：

要能够使用PowerShell ISE逐步执行安装脚本，请按照以下步骤操作：

启用使用 .Net 4 构建的程序集的执行权限

在以下路径中选择一个：

C:\Windows\System32\WindowsPowerShell\v1.0 或 C:\Windows\SysWOW64\WindowsPowerShell\v1.0

根据您使用的PS版本选择其中一个路径。如果文件不存在，请创建它们。

在以下路径中选择一个：

C:\Windows\System32\WindowsPowerShell\v1.0 或 C:\Windows\SysWOW64\WindowsPowerShell\v1.0

根据您使用的PS版本选择其中一个路径。如果配置文件不存在，请创建它们。

powershell.exe.config：

<configuration>  
    <startup useLegacyV2RuntimeActivationPolicy="true">  
        <supportedRuntime version="v4.0.30319"/>  
        <supportedRuntime version="v2.0.50727"/>  
    </startup>  
</configuration>

powershell_ise.exe.config:

<?xml version="1.0" encoding="utf-8"?>
<configuration>
    <startup>
      <supportedRuntime version="v4.0.30319" />
    </startup>
</configuration>

为了运行NuGet包中包含的PowerShell脚本，需要更改执行策略：

Set-ExecutionPolicy RemoteSigned -Scope Process

复制您想要调试的install.ps1并修改其内容如下：

删除参数块。

param(
    [Parameter(Mandatory=$true)] [string]   $installPath,
    [Parameter(Mandatory=$true)] [string]   $toolsPath,
    [Parameter(Mandatory=$true)]            $package,
    [Parameter(Mandatory=$true)]            $project
)

导入一个模块，允许在VS主进程之外使用nuget cmdlets

下载http://community.sharpdevelop.net/blogs/mattward/NuGet/NuGetOutsideVisualStudio.zip 将bin文件夹中的内容提取到某个位置，然后导入PackageManagement.Cmdlets.dll

操作如下:

import-module "C:\dev\NuGetOutsideVisualStudio\bin\PackageManagement.Cmdlets.dll"

现在，您可以手动设置所有参数，如下所示：

$toolsPath="C:\dev\demo-solution\packages\X1.Registration.DbUpdate.0.4\tools"
$installPath="C:\dev\demo-solution\packages\X1.Registration.DbUpdate.0.4"

set-project DemoSolution.Logic C:\dev\demo-solution\DemoSolution.sln

$project = Get-Project -name DemoSolution.Logic

这仍然使$package对象未设置，但我发现脚本实际上并不引用该参数。

参考资料： http://community.sharpdevelop.net/blogs/mattward/archive/2011/06/12/InstallingNuGetPackagesOutsideVisualStudio.aspx

- ambidexterous

4

使用Set-PsDebug -trace 2命令可以查看发生了什么。

- manojlds

什么也不做。可能是与Nuget相关的。 - dkl

1

在我尝试调试PowerShell包中的cmdlet时，这对我很有用。 - Simon Gill

4

通过VS的“程序包管理器控制台”运行您的脚本（有关控制台的详细信息，请参见https://docs.nuget.org/ndocs/tools/package-manager-console） - 任何导致错误的内容都将以红色方式显示。

此外，您还可以使用Write-Host在同一控制台上编写诊断跟踪类型信息。

- Ethan J. Brown

“通过包管理器控制台运行脚本”是什么意思？ - tofutim

@tofutim 我添加了一个链接，指向有关包管理器控制台的信息。 - Ethan J. Brown

1

在安装脚本的开头可能会调用Start-Transcript，并在结尾处调用Stop-Transcript。您可能会像这样包装安装代码：

try {
  $ErrorActionPreference = 'stop'  # stop on error
  Start-Transcript c:\a.txt
  ...
}
catch {
  write-host $_
}
finally {
  Stop-Transcript
}

另外，$ErrorActionPreference = 'inquire'（而不是stop）可能也可以工作。但现在没有机会尝试。请参见http://tasteofpowershell.blogspot.com/2008/07/handling-errors-in-powershell.html

- stej

NuGet包不允许这样做： “安装失败。回滚中... 此主机不支持转录。” - dkl

只有控制台主机支持转录。 - x0n

网页内容由stack overflow 提供, 点击上面的

可以查看英文原文，
原文链接

- Roman Kuzmin · Accepted Answer

也许我来晚了，但这里有一个调试NuGet特定脚本的解决方案——NuGet包NuGetDebugTools。它的脚本Add-Debugger.ps1为NuGet包管理器控制台添加了一个简单而有效的调试器。

更新：该脚本现在已经在PSGallery中Add-Debugger。NuGetDebugTools包不再更新。要么使用PowerShelf，要么从存储库获取各个脚本。

示例场景：

启动Visual Studio
打开NuGet控制台并输入命令

  PM> Add-Debugger [-ReadHost]
  PM> Set-PSBreakpoint -Command init
  PM> Set-PSBreakpoint -Command install

（或设置更具体的断点，请参见help Set-PSBreakpoint）

打开Visual Studio解决方案或为已经打开的解决方案调用Install-Package XYZ
当调用任何init.ps1和install.ps1时，调试器输入对话框将出现
在调试器输入中键入? 并查看您可以做什么：

  s, StepInto  Step to the next statement into functions, scripts, etc.
  v, StepOver  Step to the next statement over functions, scripts, etc.
  o, StepOut   Step out of the current function, script, etc.
  c, Continue  Continue operation (also on empty input).
  q, Quit      Stop operation and exit the debugger.
  ?, h         Display this help message.
  r            Display PowerShell command history.
  k            Display call stack (Get-PSCallStack).
  <number>     Show debug location in context of <number> lines.
  +<number>    Set location context preference to <number> lines.
  <command>    Invoke any PowerShell <command> and write its output.

可以输入其他调试器和PowerShell命令，并在NuGet控制台中查看输出

v1.4.0 - 新开关ReadHost 告诉使用Read-Host进行输入，而不是默认的GUI输入框。