Flutter 앱 App Store에 제출하는 방법

Android Studio로 Flutter 개발을 진행하고 Github에 업로드했다면 맥 환경에 Xcode만 다운되어 있어도 앱스토어 업로드가 가능하다. 우선 Xcode에 Github에 저장해놓은 프로젝트를 불러온다. Github clone을 이용하면 될 것 같았지만 내 컴퓨터에서는 기능이 제대로 작동하지 않았다. 그래서 나는 Github에서 프로젝트 파일을 직접 컴퓨터에 다운받은 뒤에 File -> Open을 통해서 파일을 열였다. 이때 Flutter 프로젝트의 Root를 선택하면 파일이 안열리고 프로젝트 Root -> ios 폴더를 선택해서 열어야한다. 그러면 Runner 폴더가 열린다. lib파일을 안불러왔는데 괜찮은건가 싶지만 괜찮다.

 

Runner 폴더를 불러왔으면 왼쪽에서 더블클릭해서 설정창을 띄운다. 여기서 Signing & Capabilities로 들어간다. 그뒤 Signing 부분에서 Apple Developer 계정을 연결해준다. 앱이 빌딩될때 자동으로 서명을 해주기 위해 필요한 과정이다.

완료되면 아래와 같이 해당하는 Team을 선택해주고 Signing Certificate에 계정명이 표시된다.

Runner 더블클릭 => Signing & Capabilities 클릭

 

 

CMD에서 다음 명령어를 실행해서 flutter SDK path를 설정해준다. (물론 PC에 Mac용 Flutter가 설치되어 있어야한다.)

이 경우 Flutter를 Downloads 폴더에 다운받은 상태였는데 다른 경우에는 어떤지 테스트가 필요하다.

cd ~/Downloads
export PATH="$PATH:`pwd`/flutter/bin"
flutter doctor

계속 안되면 cmd를 껏다 킨다음 처음부터 다시 입력해보자. 되는 경우가 있다.

 

 

만약 프로젝트에서 flutter 플러그인을 사용했으면 cocoapods를 설치해야한다. flutter doctor로 검사했을 때 xcode 관련 메시지에서 cocoapods를 설치하라는 경고 메시지를 확인할 수 있다. cmd에 다음 명령어를 입력해준다.

sudo gem install cocoapods

한 줄 실행해주면 알아서 잘 깔린다!

flutter doctor로 잘 설치되었는지 확인해준다. 아까 본 경고메시지가 사라졌다면 성공이다.

 

 

Github에서 프로젝트를 가져온 경우에 ios 빌드에 필요한 파일들이 누락되는 경우가 있다. 빌드에 필요한 파일들을 생성해주기 위해 다음 명령어를 실행해야 한다. CMD에서 해당 프로젝트의 root 폴더로 이동한 뒤 거기에서 flutter clean, flutter build ios를 순차적으로 실행해주면 된다. 약간의 시간이 소요된다.

#예시) Flutter 프로젝트의 root가 Downloads 폴더 내부의 Korea-Univ-Cheer-Song-Player-main 폴더 인 경우

cd ~/Downloads/Korea-Univ-Cheer-Song-Player-main
flutter clean
flutter build ios

순서대로 실행하면 앱 업로드에 필요한 파일들이 생성된다.

 

Xcode 위쪽에 시뮬레이터(iPhone 13이라고 써있는 자리)를 Any iOS Device (arm64)로 변경해준다. 위쪽 메뉴바에서 Product -> Archive 누르고 앱스토어 출시 하라는대로 하고 전송한다. Apple Store Connect 사이트에서 TestFlight로 들어가면 10~15분후에 빌드 파일이 확인 가능하다. 아래 스크린샷처럼 "제출 준비 완료"가 아니라 "수출 규정 관련 문서가 누락됨" 문구가 뜨는 경우가 있는데 옆에 있는 "관리"를 누르고 명시된 암호화 방식을 사용하지 않는다면 "두 방식 모두 사용하지 않음"을 선택한 뒤 완료를 누르면 "제출 준비 완료"로 바로 변경된다.

Apple Store Connect에서 확인 가능한 빌드 파일

 

근데 여기서 제출한 파일에 문자가 있으면 연결된 메일로 오류 내용을 보내주는데 이런 경우에 Apple Store Connect에 빌드 파일이 업로드되지 않는다. 오류를 수정해서 제출해야만 빌드 파일을 확인할 수 있다. 오류 코드를 같이 알려주기 때문에 구글에 검색하면 해결 방법을 알 수 있다. 아래와 같은 경우 "ITMS-90683"이라고만 검색해도 비슷한 사례를 많이 찾을 수 있다. 문제점들을 해결하고 다시 Xcode에서 Product => Archive로 들어가서 App Store에 제출하면 된다.

빌드 파일에 문제가 있는 경우 오는 메일. 위와 같은 메일이 오는 경우 빌드 파일을 App Store Connect에서 확인 못함

 

이제 앱 정보 입력하고 스크린샷 찍어서 빌드 파일과 함께 심사를 요청하면 된다. 리젝 안 당하도록 기도하자!!