好问题。对于您的特定问题,看起来您已解决的依赖项不匹配。当这样的事情发生时,很可能是因为您在不兼容的 dnx 上运行您的应用程序。我们仍在进行非常大的突破性更改,因此如果您看到缺少类型的方法丢失,您可能最终会运行betaX
包和betaY
dnx,反之亦然。
更具体地说,在 beta4 中删除了程序集中性接口,但看起来您正在运行的应用程序仍在使用它们。
我们计划这样做,以便软件包可以标记它们运行所需的最小 dnx,以使错误消息更清晰。同样随着时间的推移,破坏性的变化也会逐渐消失。
不过总的来说,我觉得是时候写一篇关于如何在使用 dnx 时诊断此类问题的指南了(因为它与现有的 .NET 完全不同)。
您放入的依赖project.json
项仅是顶级的。版本也总是最低要求(就像 NuGet 包一样)。这意味着当您指定时,Foo 1.0.0-beta4
您实际上是在指定Foo >= 1.0.0-beta4
. 这意味着如果您要求MVC 0.0.1
并且您配置的提要上的最低版本是MVC 3.0.0
,您将获得那个版本。除非您指定,否则我们也绝不会浮动您的版本。如果您要求 1.0.0 并且它存在,即使存在较新的版本,您也会得到 1.0.0。指定空版本总是不好的,在以后的版本中将被禁止。
我们向 nuget 引入了一项称为浮动版本的新功能。今天它只适用于 prerelease 标签,但在下一个版本中,它将适用于版本的更多部分。这类似于在包规范文件中指定版本范围的 npm 和 gem 语法。
1.0.0-*
- 意味着给我匹配前缀的最高版本(根据语义版本控制规则),或者如果没有匹配该前缀的版本,使用正常行为并让我得到最低版本 >= 指定版本。
当您在最新版本中运行还原时,它会写出一个名为project.lock.json
. 该文件将对所有定义在project.json
.
当这样的事情失败时,您可以执行以下操作:
使用 . 查看已解决的依赖项kpm list
。这将向您显示项目引用的包的已解析版本以及将其引入的依赖项。例如,如果 A -> B,它将显示:
一个
-> 乙
乙
->
实际 KPM 列表输出:
列出 ClassLibrary39 的依赖项(C:\Users\davifowl\Documents\Visual Studio 14\Projects\ClassLibrary39\src\ClassLibrary39\project.json)
[Target framework DNX,Version=v4.5.1 (dnx451)]
framework/Microsoft.CSharp 4.0.0.0
-> ClassLibrary39 1.0.0
framework/mscorlib 4.0.0.0
-> ClassLibrary39 1.0.0
framework/System 4.0.0.0
-> ClassLibrary39 1.0.0
framework/System.Core 4.0.0.0
-> ClassLibrary39 1.0.0
*Newtonsoft.Json 6.0.1
-> ClassLibrary39 1.0.0
[Target framework DNXCore,Version=v5.0 (dnxcore50)]
*Newtonsoft.Json 6.0.1
-> ClassLibrary39 1.0.0
System.Runtime 4.0.20-beta-22709
-> ClassLibrary39 1.0.0
* 表示直接依赖。
如果您有一个正常工作的 Visual Studio(现在与 DNX 中断),您可以查看引用节点。它具有相同的数据直观表示:
让我们看看依赖失败的样子:
这是project.json
{
"version": "1.0.0-*",
"dependencies": {
"Newtonsoft.Json": "8.0.0"
},
"frameworks" : {
"dnx451" : {
"dependencies": {
}
},
"dnxcore50" : {
"dependencies": {
"System.Runtime": "4.0.20-beta-22709"
}
}
}
}
Newtonsoft.Json 8.0.0
不存在。所以运行 kpm restore 会显示以下内容:
当诊断恢复可能失败时,请查看发出的 HTTP 请求,它们会告诉您 kpm 查看了哪些配置的包源。请注意,在上图中,有一个CACHE
请求。这是基于资源类型(nupkg 或 nuspec)的内置缓存,并具有可配置的 TTL(请参阅kpm restore --help
)。如果要强制kpm
访问远程 NuGet 源,请使用以下--no-cache
标志:
这些错误也会显示在 Visual Studio 的包管理器日志输出窗口中:
边注!
包源
我将描述 NuGet.config 现在的工作方式(将来可能会改变)。默认情况下,您有一个 NuGet.config,其中默认 NuGet.org 源在%appdata%\NuGet\NuGet.Config
. 您可以在 Visual Studio 中或使用 NuGet 命令行工具管理这些全局源。在尝试诊断故障时,您应该始终查看有效来源(kpm 输出中列出的来源)。
在此处阅读有关 NuGet.config的更多信息
回到现实:
当依赖项未解决时,运行应用程序将为您提供以下信息:
> dnx . run
System.InvalidOperationException: Failed to resolve the following dependencies for target framework 'DNX,Version=v4.5.1':
Newtonsoft.Json 8.0.0
Searched Locations:
C:\Users\davifowl\Documents\Visual Studio 14\Projects\ClassLibrary39\src\{name}\project.json
C:\Users\davifowl\Documents\Visual Studio 14\Projects\ClassLibrary39\test\{name}\project.json
C:\Users\davifowl\.dnx\packages\{name}\{version}\{name}.nuspec
C:\Program Files (x86)\Reference Assemblies\Microsoft\Framework\.NETFramework\v4.5.1\{name}.dll
C:\Program Files (x86)\Reference Assemblies\Microsoft\Framework\.NETFramework\v4.5.1\Facades\{name}.dll
C:\WINDOWS\Microsoft.NET\assembly\GAC_32\{name}\{version}\{name}.dll
C:\WINDOWS\Microsoft.NET\assembly\GAC_64\{name}\{version}\{name}.dll
C:\WINDOWS\Microsoft.NET\assembly\GAC_MSIL\{name}\{version}\{name}.dll
Try running 'kpm restore'.
at Microsoft.Framework.Runtime.DefaultHost.GetEntryPoint(String applicationName)
at Microsoft.Framework.ApplicationHost.Program.ExecuteMain(DefaultHost host, String applicationName, String[] args)
at Microsoft.Framework.ApplicationHost.Program.Main(String[] args)
运行时基本上尝试在尝试运行之前验证整个依赖关系图是否已解决。如果它建议运行kpm restore
它是因为它找不到列出的依赖项。
您可能会收到此错误的另一个原因是您运行了错误的 dnx 风格。如果您的应用程序仅指定 dnx451 并且您尝试运行 CoreCLR dnx,您可能会看到类似的问题。密切关注报错信息中的目标框架:
对于运行:
dnx4x - runs on dnx-clr-{etc}
dnxcore50 - runs on dnx-coreclr-{etc}
当您尝试运行时,您应该记住从 clr 到在您的project.json
.
这也显示在 Visual Studio 中的引用节点下:
标记为黄色的节点未解析。
这些也显示在错误列表中:
建造
这些错误也会在构建时出现。从命令行构建时,输出非常冗长,在诊断问题时非常有用:
> kpm build
Building ClassLibrary39 for DNX,Version=v4.5.1
Using Project dependency ClassLibrary39 1.0.0
Source: C:\Users\davifowl\Documents\Visual Studio 14\Projects\ClassLibrary39\src\ClassLibrary39\project.json
Using Assembly dependency framework/mscorlib 4.0.0.0
Source: C:\Program Files (x86)\Reference Assemblies\Microsoft\Framework\.NETFramework\v4.5.1\mscorlib.dll
Using Assembly dependency framework/System 4.0.0.0
Source: C:\Program Files (x86)\Reference Assemblies\Microsoft\Framework\.NETFramework\v4.5.1\System.dll
Using Assembly dependency framework/System.Core 4.0.0.0
Source: C:\Program Files (x86)\Reference Assemblies\Microsoft\Framework\.NETFramework\v4.5.1\System.Core.dll
Using Assembly dependency framework/Microsoft.CSharp 4.0.0.0
Source: C:\Program Files (x86)\Reference Assemblies\Microsoft\Framework\.NETFramework\v4.5.1\Microsoft.CSharp.dll
Building ClassLibrary39 for DNXCore,Version=v5.0
Using Project dependency ClassLibrary39 1.0.0
Source: C:\Users\davifowl\Documents\Visual Studio 14\Projects\ClassLibrary39\src\ClassLibrary39\project.json
Using Package dependency System.Console 4.0.0-beta-22709
Source: C:\Users\davifowl\.dnx\packages\System.Console\4.0.0-beta-22709
File: lib\contract\System.Console.dll
Using Package dependency System.IO 4.0.10-beta-22231
Source: C:\Users\davifowl\.dnx\packages\System.IO\4.0.10-beta-22231
File: lib\contract\System.IO.dll
Using Package dependency System.Runtime 4.0.20-beta-22231
Source: C:\Users\davifowl\.dnx\packages\System.Runtime\4.0.20-beta-22231
File: lib\contract\System.Runtime.dll
Using Package dependency System.Text.Encoding 4.0.10-beta-22231
Source: C:\Users\davifowl\.dnx\packages\System.Text.Encoding\4.0.10-beta-22231
File: lib\contract\System.Text.Encoding.dll
Using Package dependency System.Threading.Tasks 4.0.10-beta-22231
Source: C:\Users\davifowl\.dnx\packages\System.Threading.Tasks\4.0.10-beta-22231
File: lib\contract\System.Threading.Tasks.dll
输出显示从包和项目引用传递到编译器的所有程序集。当您开始遇到构建失败时,查看此处以确保您正在使用的包实际上在该目标平台上工作很有用。
这是一个在 dnxcore50 上不起作用的包的示例:
{
"version": "1.0.0-*",
"dependencies": {
"Microsoft.Owin.Host.SystemWeb": "3.0.0"
},
"frameworks": {
"dnx451": {
"dependencies": {
}
},
"dnxcore50": {
"dependencies": {
"System.Console": "4.0.0-beta-22709"
}
}
}
}
Microsoft.Owin.Host.SystemWeb 版本 3.0.0 没有任何在 dnxcore50 上运行的程序集(查看解压缩包的 lib 文件夹)。当我们运行时kpm build
:
请注意,它说“使用包 Microsoft.Owin.Host.SystemWeb”,但没有“文件:”。这可能是构建失败的原因。
我的大脑转储到此结束