Join us for Firebase Summit on November 10, 2021. Tune in to learn how Firebase can help you accelerate app development, release with confidence, and scale with ease. Register

iOS 프로젝트에 Firebase 추가

기본 요건

  • 다음을 설치합니다.

    • Xcode 12.2 이상
    • CocoaPods 1.10.0 이상

  • 프로젝트가 다음 요구사항을 충족하는지 확인합니다.

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

  • 실제 iOS 기기를 설정하거나 iOS 시뮬레이터를 사용하여 앱을 실행합니다.

Xcode 프로젝트가 준비되지 않았지만 Firebase 제품을 사용해 보고자 하는 경우 빠른 시작 샘플 중 하나를 다운로드하세요.

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

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

2단계: Firebase에 앱 등록

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

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

  1. Firebase Console로 이동합니다.

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

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

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

  4. (선택사항) 다른 앱 정보(앱 닉네임 및 App Store ID)를 입력합니다.

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

3단계: Firebase 구성 파일 추가

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

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

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

4단계: 앱에 Firebase SDK 추가

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

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

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

    cd your-project-directory
    pod init

  2. 앱에 사용할 Firebase pod를 Podfile에 추가합니다.

    지원되는 Firebase 제품을 iOS 앱에 추가할 수 있습니다.

    애널리틱스를 사용 설정한 경우

    platform :ios, ‘10.0’
    
# Add the Firebase pod for Google Analytics
pod 'Firebase/Analytics'

# For Analytics without IDFA collection capability, use this pod instead
# pod ‘Firebase/AnalyticsWithoutAdIdSupport’

# Add the pods for any other Firebase products you want to use in your app
# For example, to use Firebase Authentication and Cloud Firestore
pod 'Firebase/Auth'
pod 'Firebase/Firestore'

    Apple의 사용자 개인 정보 보호 및 데이터 사용과 앱 추적 투명성 문서에서 기기 수준 광고 식별자인 IDFA에 대해 자세히 알아보세요.

    애널리틱스를 사용 설정하지 않은 경우

    platform :ios, ‘10.0’
    
# Add the pods for the Firebase products you want to use in your app
# For example, to use Firebase Authentication and Cloud Firestore
pod 'Firebase/Auth'
pod 'Firebase/Firestore'

  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];
  3. Firebase 애널리틱스를 포함한 경우 앱을 실행하여 Firebase를 성공적으로 설치했다는 확인을 Firebase Console에 보낼 수 있습니다.

작업이 끝났습니다. 이제 다음 단계로 진행할 수 있습니다.

설정에 문제가 있는 경우 iOS 문제 해결 및 FAQ를 참조하세요.

사용 가능한 pod

이 섹션에는 iOS에서 지원되는 Firebase 제품과 해당 pod 목록이 나와 있습니다. 다음 Firebase iOS 라이브러리에 대해 자세히 알아보세요.

서비스 또는 제품 pod 애널리틱스 추가 권장
AdMob pod 'Google-Mobile-Ads-SDK'
애널리틱스 pod 'Firebase/Analytics'
App Check pod 'Firebase/AppCheck'
앱 배포 pod 'Firebase/AppDistribution'
인증 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 'Firebase/Crashlytics'
동적 링크 pod 'Firebase/DynamicLinks'
인앱 메시지 pod 'Firebase/InAppMessaging'
(필수)
Firebase 설치 pod 'Firebase/Installations'
Firebase ML Custom Model API pod 'Firebase/MLModelDownloader'
Performance Monitoring pod 'Firebase/Performance'
실시간 데이터베이스 pod 'Firebase/Database'
원격 구성 pod 'Firebase/RemoteConfig'

CocoaPods 없이 통합

CocoaPods를 사용하지 않는다면 프레임워크를 직접 가져오거나 Swift Package Manager를 사용하여 Firebase SDK를 활용할 수 있습니다.

프레임워크

iOS 플랫폼 지원 외에도 zip에는 이제 커뮤니티 기반 Catalyst 지원이 추가된 .xcframework 파일이 포함됩니다. 자세한 내용은 GitHub에서 Firebase iOS SDK README를 참조하세요.

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

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

  3. 타겟의 빌드 설정에서 Other Linker Settings에 ObjC 링커 플래그를 추가합니다.

Swift Package Manager

Swift Package Manager 통합에 관한 자세한 내용은 이 가이드를 참조하세요.

다음 단계

Firebase 알아보기:

앱에 Firebase 서비스 추가: