Apple Enterprise 앱 설치가 안되는 경우

Apple Enterprise 계정으로 In-house 배포한 앱이 갑자기 설치가 안되는 오류가 얼마 전 발생했다.

• '앱 이름' 을(를) 설치할 수 없음 / 무결성을 확인할 수 없기 때문에 이 앱을 설치할 수 없습니다.
• '앱 이름' 을(를) 설치할 수 없음 / 나중에 다시 시도하십시오.
• '앱 이름' 을(를) 실행할 수 없음

위 같은 문구가 뜨며 앱을 설치/실행 할 수 없는 오류였다.

하여, 해당 오류들이 발생하던 원인과 해결 방법에 대해 끄적여보려 한다.

 

1) 인증서 / 프로파일

문제가 발생하던 .ipa 파일 빌드에 사용했던 인증서나 프로파일의 만료일을 확인해보자.

인증서/프로파일의 만료일이 지난 경우엔 당연하게도 앱 실행이나 설치를 할 수가 없다.

만일 어떤 것을 사용했는지 모르겠다면 .ipa 파일로도 확인 해 볼 수 있다.

.IPA 파일을 통해 프로파일 및 배포 인증서 만료일 확인하기

 

 

2) 서버에 있는 .plist

Enterprise 앱 설치를 위해선 .plist 파일을 통해 앱의 정보, .ipa 파일 경로등을 적어주는데

.plist 파일의 내용이 잘못 된 경우엔 앱 설치를 할 수가 없으니 아래 항목들을 검토해보자.

• URL의 프로토콜은 무조건 https 여야만 한다.
• bundle-identifier 에 입력된 번들명이 정확해야 한다.
• title 에 입력된 앱 이름을 한글로 입력한 경우, 해당 문자열이 깨지진 않았는지 확인한다.( Notepad++ 추천)

 

 

3) Xcode Build Setting

사실 위의 두 개 오류가 대부분 이였고, 사내 테스트 기기에선 문제가 없었기에 Xcode Build 환경에 문제가 있을거라곤 생각도 못했다.

다른 Build Setting 들이 문제를 일으키는지는 아직은 잘 모르겠지만, 내가 겪었던 문제는

Xcode > Targets > Build Setting > Product Name 이 한글로 되어 있었는데 이게 설치가 안되는 범인이였다... 

 

문제는 이게 앱이 설치/실행이 잘 되다가 갑자기 어느 순간부터 안되서 앱에 문제가 있을거라곤 생각도 못해 나흘간 삽질한 것 같다.

프로젝트를 할 땐 웬만해서 한글을 사용하지 않는게 정신 건강에도 앱 실행에도 이로운 것 같다.

 

 

추가로 알고 계시는 오류 원인 등이 있으면 댓글로 남겨주세요 :)