콘솔로 이동

iOS 프로젝트에 Firebase 추가

기본 요건

  • Xcode 10.1 이상을 설치합니다.

  • CocoaPods 1.4.0 이상을 설치합니다.

  • Xcode에서 프로젝트를 엽니다.

    • 프로젝트에서 iOS 8 이상을 타겟팅해야 합니다.

    • Swift 프로젝트에서 Swift 3.0 이상을 사용해야 합니다.

  • 앱을 실행할 실제 iOS 기기 또는 iOS 시뮬레이터를 설정합니다.

    • 클라우드 메시징에는 다음이 필요합니다.

      • 실제 iOS 기기
      • Apple 개발자 계정의 Apple 푸시 알림 인증 키
      • Xcode의 App(앱) > Capabilities(기능)에서 푸시 알림 사용 설정
    • 다른 모든 Firebase 제품의 경우 실제 iOS 기기 또는 iOS 시뮬레이터를 사용할 수 있습니다.

  • Google 계정을 사용하여 Firebase에 로그인합니다.

Xcode 프로젝트가 준비되지 않았다면 빠른 시작 샘플 중 하나를 다운로드하여 Firebase 제품을 사용해 볼 수 있습니다.

1단계: Firebase 프로젝트 만들기

Firebase를 iOS 앱에 추가하려면 먼저 iOS 앱에 연결할 Firebase 프로젝트를 만드세요. Firebase 프로젝트에 대한 자세한 내용은 Firebase 프로젝트 이해를 참조하세요.

2단계: Firebase에 앱 등록

Firebase 프로젝트가 준비되었으면 iOS 앱을 추가할 수 있습니다.

여러 빌드 변형을 처리하는 방법을 비롯하여 앱을 Firebase 프로젝트에 추가할 때의 권장사항 및 고려사항을 자세히 알아보려면 Firebase 프로젝트 이해를 참조하세요.

  1. Firebase Console의 프로젝트 개요 페이지 중앙에 있는 iOS 아이콘을 클릭하여 설정 워크플로를 시작합니다.

    Firebase 프로젝트에 앱을 이미 추가한 경우 앱 추가를 클릭하여 플랫폼 옵션을 표시합니다.

  2. iOS 번들 ID 필드에 앱의 번들 ID를 입력합니다.

    • XCode에서 앱을 열고 최상위 Runner 디렉터리의 General(일반) 탭에 액세스하여 이 번들 ID를 찾습니다. Bundle Identifier(번들 식별자) 필드의 값이 iOS 번들 ID입니다(예: com.yourcompany.yourproject).
  3. (선택사항) 설정 워크플로의 안내를 따라 기타 앱 정보를 입력합니다.

  4. 앱 등록을 클릭합니다.

3단계: Firebase 구성 파일 추가

  1. Download GoogleService-Info.plist(GoogleService-Info.plist 다운로드)를 클릭하여 Firebase iOS 구성 파일(GoogleService-Info.plist)을 가져옵니다.

    • 언제든지 다시 Firebase iOS 구성 파일을 다운로드할 수 있습니다.

    • 구성 파일에 (2)와 같은 문자가 추가되지 않았는지 확인합니다.

  2. 구성 파일을 Xcode 프로젝트의 루트로 이동합니다. 메시지가 표시되면 모든 대상에 구성 파일을 추가하도록 선택합니다.

프로젝트에 번들 ID가 여러 개 있으면 각각 자체 GoogleService-Info.plist 파일이 포함되도록 각 번들 ID를 Firebase Console의 등록된 앱에 연결해야 합니다.

4단계: 앱에 Firebase SDK 추가

CocoaPods를 사용하여 Firebase 라이브러리를 설치하는 것이 좋습니다. 하지만 CocoaPods를 사용하지 않으려는 경우 SDK 프레임워크를 직접 통합할 수 있습니다.

빠른 시작 샘플 중 하나를 사용할 경우 Xcode 프로젝트 및 Podfile(pod 포함)이 이미 있어도 Firebase 구성 파일을 추가하고 pod를 설치해야 합니다.

