병합 전략을 사용한 번들 생성 및 파일 지정

병합 전략을 사용하여 재합성으로 번들을 생성하고 사용자 지정 블루프린트의 수명 주기 관리 업데이트를 위한 파일을 지정할 수 있습니다. 재합성 및 병합 전략을 활용하여 업데이트를 관리하고 배포 중에 업데이트되는 파일을 제어할 수 있습니다. 또한 변경 사항이 기존 CodeCatalyst 프로젝트로 병합되는 방식을 제어하는 자신만의 전략을 작성할 수 있습니다.

재합성을 사용하여 파일 생성

재합성은 블루프린트에서 생성된 소스 코드를 이전에 동일한 블루프린트에서 생성된 소스 코드와 병합하여, 블루프린트에 대한 변경 사항을 기존 프로젝트에 전파할 수 있습니다. 병합은 블루프린트 출력 번들의 resynth() 함수에서 실행됩니다. 재합성은 먼저 블루프린트과 프로젝트 상태의 다양한 측면을 나타내는 세 개의 번들을 생성합니다. yarn blueprint:resynth 명령을 사용하여 로컬에서 수동으로 실행할 수 있으며, 명령이 아직 없는 경우 번들이 생성됩니다. 번들을 수동으로 사용하면 재합성 동작을 로컬에서 모의하고 테스트할 수 있습니다. 기본적으로 블루프린트는 번들의 해당 부분만 일반적으로 소스 제어 하에 있으므로 src/*의 리포지토리 전체에서 재합성만 실행합니다. 자세한 내용은 재합성 섹션을 참조하세요.

각 번들은 this.context.resynthesisPhase의 블루프린트 클래스에서 액세스할 수 있는 재합성 단계에서 생성됩니다.

ancestor-bundle와 proposed-bundle의 차이를 가져와 existing-bundle에 추가하여 resolved-bundle를 생성하면 3방향 병합이 적용됩니다. 모든 병합 전략은 파일을 resolved-bundle로 처리합니다. 재합성은 resynth()를 실행하는 동안 블루프린트의 병합 전략으로 이러한 번들의 도달 범위를 해결하고 결과에서 해결된 번들을 생성합니다.

병합 전략 사용

블루프린트 라이브러리에서 제공한 병합 전략을 사용할 수 있습니다. 이러한 전략은 재합성을 사용하여 파일 생성 섹션에 언급된 파일에 대한 파일 출력 및 충돌을 해결하는 방법을 제공합니다.

병합 전략의 소스 코드를 보려면 open-source GitHub repository를 참조하세요.

수명 주기 관리 업데이트를 위한 파일 지정

재합성 중에 블루프린트은 변경 사항이 기존 소스 리포지토리에 병합되는 방식을 제어합니다. 그러나 블루프린트의 모든 단일 파일에 업데이트를 푸시하지 않을 수도 있습니다. 예를 들어, CSS 스타일시트와 같은 샘플 코드는 프로젝트별 코드입니다. 다른 전략을 지정하지 않으면 3방향 병합 전략이 기본 옵션입니다. 블루프린트는 리포지토리 구문 자체에 대한 병합 전략을 지정하여 소유한 파일과 소유하지 않은 파일을 지정할 수 있습니다. 블루프린트는 병합 전략을 업데이트할 수 있으며, 재합성 중에 최신 전략을 사용할 수 있습니다.

const sourceRepo = new SourceRepository(this, {
      title: 'my-repo',
    });
    sourceRepo.setResynthStrategies([
      {
        identifier: 'dont-override-sample-code',
        description: 'This strategy is applied accross all sample code. The blueprint will create sample code, but skip attempting to update it.',
        strategy: MergeStrategies.neverUpdate,
        globs: [
          '**/src/**',
          '**/css/**',
        ],
      },
    ]);

여러 병합 전략을 지정할 수 있으며, 마지막 전략이 우선합니다. 검색되지 않은 파일은 기본적으로 Git과 유사한 3방향 병합으로 설정됩니다. MergeStrategies 구문을 통해 제공되는 몇 가지 병합 전략이 있지만 직접 작성할 수도 있습니다. 제공된 전략은 git 병합 전략 드라이버를 준수합니다.

병합 전략 작성

제공된 빌드 병합 전략 중 하나를 사용하는 것 외에도 자체 전략을 작성할 수도 있습니다. 전략은 표준 전략 인터페이스를 준수해야 합니다. existing-bundle, proposed-bundle, ancestor-bundle에서 파일 버전을 가져와서 하나의 확인된 파일로 병합하는 전략 함수를 작성해야 합니다. 예시:

type StrategyFunction = (
   /**
   * file from the ancestor bundle (if it exists)
   */
    commonAncestorFile: ContextFile | undefined, 
   /**
   * file from the existing bundle (if it exists)
   */
    existingFile: ContextFile | undefined,
   /**
   * file from the proposed bundle (if it exists)
   */ 
    proposedFile: ContextFile | undefined, 
    options?: {}) 
    /**
    * Return: file you'd like in the resolved bundle
    * passing undefined will delete the file from the resolved bundle
    */ 
=> ContextFile | undefined;

파일이 존재하지 않는 경우(정의되지 않은 경우), 해당 파일 경로는 해당 특정 위치 번들에 존재하지 않습니다.

예시:

strategies: [
          {
            identifier: 'dont-override-sample-code',
            description: 'This strategy is applied across all sample code. The blueprint will create sample code, but skip attempting to update it.',
            strategy: (ancestor, existing, proposed) => {
                const resolvedfile = ...
                ...
                // do something
                ...
                return resolvedfile
            },
            globs: [
              '**/src/**',
              '**/css/**',
            ],
          },
        ],