Firebase Summit에서 발표된 모든 내용을 살펴보고 Firebase로 앱을 빠르게 개발하고 안심하고 앱을 실행하는 방법을 알아보세요. 자세히 알아보기

Firebase 확장 프로그램 설치

컬렉션을 사용해 정리하기 내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.

Firebase 콘솔 또는 Firebase CLI (명령줄 인터페이스)를 사용하여 모든 공식 Firebase 확장 프로그램을 설치(및 관리 )할 수 있습니다.

Firebase CLI와 Firebase 콘솔에 지원되는 작업의 차이점 을 검토하세요.


확장 프로그램을 설치하거나 관리하려면 소유자, 편집자 또는 Firebase 관리자 역할 중 하나를 할당받아야 합니다.

확장 프로그램을 설치하려면 프로젝트가 Blaze (종량제) 요금제에 속해야 합니다. 확장 프로그램 설치 비용은 무료이지만 사용량이 서비스의 프리 티어를 초과하는 경우 Firebase 서비스 또는 Cloud Secret Manager 와 같은 클라우드 서비스 사용에 대해 요금이 부과될 수 있습니다.

시작하기 전에

  1. 아직 추가하지 않았다면 Firebase를 프로젝트 에 추가합니다.

  2. 아직 업그레이드하지 않은 경우 프로젝트를 Blaze (종량제) 요금제로 업그레이드하세요.

  3. 최신 버전의 Firebase CLI를 설치하거나 업데이트하세요.

  4. Firebase 프로젝트 ID 또는 이전에 구성한 프로젝트 별칭을 기록해 둡니다.

    • 프로젝트 ID — 컴퓨터 어디에서나 firebase projects:list 를 실행합니다.
    • 프로젝트 별칭 — 로컬 앱 디렉터리에서 firebase use 을 실행합니다.

1단계 : 확장에 대한 자세한 정보 보기

이 단계는 선택 사항이지만 강력하게 권장됩니다.

Firebase 확장 프로그램을 설치하기 전에 다음을 포함하여 확장 프로그램에 대한 자세한 정보를 검토하는 것이 좋습니다.

  • 확장 프로그램의 작동 방식, 사전 설치 작업 및 확장 프로그램에 대한 세부 정보
  • 일반 식별 정보 및 설명
  • 확장 프로그램의 작업에 결제 계정이 필요한지 여부
  • 운영에 필요한 Google 서비스(API) 및 액세스 역할
  • 확장 프로그램용으로 생성된 리소스 (예: 함수)
  • 사용자가 구성할 수 있는 매개변수에 대한 설명

확장 프로그램의 상세 정보를 보려면:

  1. 환경을 설정 하고 확장 프로그램을 선택 했는지 확인하세요.

  2. 컴퓨터 어디에서나 extension-info 명령을 실행합니다.

    firebase ext:info publisher-id/extension-id

    publisher-idextension-id 인수는 필수이며 확장 프로그램의 사전 설치 세부정보 페이지에서 찾을 수 있습니다.

2단계 : 확장 프로그램 설치

설치 프로세스 중에 확장에 대한 기본 사양(예: 활성화된 API, 생성된 리소스 , 부여된 액세스 권한 등)을 검토하라는 메시지가 표시됩니다. 청구 요구 사항에 대한 알림을 받고 확장 프로그램의 구성 가능한 매개변수 값을 지정하라는 메시지도 표시됩니다.

  1. 환경을 설정 하고 확장 프로그램을 선택 했는지 확인하세요.

  2. 로컬 Firebase 디렉터리에서 extension-install 명령을 실행합니다. 프롬프트가 표시되면 매개변수 값을 입력하여 확장 인스턴스를 사용자 정의하십시오.

    firebase ext:install publisher-id/extension-id --project=projectId-or-alias

    publisher-idextension-id 인수는 필수이며 확장 프로그램의 사전 설치 세부정보 페이지에서 찾을 수 있습니다.

    이 명령을 실행하면 확장 인스턴스가 확장 매니페스트 에 추가됩니다.

  3. 그런 다음 매니페스트의 확장 프로그램을 Firebase 프로젝트에 배포하려면 다음을 실행하세요.

    firebase deploy --only extensions --project=projectId-or-alias