지원되는 Firebase 제품을 iOS 앱에 추가할 수 있습니다. Firebase용 Google 애널리틱스로 시작하는 것이 좋습니다.

  1. Podfile이 없으면 하나 만듭니다.

    cd your-project-directory
    pod init
  2. 앱에 사용할 pod를 Podfile에 추가합니다. 예를 들어 애널리틱스의 경우는 다음과 같습니다.

    pod 'Firebase/Analytics'

    이 pod는 iOS 앱에서 Firebase 및 Firebase용 Google 애널리틱스를 사용하기 위한 필수 라이브러리를 추가합니다.

  3. pod를 설치하고 .xcworkspace 파일을 열어 Xcode에서 프로젝트를 확인합니다.

    pod install
    open your-project.xcworkspace

5단계: 앱에서 Firebase 초기화

마지막 단계는 애플리케이션에 초기화 코드를 추가하는 것입니다. 앱에 Firebase를 추가할 때 이 단계를 이미 완료했을 수 있습니다. 빠른 시작 샘플 프로젝트를 사용하는 경우 이 단계는 이미 완료되어 있습니다.

  1. UIApplicationDelegate에서 Firebase 모듈을 가져옵니다.

    Swift

    import Firebase

    Objective-C

    @import Firebase;
  2. 일반적으로 앱의 application:didFinishLaunchingWithOptions: 메서드에서 FirebaseApp 공유 인스턴스를 구성합니다.

    Swift

    // Use Firebase library to configure APIs
    FirebaseApp.configure()

    Objective-C

    // Use Firebase library to configure APIs
    [FIRApp configure];

초기화 코드를 추가한 후 앱을 실행하여 Firebase를 성공적으로 설치했다는 확인을 Firebase Console에 보냅니다.

사용 가능한 pod

다양한 Firebase 제품에 다음과 같은 pod를 사용할 수 있습니다.

제품 pod
AdMob pod 'Firebase/AdMob'
애널리틱스 pod 'Firebase/Analytics'
인증 pod 'Firebase/Auth'
Cloud Firestore pod 'Firebase/Firestore'
Firebase용 Cloud Functions 클라이언트 SDK pod 'Firebase/Functions'
클라우드 메시징 pod 'Firebase/Messaging'
Cloud Storage pod 'Firebase/Storage'
Crashlytics pod 'Fabric'
pod 'Crashlytics'
동적 링크 pod 'Firebase/DynamicLinks'
인앱 메시지 pod 'Firebase/InAppMessaging'
인앱 메시지 표시 pod 'Firebase/InAppMessagingDisplay'
ML Kit: Vision API pod 'Firebase/MLVision'
ML Kit: 이미지 라벨 지정 모델 pod 'Firebase/MLVisionLabelModel'
ML Kit: 바코드 스캔 모델 pod 'Firebase/MLVisionBarcodeModel'
ML Kit: 텍스트 인식 모델 pod 'Firebase/MLVisionTextModel'
ML Kit: 얼굴 인식 모델 pod 'Firebase/MLVisionFaceModel'
ML Kit: 객체 감지 및 추적 모델 pod 'Firebase/MLVisionObjectDetection'
ML Kit: Natural Language API pod 'Firebase/MLNaturalLanguage'
ML Kit: 언어 식별 모델 pod 'Firebase/MLNLLanguageID'
ML Kit: 번역 모델 pod 'Firebase/MLNLTranslate'
ML Kit: 스마트 답장 모델 pod 'Firebase/MLNLSmartReply'
ML Kit: Custom Model API pod 'Firebase/MLModelInterpreter'
ML Kit: AutoML Vision Edge API pod 'Firebase/MLVisionAutoML'
Performance Monitoring pod 'Firebase/Performance'
실시간 데이터베이스 pod 'Firebase/Database'
원격 구성 pod 'Firebase/RemoteConfig'

CocoaPods 없이 통합

Cocoapods를 사용하지 않는다면 프레임워크를 직접 가져와서 Firebase SDK를 활용할 수 있습니다.

  1. 프레임워크 SDK zip 파일을 다운로드합니다. 파일 크기는 최대 1GB이며 다운로드하는 데 다소 시간이 걸릴 수 있습니다.

  2. 압축을 푼 다음 앱에 포함할 프레임워크의 README를 검토합니다.

  3. 대상의 빌드 설정에서 Other Linker SettingsObjC 링커 플래그를 추가합니다.

다음 단계

Firebase 알아보기:

앱에 Firebase 기능 추가: