Flutter iOS 빌드 및 Firebase 연결 오류 해결 (2025.11.05)

iOS 첫 빌드가 느린 이유

iOS 프로젝트를 처음 빌드할 때는 다음 모든 과정이 처음부터 실행되기 때문에 시간이 오래 걸린다.

• pod install : CocoaPods 의존성 설치
• Xcode build : iOS용 네이티브 코드 빌드
• linking : Flutter 코드와 네이티브 프레임워크 연결
• simulator boot : iOS 시뮬레이터 실행

⏱ 첫 빌드는 보통 5~15분 소요, 이후엔 캐시 덕분에 1~2분으로 단축된다.

---

2. CocoaPods 오류 해결 (pod install 실패 시)

• 터미널에서 다음 명령 실행:
•  
  pod repo update pod install
• platform :ios, '15.0' 설정이 주석 처리되어 있으면 반드시 해제해야 함.
  (ios/Podfile 내 상단에 위치)

이 과정을 거치면 대부분의 pod 관련 빌드 에러가 해결된다.

---

3. 시뮬레이터 실행 오류 해결

• 오류 메시지:
•  
  "iOS 26.1 not installed"
• 해결 방법:
  1. Xcode > Settings > Components 이동
  2. iOS 26.1 Simulator 설치
  3. 설치 후 터미널에서 실행:
  4.  
     open -a Simulator flutter run -d "iPhone 16e"

---

4. Info.plist XML 오류 해결

오류 원인:

• <key> 또는 <string> 태그가 닫히지 않았거나 중첩 구조가 깨짐

해결 방법:

• XML 구조를 아래처럼 올바르게 수정:
•  
  <key>CFBundleDisplayName</key> <string>My App</string>

이후 빌드 시 정상적으로 Info.plist가 읽힌다.

---

5. Firebase 연결 오류 해결

오류 메시지:

 

DefaultFirebaseOptions not configured

해결 방법:

1. Firebase CLI 설정:
2.  
   flutterfire configure
3. iOS 플랫폼 선택 후, firebase_options.dart 자동 생성
4. main.dart에 다음 코드 추가:
5.  
   await Firebase.initializeApp( options: DefaultFirebaseOptions.currentPlatform, );

---

6. Dart 코드 오류 정리

오류 메시지원인해결 방법

Dead code	return 이후 코드가 존재	불필요한 코드 제거
The body might complete normally	모든 if/else 분기에서 return 누락	모든 조건문에 return 추가

---

오늘의 핵심 정리

• iOS 첫 빌드는 느리지만 캐시 이후엔 빠르게 빌드 가능
• CocoaPods 오류는 repo update + Podfile 수정으로 해결
• 시뮬레이터 버전이 맞지 않으면 Xcode > Components에서 설치
• Info.plist는 XML 구조를 꼼꼼히 확인
• Firebase 오류는 flutterfire configure로 대부분 해결
• Dart 경고는 return 및 코드 흐름 점검으로 정리 가능