iOS 프로젝트에 Firebase 추가

필수 조건

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

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

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

앱에 Firebase 추가

앱에 Firebase를 추가할 차례입니다. 이를 위해 Firebase 프로젝트 및 앱의 Firebase 구성 파일이 필요합니다.

Firebase 프로젝트를 만드는 방법은 다음과 같습니다.

  1. 기존 Firebase 프로젝트가 없다면 Firebase 콘솔에서 프로젝트를 만듭니다. 프로젝트 추가를 클릭합니다. 모바일 앱에 연결된 기존 Google 프로젝트가 있으면 프로젝트 이름을 드롭다운 메뉴에서 선택합니다. 기존 프로젝트가 없는 경우 프로젝트 이름을 입력하여 새 프로젝트를 만듭니다.
  2. 선택사항: Project ID를 수정합니다. 프로젝트에는 고유 ID가 자동으로 지정며, 고유 ID는 데이터베이스 URL 및 Firebase 호스팅 하위 도메인과 같이 공개적으로 표시되는 Firebase 기능에 사용됩니다. 특정 하위 도메인을 사용하려는 경우 변경할 수 있습니다.
  3. 나머지 설정 단계를 따르고 프로젝트 만들기(기존 프로젝트를 사용 중인 경우 Firebase 추가)를 클릭하여 프로젝트 리소스 프로비저닝을 시작합니다. 이 작업은 일반적으로 몇 분 정도 걸립니다. 프로세스가 완료되면 프로젝트 개요로 이동하게 됩니다.

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

  1. iOS 앱에 Firebase 추가를 클릭하고 설정 단계를 따릅니다. 기존 Google 프로젝트를 가져오면 이 단계가 자동으로 이루어지므로 구성 파일만 다운로드하면 됩니다.
  2. 메시지가 표시되면 앱의 번들 ID를 입력합니다. 앱에서 사용하는 번들 ID를 입력해야 합니다. 이 설정은 Firebase 프로젝트에 앱을 추가할 때만 가능합니다.
  3. 이 프로세스 중에 GoogleService-Info.plist 파일을 다운로드하게 됩니다. 언제든지 다시 이 파일을 다운로드할 수 있습니다.
  4. 초기화 코드를 추가한 후 앱을 실행하여 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/Core'
    
    

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

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

    $ pod install
    $ open your-project.xcworkspace
    
  5. Firebase 콘솔에서 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/Core' 필수 조건 라이브러리 및 애널리틱스
pod 'Firebase/AdMob' AdMob
pod 'Firebase/Messaging' 클라우드 메시징
pod 'Firebase/Database' 실시간 데이터베이스
pod 'Firebase/Invites' 초대
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 함수 클라이언트 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(기기별 얼굴 인식)

CocoaPods 없이 통합

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

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

다음 단계

Firebase 알아보기:

앱에 Firebase 기능 추가:

다음에 대한 의견 보내기...

도움이 필요하시나요? 지원 페이지를 방문하세요.