Check out what’s new from Firebase at Google I/O 2022. Learn more

Apple 앱에 Firebase 설치

스위프트 패키지 관리자

Firebase Apple SDK의 v8.0.0부터 Firebase의 Swift Package Manager 지원은 베타 버전이 아니며 일반적으로 사용할 수 있습니다. Swift Package Manager 사용자에게는 CocoaPods가 필요하지 않습니다.

Firebase 버전 8 이상에서는 Swift Package Manager가 권장되는 설치 방법입니다.

Xcode를 통해

Swift Package Manager 지원에는 13.3.1 이상이 필요합니다.

  1. CocoaPods 기반 프로젝트에서 마이그레이션하는 경우 pod deintegrate 를 실행하여 Xcode 프로젝트에서 CocoaPods를 제거합니다. CocoaPods 생성 .xcworkspace 파일은 나중에 안전하게 삭제할 수 있습니다. Firebase를 프로젝트에 처음 추가하는 경우 이 단계를 무시할 수 있습니다.

  2. Xcode에서 파일 > 패키지 추가 로 이동하여 Firebase 라이브러리를 설치합니다.

  3. 표시되는 프롬프트에서 Firebase GitHub 리포지토리를 선택합니다.

    https://github.com/firebase/firebase-ios-sdk.git
    
  4. 사용하려는 Firebase 버전을 선택합니다. 새 프로젝트의 경우 최신 버전의 Firebase를 사용하는 것이 좋습니다.

  5. 앱에 포함할 Firebase 라이브러리를 선택합니다.

완료되면 Xcode는 패키지 종속성을 해결하고 백그라운드에서 다운로드하기 시작합니다.

Package.swift 통해

Package.swift 매니페스트를 통해 Firebase를 Swift 패키지에 통합하려면 패키지의 dependencies 배열에 Firebase를 추가하면 됩니다. 자세한 내용은 Swift 패키지 관리자 문서 를 참조하세요.

dependencies: [

  .package(name: "Firebase",
           url: "https://github.com/firebase/firebase-ios-sdk.git",
           from: "8.0"),
  // ...

],

그런 다음 Firebase 제품에 의존하는 모든 대상에서 해당 대상의 dependencies 배열 에 추가합니다.

.target(
  name: "MyTargetName",
  dependencies: [
    .product(name: "FirebaseAuth", package: "Firebase"),
    // ...
  ]
),

제품별 고려사항

일부 Firebase 제품이 올바르게 작동하려면 추가 통합 단계가 필요합니다.

구글 애널리틱스

Google Analytics는 전이적으로 포함된 경우 대상의 빌드 설정에 -ObjC 링커 플래그를 추가해야 합니다.

Crashlytics

Crashlytics를 사용하려면 디버그 기호를 업로드해야 합니다.

Xcode용 실행 스크립트 빌드 단계를 사용하여 빌드 후 디버그 기호를 자동으로 업로드할 수 있습니다. 여기에서 실행 스크립트를 찾으십시오.

${BUILD_DIR%Build/*}/SourcePackages/checkouts/firebase-ios-sdk/Crashlytics/run

기호를 업로드하는 또 다른 옵션은 upload-symbols 스크립트를 사용하는 것입니다. 스크립트를 프로젝트 파일의 하위 디렉터리(예: scripts/upload-symbols )에 넣은 다음 스크립트가 실행 가능한지 확인합니다.

chmod +x scripts/upload-symbols

이 스크립트는 dSYM 파일을 수동으로 업로드하는 데 사용할 수 있습니다. 스크립트에 대한 사용 참고 사항 및 추가 지침을 보려면 매개변수 없이 upload-symbols 를 실행하십시오.

코코아팟

Firebase는 Swift Package Manager 외에도 CocoaPods 를 사용한 설치를 지원합니다.

Firebase의 CocoaPods 배포에는 Xcode 13.3.1 및 CocoaPods 1.10.0 이상이 필요합니다. CocoaPods를 사용하여 Firebase를 설치하는 방법은 다음과 같습니다.

  1. 아직 없는 경우 Podfile을 만듭니다. 프로젝트 디렉터리의 루트에서 다음 명령을 실행합니다.

    pod init
  2. Podfile에 앱에서 사용하려는 Firebase 포드를 추가합니다.

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

    분석 사용

    # Add the Firebase pod for Google Analytics
    pod 'FirebaseAnalytics'
    
    # 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 'FirebaseAuth'
    pod 'FirebaseFirestore'

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

    분석이 활성화되지 않음

    # Add the pods for the Firebase products you want to use in your app
    # For example, to use Firebase Authentication and Cloud Firestore
    pod 'FirebaseAuth'
    pod 'FirebaseFirestore'
  3. 포드를 설치한 다음 .xcworkspace 파일을 열어 Xcode에서 프로젝트를 확인합니다.

    pod install --repo-update
    open your-project.xcworkspace

제품별 고려사항

일부 Firebase 제품이 올바르게 작동하려면 추가 통합 단계가 필요합니다.

Crashlytics

Crashlytics를 사용하려면 디버그 기호를 업로드해야 합니다.

Xcode용 실행 스크립트 빌드 단계를 사용하여 빌드 후 디버그 기호를 자동으로 업로드할 수 있습니다. 여기에서 실행 스크립트를 찾으십시오.

"${PODS_ROOT}/FirebaseCrashlytics/run"

카르타고

카르타고 지원은 실험적입니다. Carthage를 통해 앱에 Firebase를 포함하는 방법은 GitHub의 지침을 참조하세요.

수동으로 통합

Firebase는 종속성 관리자를 사용하지 않고 Firebase를 통합하려는 사용자를 위해 사전 빌드된 바이너리 XCFramework 배포를 제공합니다. Firebase를 설치하려면 다음 단계를 따르세요.

  1. 프레임워크 SDK zip 을 다운로드합니다. 이 파일에는 모든 Firebase SDK에 대해 사용 가능한 모든 대상 아키텍처에 대한 아키텍처 슬라이스가 포함되어 있으므로 다운로드하는 데 시간이 걸릴 수 있습니다.

  2. 파일의 압축을 푼 다음 앱에 포함하려는 프레임워크에 대한 README 를 검토합니다.

  3. 대상 빌드 설정의 Other Linker Settings-ObjC 링커 플래그 를 추가합니다.