React Native Academy · 강의

React Native Firebase를 프로젝트에 연결하기

@react-native-firebase/app을 설치하고 google-services.json 및 GoogleService-Info.plist 파일을 추가한 다음, iOS와 Android 모두에 네이티브 모듈을 연결합니다.

React Native Firebase를 프로젝트에 연결하기은(는) CoddyKit의 무료 React Native Academy 강의입니다. 이것은 4개 중 1번째 강의입니다. 아래에서 전체 강의를 무료로 읽을 수 있으며, 내장 코드 에디터와 24/7 AI 튜터와 함께 브라우저에서 직접 실습할 수 있습니다. 이 강의는 React Native Academy 학습 경로의 일부이며, 진행 상황이 웹과 CoddyKit 앱에 동기화됩니다. React Native Academy 강의에는 총 4개의 강의가 포함되어 있습니다.

이 강의의 일부는 아직 번역되지 않았으며 영어로 표시됩니다.

React Native Firebase vs Expo Firebase

There are two approaches to using Firebase in React Native: the React Native Firebase library (@react-native-firebase) and the Firebase JS SDK used via firebase npm package. React Native Firebase uses native SDKs and is significantly more performant, but requires native build steps. The JS SDK works with Expo Go but has limitations on mobile.

This lesson covers React Native Firebase, which is the recommended approach for production apps. It requires a bare React Native or Expo bare workflow setup, meaning you must run expo prebuild or expo eject.

Creating a Firebase Project

Before writing any code, you need a Firebase project. Go to console.firebase.google.com, click Add project, and follow the setup wizard. Once the project is created, you add two app registrations: one for iOS (with your bundle ID) and one for Android (with your package name).

Firebase then provides configuration files: google-services.json for Android and GoogleService-Info.plist for iOS. These files contain API keys and project identifiers that the native Firebase SDKs use to authenticate with Firebase servers.

Installing React Native Firebase

Install the core Firebase app module first, then add only the modules you need (auth, firestore, storage, etc.). Each service is a separate package, so your app only bundles what it actually uses.

After installation, run npx expo prebuild if you are in Expo managed workflow, or cd ios && pod install for a bare React Native project. The native modules are linked automatically on newer versions.

# Install the core module
npm install @react-native-firebase/app

# Install specific service modules
npm install @react-native-firebase/auth
npm install @react-native-firebase/firestore

# For Expo managed workflow, use the config plugin:
npx expo install @react-native-firebase/app @react-native-firebase/auth

# iOS native linking
cd ios && pod install

Adding google-services.json for Android

Download google-services.json from the Firebase console (Project Settings > Your apps > Android app > Download config) and place it in android/app/google-services.json.

Then apply the Google Services Gradle plugin by adding apply plugin: 'com.google.gms.google-services' at the bottom of android/app/build.gradle and the classpath in android/build.gradle. If you use Expo's config plugin, this is handled automatically.

// android/build.gradle
buildscript {
  dependencies {
    classpath 'com.google.gms:google-services:4.4.0'
  }
}

// android/app/build.gradle (add at the BOTTOM)
apply plugin: 'com.google.gms.google-services'

Adding GoogleService-Info.plist for iOS

Download GoogleService-Info.plist from the Firebase console (Project Settings > Your apps > iOS app > Download config) and place it in the root of your iOS project: ios/YourApp/GoogleService-Info.plist.

If you use Xcode, drag the file into the Xcode project navigator and ensure Copy items if needed is checked and the file is added to your app target. The native Firebase SDK reads this file at launch to initialize itself.

# Directory structure after adding the file:
ios/
  YourApp/
    GoogleService-Info.plist  <-- place it here
    AppDelegate.swift
    Info.plist
  YourApp.xcworkspace

Using the Expo Config Plugin Approach

If you are building with Expo, the @react-native-firebase/app package ships an Expo config plugin that automates the native setup. Add it to your app.json plugins array and provide paths to your config files.

When you run npx expo prebuild, the plugin automatically adds the Google Services plugin to Gradle and copies the plist file into the correct iOS location. This eliminates manual native file editing.

// app.json
{
  'expo': {
    'plugins': [
      '@react-native-firebase/app',
      '@react-native-firebase/auth'
    ],
    'android': {
      'googleServicesFile': './google-services.json'
    },
    'ios': {
      'googleServicesFile': './GoogleService-Info.plist'
    }
  }
}

Initializing Firebase in JavaScript

With React Native Firebase, you do not call initializeApp in JavaScript — the native SDKs initialize automatically using the config files. You simply import the modules and use them.

Access Firebase Auth with import auth from '@react-native-firebase/auth' and Firestore with import firestore from '@react-native-firebase/firestore'. These return singleton instances connected to your Firebase project.

// No explicit initialization needed!
// The native SDK reads GoogleService-Info.plist and google-services.json

import auth from '@react-native-firebase/auth';
import firestore from '@react-native-firebase/firestore';

// Use Firebase Auth
const currentUser = auth().currentUser;

// Use Firestore
const usersCollection = firestore().collection('users');

Verifying the Connection Works

