Fastlane 자동 배포 시 발생할 수 있는 오류는 무엇인지?

Q1: Fastlane 실행 시 “No such file or directory” 오류가 발생합니다. 왜 그런가요?
A1: 보통 Fastfile, Appfile 또는 관련 인증서 경로가 잘못 설정되었을 때 발생합니다. 파일 경로를 다시 확인하고, 프로젝트 루트 디렉토리에서 명령어를 실행하고 있는지 점검하세요.

---

Q2: 인증서(certificate) 관련 오류가 발생하며 “Could not find matching provisioning profile” 메시지가 나옵니다. 어떻게 해결하나요?
A2: Fastlane이 사용하는 프로비저닝 프로필이나 인증서가 로컬에 없거나 유효하지 않은 경우입니다. `match`를 사용하는 경우 `fastlane match nuke`로 리셋 후 다시 동기화하거나 Apple Developer Portal에서 프로필/인증서를 재생성하고 Fastlane에 올바르게 설정했는지 확인하세요.

---

Q3: “Unauthorized Access” 또는 “403 Forbidden” 에러가 뜹니다. Fastlane과 연동된 Apple 계정 문제가 있나요?
A3: Apple Developer Portal 또는 App Store Connect API 키에서 권한 부족, 계정 잠금, 2단계 인증 미설정 등이 원인입니다. Apple ID 로그인 상태와 API 키 권한, 2FA 설정을 점검하고, 필요한 경우 Apple 계정 암호나 토큰을 갱신하세요.

---

Q4: “Xcodebuild fails with exit code 65” 에러입니다. 어떻게 디버깅해야 하나요?
A4: 빌드 중 Xcode 관련 오류입니다. Xcode 버전 호환성, 프로젝트 설정, 코드 서명 설정을 확인하세요. 또한, `fastlane gym` 명령어 실행 시 상세 로그를 활성화하여 원인을 파악합니다.

---

Q5: “Could not find the provisioning profile matching the bundle identifier” 오류가 계속 납니다. 해결책은?
A5: bundle identifier가 Apple Developer Portal에 등록된 프로비저닝 프로필과 일치하지 않을 때 발생합니다. Fastlane의 Appfile과 프로젝트 내 bundle identifier가 동일한지, 프로비저닝 프로필이 이 값을 정확히 포함하는지 확인하세요.

---
Q6: Fastlane이 App Store Connect에 앱을 업로드하지 못하며 “Timeout” 에러가 발생합니다.
A6: 네트워크 문제일 수 있습니다. 인터넷 연결 상태를 점검하고, Fastlane에서 `upload_to_app_store` 액션 시 timeout 시간을 늘리거나 재시도 옵션을 사용해 보세요.

---

Q7: 햇수동 빌드 시 오류 없이 성공했는데, Fastlane으로 빌드 시 오류가 나는 이유는?
A7: 환경 변수, 작업 디렉토리, Xcode 명령어 옵션 등이 수동 빌드와 달라서 발생합니다. Fastlane 스크립트 내 설정과 수동 빌드 과정을 비교해 환경 세팅이 일치하는지 검토하세요.

---

Q8: “Unable to authenticate” 오류가 나면서 fastlane login이 실패합니다.
A8: Apple ID 비밀번호, 앱 전용 비밀번호, API 키 설정이 잘못되었을 수 있습니다. 인증 정보를 재확인하고, 2단계 인증 또는 앱 전용 비밀번호를 반드시 사용해야 합니다.

---

Q9: Fastlane 실행 중 “Missing or invalid credentials” 오류 메시지가 표시됩니다.
A9: `fastlane credentials`에 저장된 인증 정보 또는 `.env` 파일 등에 선언된 환경변수가 올바르지 않거나 만료됐을 수 있습니다. 인증 정보를 재발급받아 갱신하세요.

---

Q10: Fastlane에서 `deliver` 실행 시 스크린샷 업로드 실패가 발생합니다.
A10: 스크린샷 이미지 경로나 형식, 크기 제한을 확인하세요. 지원하는 해상도 및 파일 형식(PNG, JPG)을 준수해야 하며, 경로 설정이 올바른지 확인해 주세요.

---

