Firebase Local Emulator Suite은 Cloud Firestore, Realtime Database, Cloud Storage for Firebase, Authentication, Firebase Hosting, Cloud Functions(베타), Pub/Sub(베타) 및 Firebase Extensions(베타)를 사용하여 로컬에서 앱을 빌드하고 테스트하려는 개발자를 위한 고급 도구 모음으로, 빠른 실행과 프로토타입 제작에 도움이 되는 풍부한 사용자 인터페이스를 제공합니다.
로컬 에뮬레이터 도구 모음을 사용한 로컬 개발은 평가, 프로토타입 제작, 개발, 지속적 통합 워크플로에 적합합니다.
시작하기 전에
Firebase 로컬 에뮬레이터 도구 모음을 살펴보기 전에 Firebase 제품 및 Firebase 개발 모델을 숙지하는 것이 좋습니다.
플랫폼 및 제품(Apple, Android 또는 웹)의 Firebase 시작하기 주제를 읽어보세요.
선택한 플랫폼에서 바로 실행할 수 있는 빠른 시작 앱을 다운로드한 다음 코드를 읽고 실행합니다. FriendlyEats 빠른 시작 앱(iOS, Android 또는 웹)을 사용하면 좋습니다.
Firebase Local Emulator Suite(이)란 무엇인가요?
Firebase 로컬 에뮬레이터 도구 모음은 Firebase 서비스의 동작을 정확하게 모방하도록 설계된 개별 서비스 에뮬레이터로 구성됩니다. 즉, 프로덕션 데이터를 터치하지 않고도 앱을 이러한 에뮬레이터에 직접 연결하여 통합 테스트 또는 QA를 수행할 수 있습니다.
예를 들어 앱을 Cloud Firestore 에뮬레이터에 연결하여 테스트 중에 문서를 안전하게 읽고 쓸 수 있습니다. 이러한 쓰기는 Cloud Functions 에뮬레이터에서 함수를 트리거할 수 있습니다. 하지만 에뮬레이터를 사용하거나 구성할 수 없어도 앱은 계속해서 프로덕션 Firebase 서비스와 통신합니다.
로컬 워크플로의 에뮬레이터 도구 모음
프로토타입 제작 및 테스트 워크플로에서는 여러 방법으로 로컬 에뮬레이터 도구 모음을 사용할 수 있습니다.
단위 테스트: Firebase Test SDK를 사용하면 Mocha 테스트 실행기로 Node.js에 단위 테스트를 작성할 수 있습니다. Test SDK는 보안 규칙을 로드하고, 테스트 간 로컬 데이터베이스를 삭제하며, 에뮬레이터와의 동기식 상호 작용을 관리할 수 있는 몇 가지 편리한 메서드를 제공합니다. 앱의 로직에 종속되지 않는 데이터베이스 상호작용에 대한 간단한 테스트를 작성하는 데 유용합니다.
통합 테스트: 에뮬레이터 도구 모음의 각 개별 제품 에뮬레이터는 프로덕션 Firebase 서비스와 마찬가지로 SDK 및 REST API 호출에 응답합니다.
따라서 자체 테스트 도구를 사용하여 Local Emulator Suite을 백엔드로 사용하는 독립 실행형 통합 테스트를 작성할 수 있습니다.
수동 테스트: 실행 중인 애플리케이션을 Local Emulator Suite에 연결하여 프로덕션 데이터를 위험하게 만들거나 테스트 프로젝트를 구성하지 않고도 Firebase 앱을 수동으로 테스트할 수 있습니다.
제품 평가: 안전한 로컬 환경에서 Firebase Extensions를 설치 및 관리하고 청구 비용을 최소화하면서 Firebase Extensions의 기능을 보다 잘 파악할 수 있습니다.
어떤 Firebase 기능과 플랫폼이 지원되나요?
Firebase 로컬 에뮬레이터 도구 모음을 사용하면 상호 운용 가능한 방식으로 핵심 제품을 사용하여 코드를 테스트할 수 있습니다. Cloud Functions 에뮬레이터는 Cloud Firestore, Realtime Database, Cloud Storage for Firebase, Authentication, Pub/Sub에서 트리거한 HTTP 함수, 호출 가능한 함수, 백그라운드 함수를 지원합니다. Cloud Firestore, Realtime Database, Cloud Storage for Firebase 에뮬레이터에는 Firebase Security Rules 에뮬레이션이 내장되어 있습니다.
Cloud
Firestore
실시간
데이터베이스
Firebase용
Cloud Storage
인증
Cloud
Functions
Cloud
Pub/Sub
확장 프로그램
Android SDK
해당 없음
해당 없음
iOS SDK
해당 없음
해당 없음
웹 SDK
해당 없음
해당 없음
Node.js Admin SDK
해당 없음
해당 없음
다음 단계
데이터베이스와 Cloud Functions의 오프라인 프로토타입 제작을 수행하는 방법을 보여주는 Local Emulator Suite 둘러보기로 시작하세요.
Cloud Functions 테스트 도구 Firebase CLI 환경은 함수의 프로토타입을 만들고 테스트하는 다음과 같은 방법을 제공합니다.
에뮬레이터 도구 모음의 일부인 Cloud Functions 에뮬레이터. 이 에뮬레이터는 Firestore 에뮬레이터 및 실시간 데이터베이스 에뮬레이터의 로컬, 실시간 데이터 및 보안 규칙과 상호 운용이 가능합니다.
대화형의 반복 함수 프로토타입 제작 및 개발을 지원하는 Cloud Functions 셸. 이 셸은 개발용 REPL 스타일 인터페이스를 갖춘 Cloud Functions 에뮬레이터를 사용합니다. Cloud Firestore 또는 Realtime Database 에뮬레이터와의 통합은 제공되지 않습니다. 셸을 사용하여 데이터를 모의 처리하고 함수 호출을 수행하여 Local Emulator Suite에서 현재 지원하지 않는 제품(예: 애널리틱스, 원격 구성, Crashlytics 등)과의 상호작용을 시뮬레이션합니다.
Cloud Functions용 Firebase Test SDK: 함수 개발용 Mocha 프레임워크가 있는 Node.js입니다. 실제로 Cloud Functions Test SDK는 Cloud Functions 셸을 기반으로 자동화 기능을 제공합니다.
[[["이해하기 쉬움","easyToUnderstand","thumb-up"],["문제가 해결됨","solvedMyProblem","thumb-up"],["기타","otherUp","thumb-up"]],[["필요한 정보가 없음","missingTheInformationINeed","thumb-down"],["너무 복잡함/단계 수가 너무 많음","tooComplicatedTooManySteps","thumb-down"],["오래됨","outOfDate","thumb-down"],["번역 문제","translationIssue","thumb-down"],["샘플/코드 문제","samplesCodeIssue","thumb-down"],["기타","otherDown","thumb-down"]],["최종 업데이트: 2025-09-04(UTC)"],[],[],null,["The Firebase Local Emulator Suite is a set of advanced tools for developers\nlooking to build and test apps locally using Cloud Firestore, Realtime Database,\nCloud Storage for Firebase, Authentication, Firebase Hosting, Cloud Functions (beta),\nPub/Sub (beta), and Firebase Extensions (beta). It provides a rich\nuser interface to help you get running and prototyping quickly.\n\nLocal development with Local Emulator Suite can be a good fit for your\nevaluation, prototyping, development and continuous integration workflows.\n\n\nBefore you begin\n\nBefore you explore Firebase Local Emulator Suite, we recommend you get oriented\nto Firebase products and the Firebase development model:\n\n- Read the **Get started with Firebase** topics for your platform and products ([Apple](/docs/ios/setup), [Android](/docs/android/setup) or [Web](/docs/web/setup)).\n- Download a ready-to-run quickstart app on your platform of choice, then read through and execute the code. The FriendlyEats quickstart app is a good choice ([iOS](https://github.com/firebase/friendlyeats-ios), [Android](https://github.com/firebase/friendlyeats-android) or [Web](https://github.com/firebase/friendlyeats-web)).\n\nWhat is Firebase Local Emulator Suite?\n\nThe Firebase Local Emulator Suite consists of individual service\nemulators built to accurately mimic the behavior of Firebase services. This\nmeans you can connect your app directly to these emulators to perform\nintegration testing or QA without touching production data.\n\nFor example, you could connect your app to the Cloud Firestore emulator to\nsafely read and write documents in testing. These writes may trigger functions\nin the Cloud Functions emulator. However your app will still continue to\ncommunicate with production Firebase services when emulators are not available\nor configured.\n\n| **Note:** Do not attempt to use these emulators as \"self-hosted\" versions of Firebase services. They are built for accuracy, not performance or security, and are not appropriate to use in production.\n\nEmulator Suite in your local workflows\n\nYour prototype and test workflow can make use of the Local Emulator Suite in\nseveral ways:\n\n- **Unit Tests**: using the Firebase Test SDK, you can write unit tests in Node.js using the mocha test runner. The Test SDK provides several convenience methods for loading Security Rules, flushing the local database between tests, and managing synchronous interaction with the emulators. It's great for writing simple tests for database interactions that don't depend on your app's logic.\n- **Integration Tests** : each individual product emulator in the Emulator Suite responds to SDK and REST API calls just like production Firebase services. So you can use your own testing tools to write self-contained integration tests that use the Local Emulator Suite as the backend.\n- **Manual Tests** : you can connect your running application to the Local Emulator Suite to test your Firebase app manually, without risking production data or configuring a test project.\n- **Product Evaluations** : you can install and manage Firebase Extensions in a safe local environment and better understand their capabilities while minimizing billing costs.\n\nWhich Firebase features and platforms are supported?\n\nThe Firebase Local Emulator Suite allows you to test your code with our core\nproducts in an interoperable way. The Cloud Functions emulator supports\nHTTP functions, callable functions, and background functions\ntriggered by Cloud Firestore, Realtime Database, Cloud Storage for Firebase, Authentication,\nand Pub/Sub. The Cloud Firestore, Realtime Database, and\nCloud Storage for Firebase emulators have Firebase Security Rules emulation built in.\n\n| | **Cloud Firestore** | **Realtime Database** | **Cloud Storage for Firebase** | **Authentication** | **Cloud Functions** | **Cloud Pub/Sub** | **Extensions** |\n|-----------------------|---------------------|-----------------------|--------------------------------|--------------------|---------------------|-------------------|----------------|\n| **Android SDK** | | | | | | n/a | n/a |\n| **iOS SDK** | | | | | | n/a | n/a |\n| **Web SDK** | | | | | | n/a | n/a |\n| **Node.js Admin SDK** | | | | | n/a | | n/a |\n\nNext steps\n\n- [Get started](/docs/emulator-suite/connect_and_prototype) with a\n Local Emulator Suite walkthrough that shows how you can do offline\n prototyping of a database and Cloud Functions.\n\n- Learn how to [install and configure Local Emulator Suite](/docs/emulator-suite/install_and_configure).\n\nOther tools for prototyping and testing\n\nThe Emulator Suite is supplemented by other prototype and test tools.\n\n**Cloud Functions testing tools.** The Firebase CLI environment provides you\nseveral ways to prototype and test functions:\n\n- The Cloud Functions emulator, part of the Emulator Suite. This emulator is interoperable with local, live data and Security Rules in the Firestore emulator and/or Realtime Database emulator.\n- The Cloud Functions shell, which allows for interactive, iterative functions prototyping and development. The shell employs the Cloud Functions emulator with a REPL-style interface for development. No integration with the Cloud Firestore or Realtime Database emulators is provided. Using the shell, you mock data and perform function calls to simulate interaction with products that the Local Emulator Suite does not currently support: Analytics, Remote Config, and Crashlytics.\n- The Firebase Test SDK for Cloud Functions, a Node.js with mocha framework for functions development. In effect, the Cloud Functions Test SDK provides automation atop the Cloud Functions shell.\n\nYou can find more about the Cloud Functions shell and Cloud Functions Test SDK\nat [Test functions interactively](/docs/functions/local-shell) and\n[Unit testing of Cloud Functions](/docs/functions/unit-testing).\n\n**Security Rules testing tools.** Emulator Suite is the preferred toolset for\ntesting Security Rules. However, you can also use:\n\n- The Rules Playground, a part of the Firebase console. The Rules Playground provides a great interactive getting started experience with Security Rules design. For more information see [Quickly validate Firebase Security Rules](/docs/rules/simulator)."]]
