Форматирование примечаний к выпуску в задаче сборки VSTS Deploy to App Center

Я потратил около часа на поиск ответа на этот вопрос и ничего не нашел, поэтому я надеюсь, что кто-то здесь может мне помочь.

Фон

В настоящее время мы экспериментируем с развертыванием нашего приложения Xamarin.Forms для Android через App Center с помощью задачи сборки App Center Distribute в VSTS.

Один из параметров позволяет вам указать файл примечаний к выпуску в вашем проекте, который затем будет включен как часть отправляемого электронного письма, а также в информацию о выпуске центра приложений, когда вы нажмете на него. Этот файл должен быть в формате UTF-8.

Вопрос

Есть ли способ отформатировать этот файл, чтобы он отображался красиво? Я пытался использовать HTML, это не сработало. При использовании простого текстового файла он игнорирует любые разрывы строк в текстовом файле и просто отображает весь текст в виде непрерывной строки.

Мне не нужно какое-либо новаторское форматирование, если это невозможно, просто интересно, есть ли способ форматирования, чтобы, по крайней мере, это не была одна массивная строка текста.

Заранее спасибо

Гарет


person Gaz Winter    schedule 16.05.2018    source источник
comment
Основываясь на исходном коде, он читает содержимое как строку, я боюсь, что вы не можете отформатировать его, просто добавьте простую информацию для примечания к выпуску.   -  person starian chen-MSFT    schedule 17.05.2018


Ответы (3)


Вы можете технически форматировать с помощью уценки. К сожалению, Microsoft считает, что примечания к выпуску должны быть однострочными, с удалением явных и неявных новых строк, а также с экранированием \n. Вот упрощенная версия задачи YAML, показывающая, что releaseNotesInput добавляется с использованием YAML Multiline блочного скаляра синтаксиса, который добавляет новую строку к каждому ряду.

- 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

с форматированием уценки только полужирный текст, обернутый **, действительно правильно анализируется.

Я буду продолжать экспериментировать... но я должен сказать, что это одна из самых печальных возможностей форматирования уценки, с которыми я когда-либо сталкивался.

Обновлять

Это работает:

    releaseNotesInput:  |+

      AppCenterDistribute (iOS UAT)
      ---

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

# для заголовков не работает, а --- работает. Синтаксис |+ позволяет использовать необходимые пустые строки для запуска списков и т. д.

person greg.arnott    schedule 15.11.2018

Вы можете использовать Markdown для форматирования. И, глядя на ваш хорошо отформатированный пост, вы, кажется, уже знаете, как его использовать ????

person Daniel P    schedule 10.07.2018

Я столкнулся с этой же проблемой при попытке добавить разрывы строк. Решение заключалось в использовании двойных разрывов строк в поле release_notes (\n\n вместо \n). В моем случае я отправляю поле release_notes как json, поэтому оно становится \\n\\n.

person Stijn VDB    schedule 22.07.2019