위와 같은 공통 오류들은 Fastlane 설정, 인증서/프로비저닝 프로필 관리, Apple Developer 계정 권한 문제, 네트워크 상태, 그리고 Xcode 및 프로젝트 설정 등에서 자주 발생합니다. 문제 발생 시 로그를 꼼꼼히 확인하고 공식 문서 및 커뮤니티 참고하여 단계별로 점검하는 것이 중요합니다.

Fastlane은 iOS 및 Android 애플리케이션의 자동화를 지원하는 도구로, 앱 배포 프로세스를 굉장히 간편하게 만들어줍니다.

그러나 Fastlane을 사용하면서 여러 가지 오류가 발생할 수 있습니다.

아래는 일반적으로 발생할 수 있는 오류와 그 해결 방법에 대해 설명합니다.

1. 인증서 및 프로비저닝 프로파일 오류 - 문제 : 인증서 또는 프로비저닝 프로파일이 잘못되었거나 만료되었을 수 있습니다.

- 해결 : Xcode에서 인증서 및 프로비저닝 프로파일을 확인하고, Fastlane에서 사용하는 인증서와 프로파일이 올바르게 설정되었는지 확인합니다.



2. Fastlane Gem 설치 문제 - 문제 : Fastlane이 의존하는 gem이 누락되거나 잘못된 버전일 수 있습니다.

- 해결 : Gemfile을 사용하여 Fastlane 버전을 관리하고, `bundle install` 명령어로 필요한 gem을 설치합니다.



3. 계정 로그인 정보 오류 - 문제 : Apple Developer 계정 로그인 정보가 잘못되었거나, 너무 많은 로그인 시도로 인해 계정이 잠길 수 있습니다.

- 해결 : `fastlane pilot` 및 `fastlane deliver`에서 사용하는 계정 정보를 확인하고, Apple Developer 사이트에서 직접 로그인하여 계정 상태를 점검합니다.



4. 접근 권한 문제 - 문제 : CI/CD 환경에서 필요한 권한이 부족할 수 있습니다.

- 해결 : CI/CD 설정에서 Fastlane이 필요한 권한을 보유하고 있는지 확인합니다.

예를 들어, SSH 키나 접근 토큰 설정을 점검해야 합니다.



5. 빌드 오류 - 문제 : Xcode 프로젝트에서 빌드 오류가 발생할 수 있습니다.

- 해결 : Xcode에서 직접 프로젝트를 열고 빌드를 시도하여 발생하는 오류를 찾고 해결합니다.

Fastlane이 빌드를 시작할 때는 항상 최신 상태의 코드를 기반으로 하여야 합니다.



6. 환경 변수 문제 - 문제 : 필요한 환경 변수가 제대로 설정되지 않았을 수 있습니다.

- 해결 : `.env` 파일을 확인하거나 CI/CD 환경의 환경 변수를 설정해줍니다.



7. 네트워크 문제 - 문제 : Apple의 서버에 연결할 수 없는 경우가 있습니다.

- 해결 : 인터넷 연결 상태를 점검하고, 특정 서버의 장애 여부를 확인합니다.



8. 배포 스크립트 오류 - 문제 : Fastlane 배포 설정에서 오타나 잘못된 설정이 있을 수 있습니다.

- 해결 : `Fastfile` 및 관련 설정 파일을 검토하여 모든 설정이 올바른지 확인합니다.



9. App Store 연결 문제 - 문제 : App Store Connect API에 연결하는 과정에서 발생할 수 있는 오류입니다.

- 해결 : API key 및 관련 설정이 올바르게 되어있는지, 해당 API 키의 유효성을 확인합니다.



10. 라이브러리 업데이트 필요 - 문제 : Fastlane의 특정 기능이 deprecated되었거나, 최신 버전으로 업데이트가 필요할 수 있습니다.

- 해결 : Fastlane 및 관련 플러그인의 최신 버전을 설치하여 업데이트합니다.

결론 Fastlane은 매우 강력한 도구이지만, 위와 같은 다양한 오류가 발생할 수 있습니다.

이러한 문제를 미리 인지하고 해결 방법을 숙지함으로써, 보다 효율적으로 배포 프로세스를 관리할 수 있습니다.

주기적으로 Fastlane 문서를 참조하고 커뮤니티 시스템을 활용하여 최신 정보를 확보하는 것도 좋은 방법입니다.