iOS 프로젝트 빌드
맥북에 설치되어 있는 Xcode 를 이용하여 프로젝트를 빌드합니다.
프로젝트 오픈
App Builder 에서 다운로드 받은 프로젝트 zip 파일을 압축을 풀어 Xcode 로 열어보겠습니다. Finder 에서 프로젝트 소스 폴더 안에 .xcodeproj 파일을 더블클릭 하면 맥북에 설치 되어 있는 Xcode 에서 프로젝트를 열 수 있습니다. (Xcode 에서 File > Open 을 이용하여 프로젝트를 열 수도 있습니다.)
맥북에 Xcode 가 없는 경우 아래 링크를 접속하여 설치합니다.
참고 URL : https://apps.apple.com/kr/app/xcode/id497799835?mt=12
문서를 작성하는 시점의 Xcode Version 은 12.4 입니다.
업데이트가 진행되며 달라지는 부분이 있을 수 있으니 상위 버전의 경우 확인 부탁 드립니다.
프로젝트의 기본 정보를 확인합니다.
General
Identity 정보를 확인 합니다. 수정 할 수 있습니다.
1 Display Name 값은 디바이스에 앱이 설치되면 아이콘 아래 보이는 NAME 값 입니다. 2 Bundle Identifier 는 프로젝트를 생성했을 시 Package 명과 동일하게 작성합니다. 3 Version 과 Build 정보는 앱 스토어에서 앱을 업데이트 할 때 사용합니다. 예) 1.0.0 에서 1.0.1 로 올리고 앱스토어에서 앱을 업데이트 할 수 있습니다. 4 설치할 디바이스 정보를 체크합니다. iPhone 에서만 사용할 경우 iPad 체크를 해제합니다. 5 Portrait 만 체크된 경우 가로로 디바이스를 회전 시켜도 세로 고정으로 앱을 보실 수 있습니다.
App 에서 사용할 Icon 이미지를 셋팅합니다. 오른쪽 화살표를 선택하여 각 사이즈에 맞는 이미지를 셋팅합니다. 각 사이즈의 이미지는 미리 준비하셔야 합니다.
Icons 이미지는 Xcode 에서 원하는 사이즈만 올릴 수 있습니다.
이미지에는 라운드와 투명도 처리가 되 있는 경우 스토어에 배포하실 수 없습니다.
각 해상도에 맞는 px 이미지 사이즈를 준비하여 drag & drop 을 이용하여 이미지 아이콘을 셋팅합니다.
이미지 해상도 정보 (px) 이미지 필요.
iPhone Notification iOS 7-14 20pt
20pt - 2x - 40x40 (px)
20pt - 3x - 60x60
iPhone Settings iOS 7-14 29pt
29pt - 1x - 29x29
29pt - 2x - 58x58
29pt - 3x - 87x87
iPhone Spotlight iOS 7-14 40pt
40pt - 2x - 80x80
40pt - 3x - 120x120
iPhone App iOS 5, 6 57pt
57pt - 1x - 57x57
57pt - 2x - 114x114
iPhone App iOS 7-14 60pt
60pt - 2x - 120x120
60pt - 3x - 180x180
iPad Notification iOS 7-14 20pt
20pt - 1x - 20x20
20pt - 2x - 40x40
iPad Settings iOS 7-14 29pt
29pt - 1x - 29x29
29pt - 2x - 58x58
iPad Spotlight iOS 7-14 40pt
40pt - 1x - 40x40
40pt - 2x - 80x80
iPad App iOS 7-14 76pt
76pt - 1x - 76x76
76pt - 2x - 152x152
iPad Pro (12.9-Inch) App iOS 9-14
83,5pt - 2x - 167x167
App Store iOS
1024pt - 1024x1024
Signing & Capabilities
Provisioning Profile 을 확인 이 전에 만든 프로비저닝 파일과 다르다면 수정해서 사용합니다.
Info
Custom iOS Target Properties 값을 확인합니다.
App Uses Non-Exempt Encryption 을 no 로 설정합니다.
App Uses Non-Exempt Encryption 을 no 로 설정 하셔야 "수출 규정 관련 문서가 누락됨 경고 메세지" 를 회피하실 수 있습니다. 프로퍼티에서 보이지 않을 경우 프로퍼티를 추가하여 작성합니다.
국가에서 국가로 물자나 기술이 이동을 해야 하는 경우 국제안보에 위협 소지가 있으면 허가를 받아야 합니다. 소프트웨어도 이에 해당합니다. 소프트웨어는 암호화, 정보 보안 관련 제품이 규제 대상이고 사용을 안하면 no 를 셋팅합니다. 규제대상인 경우 해당 기관에 승인을 받아야 하고 스토에 배포에 맞게 문서를 제출합니다.
Build Settings
Code Signing Identity 를 iOS Distribution 으로 셋팅합니다. iOS Distribution 을 사용하셔야지만 앱 스토어에 배포가 가능합니다.
Build Project
Project > Build 를 선택합니다.
Build Succeeded 팝업을 확인합니다.
iOS 프로젝트 Archive
Xcode 를 이용하여 Archive 를 진행합니다. Validate App 을 통해 검증을 하고 Distribute App 을 이용해 배포를 진행합니다.
Archive 를 사용하기 위해 선행 작업이 필요합니다.
개발용 디바이스 준비하고 맥북과 디바이스를 연결합니다. 디바이스와 연결이 안 되 있는 경우 Archive 기능을 사용할 수 없습니다.
예) 준비물 iPhone , iPad, 디바이스 연결 케이블 ( 맥북 + 디바이스 연결)
Any iOS Device 형태(에뮬레이터) 로 설정 되어 있으면 Archive 메뉴가 비활성화 됩니다.
실제 디바이스(iPhone, iPad) 와 케이블을 연결한 후 디바이스에서 '신뢰함' 을 선택합니다. 메뉴에 디바이스 정보가 보이면 선택합니다.
디바이스(iPhone, iPad) 와 케이블을 연결한 후 디바이스에서 '신뢰함' 을 선택합니다. 메뉴에 디바이스 정보가 보이면 선택합니다.
디바이스(iPhone, iPad) 와 케이블을 연결하여 Archive 메뉴를 선택합니다.
Validate App
Validate App 기능을 이용해 앱에서 발생하는 에러사항을 판단합니다. 앱스토어 배포 이 전에 앱에서 에러가 발생하는지 확인하는 작업입니다. Vailidate App 버튼을 선택합니다.
Upload your app's symbols ... 체크박스를 선택한 후 Next 버튼을 선택합니다. (Apple에서 보고서를 수신하도록 앱을 업데이트 합니다.)
생성한 Profiles 를 선택하고 Next 버튼을 선택합니다.
app 정보를 확인하고 Validate 버튼을 선택합니다.
정상적으로 빌드가 되었으면 Done 버튼을 선택합니다.
에러 메시지
No App Store Connect accout 에러 발생 시 Xcode 를 종료하고 맥북을 재부팅 하면 해결되는 에러입니다.
Distribute App
Distribute App 을 이용해 App Stroe 에 iOS 앱을 배포합니다. Validate App 을 선택해서 진행 했을 때와 과정이 거의 비슷합니다. Distribute App 버튼을 선택합니다.
App Store Connect 라디오를 선택하고 Next 버튼을 선택합니다.
App Store Connect 라디오를 선택하고 Next 버튼을 선택합니다.
Upload your app's symbols ... 체크박스를 선택한 후 Next 버튼을 선택합니다.
생성한 Profiles 를 선택하고 Next 버튼을 선택합니다.
app 정보를 확인하고 Validate 버튼을 선택합니다.
Uploading 과정을 기다립니다.
Archive upload complete 성공 메시지를 확인합니다.
에러 메시지
동일한 버전으로 Distribute App 을 진행할 경우 흔히 볼 수 있는 에러 메시지 입니다.
General 에 Version 과 Build 정보를 업데이트 합니다.
예) 1.0.8 -> 1.0.9