Dart 2를 준비하고, Pub 사이트에서 패키지를 돋보이게 만들기

Dart 패키지 저장소인 Pub의 새 릴리스가 나왔어요! 이번에는 Dart 2 안정 릴리스 준비에 집중했어요.

출처: Getting ready for Dart 2, and making your packages look great on the Pub site!

본문

패키지를 Dart 2로 마이그레이션하기

Dart 2 릴리스가 머지않아 stable로 승급될 것으로 예상해요! 그러니 특히 게시한 패키지를 포함해 여러분의 코드를 Dart 2 호환이 되도록 마이그레이션하는 게 중요해요. 여기에는 세 가지 핵심 측면이 있어요.

코드가 Dart 2 분석을 통과하는지 확인하세요(자세한 내용은 링크). deprecation에 대비하는 등 힌트에도 주의를 기울이길 권해요.
테스트를 실행해 코드가 Dart 2 런타임 검사를 통과하는지 확인하세요(자세한 내용은 링크).
패키지 SDK 제약 조건의 상한을 <3.0.0으로 업데이트하세요(자세한 내용은 링크).

모든 패키지 저자분들이 이 작업을 하길 강력히 권장해요. 저희도 앞으로 며칠간 우리가 소유한 패키지들을 적극적으로 밀어붙일 거예요.

Pub 사이트에서 개선된 분석 UI

이 마이그레이션을 돕기 위해 Pub 사이트의 분석 탭을 업데이트해서 코드 분석 결과를 더 읽기 쉽게 만들었어요. 먼저 분석 페이지 맨 위에 진행률 막대를 추가해서 패키지 상태를 빠르게 확인할 수 있게 했어요.

진행률 막대 아래에는 심각도별로 그룹화된 상세 분석 결과가 있어요. 오류(빨간 아이콘), 경고(노란 아이콘), 제안된 이슈(파란 아이콘)로요. 다음 스크린샷에서 볼 수 있어요.

업데이트된 분석 점수

분석 점수에도 몇 가지 조정을 가했어요. 이제 다음 중 하나라도 해당하면 패키지 점수를 낮춰요.

패키지가 Dart 2 분석을 통과하지 못한 경우.
SDK 제약 상한이 최소한 <3.0.0이 아닌 경우.
API 참조 생성(dartdoc)이 실패한 경우.

다음 Pub 사이트 릴리스에서는 점수를 더 세밀하게 다듬고, 점수가 어떻게 계산되는지에 대한 문서도 추가할 예정이에요.

패키지의 API 표면 검색하기

검색은 — 그리 놀랍지 않게도 — Pub 사이트에서 가장 인기 있는 기능이에요. 지난 몇 분기에 걸쳐 이 영역에서 여러 개선을 했는데, 플랫폼 필터 추가와 순위 개선에 집중했어요. 이번 새 릴리스는 검색에 패키지의 API 표면 검색 지원을 추가해요. 기존에 패키지 설명과 README.md 내용을 검색 인덱싱했던 것에 더해, 이제 검색이 패키지의 모든 공개 API 멤버와 그 멤버의 API 문서까지 다루게 돼요! 설명이나 README.md 파일에 언급되지 않은 것을 찾고 싶을 때 아주 좋아요.

예를 들어, ISO 4217 통화 형식을 사용해 문자열을 포맷할 수 있는 패키지를 찾고 있다고 해 봅시다. 설명과 README.md 파일에서 검색하면 결과가 하나뿐이지만, API 문서를 포함한 검색은 여러 결과를 줘요.

10 results for 4217

intl

Contains code to deal with internationalized/localized messages, date and number formatting and parsing, bi-directional text, and other internationalization issues.

v 0.15.2 • Updated: Oct 19, 2017 FLUTTER WEB OTHER

API results:

intl/NumberFormat-class.html

flutter_billing

A flutter plugin to communicate with billing on iOS and Android.

v 0.1.2 • Updated: Feb 10, 2018 FLUTTER

API results:

flutter_billing/BillingProduct-class.html

요약하자면…

Dart 2 stable 채널 릴리스가 곧 이뤄질 예정이고, 그에 맞춰 Pub 사이트에 Dart 2, 순위, 검색과 관련된 여러 개선을 추가했어요.

패키지를 게시했다면, 지금이 Dart 2에 맞춰 업데이트할 때예요.

패키지가 Dart 2 분석을 통과하는지 확인하세요.
pubspec.yaml에서 SDK 제약 조건의 상한을 <3.0.0으로 업데이트하세요.
업데이트된 패키지를 다시 게시하세요.

그런 다음 pub.dartlang.org의 패키지 분석 페이지로 가서, 순위를 높일 수 있는 다른 방법이 뭐가 있는지 살펴보세요!

더 알아보기

패키지를 Dart 2로 마이그레이션할 때는 Dart 2 분석, 런타임 검사 통과, SDK 제약 상한 <3.0.0 업데이트를 꼭 확인하세요.
Pub 사이트 검색은 이제 패키지의 공개 API 멤버와 API 문서까지 포함해요.