使用Azure Functions，我可以在我的 C# 函数中引用和使用 NuGet 包吗？
【问题讨论】：
标签： c# azure azure-functions nuget-package azure-web-app-service
是的！尽管 Azure Functions 门户目前不提供添加和管理 NuGet 包的机制，但运行时支持 NuGet 引用，并确保在编译和执行函数时正确使用它们。
为了定义您的依赖项，您需要使用所需的 NuGet 包引用创建一个 Project.json 文件。这是一个添加对Microsoft.ProjectOxford.Face 1.1.0 版本的引用的示例：
{
"frameworks": {
"net46":{
"dependencies": {
"Microsoft.ProjectOxford.Face": "1.1.0"
}
}
}
}
Azure Functions 门户提供了一种方便的方式来管理您的函数文件，我们可以使用它来创建（或上传）我们的project.json：
project.json文件，你也可以点击上传文件的选项project.json 并定义您的包引用（您可以使用上面的示例作为模板）。程序包还原过程将开始，您应该会在日志窗口中看到类似于以下内容的输出：
2016-04-04T19:02:48.745 Restoring packages.
2016-04-04T19:02:48.745 Starting NuGet restore
2016-04-04T19:02:50.183 MSBuild auto-detection: using msbuild version '14.0' from 'D:\Program Files (x86)\MSBuild\14.0\bin'.
2016-04-04T19:02:50.261 Feeds used:
2016-04-04T19:02:50.261 C:\DWASFiles\Sites\facavalfunctest\LocalAppData\NuGet\Cache
2016-04-04T19:02:50.261 https://api.nuget.org/v3/index.json
2016-04-04T19:02:50.261
2016-04-04T19:02:50.511 Restoring packages for D:\home\site\wwwroot\HttpTriggerCSharp1\Project.json...
2016-04-04T19:02:52.800 Installing Newtonsoft.Json 6.0.8.
2016-04-04T19:02:52.800 Installing Microsoft.ProjectOxford.Face 1.1.0.
2016-04-04T19:02:57.095 All packages are compatible with .NETFramework,Version=v4.6.
2016-04-04T19:02:57.189
2016-04-04T19:02:57.189
2016-04-04T19:02:57.455 Packages restored.
正如预期的那样，Azure Functions 运行时会自动添加对包程序集的引用，因此您不需要使用 #r "AssemblyName" 显式添加程序集引用，您只需将所需的 using 语句添加到您的函数并使用您引用的 NuGet 包中定义的类型。
由于 Azure Functions 构建在应用服务之上，作为上述步骤的替代方案，您还可以访问标准 Azure Web 应用（Azure 网站）可用的所有出色部署选项。
这里有一些例子：
为了使用应用服务编辑器（摩纳哥）直接从浏览器管理您的文件：
Function app settings
Go to App Service Settings
Tools按钮On，然后单击Go
project.json 文件拖放到函数的文件夹（以函数命名的文件夹。https://<function_app_name>.scm.azurewebsites.net
D:\home\site\wwwroot\<function_name>
Project.json 文件拖放到文件夹中（文件网格上）连接后（按照上述说明）将您的 Project.json 文件复制到 /site/wwwroot/<function_name>
有关其他部署选项，请参阅：https://azure.microsoft.com/en-us/documentation/articles/web-sites-deploy/
如果您在 Function App 未运行时启用持续集成并使用 project.json 文件部署您的函数，则一旦您的 Function App 初始化，程序包还原将自动发生。建议您不要将您的 project.lock.json 文件添加到源代码管理中。
函数也可以部署为预编译的程序集，在这种情况下，所有依赖项管理都在 Visual Studio 中处理。此选项可用作任何版本的 Visual Studio 上的标准类库或使用 Visual Studio 2017 Azure Functions Tools。
【讨论】：
function script root 是什么？我知道这是project.json 所在的位置。对吗？
project.json 位于您的函数文件夹中，该文件夹是脚本根目录的子文件夹。脚本根映射到 Azure 中的 wwwroot 文件夹。
这个帖子帮了我很多 - 但我仍然浪费了几个小时试图让 Project.json 工作 - 无济于事。
如果您在 2.x 版中创建 Azure 函数，则需要以不同的方式执行此操作。
按照说明创建一个新文件，但将其命名为 function.proj。此文件具有用于通过 Nuget 导入库的 XML 结构。
这是我为 .Net 导入 Amazon S3 开发工具包的示例；
<Project Sdk="Microsoft.NET.Sdk">
<PropertyGroup>
<TargetFramework>netstandard2.0</TargetFramework>
</PropertyGroup>
<ItemGroup>
<PackageReference Include="AWSSDK.S3" Version="3.3.26.3"/>
<PackageReference Include="AWSSDK.Core" Version="3.3.29.1"/>
</ItemGroup>
</Project>
保存后，您应该会看到控制台更新说明正在安装软件包。这真的没有很好的记录，我花了好几个小时才发现这一点。所以我希望这对某人有所帮助。
【讨论】：
您可以在 Azure Functions 中使用 Nuget 包。最简单的方法是使用有 Azure Functions 模板的 Visual Studio 2017 15.4。请按照以下步骤操作
1) 添加 Azure 功能项目：右键单击解决方案并选择添加新项目。转到 CLOUD 选项，您将找到“Azure Function”项目。
2) 现在可以添加任何 Nuget 包了。展开“DEPENDENCIES”并右键单击它以选择“Manage Nuget Packages”选项。将出现 Nuget 包对话框，选择您要安装的任何 Nuget 包。请看下面的截图
3) 现在发布您的 Azure 函数，Visual Studio 将处理所有设置等。
此方法仅在您使用 Visual Studio 2017 15.4 或更高版本时有效，否则您必须遵循其他人解释的其他方法。
【讨论】：
假设我们要使用SFTP 客户端，它是一个外部库，存储在NuGet 的某个位置。
要实现这一点，根据最新的 Azure Functions 规范，请执行以下操作：
在您的 Azure 函数 中打开文件部分并添加一个名为 function.proj 的新文件。
有关详细信息，请参阅 Microsoft documentation。
在function.proj 中使用XML 结构放置Nuget 包引用（如果您使用Visual Studio创建本地项目，您可以在*.csproj 文件中找到相同的结构> 并在其中安装一些NuGet 包）。
这里最重要的是您应该提供库的完整路径，就像在示例中您可以看到的那样："D:\home\site\wwwroot\bin\your_custom_library.dll"
如果库仍然显示为未知，请尝试使用 Visual Studio 中的 Azure 云资源管理器 将其 Dll 手动添加到 bin 文件夹中。
【讨论】：
function.proj 安装脚本时，dll 的位置会在一段时间后出现在“日志”部分中。有时您需要再次重新加载 Azure Function 的页面，有时单击“运行”按钮以查看 NuGet 包的安装以及位置。请检查日志部分中打印的内容作为位置并尝试放置。
请注意，Visual Studio 2017 中的新 .csproj 格式也受支持。如果您将项目创建为 ASPNET Web 项目，Azure Functions 运行时会在构建项目之前下载所有必需的 nuget 包。
【讨论】：