샘플에 참여

Blockly 샘플에는 핵심 저장소에 포함되지 않은 Blockly와 관련된 추가 콘텐츠(예: 플러그인, Codelab, 예시 코드)가 포함되어 있습니다. 각 항목에 관한 자세한 내용은 저장소 구조 페이지를 참고하세요.

알아야 할 사항

다음은 PR을 만들기 위해 알아야 하는 블록리 샘플에 관한 사실의 간략한 개요입니다.

  • 작업 브랜치는 마스터이며 모든 PR은 마스터에 대해 생성되어야 합니다.
  • 개별 플러그인 수준이 아닌 blockly-samples의 루트 수준에서 npm install를 실행합니다. Blockly-samples는 모노레포로, 동일한 저장소에 여러 패키지가 포함되어 있으며 루트 수준에서 설치하는 것은 Lerna로 모노레포를 관리하기 위한 워크플로의 일부입니다.
  • 코드는 사용되는 언어에 따라 Google의 JavaScript 스타일 가이드 또는 TypeScript 스타일 가이드를 준수해야 합니다.
  • 커밋 메시지와 pull 요청 제목에 기존 커밋을 사용합니다.

  • 새 코드 파일은 Apache 라이선스 v2.0을 접두사로 사용해야 합니다.

    /**
 *   @license
 *   Copyright <Current YYYY> Google LLC
 *   SPDX-License-Identifier: Apache-2.0
 */

변경사항 적용 및 확인

  1. blockly-samples의 루트 수준에서 npm install을 실행하여 종속 항목을 설치합니다.
  2. 플러그인 디렉터리에서 npm run start를 실행하여 플러그인의 테스트 페이지를 실행하는 서버를 빌드하고 시작합니다. 이 페이지를 사용하여 플러그인의 기존 동작을 볼 수 있습니다. 또는 새 플러그인을 추가하는 경우 다른 사용자가 플러그인의 기능을 볼 수 있도록 유용한 테스트 페이지로 만들어야 합니다. 자세한 내용은 플레이그라운드 페이지를 참고하세요.
  3. 플러그인의 코드를 필요한 대로 변경합니다.
  4. 서버를 계속 실행한 경우 변경사항이 자동으로 로드됩니다. 그렇지 않으면 서버를 다시 시작하고 플러그인이 예상대로 작동하고 콘솔에 오류나 경고가 없는지 확인합니다.
  5. npm run build를 실행하고 빌드 오류가 없는지 확인합니다.
  6. test/ 디렉터리에 자동화된 Mocha 테스트를 작성합니다.
  7. npm run test를 실행하여 자동 테스트를 실행합니다.
  8. npm run lint:fix를 실행하여 린트 오류를 수정합니다. 남은 경고 또는 오류를 해결합니다.
  9. npm run format를 실행하여 자동 형식 지정 도구를 실행합니다.
  10. 모든 테스트를 통과하면 변경사항이 포함된 master에 대한 PR을 열 준비가 된 것입니다.