使用 CLI 创建 Azure 函数项目

Question

使用npm i -g azure-functions-core-tools@3 --unsafe-perm true安装 Azure Functions Core Tools 后，我假设func init --ProjectName命令将使用 AzureFunctionsVersion v3 创建 Azure Functions 项目，但它在项目文件中使用 v2 创建：

.csproj

<Project Sdk="Microsoft.NET.Sdk">
<PropertyGroup>
<TargetFramework>netcoreapp3.0</TargetFramework>
<AzureFunctionsVersion>v2</AzureFunctionsVersion>
</PropertyGroup>
<ItemGroup>
<PackageReference Include="Microsoft.NET.Sdk.Functions" Version="3.0.1" />
</ItemGroup>
<ItemGroup>
<None Update="host.json">
<CopyToOutputDirectory>PreserveNewest</CopyToOutputDirectory>
</None>
<None Update="local.settings.json">
<CopyToOutputDirectory>PreserveNewest</CopyToOutputDirectory>
<CopyToPublishDirectory>Never</CopyToPublishDirectory>
</None>
</ItemGroup>
</Project>

在CLI_DEBUG=1设置环境变量并重新运行我意识到的 func init 命令后，它会触发以下命令：

> dotnet new --install "C:UsersmuratAppDataRoamingnpmnode_modulesazure-functions-core-toolsbintemplatesitemTemplates.3.0.10405.nupkg"
> dotnet new --install "C:UsersmuratAppDataRoamingnpmnode_modulesazure-functions-core-toolsbintemplatesprojectTemplates.3.0.10405.nupkg"
> dotnet new func --AzureFunctionsVersion v2 --name ProjectName --StorageConnectionStringValue "UseDevelopmentStorage=true"
> dotnet new --uninstall "C:UsersmuratAppDataRoamingnpmnode_modulesazure-functions-core-toolsbintemplatesitemTemplates.3.0.10405.nupkg"
> dotnet new --uninstall "C:UsersmuratAppDataRoamingnpmnode_modulesazure-functions-core-toolsbintemplatesprojectTemplates.3.0.10405.nupkg"

显然，它称之为--AzureFunctionsVersion v2论点。这是默认行为吗？

因为如果我在文件夹中使用 dotnet new func 命令，或者使用 VS2019 AzureFunctions v3 Project，它会将 AzureFunctionsVersion 设置为v3

在深入研究AcureFunctionsCoreTools源代码后，我在DotnetHelpers类的DeployDotnetProject方法中找到了以下代码：

public async static Task DeployDotnetProject(string Name, bool force)
{
await TemplateOperation(async () =>
{
var connectionString = RuntimeInformation.IsOSPlatform(OSPlatform.Windows)
? $"--StorageConnectionStringValue "{Constants.StorageEmulatorConnectionString}""
: string.Empty;
var exe = new Executable("dotnet", $"new func --AzureFunctionsVersion v2 --name {Name} {connectionString} {(force ? "--force" : string.Empty)}");
var exitCode = await exe.RunAsync(o => { }, e => ColoredConsole.Error.WriteLine(ErrorColor(e)));
if (exitCode != 0)
{
throw new CliException("Error creating project template");
}
});
}

我们还需要这个--AzureFunctionsVersion v2论点吗？

Answer 1

是的，通常，你会得到这样的项目：

<Project Sdk="Microsoft.NET.Sdk">
<PropertyGroup>
<TargetFramework>netcoreapp3.0</TargetFramework>
<AzureFunctionsVersion>v2</AzureFunctionsVersion>
</PropertyGroup>
<ItemGroup>
<PackageReference Include="Microsoft.NET.Sdk.Functions" Version="3.0.1" />
</ItemGroup>
<ItemGroup>
<None Update="host.json">
<CopyToOutputDirectory>PreserveNewest</CopyToOutputDirectory>
</None>
<None Update="local.settings.json">
<CopyToOutputDirectory>PreserveNewest</CopyToOutputDirectory>
<CopyToPublishDirectory>Never</CopyToPublishDirectory>
</None>
</ItemGroup>
</Project>

查看此博客，可以选择通过Visual Studio 2019 16.4或更高版本创建Azure Function v3。它将成功创建 v3。

看看这个：默认情况下，Azure CLI 可能仍处于创建 v2 的情况。

顺便说一下，你可以更改函数应用的AzureFunctionsVersion使用 CLI 到 v3 创建的。似乎无论您设置什么版本，运行时版本仍然是 3.0。