[iOS] iPhone Development 증명서가 아닌 Apple Development 증명서 요구 이슈

0. 프로비저닝의 개념 및 역할

팀으로 Apple플랫폼의 앱을 만들면 프로비저닝을 마주해야 한다.
프로비저닝은 코드(프로덕션)가 인가된 Apple 개발자로부터 생성됐음을 서명해주는 작업에 쓰인다.
또한 생성시 지정한 증명서를 포함하는데, 이때 목적에 맞는 증명서만 포함하게 함으로써
개발이나 배포 권한에 대한 인가 제한을 걸 수 있다.

1. 문제 발생: Apple Development 증명서 요구

유니페스 개발팀에 들어가면서, 개발자 구독권을 가진 내가 앱을 이전받았다.
이에 발급한 프로비저닝을 팀원과 나눠야 했고, 유니페스는 iOS 플랫폼만이 개발 대상이기에 iOS Developer 증명서만 포함하도록 했다.

이후 프로젝트에 프로비저닝을 설정했으나
프로비저닝이 Apple Development 인증서를 포함하고 있지않아 코드 사이닝이 불가하다는 오류가 발생했다.

2. 문제 재현 - 임의 프로젝트 생성 후 프로비저닝 수동 설정

Apple Development 인증서는 Apple의 모든 플랫폼(iOS, iPadOS, VisionOs, etc...)를 개발할 때 필요하다.
허나 유니페스 프로젝트는 iOS만 타겟으로 하고 있었고, 이론상 iOS Development만으로도 사이닝이 돼야 했다.

이슈 재현을 위해 임의의 새 프로젝트를 만들어 프로비저닝을 수동으로 주입했을 때에도 같은 오류가 발생하는지를 확인했다.

같은 오류가 발생됨을 확인할 수 있다.

3. 문제 분석- 빌드 설정 점검

아래의 사항을 확인했고, 인증서와 프로비저닝에는 문제가 없는것이 확실하다.

• 앱 번들 아이디 일치
• Destination이 iOS만 포함, iOS Development 인증서만으로 사이닝에 충분
• 프로비저닝이 iOS Development 인증서 포함
• 키체인에 iOS Development 인증서 등록
• 키체인에 iOS Development 인증서의 개인키 등록

해당 문제에 관해 서칭했지만, Apple Development를 프로비저닝에 넣으라는 얘기 뿐이었다.
몇번의 프로젝트 생성 - 프로비저닝 수동 삽입 과정을 반복하며 아래의 가설을 세웠다.

첫 프로젝트 생성시에 여러 Destination을 포함하니, 이에 알맞도록 프로젝트의 프로비저닝 관련 설정이 돼 있는것은 아닐까?
그러므로 다른 플랫폼을 삭제해도 프로젝트에서는 여전히 Apple Development를 요구하는 것은 아닐까?

사이닝 관련 설정이 있는지 찾아봤고, Build Setting에서 Signig 섹션을 찾을 수 있었다.

4. 문제 해결 - 사이닝 관련 빌드 설정 변경

XCode 프로젝트 설정 중 사이닝 관련 항목을 공식 문서에서 찾을 수 있었다.

https://developer.apple.com/documentation/xcode/build-settings-reference#Code-Signing-Identity

Code Signing Identity 항목은 유효한 코드-사이닝 증명서를 설정하는 항목으로
유효한 인증서를 설정하지 않으면 빌드 에러를 발생시킨다는 것을 알 수 있었다.
따라서 빌드 설정의 해당 항목에 적절한 증명서를 설정했는지를 점검했다.
(설명이 너무 간략한거 아닙니까 애플 ㅠㅜ)

현재 Any iOS SDK에서 요구하는 프로비저닝의 종류가 iPhone Developer로, 언뜻 보기엔 문제가 없어보였다.
오히려 상위의 Debug 항목에서 Apple Development를 요구하는게 수상해보였다.
그러나 Debug 항목의 프로비저닝 종류를 변경해도 사이닝 문제를 해결하지는 못했다.

문제 없어 보이는 Any iOS SDK의 프로비저닝을 키체인의 iPhone Developer으로 변경 후, 이를 해결할 수 있었다.

이제 iPhone Developer 인증서만으로 개발을 진행할 수 있다!

 

많은 Apple 개발자들이 프로비저닝으로 인해 머리아파 했고, 최근에는 많이 개선됐으나 여전히 이런 버그들이 남아있다.
Apple에서 수많은 XCode 프로젝트의 빌드 설정에 대한 상세 가이드를 제공했으면 하는 바람과 함께 포스팅을 줄인다.

---

https://medium.com/@pramodmanjunath/xcode-provisioning-woes-code-signing-identity-417900705801

Xcode provisioning woes: Code signing identity.

https://developer.apple.com/documentation/xcode/build-settings-reference#Code-Signing-Identity

Build settings reference | Apple Developer Documentation