Core에 참여

Blockly 핵심 저장소에는 모든 Blockly 기반 애플리케이션을 실행하는 데 필요한 코드가 포함되어 있습니다.

알아야 할 사항

다음은 PR을 만들기 위해 알아야 하는 Blockly Core에 관한 사실에 관한 간단한 개요입니다.

  • 작업 브랜치는 develop이며 모든 PR은 develop를 대상으로 제출해야 합니다.
  • 요청된 정보로 풀 리퀘스트 템플릿을 작성해야 합니다.
  • 코드는 Google의 TypeScript 스타일 가이드를 준수해야 합니다.
  • 커밋 메시지와 풀 리퀘스트 제목에 기존 커밋을 사용합니다.
  • 사용자에게 표시되는 문자열은 번역할 수 있도록 /msg/messages.js 파일에 있어야 합니다. 영어를 모국어로 사용하는 사람은 전 세계 인구의 6% 미만입니다.
  • 블록의 텍스트는 일반적으로 모두 소문자여야 합니다 (대부분의 프로그래밍 언어의 키워드와 마찬가지로).
  • 이전 버전과의 호환성을 유지합니다. Blockly 앱이 많이 있습니다. 다른 앱을 중단시키지 마세요.

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

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

변경사항 적용 및 확인

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