3단계 : 설치 후 설정 완료

일부 확장에는 사용하기 전에 완료해야 하는 필수 또는 선택적 단계가 있습니다. Firebase 콘솔의 확장 프로그램 대시보드에 있는 확장 프로그램의 설치 후 세부정보 페이지에서 이러한 지침을 찾으세요(대시보드에 대한 특정 링크는 설치 후 터미널에 표시됨).

확장 프로그램의 소스 디렉토리 에 포함된 POSTINSTALL.md 파일에서도 이러한 지침을 찾을 수 있습니다.

Firebase 리소스 만들기

아직 존재하지 않는 Firebase 리소스(Cloud Firestore 컬렉션, 실시간 데이터베이스 경로, Cloud Storage 버킷)를 사용하도록 확장 프로그램을 구성한 경우 확장 프로그램을 사용하기 전에 만드세요.

Eventarc 이벤트 핸들러 만들기

일부 확장 프로그램은 실행 중에 중요한 이벤트가 발생할 때 Eventarc 에 게시합니다. 확장 프로그램이 이벤트를 게시하고 설치 중에 이벤트를 활성화한 경우 고유한 사용자 지정 논리로 이러한 이벤트에 반응하는 함수를 작성할 수 있습니다. 예를 들어 장기 실행 작업이 완료될 때 사용자에게 알리거나 확장 기능의 출력을 사후 처리하는 데 유용할 수 있습니다.

게시하는 이벤트 목록(있는 경우)은 확장 문서를 참조하세요.

그런 다음 Eventarc 이벤트 핸들러 작성에 대한 정보는 사용자 정의 이벤트 트리거 를 참조하십시오.

여러 확장 인스턴스 설치

동일한 프로젝트에 동일한 확장을 두 번 이상 설치할 수 있습니다. 설치된 각 인스턴스는 고유한 사용자 정의 구성 및 고유한 확장 리소스를 가질 수 있습니다. 프로젝트 내에서 고유한 인스턴스 ID 를 사용하여 설치된 각 인스턴스를 식별하고 참조합니다. 설치하는 확장의 각 추가 인스턴스의 인스턴스 ID를 확인하거나 편집하라는 메시지가 표시됩니다.

다음 단계

,

Firebase 콘솔 또는 Firebase CLI (명령줄 인터페이스)를 사용하여 모든 공식 Firebase 확장 프로그램을 설치(및 관리 )할 수 있습니다.

Firebase CLI와 Firebase 콘솔에 지원되는 작업의 차이점 을 검토하세요.


확장 프로그램을 설치하거나 관리하려면 소유자, 편집자 또는 Firebase 관리자 역할 중 하나를 할당받아야 합니다.

확장 프로그램을 설치하려면 프로젝트가 Blaze (종량제) 요금제에 속해야 합니다. 확장 프로그램 설치 비용은 무료이지만 사용량이 서비스의 프리 티어를 초과하는 경우 Firebase 서비스 또는 Cloud Secret Manager 와 같은 클라우드 서비스 사용에 대해 요금이 부과될 수 있습니다.

시작하기 전에

  1. 아직 추가하지 않았다면 Firebase를 프로젝트 에 추가합니다.

  2. 아직 업그레이드하지 않은 경우 프로젝트를 Blaze (종량제) 요금제로 업그레이드하세요.

  3. 최신 버전의 Firebase CLI를 설치하거나 업데이트하세요.

  4. Firebase 프로젝트 ID 또는 이전에 구성한 프로젝트 별칭을 기록해 둡니다.

    • 프로젝트 ID — 컴퓨터 어디에서나 firebase projects:list 를 실행합니다.
    • 프로젝트 별칭 — 로컬 앱 디렉터리에서 firebase use 을 실행합니다.

1단계 : 확장에 대한 자세한 정보 보기

이 단계는 선택 사항이지만 강력하게 권장됩니다.

