用CLI创建Azure函数项目

Question

在使用npm i -g azure-functions-core-tools@3 --unsafe-perm true安装Azure函数核心工具之后，我假设func init --ProjectName命令将使用AzureFunctionsVersion v3创建Azure函数项目，但在项目文件中使用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命令之后，它将触发以下命令：

> dotnet new --install "C:\Users\murat\AppData\Roaming\npm\node_modules\azure-functions-core-tools\bin\templates\itemTemplates.3.0.10405.nupkg"
> dotnet new --install "C:\Users\murat\AppData\Roaming\npm\node_modules\azure-functions-core-tools\bin\templates\projectTemplates.3.0.10405.nupkg"
> dotnet new func --AzureFunctionsVersion v2 --name ProjectName --StorageConnectionStringValue "UseDevelopmentStorage=true"

> dotnet new --uninstall "C:\Users\murat\AppData\Roaming\npm\node_modules\azure-functions-core-tools\bin\templates\itemTemplates.3.0.10405.nupkg"
> dotnet new --uninstall "C:\Users\murat\AppData\Roaming\npm\node_modules\azure-functions-core-tools\bin\templates\projectTemplates.3.0.10405.nupkg"

显然，它调用了--AzureFunctionsVersion v2参数。是默认行为吗？

因为如果我在文件夹中使用dotnet命令，或者使用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>

看看这个博客，您可以选择使用VisualStudio201916.4或更高版本创建蔚蓝函数v3。它将成功地创建v3。

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

顺便说一句，您可以将使用CLI创建的函数应用程序的AzureFunctionsVersion更改为v3。似乎无论您设置了什么版本，RunTime Verison仍然是3.0。