Swift 패키지 사용 및 게시

CodeArtifact 리포지토리에서 Swift 패키지를 사용하려면

1. 아직 구성하지 않았다면, CodeArtifact를 사용하여 Swift Package Manager 설정의 단계에 따라 적절한 보안 인증과 함께 CodeArtifact 리포지토리를 사용하도록 Swift Package Manager를 구성합니다.

   참고

   생성된 권한 부여 토큰은 12시간 동안 유효합니다. 토큰이 생성된 후 12시간이 경과한 경우 새 토큰을 생성해야 합니다.

2. 애플리케이션 프로젝트 폴더의 Package.swift 파일을 편집하여 프로젝트에서 사용할 패키지 종속성을 업데이트합니다.

   1. Package.swift 파일에 dependencies 섹션이 없는 경우 해당 섹션을 추가합니다.

   2. Package.swift 파일의 dependencies 섹션에서 패키지 식별자를 추가하여 사용하려는 패키지를 추가합니다. 패키지 식별자는 범위와 패키지 이름을 마침표로 구분하여 구성됩니다. 예제는 이후 단계 다음에 나오는 코드 스니펫을 참조하세요.

      작은 정보

      CodeArtifact 콘솔을 사용하여 패키지 식별자를 찾을 수 있습니다. 사용하려는 특정 패키지 버전을 찾고 패키지 버전 페이지의 설치 단축키 지침을 참조하세요.

   3. Package.swift 파일에 targets 섹션이 없는 경우 해당 섹션을 추가합니다.

   4. targets 섹션에서 종속성을 사용해야 하는 대상을 추가합니다.

      다음 스니펫은 Package.swift 파일의 구성된 dependencies 섹션과 targets 섹션을 보여 주는 예제 스니펫입니다.

      ...
          ],
          dependencies: [
              .package(id: "my_scope.package_name", from: "1.0.0")
          ],
          targets: [
            .target(
               name: "MyApp",
               dependencies: ["package_name"]
            ),...
          ],
      ...

3. 이제 모든 구성이 완료되었으므로 다음 명령을 사용하여 CodeArtifact에서 패키지 종속성을 다운로드합니다.

   swift package resolve

Xcode의 CodeArtifact 리포지토리에서 Swift 패키지를 사용하려면

1. 아직 구성하지 않았다면, CodeArtifact를 사용하여 Swift Package Manager 설정의 단계에 따라 적절한 보안 인증과 함께 CodeArtifact 리포지토리를 사용하도록 Swift Package Manager를 구성합니다.

   참고

   생성된 권한 부여 토큰은 12시간 동안 유효합니다. 토큰이 생성된 후 12시간이 경과한 경우 새 토큰을 생성해야 합니다.

2. 패키지를 Xcode의 프로젝트에 종속 항목으로 추가합니다.

   1. 파일 > 패키지 추가를 선택합니다.

   2. 검색 창을 사용하여 패키지를 검색합니다. 검색은 package_scope.package_name 형식으로 합니다.

   3. 패키지를 찾으면 패키지를 선택한 다음 패키지 저장을 선택합니다.

   4. 패키지가 확인되면 종속 항목으로 추가할 패키지 제품을 선택한 다음 패키지 추가를 선택합니다.

1. 아직 구성하지 않았다면, CodeArtifact를 사용하여 Swift Package Manager 설정의 단계에 따라 적절한 보안 인증과 함께 CodeArtifact 리포지토리를 사용하도록 Swift Package Manager를 구성합니다.

   참고

   생성된 권한 부여 토큰은 12시간 동안 유효합니다. 토큰이 생성된 후 12시간이 경과한 경우 새 토큰을 생성해야 합니다.

2. 패키지의 Package.swift 파일이 포함된 Swift 프로젝트 디렉터리로 이동합니다.

3. 다음 swift package-registry publish 명령을 실행하여 패키지를 게시합니다. 이 명령은 패키지 소스 아카이브를 생성한 다음 CodeArtifact 리포지토리에 게시합니다.

   swift package-registry publish packageScope.packageName packageVersion

   예시:

   swift package-registry publish myScope.myPackage 1.0.0

4. 패키지가 게시되었고 리포지토리에 존재하는지 여부는 콘솔에서 확인하거나 다음과 같은 aws codeartifact list-packages 명령을 사용하여 확인할 수 있습니다.

   aws codeartifact list-packages --domain my_domain --repository my_repo

   다음과 같이 aws codeartifact list-package-versions 명령을 사용하여 패키지의 단일 버전을 나열할 수 있습니다.

   aws codeartifact list-package-versions --domain my_domain --repository my_repo \
   --format swift --namespace my_scope --package package_name

1. 아직 업데이트하지 않았다면 CodeArtifact를 사용하여 Swift Package Manager 설정의 단계에 따라 CODEARTIFACT_AUTH_TOKEN 및 CODEARTIFACT_REPO 환경 변수를 만들고 업데이트합니다.

   참고

   권한 부여 토큰은 12시간 동안 유효합니다. CODEARTIFACT_AUTH_TOKEN 환경 변수를 생성한 후 12시간이 경과한 경우 새 보안 인증으로 환경 변수를 새로 고쳐야 합니다.

