Dartdoc: 같은 유형의 늦은 필드 2개가 오류로 이어집니다.

에 만든 2020년 07월 24일 · 17코멘트 · 출처: dart-lang/dartdoc

다음 코드와 같은 동일한 유형의 늦은 필드 2개:

class A {
  late double a;
  late double b;
}

dartdoc --enable-experiment=non-nullable 출력 오류:

Generating docs for library a from package:hello_world/a.dart...
  error: failed to write file at: a/A/double.html, for symbol a.A.double: (file:///home/a14n/hello_world/lib/a.dart:2:8)
            Dartdoc generates a path and filename to write to for each symbol.
            a.A.double conflicts with another symbol in the generated path, and
            therefore can not be written out.  Changing the name, library name, or
            class name (if appropriate) of one of the conflicting items can resolve
            the conflict.   Alternatively, use the <strong i="10">@nodoc</strong> tag in one symbol's
            documentation comments to hide it.

지연 필드가 하나만 있으면 문제가 나타나지 않습니다.

P1 bug

출처

a14n

모든 17 댓글

FWIW 이 문제는 nullsafety로의 플러터 마이그레이션을 차단합니다.

a14n 에 2020년 07월 24일

찡그린 얼굴 이모티콘은 어디에... 참 이상한 버그입니다. 나는 오늘 이것을 볼 것이다.

srawlins 에 2020년 07월 24일

dartdoc은 귀하의 소스가 null-safety 기능에 옵트인된 것으로 보지 않습니다. 17가지 이유가 있습니다. 하하. 다음을 확인할 수 있습니까?

패키지가 SDK 제약 조건을 통해 null 안전을 선택했습니까? 사용 중인 Dart 버전에 따라 2.9 _또는_ 2.10이 포함될 수 있다고 생각합니다.
패키지가 analysis_options를 통해 null-safety로 선택되었습니까?

analyzer:
  enable-experiment:
    - non-nullable

null-safety 실험으로 dartdoc을 실행하고 있습니까? pub를 통해 호출하는 경우 pub global run dartdoc --enable-experiment=null-safety 와 같을 것입니다.

srawlins 에 2020년 07월 24일

예, 간단한 패키지가 있습니다.

//------ analysis_options.yaml
analyzer:
  enable-experiment:
  - non-nullable
//------ pubspec.yaml
name: hello_world
environment:
  sdk: ">=2.9.0-14.0.dev <3.0.0"
//------ lib/a.dart
class A {
  late double a;
  late double b;
}

그리고 dartdoc --enable-experiment=non-nullable ( dartdoc --enable-experiment=null-safety 와 동일한 오류)를 실행합니다.

내 플러터 PR에서 실패를 볼 수 있습니다 https://cirrus-ci.com/task/4975447580606464?command=main#L137

a14n 에 2020년 07월 24일

@srawlins 문제를 재현할 수 있었습니까?

a14n 에 2020년 07월 28일

FWIW 이 문제는 nullsafety로의 플러터 마이그레이션을 차단하고 있습니다.

이것이 마이그레이션을 차단합니까? 그것의 일부를 차단? 가까운 시일 내에 해결 방법이 있습니까?

devoncarew 에 2020년 07월 28일

pubspec을 통해 null 안전을 선택했을 때 이것을 재현할 수 없었습니다.

environment:
  sdk: '>=2.9.0-18.0 <2.9.0'

및 analysis_options:

analyzer:
  enable-experiment:
    - non-nullable

헤드에서 dartdoc을 사용하여 헤드에서 dart 실행:

~/code/dart-sdk/sdk/xcodebuild/ReleaseX64/dart-sdk/bin/dart
    --enable-experiment=non-nullable
    ../dart-dartdoc/bin/dartdoc.dart
    --enable-experiment=non-nullable

오랜만에 dartdoc을 공개합니다. 또한 최신 최신 릴리스를 확인하겠습니다.

srawlins 에 2020년 07월 28일

이것이 마이그레이션을 차단합니까? 그것의 일부를 차단?

docs-linux 작업이 항상 실패하기 때문에 그렇습니다. (플러터/플러터#62157 참조)

가까운 시일 내에 해결 방법이 있습니까?

모든 late 제거는 ! 및 ? 모든 곳에 추가해야 하기 때문에 실제로 해결 방법이 아닙니다. :-(

a14n 에 2020년 07월 28일

실패한 작업은 dartdoc version: 0.32.1 언급합니다. 이 버전이 귀하의 문제를 유발하는지 확인할 수 있습니까? 문제가 표시되면 문제가 어느 시점에서 수정되었으며 다음 릴리스에서 문제가 해결될 수 있음을 의미할 수 있습니다.

a14n 에 2020년 07월 28일

갓챠; 나는 우리가 dartdoc에 전달할 수 있는 몇 가지 플래그(또는 생략할 수 있는 플래그)를 원했습니다. 그러면 그 동안 계속 진행할 수 있습니다.

@srawlins - nnbd 마이그레이션이 일반적으로 진행되도록 하려면 여기에서 수정하는 것이 중요하다고 생각합니다.

devoncarew 에 2020년 07월 28일

예, Dart 2.10.0-dev.something을 사용하여 0.32.1에서 이것을 재현할 수 있는 것 같습니다. 작동할 수 있는 릴리스되지 않은 0.32.2가 있습니다. 저도 해보겠습니다.

srawlins 에 2020년 07월 28일

🎉1

~~v0.32.2 git 태그와 마스터에서 pub global run 를 사용하여 재현할 수 있습니다.~~ ~~pub 가 범인인 이유를 조사 중입니다.~~

긁어. 테스트 파일에 // @dart=2.9 있었습니다(현재 Null 안전성을 나타내기에는 _너무 낮음_).

dartdoc 0.32.1, git branch v0.32.2 또는 head에서 pub run dartdoc 오류를 재현할 수 없습니다.

srawlins 에 2020년 07월 28일

FWIW, 연결된 Linux 봇의 dartdoc 호출에 --enable-experiment=non-nullable 가 표시되지 않습니다.

devoncarew 에 2020년 07월 28일

👍1

귀하의 권운 링크나 귀하의 PR에 있는 최신 권운 링크에 --enable-experiment=non-nullable 이 표시되지 않습니다.

srawlins 에 2020년 07월 28일

좋은 캐치! 문제를 해결해야 합니다.

(하지만 로컬에서는 이 문제를 보기 위해 무엇을 했는지 모르겠습니다)

a14n 에 2020년 07월 28일

작동하는지 알려주십시오. 내부적으로 검토한 후 내일 아침에 dartdoc을 게시할 계획입니다.

srawlins 에 2020년 07월 28일

--enable-experiment=non-nullable 추가하면 문제가 해결되었습니다. 당신의 도움을 주셔서 감사합니다.

a14n 에 2020년 07월 28일

이 페이지가 도움이 되었나요?

0 / 5 - 0 등급

Dartdoc: 같은 유형의 늦은 필드 2개가 오류로 이어집니다.

모든 17 댓글

관련 문제