好问题。对于您的特定问题,看起来您已解决的依赖项不匹配。当这样的事情发生时,很可能是因为您在不兼容的 dnx 上运行您的应用程序。我们仍在进行非常大的突破性更改,因此如果您发现缺少类型的方法丢失,您可能最终会运行 betaX 包和 betaY dnx,反之亦然。
更具体地说,Assembly Neutral Interfaces 在 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-* - 意味着给我匹配前缀的最高版本(根据semantic versioning rules)或者如果没有匹配该前缀的版本,使用正常行为并给我最低版本> =指定的版本。
当您在最新版本中运行还原时,它会写出一个名为 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 的更多信息here
回到现实:
当依赖关系未解决时,运行应用程序会给你这个:
> 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”,但没有“文件:”。这可能是构建失败的原因。
我的脑残粉到此结束