dart pub publish로 패키지 배포하기

dart pub publish 명령어를 쓰면 Dart 패키지를 pub.dev 사이트에 배포할 수 있어요. 실제로 올리기 전에 검증만 해보는 dry-run 옵션과 강제 배포하는 방법도 함께 살펴볼게요.

출처: dart pub publish

본문

dart pub publish는 pub 도구의 명령어 중 하나예요. 이 명령어는 패키지를 pub.dev 사이트에 배포해서 누구나 다운로드하고 의존할 수 있게 해 줘요. 배포 전에 패키지를 어떻게 준비하고, 어떤 파일을 포함하거나 제외해야 하는지는 패키지 배포 문서를 참고해 주세요.

$ dart pub publish [options]

옵션 (Options)

모든 pub 명령어에 적용되는 옵션은 글로벌 옵션 문서에서 확인할 수 있어요.

--dry-run 또는 -n

이 옵션을 쓰면 pub은 검증 과정을 거치지만 실제로 패키지를 업로드하지 않아요. 실제로 공개하기 전에 패키지가 모든 배포 요구사항을 충족하는지 확인하고 싶을 때 유용해요.

--force 또는 -f

이 옵션을 쓰면 pub은 배포 전에 확인을 요청하지 않아요. 보통은 패키지 내용을 보여 주고 업로드를 확인하라고 묻거든요. 패키지에 오류가 있으면 pub은 업로드하지 않고 오류와 함께 종료해요. 경고가 있는 경우에는 패키지가 업로드돼요. 업로드 전에 경고가 없도록 하려면 --force를 쓰지 않거나, 먼저 --dry-run을 사용해 주세요.

--skip-validation

클라이언트 측 검증 과정이나 의존성 해석을 거치지 않고 배포해요. 검증이 왜 실패하는지 알고 있고 특정 문제를 우회하고 싶은 고급 사용자에게 유용해요.

예시: pub.dev에 배포할 때 새로 배포한 패키지를 사용할 수 있게 되기까지 몇 분이 걸릴 수 있어요. 그래서 서로 의존하는 패키지 두 개를 배포하는데 두 번째가 첫 번째에 의존한다면, 첫 번째와 두 번째 배포 사이에 몇 분 기다리거나, --skip-validation을 사용해 클라이언트 측 검증을 우회하고 두 번째 패키지를 바로 배포할 수 있어요. 자세한 문제 해결 방법은 pub 문제 해결 가이드를 확인해 주세요.

워크스페이스에서

Pub 워크스페이스에서 dart pub publish는 현재 디렉터리에 있는 패키지를 배포해요.

더 알아보기

패키지 배포 — 배포 전 준비 사항과 포함할 파일 확인하기
dart pub bump — 배포 전에 버전 올리는 명령어 보기