iOS SDK
iOS 앱 출시에 필요한 과정을 순서대로 따라하며 진행해보세요.
Last updated
iOS 앱 출시에 필요한 과정을 순서대로 따라하며 진행해보세요.
Last updated
프로젝트 빌드 중 문제가 발생하는 경우 하단의 문제 해결하기를 참고하세요.
샘플 프로젝트를 수정하고 앱 빌드 파일을 만들기 위해서 Apple기기와 Xcode가 필요합니다. 하단 링크 또는 AppStore를 통해 설치해주세요.
Xcode 15 - Apple DeveloperApple Developer
샘플 프로젝트를 사용하면 일부 설정만 변경해서 쉽게 앱을 빌드할 수 있습니다.
플렉스튜디오 git 주소를 복사하여 샘플 프로젝트를 구성합니다.
git 사용이 어려운 경우 아래의 주소에서 샘플 프로젝트를 다운받아 쉽게 사용할 수 있습니다.
번들아이디는 앱을 구분하는 고유한 값입니다. 도메인을 거꾸로 하는 명명 규칙이 일반적입니다.
com.(소속명).(앱이름) [예시] com.flextudio.flexapp
프로젝트 선택 후 Signing & Capabilities > Signing 설정을 확인합니다.
Team 항목에 애플 개발자 계정을 지정합니다.
Bundle Identifier 항목에 사용할 번들아이디를 입력합니다.
앱 설치시 사용자에게 보여질 앱 아이콘을 설정할 수 있습니다.
프로젝트 폴더 하위 Assets > AppIcon을 원하는 앱 아이콘 이미지로 변경합니다.
앱 설치시 사용자에게 보여질 명칭을 정의할 수 있습니다.
프로젝트 선택 후 General > 설정을 확인합니다.
Display Name에 원하는 명칭을 입력합니다.
위치 정확도를 높이기 위한 추가 권한키를 등록합니다.
프로젝트 폴더 하위 Info > Information Property List > 우측 + 추가 버튼을 클릭합니다.
pod을 사용하여 FlextudioSDK를 설치합니다.
터미널에서 pod install 명령어를 실행합니다. 이후 SDK가 업데이트 되는 경우 pod update명령어를 실행합니다.
원하는 iOS Device/Simulators를 선택하고 디버깅을 실행합니다.
새로운 기능을 추가하거나 오류가 개선된 경우 Flextudio SDK, 앱을 업데이트 해야합니다.
SDK 라이브러리 버전 업데이트
pod 설치와 동일하게 sdk를 업데이트 해 주세요.
NFC 기능 사용시 추가 작업이 필요합니다. (SDK 버전 1.0.10 이상)
위치 권한 설정 추가하기를 참고하여 info.plist를 수정해주세요.
NFC 하드웨어에 접근 요청하는 이유
Privacy - NFC Scan Usage Description
Value 예시 : This app requires use NFC to scan NFC tags.
프로젝트에서 +Capability 버튼을 클릭합니다.
Near Field Communication Tag Reading 을 검색하여 추가합니다.
아래와 같이 항목이 추가됩니다.
블루투스 기능 사용시 추가 작업이 필요합니다. (SDK 버전 1.0.10 이상)
위치 권한 설정 추가하기를 참고하여 info.plist를 수정해주세요.
블루투스에 접근 요청하는 이유
Privacy - Bluetooth Always Usage Description
Value 예시 : App needs bluetooth access to connect to nearby devices.
앱 버전 업데이트
최초 앱 등록시에는 변경할 필요가 없습니다. 업데이트할 때 아래의 Version을 변경하고 빌드해주세요. 앱 심사 요청하기 전에 같은 버전으로 다시 빌드하는 경우 Build 숫자를 올려 빌드를 해야합니다.
푸시 알림 기능을 사용하시려면 이 과정을 따라 해주세요. 기능을 사용하지 않는 경우엔 넘어가셔도 좋습니다.
Firebase에 구글 개발자 계정과 동일한 계정으로 로그인합니다.
프로젝트 만들기를 클릭합니다.
프로젝트 이름은 앱의 영문 이름을 기입합니다.
Google 애널리틱스 사용 설정을 합니다. 애널리틱스 설정은 추후에 변경 가능합니다.
iOS 아이콘을 클릭해 앱을 추가합니다.
Apple 번들 ID와 앱 닉네임을 작성합니다.
GoogleService-Info.plist 파일을 다운로드합니다. 이 파일은 Firebase의 안내에 따라 프로젝트 안에 넣어주세요.
Apple 정책에 따라 내용이 변동될 수 있습니다. 상세한 내용은 App Store Connect 공식 문서를 참고해 주세요.
Mac 상단메뉴에서 Product > Archive를 선택합니다.
아카이브가 성공적으로 완료되면 Organizer 팝업이 나타납니다. 버전과 빌드번호 등을 확인하고 Distribute App을 실행합니다.
이후 순차적으로 distribute 과정을 진행합니다.
앱이 없는 경우 App Store Connect 로그인 후 [나의 앱] > [+ 추가 버튼] 을 통해 앱을 생성합니다.
업데이트를 진행할 버전 및 심사 정보를 입력합니다.
초대앱의 경우 SDK설정 페이지를 따라 설정해주세요.
A. 좌측 탐색기에서 Pods 선택 후 문제가 발생하는 특정 라이브러리의 General 탭에서 Minimum Deployments 값을 15.0으로 변경합니다.
필요한 권한 항목을 검색한 후 추가합니다. Privacy - Location Temporary Usage Description Dictionary
추가한 권한 상세가 펼쳐진 상태에서 + 추가 버튼을 클릭하여 상세 설정을 추가합니다. Value에는 이 권한이 필요한 이유를 입력합니다. Key : Value : This app needs accurate location
프로젝트를 우클릭하여 [Show in Finder]를 선택합니다.
프로젝트의 상위 폴더를 우클릭하고 [폴더에서 새로운 터미널 탭 열기]를 선택합니다.
SDK가 설치되면 XCode 프로젝트를 종료하고 .xcworkspace 확장자로 프로젝트를 엽니다.
정상적으로 설정이 완료된 경우 아래와 같이 앱이 실행됩니다.
Xcode 상단의 빌드 타겟을 Any iOS Device로 변경합니다.
