Ошибка DocFx после установки dotnet core 2.1.300 - PullRequest
0 голосов
/ 05 июня 2018

Я создал простое консольное приложение вместе с простым проектом docfx.Когда я запускаю команду DocFX для генерации документации, я получаю следующее предупреждение метаданных и потому, что оно приводит к тому, что документация не генерируется.

[18-06-05 05: 52: 41.715] Предупреждение: MetadataCommand.Сбой ExtractMetadataWorkspace: [Failure] Сбой Msbuild при обработке файла 'E: \ Files \ tmp \ docx \ docfx_project \ src \ src.csproj' с сообщением: C: \ Program Files \ dotnet \ sdk \ 2.1.300 \ Sdks \Microsoft.NET.Sdk \ target \ Microsoft.PackageDependencyResolution.targets: (198, 5): Ошибка загрузки файла блокировки 'E: \ Files \ tmp \ docx \ docfx_project \ src \ obj \ project.assets.json': ссылка на объект отсутствуетустановить экземпляр объекта.

позже в выводе вы увидите

[18-06-05 05: 52: 42.467] Предупреждение: [MetadataCommand.ExtractMetadata] Метаданные не генерируются дляsrc.

Кто-нибудь еще сталкивался с этой проблемой?Как получить метаданные для генерации?

Воссоздать проект довольно просто:

  1. goto dotnet cli tools, командная строка
  2. docfx init
  3. cd src
  4. dotnet новая консоль
  5. cd ..
  6. docfx

Я установил и использую dotnet sdk 2.1.300

1 Ответ

0 голосов
/ 05 июня 2018

В .net 2.1 произошли серьезные изменения в использовании инструментов, которые теперь установлены и используются во всем мире, например:

dotnet watch
dotnet user-secrets
dotnet sql-cache
dotnet dev-certs

Разработчики docfx в настоящее время работают над версией, которая поддерживает.net 2.1 (docfx v3): https://github.com/dotnet/docfx/pull/2829

Здесь вы можете увидеть текущее состояние реализации: https://github.com/dotnet/docfx/projects/1

Итак, ответ на ваш вопрос: пока вы не можетеиспользуйте docfx с .net 2.1

...