Firebase 확장 프로그램을 설치하기 전에 다음을 포함하여 확장 프로그램에 대한 자세한 정보를 검토하는 것이 좋습니다.

  • 확장 프로그램의 작동 방식, 사전 설치 작업 및 확장 프로그램에 대한 세부 정보
  • 일반 식별 정보 및 설명
  • 확장 프로그램의 작업에 결제 계정이 필요한지 여부
  • 운영에 필요한 Google 서비스(API) 및 액세스 역할
  • 확장 프로그램용으로 생성된 리소스 (예: 함수)
  • 사용자가 구성할 수 있는 매개변수에 대한 설명

확장 프로그램의 상세 정보를 보려면:

  1. 환경을 설정 하고 확장 프로그램을 선택 했는지 확인하세요.

  2. 컴퓨터 어디에서나 extension-info 명령을 실행합니다.

    firebase ext:info publisher-id/extension-id

    publisher-idextension-id 인수는 필수이며 확장 프로그램의 사전 설치 세부정보 페이지에서 찾을 수 있습니다.

2단계 : 확장 프로그램 설치

설치 프로세스 중에 확장에 대한 기본 사양(예: 활성화된 API, 생성된 리소스 , 부여된 액세스 권한 등)을 검토하라는 메시지가 표시됩니다. 청구 요구 사항에 대한 알림을 받고 확장 프로그램의 구성 가능한 매개변수 값을 지정하라는 메시지도 표시됩니다.

  1. 환경을 설정 하고 확장 프로그램을 선택 했는지 확인하세요.

  2. 로컬 Firebase 디렉터리에서 extension-install 명령을 실행합니다. 프롬프트가 표시되면 매개변수 값을 입력하여 확장 인스턴스를 사용자 정의하십시오.

    firebase ext:install publisher-id/extension-id --project=projectId-or-alias

    publisher-idextension-id 인수는 필수이며 확장 프로그램의 사전 설치 세부정보 페이지에서 찾을 수 있습니다.

    이 명령을 실행하면 확장 인스턴스가 확장 매니페스트 에 추가됩니다.

  3. 그런 다음 매니페스트의 확장 프로그램을 Firebase 프로젝트에 배포하려면 다음을 실행하세요.

    firebase deploy --only extensions --project=projectId-or-alias

3단계 : 설치 후 설정 완료

일부 확장에는 사용하기 전에 완료해야 하는 필수 또는 선택적 단계가 있습니다. Firebase 콘솔의 확장 프로그램 대시보드에 있는 확장 프로그램의 설치 후 세부정보 페이지에서 이러한 지침을 찾으세요(대시보드에 대한 특정 링크는 설치 후 터미널에 표시됨).

확장 프로그램의 소스 디렉토리 에 포함된 POSTINSTALL.md 파일에서도 이러한 지침을 찾을 수 있습니다.

Firebase 리소스 만들기

아직 존재하지 않는 Firebase 리소스(Cloud Firestore 컬렉션, 실시간 데이터베이스 경로, Cloud Storage 버킷)를 사용하도록 확장 프로그램을 구성한 경우 확장 프로그램을 사용하기 전에 만드세요.

Eventarc 이벤트 핸들러 만들기

일부 확장 프로그램은 실행 중에 중요한 이벤트가 발생할 때 Eventarc 에 게시합니다. 확장 프로그램이 이벤트를 게시하고 설치 중에 이벤트를 활성화한 경우 고유한 사용자 지정 논리로 이러한 이벤트에 반응하는 함수를 작성할 수 있습니다. 예를 들어 장기 실행 작업이 완료될 때 사용자에게 알리거나 확장 기능의 출력을 사후 처리하는 데 유용할 수 있습니다.

게시하는 이벤트 목록(있는 경우)은 확장 문서를 참조하세요.

그런 다음 Eventarc 이벤트 핸들러 작성에 대한 정보는 사용자 정의 이벤트 트리거 를 참조하십시오.

여러 확장 인스턴스 설치

동일한 프로젝트에 동일한 확장을 두 번 이상 설치할 수 있습니다. 설치된 각 인스턴스는 고유한 사용자 정의 구성 및 고유한 확장 리소스를 가질 수 있습니다. 프로젝트 내에서 고유한 인스턴스 ID 를 사용하여 설치된 각 인스턴스를 식별하고 참조합니다. 설치하는 확장의 각 추가 인스턴스의 인스턴스 ID를 확인하거나 편집하라는 메시지가 표시됩니다.

다음 단계