2. 먼저 Swift 패키지를 생성하지 않은 경우 다음 명령을 실행하여 생성할 수 있습니다.

   mkdir testDir && cd testDir
   swift package init
   git init .
   swift package archive-source

3. 다음 Curl 명령을 사용하여 CodeArtifact에 Swift 패키지를 게시합니다.

   macOS and Linux

   curl -X PUT  --user "aws:$CODEARTIFACT_AUTH_TOKEN" \
   -H "Accept: application/vnd.swift.registry.v1+json" \
   -F source-archive="@test_dir_package_name.zip" \
   "${CODEARTIFACT_REPO}my_scope/package_name/packageVersion"

   Windows

   curl -X PUT  --user "aws:%CODEARTIFACT_AUTH_TOKEN%" \
   -H "Accept: application/vnd.swift.registry.v1+json" \
   -F source-archive="@test_dir_package_name.zip" \
   "%CODEARTIFACT_REPO%my_scope/package_name/packageVersion"

4. 패키지가 게시되었고 리포지토리에 존재하는지 여부는 콘솔에서 확인하거나 다음과 같은 aws codeartifact list-packages 명령을 사용하여 확인할 수 있습니다.

   aws codeartifact list-packages --domain my_domain --repository my_repo

   다음과 같이 aws codeartifact list-package-versions 명령을 사용하여 패키지의 단일 버전을 나열할 수 있습니다.

   aws codeartifact list-package-versions --domain my_domain --repository my_repo \
   --format swift --namespace my_scope --package package_name

Swift 패키지를 GitHub에서 가져와서 CodeArtifact에 다시 게시하려면

1. 아직 구성하지 않았다면, CodeArtifact를 사용하여 Swift Package Manager 설정의 단계에 따라 적절한 보안 인증과 함께 CodeArtifact 리포지토리를 사용하도록 Swift Package Manager를 구성합니다.

   참고

   생성된 권한 부여 토큰은 12시간 동안 유효합니다. 토큰이 생성된 후 12시간이 경과한 경우 새 토큰을 생성해야 합니다.

2. 다음 git clone 명령을 사용하여 가져오고 다시 게시하려는 Swift 패키지의 git 저장소를 복제합니다. GitHub 리포지토리 복제에 관한 자세한 내용은 GitHub 문서에서 리포지토리 복제를 참조하세요.

   git clone repoURL

3. 방금 복제한 리포지토리로 이동합니다.

   cd repoName

4. 패키지를 생성하여 CodeArtifact에 게시합니다.

   1. 권장: Swift 5.9 이상을 사용하는 경우 다음 swift package-registry publish 명령을 사용하여 패키지를 생성하고 구성된 CodeArtifact 저장소에 게시할 수 있습니다.

      swift package-registry publish packageScope.packageName versionNumber

      예시:

      swift package-registry publish myScope.myPackage 1.0.0

   2. 5.9 이전의 Swift 버전을 사용하는 경우 swift archive-source 명령을 사용하여 패키지를 생성한 다음 Curl 명령을 사용하여 패키지를 게시해야 합니다.

      1. CODEARTIFACT_AUTH_TOKEN 및 CODEARTIFACT_REPO 환경 변수를 구성하지 않았거나 구성한 지 12시간이 넘었다면 로그인 명령 없이 Swift 구성의 다음 단계를 따르세요.

      2. swift package archive-source 명령을 사용하여 Swift 패키지 생성:

         swift package archive-source

         성공하면 명령줄에 Created package_name.zip이 표시됩니다.

      3. 다음 Curl 명령을 사용하여 CodeArtifact에 Swift 패키지를 게시합니다.

         macOS and Linux

         curl -X PUT  --user "aws:$CODEARTIFACT_AUTH_TOKEN" \
         -H "Accept: application/vnd.swift.registry.v1+json" \
         -F source-archive="@package_name.zip" \
         "${CODEARTIFACT_REPO}my_scope/package_name/packageVersion"

         Windows

         curl -X PUT  --user "aws:%CODEARTIFACT_AUTH_TOKEN%" \
         -H "Accept: application/vnd.swift.registry.v1+json" \
         -F source-archive="@package_name.zip" \
         "%CODEARTIFACT_REPO%my_scope/package_name/packageVersion"

5. 패키지가 게시되었고 리포지토리에 존재하는지 여부는 콘솔에서 확인하거나 다음과 같은 aws codeartifact list-packages 명령을 사용하여 확인할 수 있습니다.

   aws codeartifact list-packages --domain my_domain --repository my_repo

   다음과 같이 aws codeartifact list-package-versions 명령을 사용하여 패키지의 단일 버전을 나열할 수 있습니다.

   aws codeartifact list-package-versions --domain my_domain --repository my_repo \
   --format swift --namespace my_scope --package package_name