使用 CLI 创建 Azure Functions 项目

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:\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 new func 命令，或者使用 VS2019 AzureFunctions v3 项目，它会将 AzureFunctionsVersion 设置为 v3

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

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>

看看this Blog，你可以选择通过Visual Studio 2019 16.4 或更新版本创建 azure function v3。它将成功创建v3。

看看这个：The Azure CLI may be still in the situation of create v2 by default。

顺便说一句，你可以把函数应用的AzureFunctionsVersion改成您使用 CLI 创建到 v3。看来无论你设置什么Version，RunTime Verison都是3.0.

使用 CLI 创建 Azure Functions 项目

Creating Azure Function Project with CLI

azure-functions

azure-functions-core-tools