문제 해결
레지스트리 도입 시 흔한 문제와 해결 방법.
로그인 후에도 인증 실패 (macOS)
macOS에서 SwiftPM은 netrc보다 Keychain 항목을 우선할 수 있습니다. swiftregistry login 후에도 인증이 안 되면, 레지스트리 호스트의 오래된 Keychain 항목을 지우거나 SwiftPM이 netrc를 쓰도록 구성하세요.
'.package(id:) is unavailable' 오류
레지스트리 의존성은 swift-tools-version 5.7 이상이 필요합니다. Package.swift 상단의 버전을 올리세요.
SwiftPM이 http 레지스트리를 거부
SwiftPM은 기본적으로 평문 http를 차단합니다. https 레지스트리 URL을 쓰세요. 로컬 테스트에 한해 SwiftPM은 --allow-insecure-http를 허용합니다.
해석 후 Package.resolved가 없음
의존성이 없는 패키지는 Package.resolved 파일을 만들지 않습니다 — 오류가 아니라 정상입니다.
그래도 막히면 swiftregistry doctor가 레지스트리 설정을 읽기 전용으로 진단하고, analyze가 해석된 의존성 그래프를 점검합니다.