A quick way to verify that Firebase is connected correctly is to listen to the auth state. Run the app and check that onAuthStateChanged fires with null (no user logged in). If you see a native crash or a red screen mentioning the Firebase app was not initialized, double-check that the config files are in the right locations and you ran pod install.

You can also add a simple Firestore read in a test screen — if it returns data or an auth/permission error (not a crash), the SDK is initialized correctly.

import { useEffect } from 'react';
import auth from '@react-native-firebase/auth';

export function TestScreen() {
  useEffect(() => {
    const unsubscribe = auth().onAuthStateChanged((user) => {
      if (user) {
        console.log('User is signed in:', user.uid);
      } else {
        console.log('No user signed in — Firebase is connected!');
      }
    });

    return unsubscribe; // Cleanup
  }, []);

  return null;
}

Multiple Firebase Projects

If your app needs to connect to more than one Firebase project (for example, a different project for development vs. production), you can initialize additional Firebase app instances with a secondary config. Call firebase().initializeApp(config, 'secondaryApp') and reference it with firebase().app('secondaryApp').

In most React Native apps a single Firebase project is sufficient. The development vs. production split is better handled by having separate google-services.json files per build variant configured in Gradle.

// android/app/build.gradle
android {
  buildTypes {
    debug {
      // Uses google-services-debug.json
    }
    release {
      // Uses google-services-release.json
    }
  }
  sourceSets {
    debug { resources.srcDirs = ['src/debug'] }
    release { resources.srcDirs = ['src/release'] }
  }
}

Checking the Firebase Dashboard

Once your app is running and connected, you can see activity in the Firebase console. Open Authentication to see signed-in users, Firestore Database to inspect document reads and writes, and App Check to monitor requests.

The Firebase Emulator Suite is very useful during development — it runs a local Firebase server on your machine so you can test Auth and Firestore without hitting production data. Run firebase emulators:start and point the Firebase SDK to localhost.

// Point Auth and Firestore to the local emulator during development
import auth from '@react-native-firebase/auth';
import firestore from '@react-native-firebase/firestore';

if (__DEV__) {
  auth().useEmulator('http://localhost:9099');
  firestore().useEmulator('localhost', 8080);
}

Common Setup Errors and Fixes

The most frequent setup errors when integrating React Native Firebase are:

No Firebase App '[DEFAULT]' has been created — the config file is missing or in the wrong directory
Missing google-services plugin — the Gradle plugin was not applied in build.gradle
Pod install not run — running the app on iOS without linking native modules

After fixing any of these issues, always do a full rebuild: stop the bundler, run cd ios && pod install, and restart with npx expo run:ios --device or the equivalent.

Quick Check

Test your understanding of React Native Mobile Development concepts from this lesson.

Lesson Recap

In this lesson you learned: how to create a Firebase project and register iOS and Android apps, how to add google-services.json and GoogleService-Info.plist to the correct locations, and how React Native Firebase auto-initializes from native config files without a JavaScript initializeApp call. Next up we implement email and phone authentication with Firebase.

자주 묻는 질문

“React Native Firebase를 프로젝트에 연결하기” 강의는 무료인가요?

네 — “React Native Firebase를 프로젝트에 연결하기” 전체 내용을 이 웹사이트에서 무료로 읽을 수 있습니다. 인터랙티브하게 실습하려면(내장 코드 에디터와 24/7 AI 튜터), CoddyKit PRO로 업그레이드하면 React Native Academy 강의 전체를 잠금 해제할 수 있습니다. React Native Academy 강의에는 총 4개의 강의가 포함되어 있습니다.

“React Native Firebase를 프로젝트에 연결하기”에서 뭘 배우나요?

@react-native-firebase/app을 설치하고 google-services.json 및 GoogleService-Info.plist 파일을 추가한 다음, iOS와 Android 모두에 네이티브 모듈을 연결합니다. 브라우저에서 직접 실행하는 실습 코드로 React Native Academy을(를) 배우며, 24/7 AI 튜터가 강의를 진행하면서 질문에 답변해줍니다.

React Native Academy을(를) 시작하는 데 경험이 필요한가요?

사전 경험은 필요하지 않습니다. CoddyKit의 React Native Academy은(는) 초급자부터 고급 학습자까지를 위해 구성되어 있으므로, 여기서 시작하거나 처음부터 시작할 수 있으며 자신의 속도대로 진행할 수 있습니다. 이것은 4개 중 1번째 강의입니다.

“React Native Firebase를 프로젝트에 연결하기” 강의는 얼마나 걸리나요?

대부분의 CoddyKit 강의는 약 5~10분이 소요됩니다. 각 강의는 간결하고 인터랙티브하여 꾸준한 진행이 가능하며, 웹과 앱에서 중단한 부분부터 바로 시작할 수 있습니다.

이 React Native Academy 강의에서 코드를 작성하고 실행할 수 있나요?

네. 모든 React Native Academy 강의에는 내장 코드 에디터가 포함되어 있으므로, 브라우저에서 바로 실제 코드를 작성하고 실행한 후 즉시 AI 피드백을 받을 수 있습니다 — 로컬 설정이 필요 없습니다.

이 강의의 모든 강의

← React Native Academy(으)로 돌아가기