azure-devops - 在 VSTS Deploy to App Center 构建任务中格式化发行说明

Question

我花了大约一个小时来寻找这个问题的答案，但一无所获，所以我希望这里有人可以帮助我。

背景

我们目前正在尝试使用 VSTS 中的 App Center Distribute 构建任务通过 App Center 部署我们的 Xamarin.Forms android 应用程序。

其中一项设置允许您指向项目中的发行说明文件，当您点击该文件时，该文件将作为发送的电子邮件的一部分包含在应用中心发布信息中。此文件必须为 UTF-8 格式。

问题

有没有办法实际格式化这个文件，以便它显示得很好？我尝试使用 HTML，这不起作用。当只使用纯文本文件时，它会忽略文本文件中的任何换行符，只将所有文本显示为连续字符串。

如果不可能的话，我不会进行任何突破性的格式化，只是想知道是否有一种格式化方式，所以它至少不是一行大量的文本。

提前致谢

加雷斯

Answer 1

您可以在技术上使用 Markdown 进行格式化。不幸的是，微软认为发行说明应该是单行字符串，删除显式和隐式换行符，以及转义 \n 。这是 YAML 任务的简化版本，显示了使用 YAML 多行 block scalar 语法添加的 releaseNotesInput，该语法为每行添加了一个换行符。

- task: AppCenterDistribute@1
  displayName: AppCenter Distribution iOS Test
  inputs:
    serverEndpoint: AppCenterConnectionName # known as ConnectionName in DevOps
    appSlug: '{name|org}/{app|project}'
    appFile: '$(build.artifactStagingDirectory)/**/*.ipa'
    releaseNotesOption: 'input'
    releaseNotesInput: |+
      #AppCenterDistribute (iOS Test)\n
      \n
      - **Build Number**  : $(build.buildNumber)
      - **Build started** : $(system.pipelineStartTime)
      - **Source Branch** : $(build.sourceBranch)

不幸的是，这解决为:

#AppCenterDistribute (Android Test)\n\n - Build Number : 20181115.13\n - Build started : 2018-11-15 11:42:44+11:00\n - Source Branch : refs/heads/feature/example\n

只有粗体 ** 包装文本的 Markdown 格式才能正确解析。

我会继续尝试……但我不得不说，这是我遇到过的最糟糕的 Markdown 格式支持。

更新

这有效:

    releaseNotesInput:  |+

      AppCenterDistribute (iOS UAT)
      ---

      - **Build Number**  : $(build.buildNumber)
      - **Build started** : $(system.pipelineStartTime)
      - **Source Branch** : $(build.sourceBranch)

标题的 # 不起作用，而 --- 起作用。 |+ 语法允许必要的空行来触发列表等。