使用 Azure Functions,可以在C#函数中引用和使用NuGet包吗?
使用 Azure Functions,可以在C#函数中引用和使用NuGet包吗?
Answers:
是! 尽管Azure Functions门户当前不提供添加和管理NuGet程序包的机制,但运行时支持NuGet引用,并会确保在编译和执行函数时正确使用了它们。
为了定义依赖关系,您需要Project.json
使用必需的NuGet包引用创建文件。这是一个添加对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功能是在App Services之上构建的,因此可以替代上述步骤,因此您还可以访问标准Azure Web Apps(Azure网站)可用的所有出色部署选项。
这里有些例子:
为了使用App Service编辑器(摩纳哥)直接从浏览器直接管理文件,请执行以下操作:
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/zh-cn/documentation/articles/web-sites-deploy/
如果您project.json
在不运行Function App的情况下启用了持续集成并使用文件部署了功能,则一旦Function App初始化,程序包还原将自动发生。建议不要将project.lock.json
文件添加到源代码管理中。
函数也可以作为预编译的程序集部署,在这种情况下,所有依赖项管理都在Visual Studio中处理。此选项可以在任何版本的Visual Studio上用作标准类库,也可以通过使用Visual Studio 2017 Azure函数工具用作标准类库。
function script root
你的最后一个段落?我知道它在哪里project.json
。那是对的吗?
project.json
是你的文件夹的功能,这是脚本根的子文件夹。脚本根目录映射到wwwroot
Azure中的文件夹。
这个线程对我有很大帮助-但是我仍然浪费了几个小时试图使Project.json正常工作-无济于事。
如果您在2.x版中执行Azure功能,则需要以其他方式执行此操作。
如所述创建一个新文件,但将其命名为function.proj。该文件具有XML结构,用于通过Nuget导入库。
这是我导入.Net的Amazon S3 SDK的示例;
<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程序包。最简单的方法是使用Visual Studio 2017 15.4(其中存在Azure函数的模板)。遵循以下步骤
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 文档。
在内部,使用结构function.proj
将Nuget
包引用放入内部XML
(您可以在内部找到相同的结构*.csproj
如果使用Visual Studio创建本地项目并在其中安装一些NuGet
包,则文件)。
这里最重要的是,您应该提供库的完整路径,就像在示例中可以看到的那样: "D:\home\site\wwwroot\bin\your_custom_library.dll"
在情况下,如果库中仍然显示为未知的尝试添加它的Dll
“手动S插入bin文件夹使用Azure的云资源管理器从Visual Studio中。
function.proj
,dll
一段时间后,的位置会出现在“日志”部分中。有时您需要再次重新加载Azure功能的页面,有时单击“运行”按钮以查看NuGet软件包的安装以及位置。请检查“日志”部分中正在打印的内容,然后尝试放入。