콘솔로 이동

iOS 프로젝트에 Firebase 추가

기본 요건

시작하기 전에 몇 가지 환경 설정이 필요합니다.

  • Xcode 10.1 이상
  • iOS 8 이상을 타겟팅하는 Xcode 프로젝트
  • Swift 프로젝트의 경우 Swift 3.0 이상 사용
  • 앱의 번들 식별자
  • CocoaPods 1.4.0 이상
  • 클라우드 메시징:
    • 실제 iOS 기기
    • Apple 개발자 계정의 Apple 푸시 알림 인증 키
    • Xcode의 App > Capabilities에서 푸시 알림 사용 설정

Xcode 프로젝트를 준비하지 않았다면 빠른 시작 샘플 중 하나를 다운로드하여 Firebase 기능을 시험해 볼 수 있습니다. 빠른 시작을 사용한다면 프로젝트 설정에서 번들 식별자를 확인해야 합니다. 다음 단계에서 이 식별자가 필요합니다.

앱에 Firebase 추가

앱에 Firebase를 추가할 차례입니다. 그러려면 Firebase 프로젝트 및 앱의 Firebase 구성 파일이 필요합니다. Firebase 프로젝트에 대한 자세한 내용은 Firebase 프로젝트 이해를 참조하세요.

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

  1. iOS 앱에 Firebase 추가를 클릭하고 설정 단계를 따릅니다. 기존 Google 프로젝트를 가져오면 이 단계가 자동으로 이루어지므로 구성 파일만 다운로드하면 됩니다.

  2. 메시지가 표시되면 앱의 번들 ID를 입력합니다. 앱에서 사용하는 번들 ID를 입력해야 합니다. 이 설정은 Firebase 프로젝트에 앱을 추가할 때만 가능합니다.

  3. 앱에 Firebase iOS 구성 파일을 추가합니다.

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

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

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

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

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

SDK 추가

새 프로젝트를 설정할 때는 SDK를 설치해야 합니다. 이 단계는 Firebase 프로젝트를 만들 때 이미 완료했을 수 있습니다.

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

빠른 시작 샘플 중 하나를 다운로드하고 실행하려는 경우 Xcode 프로젝트 및 Podfile은 이미 있지만 pod를 설치하고 GoogleService-Info.plist 파일을 다운로드해야 합니다. 자신의 프로젝트 중 하나에 Firebase 라이브러리를 통합하려면 사용할 라이브러리에 대한 pod를 추가해야 합니다.

  1. 아직 Xcode 프로젝트가 없으면 지금 만듭니다.

  2. Podfile이 없으면 새로 만듭니다.

    $ cd your-project directory
    $ pod init
    
  3. 설치할 pod를 추가합니다. 다음과 같이 Podfile에 Pod를 포함할 수 있습니다.

    pod 'Firebase/Analytics'
    
    

    이렇게 하면 iOS 앱에서 Firebase 및 Firebase용 Google 애널리틱스를 사용하기 위한 필수 라이브러리가 추가됩니다. 현재 사용 가능한 pod 및 하위 스펙은 아래를 참조하세요. 기능별 설정 가이드에도 이 내용이 링크되어 있습니다.

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

    $ pod install
    $ open your-project.xcworkspace
    
  5. Firebase Console에서 GoogleService-Info.plist 파일을 다운로드하여 앱에 포함합니다.

앱에서 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];

사용 가능한 pod

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

pod 서비스
pod 'Firebase/Analytics' 애널리틱스
pod 'Firebase/AdMob' AdMob
pod 'Firebase/Messaging' 클라우드 메시징
pod 'Firebase/Database' 실시간 데이터베이스
pod 'Firebase/DynamicLinks' 동적 링크
pod 'Fabric'
pod 'Crashlytics'
Crashlytics
pod 'Firebase/RemoteConfig' 원격 구성
pod 'Firebase/Auth' 인증
pod 'Firebase/Storage' 저장소
pod 'Firebase/Performance' 성능 모니터링
pod 'Firebase/Firestore' Cloud Firestore
pod 'Firebase/Functions' Firebase용 Cloud Functions 클라이언트 SDK
pod 'Firebase/MLVision' ML Kit Vision API
pod 'Firebase/MLVisionLabelModel' ML Kit 이미지 라벨 지정 모델
pod 'Firebase/MLVisionBarcodeModel' ML Kit 바코드 스캔 모델
pod 'Firebase/MLVisionTextModel' ML Kit 텍스트 인식 모델
pod 'Firebase/MLVisionFaceModel' ML Kit 얼굴 인식 모델
pod 'Firebase/MLNaturalLanguage' ML Kit 자연어 API
pod 'Firebase/MLNLLanguageID' ML Kit 언어 식별 모델
pod 'Firebase/MLNLSmartReply' ML Kit 스마트 답장 모델
pod 'Firebase/MLModelInterpreter' ML Kit 맞춤 모델 API

CocoaPods 없이 통합

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

  1. 프레임워크 SDK zip 파일을 다운로드합니다. 파일 크기는 최대 1GB이며 다운로드하는 데 다소 시간이 걸릴 수 있습니다.
  2. 파일의 압축을 풀고 프로젝트에 포함할 프레임워크의 README 파일을 확인합니다.
  3. 대상의 빌드 설정에서 Other Linker SettingsObjC 링커 플래그를 추가합니다.

다음 단계

Firebase 알아보기:

앱에 Firebase 기능 추가: