전제 조건
다음을 설치합니다.
- Xcode 13.3.1 이상
프로젝트가 다음 요구 사항을 충족하는지 확인하십시오.
- 프로젝트는 다음 플랫폼 버전 이상을 대상으로 해야 합니다.
- 아이폰 OS 11
- 맥OS 10.13
- tvOS 12
- 워치 OS 6
- 프로젝트는 다음 플랫폼 버전 이상을 대상으로 해야 합니다.
실제 Apple 기기를 설정하거나 시뮬레이터를 사용하여 앱을 실행합니다.
Apple 플랫폼의 클라우드 메시징에 대한 전제 조건은 다음과 같습니다.
- 실제 Apple 기기 를 설정합니다.
- Apple 개발자 계정 에 대한 Apple 푸시 알림 인증 키를 얻습니다.
- App > Capabilities 아래의 Xcode에서 푸시 알림을 활성화합니다.
- Google 계정을 사용하여 Firebase에 로그인 합니다.
아직 Xcode 프로젝트가 없고 Firebase 제품을 사용해 보고 싶다면 빠른 시작 샘플 중 하나를 다운로드할 수 있습니다.
1단계 : Firebase 프로젝트 생성
Apple 앱에 Firebase를 추가하려면 먼저 앱에 연결할 Firebase 프로젝트를 만들어야 합니다. Firebase 프로젝트에 대해 자세히 알아보려면 Firebase 프로젝트 이해 를 방문하세요.
2단계 : Firebase에 앱 등록
Apple 앱에서 Firebase를 사용하려면 Firebase 프로젝트에 앱을 등록해야 합니다. 앱을 등록하는 것을 종종 프로젝트에 앱을 "추가"라고 합니다.
Firebase 콘솔 로 이동합니다.
프로젝트 개요 페이지 중앙에서 iOS+ 아이콘을 클릭하여 설정 워크플로를 시작합니다.
Firebase 프로젝트에 앱을 이미 추가한 경우 앱 추가 를 클릭하여 플랫폼 옵션을 표시합니다.
번들 ID 필드에 앱의 번들 ID를 입력합니다.
번들 ID 는 Apple 생태계에서 애플리케이션을 고유하게 식별합니다.
번들 ID 찾기: Xcode에서 프로젝트를 열고 프로젝트 탐색기에서 최상위 앱을 선택한 다음 일반 탭을 선택합니다.
번들 식별자 필드의 값은 번들 ID(예:
com.yourcompany.yourproject
)입니다.번들 ID 값은 대소문자를 구분하며 Firebase 프로젝트에 등록한 후에는 이 Firebase 앱에 대해 변경할 수 없습니다.
(선택사항) 기타 앱 정보 입력: 앱 닉네임 및 App Store ID .
앱 닉네임 : Firebase 콘솔에서 나에게만 표시되는 내부 편의 식별자
App Store ID : Firebase Dynamic Links에서 사용자를 App Store 페이지로 리디렉션 하고 Google Analytics에서 전환 이벤트를 Google Ads로 가져오기 위해 사용합니다. 앱에 아직 App Store ID가 없는 경우 나중에 프로젝트 설정 에서 ID를 추가할 수 있습니다.
앱 등록 을 클릭합니다.
3단계 : Firebase 구성 파일 추가
GoogleService-Info.plist 다운로드 를 클릭하여 Firebase Apple 플랫폼 구성 파일(
GoogleService-Info.plist
)을 가져옵니다.Firebase 구성 파일에는 고유하지만 비밀이 아닌 프로젝트 식별자가 포함되어 있습니다. 이 구성 파일에 대해 자세히 알아보려면 Firebase 프로젝트 이해 를 방문하세요.
언제든지 Firebase 구성 파일 을 다시 다운로드할 수 있습니다.
구성 파일 이름에
(2)
와 같은 추가 문자가 추가되지 않았는지 확인하십시오.
구성 파일을 Xcode 프로젝트의 루트로 이동합니다. 메시지가 표시되면 구성 파일을 모든 대상에 추가하도록 선택합니다.
프로젝트에 번들 ID가 여러 개 있는 경우 각 앱이 자체 GoogleService-Info.plist
파일을 가질 수 있도록 각 번들 ID를 Firebase 콘솔에 등록된 앱과 연결해야 합니다.
4단계 : 앱에 Firebase SDK 추가
Swift Package Manager를 사용하여 Firebase 종속 항목을 설치하고 관리합니다.
- Xcode에서 앱 프로젝트를 연 상태에서 File > Add Packages 로 이동합니다.
- 메시지가 표시되면 Firebase Apple 플랫폼 SDK 저장소를 추가합니다.
- 사용하려는 SDK 버전을 선택합니다.
사용하려는 Firebase 라이브러리를 선택합니다.
Firebase 프로젝트에서 Google 애널리틱스가 활성화된 경우
FirebaseAnalytics
를 추가해야 합니다. IDFA 수집 기능이 없는 애널리틱스의 경우FirebaseAnalyticsWithoutAdId
를 대신 추가하세요.
https://github.com/firebase/firebase-ios-sdk
완료되면 Xcode는 자동으로 백그라운드에서 종속성을 해결하고 다운로드하기 시작합니다.
5단계 : 앱에서 Firebase 초기화
마지막 단계는 애플리케이션에 초기화 코드를 추가하는 것입니다. Firebase를 앱에 추가하는 과정에서 이미 이 작업을 수행했을 수 있습니다. 빠른 시작 샘플 프로젝트 를 사용하는 경우 이 작업이 완료된 것입니다.
-
UIApplicationDelegate
에서 FirebaseCore 모듈과 앱 대리인이 사용하는 다른 모든FirebaseCore
모듈 을 가져옵니다. 예를 들어 Cloud Firestore 및 인증을 사용하려면 다음과 같이 하세요.SwiftUI
import SwiftUI import FirebaseCore import FirebaseFirestore import FirebaseAuth // ...
빠른
import FirebaseCore import FirebaseFirestore import FirebaseAuth // ...
목표-C
@import FirebaseCore; @import FirebaseFirestore; @import FirebaseAuth; // ...
- 앱 대리인의
application(_:didFinishLaunchingWithOptions:)
메서드에서FirebaseApp
공유 인스턴스를 구성합니다.SwiftUI
// Use Firebase library to configure APIs FirebaseApp.configure()
빠른
// Use Firebase library to configure APIs FirebaseApp.configure()
목표-C
// Use Firebase library to configure APIs [FIRApp configure];
- SwiftUI를 사용하는 경우 애플리케이션 대리자를 생성하고
UIApplicationDelegateAdaptor
또는NSApplicationDelegateAdaptor
를 통해App
구조체에 연결해야 합니다. 앱 대리자 스위즐링도 비활성화해야 합니다. 자세한 내용은 SwiftUI 지침 을 참조하십시오.SwiftUI
@main struct YourApp: App { // register app delegate for Firebase setup @UIApplicationDelegateAdaptor(AppDelegate.self) var delegate var body: some Scene { WindowGroup { NavigationView { ContentView() } } } }
- Google 애널리틱스용 Firebase SDK를 포함했다면 앱을 실행하여 Firebase를 성공적으로 설치했다는 확인을 Firebase 콘솔에 보낼 수 있습니다.
그게 다야! 다음 단계 로 건너뛸 수 있습니다.
하지만 설정하는 데 문제가 있는 경우 Apple 플랫폼 문제 해결 및 FAQ 를 방문하세요.
사용 가능한 라이브러리
이 섹션에는 Apple 플랫폼에서 지원되는 Firebase 제품이 나와 있습니다. 다음 Firebase Apple 플랫폼 라이브러리에 대해 자세히 알아보세요.
Firebase Apple 플랫폼 SDK GitHub 저장소
서비스 또는 제품 | 포드 | SwiftPM 라이브러리 | 분석을 추가하시겠습니까? |
---|---|---|---|
애드몹 | pod 'Google-Mobile-Ads-SDK' | 해당 없음 | |
해석학 | pod 'FirebaseAnalytics' | FirebaseAnalytics | |
앱 체크 | pod 'FirebaseAppCheck' | FirebaseAppCheck | |
앱 배포 | pod 'FirebaseAppDistribution' | FirebaseAppDistribution | |
입증 | pod 'FirebaseAuth' | FirebaseAuth | |
클라우드 파이어스토어 | pod 'FirebaseFirestore' | FirebaseFirestore | |
Firebase 클라이언트 SDK용 Cloud Functions | pod 'FirebaseFunctions' | FirebaseFunctions | |
클라우드 메시징 | pod 'FirebaseMessaging' | FirebaseMessaging | |
클라우드 스토리지 | pod 'FirebaseStorage' | FirebaseStorage | |
Crashlytics | pod 'FirebaseCrashlytics' | FirebaseCrashlytics | |
동적 링크 | pod 'FirebaseDynamicLinks' | FirebaseDynamicLinks | |
인앱 메시지 | pod 'FirebaseInAppMessaging' | FirebaseInAppMessaging | (필수의) |
Firebase 설치 | pod 'FirebaseInstallations' | FirebaseInstallations | |
Firebase ML 커스텀 모델 API | pod 'FirebaseMLModelDownloader' | FirebaseMLModelDownloader | |
성능 모니터링 | pod 'FirebasePerformance' | FirebasePerformance | |
실시간 데이터베이스 | pod 'FirebaseDatabase' | FirebaseDatabase | |
원격 구성 | pod 'FirebaseRemoteConfig' | FirebaseRemoteConfig |
Swift Package Manager를 사용하지 않고 통합
Swift Package Manager를 사용하지 않으려면 CocoaPods를 사용하거나 프레임워크를 직접 가져와 Firebase SDK를 계속 활용할 수 있습니다.
코코아팟
가이드 에서 CocoaPods 통합에 대해 자세히 알아보세요.
프레임워크
iOS 플랫폼 지원 외에도 zip에는 이제 .xcframework
파일이 포함됩니다. 자세한 내용 은 GitHub의 Firebase Apple 플랫폼 SDK README를 참조하세요.
프레임워크 SDK zip 을 다운로드합니다. 이것은 ~200MB 파일이며 다운로드하는 데 약간의 시간이 걸릴 수 있습니다.
파일의 압축을 푼 다음 앱에 포함하려는 프레임워크에 대한
README
를 검토하십시오.대상 빌드 설정의
Other Linker Settings
에-ObjC
링커 플래그 를 추가합니다.
다음 단계
Firebase에 대해 알아보기:
Firebase 프로젝트 및 프로젝트 권장사항에 대해 자세히 알아보려면 Firebase 프로젝트 이해 를 방문하세요.
샘플 Firebase 앱 을 살펴보세요.
Firebase iOS Codelab 을 직접 체험해 보세요.
GitHub 에서 오픈 소스 코드를 살펴보세요.
앱 실행 준비:
- Google Cloud Console에서 프로젝트에 대한 예산 알림 을 설정하세요.
- Firebase Console에서 사용량 및 결제 대시보드 를 모니터링하여 여러 Firebase 서비스에서 프로젝트 사용량을 전체적으로 파악하세요.
- Firebase 출시 체크리스트 를 검토하세요.
Firebase와 Apple 프로젝트에 문제가 있습니까? Apple 플랫폼 문제 해결 및 FAQ 를 방문하십시오.
앱에 Firebase 서비스를 추가합니다.
Analytics 로 사용자 행동에 대한 인사이트를 얻으십시오.
인증으로 사용자 인증 을 설정합니다.
사용자 정보와 같은 데이터를 Cloud Firestore 또는 실시간 데이터베이스 에 저장합니다.
Cloud Storage 를 사용하여 사진 및 동영상과 같은 파일을 저장합니다.
Cloud Functions 를 사용하여 보안 환경에서 실행되는 백엔드 코드를 트리거합니다.
클라우드 메시징 으로 알림을 보냅니다.
앱이 Crashlytics 와 충돌하는 시기와 이유를 알아보세요.
전제 조건
다음을 설치합니다.
- Xcode 13.3.1 이상
프로젝트가 다음 요구 사항을 충족하는지 확인하십시오.
- 프로젝트는 다음 플랫폼 버전 이상을 대상으로 해야 합니다.
- 아이폰 OS 11
- 맥OS 10.13
- tvOS 12
- 워치 OS 6
- 프로젝트는 다음 플랫폼 버전 이상을 대상으로 해야 합니다.
실제 Apple 기기를 설정하거나 시뮬레이터를 사용하여 앱을 실행합니다.
Apple 플랫폼의 클라우드 메시징에 대한 전제 조건은 다음과 같습니다.
- 실제 Apple 기기 를 설정합니다.
- Apple 개발자 계정 에 대한 Apple 푸시 알림 인증 키를 얻습니다.
- App > Capabilities 아래의 Xcode에서 푸시 알림을 활성화합니다.
- Google 계정을 사용하여 Firebase에 로그인 합니다.
아직 Xcode 프로젝트가 없고 Firebase 제품을 사용해 보고 싶다면 빠른 시작 샘플 중 하나를 다운로드할 수 있습니다.
1단계 : Firebase 프로젝트 생성
Apple 앱에 Firebase를 추가하려면 먼저 앱에 연결할 Firebase 프로젝트를 만들어야 합니다. Firebase 프로젝트에 대해 자세히 알아보려면 Firebase 프로젝트 이해 를 방문하세요.
2단계 : Firebase에 앱 등록
Apple 앱에서 Firebase를 사용하려면 Firebase 프로젝트에 앱을 등록해야 합니다. 앱을 등록하는 것을 종종 프로젝트에 앱을 "추가"라고 합니다.
Firebase 콘솔 로 이동합니다.
프로젝트 개요 페이지 중앙에서 iOS+ 아이콘을 클릭하여 설정 워크플로를 시작합니다.
Firebase 프로젝트에 앱을 이미 추가한 경우 앱 추가 를 클릭하여 플랫폼 옵션을 표시합니다.
번들 ID 필드에 앱의 번들 ID를 입력합니다.
번들 ID 는 Apple 생태계에서 애플리케이션을 고유하게 식별합니다.
번들 ID 찾기: Xcode에서 프로젝트를 열고 프로젝트 탐색기에서 최상위 앱을 선택한 다음 일반 탭을 선택합니다.
번들 식별자 필드의 값은 번들 ID(예:
com.yourcompany.yourproject
)입니다.번들 ID 값은 대소문자를 구분하며 Firebase 프로젝트에 등록한 후에는 이 Firebase 앱에 대해 변경할 수 없습니다.
(선택사항) 기타 앱 정보 입력: 앱 닉네임 및 App Store ID .
앱 닉네임 : Firebase 콘솔에서 나에게만 표시되는 내부 편의 식별자
App Store ID : Firebase Dynamic Links에서 사용자를 App Store 페이지로 리디렉션 하고 Google Analytics에서 전환 이벤트를 Google Ads로 가져오기 위해 사용합니다. 앱에 아직 App Store ID가 없는 경우 나중에 프로젝트 설정 에서 ID를 추가할 수 있습니다.
앱 등록 을 클릭합니다.
3단계 : Firebase 구성 파일 추가
GoogleService-Info.plist 다운로드 를 클릭하여 Firebase Apple 플랫폼 구성 파일(
GoogleService-Info.plist
)을 가져옵니다.Firebase 구성 파일에는 고유하지만 비밀이 아닌 프로젝트 식별자가 포함되어 있습니다. 이 구성 파일에 대해 자세히 알아보려면 Firebase 프로젝트 이해 를 방문하세요.
언제든지 Firebase 구성 파일 을 다시 다운로드할 수 있습니다.
구성 파일 이름에
(2)
와 같은 추가 문자가 추가되지 않았는지 확인하십시오.
구성 파일을 Xcode 프로젝트의 루트로 이동합니다. 메시지가 표시되면 구성 파일을 모든 대상에 추가하도록 선택합니다.
프로젝트에 번들 ID가 여러 개 있는 경우 각 앱이 자체 GoogleService-Info.plist
파일을 가질 수 있도록 각 번들 ID를 Firebase 콘솔에 등록된 앱과 연결해야 합니다.
4단계 : 앱에 Firebase SDK 추가
Swift Package Manager를 사용하여 Firebase 종속 항목을 설치하고 관리합니다.
- Xcode에서 앱 프로젝트를 연 상태에서 File > Add Packages 로 이동합니다.
- 메시지가 표시되면 Firebase Apple 플랫폼 SDK 저장소를 추가합니다.
- 사용하려는 SDK 버전을 선택합니다.
사용하려는 Firebase 라이브러리를 선택합니다.
Firebase 프로젝트에서 Google 애널리틱스가 활성화된 경우
FirebaseAnalytics
를 추가해야 합니다. IDFA 수집 기능이 없는 애널리틱스의 경우FirebaseAnalyticsWithoutAdId
를 대신 추가하세요.
https://github.com/firebase/firebase-ios-sdk
완료되면 Xcode는 자동으로 백그라운드에서 종속성을 해결하고 다운로드하기 시작합니다.
5단계 : 앱에서 Firebase 초기화
마지막 단계는 애플리케이션에 초기화 코드를 추가하는 것입니다. Firebase를 앱에 추가하는 과정에서 이미 이 작업을 수행했을 수 있습니다. 빠른 시작 샘플 프로젝트 를 사용하는 경우 이 작업이 완료된 것입니다.
-
UIApplicationDelegate
에서 FirebaseCore 모듈과 앱 대리인이 사용하는 다른 모든FirebaseCore
모듈 을 가져옵니다. 예를 들어 Cloud Firestore 및 인증을 사용하려면 다음과 같이 하세요.SwiftUI
import SwiftUI import FirebaseCore import FirebaseFirestore import FirebaseAuth // ...
빠른
import FirebaseCore import FirebaseFirestore import FirebaseAuth // ...
목표-C
@import FirebaseCore; @import FirebaseFirestore; @import FirebaseAuth; // ...
- 앱 대리인의
application(_:didFinishLaunchingWithOptions:)
메서드에서FirebaseApp
공유 인스턴스를 구성합니다.SwiftUI
// Use Firebase library to configure APIs FirebaseApp.configure()
빠른
// Use Firebase library to configure APIs FirebaseApp.configure()
목표-C
// Use Firebase library to configure APIs [FIRApp configure];
- SwiftUI를 사용하는 경우 애플리케이션 대리자를 생성하고
UIApplicationDelegateAdaptor
또는NSApplicationDelegateAdaptor
를 통해App
구조체에 연결해야 합니다. 앱 대리자 스위즐링도 비활성화해야 합니다. 자세한 내용은 SwiftUI 지침 을 참조하십시오.SwiftUI
@main struct YourApp: App { // register app delegate for Firebase setup @UIApplicationDelegateAdaptor(AppDelegate.self) var delegate var body: some Scene { WindowGroup { NavigationView { ContentView() } } } }
- Google 애널리틱스용 Firebase SDK를 포함했다면 앱을 실행하여 Firebase를 성공적으로 설치했다는 확인을 Firebase 콘솔에 보낼 수 있습니다.
그게 다야! 다음 단계 로 건너뛸 수 있습니다.
하지만 설정하는 데 문제가 있는 경우 Apple 플랫폼 문제 해결 및 FAQ 를 방문하세요.
사용 가능한 라이브러리
이 섹션에는 Apple 플랫폼에서 지원되는 Firebase 제품이 나와 있습니다. 다음 Firebase Apple 플랫폼 라이브러리에 대해 자세히 알아보세요.
Firebase Apple 플랫폼 SDK GitHub 저장소
서비스 또는 제품 | 포드 | SwiftPM 라이브러리 | 분석을 추가하시겠습니까? |
---|---|---|---|
애드몹 | pod 'Google-Mobile-Ads-SDK' | 해당 없음 | |
해석학 | pod 'FirebaseAnalytics' | FirebaseAnalytics | |
앱 체크 | pod 'FirebaseAppCheck' | FirebaseAppCheck | |
앱 배포 | pod 'FirebaseAppDistribution' | FirebaseAppDistribution | |
입증 | pod 'FirebaseAuth' | FirebaseAuth | |
클라우드 파이어스토어 | pod 'FirebaseFirestore' | FirebaseFirestore | |
Firebase 클라이언트 SDK용 Cloud Functions | pod 'FirebaseFunctions' | FirebaseFunctions | |
클라우드 메시징 | pod 'FirebaseMessaging' | FirebaseMessaging | |
클라우드 스토리지 | pod 'FirebaseStorage' | FirebaseStorage | |
Crashlytics | pod 'FirebaseCrashlytics' | FirebaseCrashlytics | |
동적 링크 | pod 'FirebaseDynamicLinks' | FirebaseDynamicLinks | |
인앱 메시지 | pod 'FirebaseInAppMessaging' | FirebaseInAppMessaging | (필수의) |
Firebase 설치 | pod 'FirebaseInstallations' | FirebaseInstallations | |
Firebase ML 커스텀 모델 API | pod 'FirebaseMLModelDownloader' | FirebaseMLModelDownloader | |
성능 모니터링 | pod 'FirebasePerformance' | FirebasePerformance | |
실시간 데이터베이스 | pod 'FirebaseDatabase' | FirebaseDatabase | |
원격 구성 | pod 'FirebaseRemoteConfig' | FirebaseRemoteConfig |
Swift Package Manager를 사용하지 않고 통합
Swift Package Manager를 사용하지 않으려면 CocoaPods를 사용하거나 프레임워크를 직접 가져와 Firebase SDK를 계속 활용할 수 있습니다.
코코아팟
가이드 에서 CocoaPods 통합에 대해 자세히 알아보세요.
프레임워크
iOS 플랫폼 지원 외에도 zip에는 이제 .xcframework
파일이 포함됩니다. 자세한 내용 은 GitHub의 Firebase Apple 플랫폼 SDK README를 참조하세요.
프레임워크 SDK zip 을 다운로드합니다. 이것은 ~200MB 파일이며 다운로드하는 데 약간의 시간이 걸릴 수 있습니다.
파일의 압축을 푼 다음 앱에 포함하려는 프레임워크에 대한
README
를 검토하십시오.대상 빌드 설정의
Other Linker Settings
에-ObjC
링커 플래그 를 추가합니다.
다음 단계
Firebase에 대해 알아보기:
Firebase 프로젝트 및 프로젝트 권장사항에 대해 자세히 알아보려면 Firebase 프로젝트 이해 를 방문하세요.
샘플 Firebase 앱 을 살펴보세요.
Firebase iOS Codelab 을 직접 체험해 보세요.
GitHub 에서 오픈 소스 코드를 살펴보세요.
앱 실행 준비:
- Google Cloud Console에서 프로젝트에 대한 예산 알림 을 설정하세요.
- Firebase Console에서 사용량 및 결제 대시보드 를 모니터링하여 여러 Firebase 서비스에서 프로젝트 사용량을 전체적으로 파악하세요.
- Firebase 출시 체크리스트 를 검토하세요.
Firebase와 Apple 프로젝트에 문제가 있습니까? Apple 플랫폼 문제 해결 및 FAQ 를 방문하십시오.
앱에 Firebase 서비스를 추가합니다.
Analytics 로 사용자 행동에 대한 인사이트를 얻으십시오.
인증으로 사용자 인증 을 설정합니다.
사용자 정보와 같은 데이터를 Cloud Firestore 또는 실시간 데이터베이스 에 저장합니다.
Cloud Storage 를 사용하여 사진 및 동영상과 같은 파일을 저장합니다.
Cloud Functions 를 사용하여 보안 환경에서 실행되는 백엔드 코드를 트리거합니다.
클라우드 메시징 으로 알림을 보냅니다.
앱이 Crashlytics 와 충돌하는 시기와 이유를 알아보세요.