Firebase로 손쉽게 앱 테스트 배포하기

앱 개발을 진행하다 보면, 사용자에게 정식으로 출시하기 전 여러 번의 테스트가 필요해요. 기능을 하나 추가할 때마다 직접 빌드해서 테스터에게 전달하고, 설치 방법을 안내하고, 피드백을 받는 일련의 과정은 생각보다 번거롭고 반복적인 일이죠. 특히 Android와 iOS 양쪽을 모두 지원하는 Flutter 앱의 경우, 각각의 플랫폼에 맞는 빌드와 배포 방식까지 고민해야 하니 더욱 복잡하게 느껴질 수 있어요.

 

이럴 때 매우 유용한 도구가 바로 Firebase의 App Distribution입니다. TestFlight처럼 앱 마켓을 거치지 않고도 테스터에게 앱을 배포할 수 있고, Android와 iOS를 동시에 지원해 관리가 훨씬 간편하죠. 특히 Supabase처럼 Firebase 외의 백엔드를 쓰더라도 무관하게 사용할 수 있어, 테스트 배포만을 목적으로 Firebase를 도입하는 것도 충분히 의미 있는 선택이에요.

 

이번 글에서는 Flutter로 만든 앱을 Firebase App Distribution을 통해 테스트 환경에 배포하는 전 과정을 소개하려고 해요. 처음 Firebase를 써보는 초보자도 따라할 수 있도록, Android와 iOS 설정부터 실제 배포까지 필요한 모든 단계를 하나씩 안내해 드릴게요.

 

---

Firebase 프로젝트 생성 및 앱 등록하기

가장 먼저 해야 할 일은 Firebase 프로젝트를 만드는 거예요. Firebase는 구글 계정만 있으면 누구나 무료로 시작할 수 있으며, 배포만을 위한 용도로도 부담 없이 사용할 수 있어요.

 

Firebase 콘솔에 접속해 새로운 프로젝트를 생성하고 나면, 그 프로젝트 안에 Android와 iOS 앱을 각각 등록해야 해요. 이 단계에서 주의할 점은 Android 앱의 패키지 이름과 iOS 앱의 번들 ID가 Flutter 프로젝트 내 설정과 정확히 일치해야 한다는 점이에요. 실수로 다른 이름을 입력하면 나중에 Firebase 기능이 정상적으로 작동하지 않거나 빌드에 실패할 수 있어요.

 

앱을 등록한 뒤에는 Firebase에서 제공하는 설정 파일을 다운로드해 Flutter 프로젝트에 포함시켜야 해요. Android의 경우 google-services.json 파일을 android/app 폴더에 넣고, Gradle 설정에 Firebase 관련 플러그인을 추가해야 하고요. iOS는 GoogleService-Info.plist 파일을 ios/Runner 폴더에 넣고, Xcode 프로젝트에 제대로 포함시키는 작업이 필요해요.

 

이렇게 앱 등록이 끝나면, 실제 배포할 앱 파일을 빌드하고 업로드할 준비가 완료됩니다. 다음 단계에서는 Android와 iOS의 빌드 방법, 그리고 Firebase 콘솔을 이용한 배포 절차에 대해 알아보겠습니다.

 

---

앱 빌드 및 Firebase 콘솔로 테스트 배포하기

Firebase에 Android와 iOS 앱 등록을 마쳤다면, 이제 Flutter 프로젝트를 빌드하여 테스터에게 배포할 수 있는 실제 파일을 만들어야 해요. Android는 .apk 또는 .aab 파일, iOS는 .ipa 파일을 각각 생성해 Firebase App Distribution에 업로드하게 됩니다.

 

Android용 APK 빌드하기

Android 앱은 일반적으로 .apk 파일 형식으로 배포하는 것이 편리해요. 빌드 전에 먼저 앱 서명용 키스토어를 생성하고, Gradle 설정에 서명 정보를 등록해야 합니다. 이 작업은 한 번만 해두면 이후에는 반복하지 않아도 되기 때문에 꼭 정리해두는 것이 좋아요.

 

서명 설정이 끝났다면, 터미널에서 아래 명령어를 입력하여 릴리스 빌드를 수행하면 됩니다.

flutter build apk --release

 

빌드가 성공하면 build/app/outputs/flutter-apk/ 경로에 .apk 파일이 생성돼요. 이 파일이 테스터에게 배포할 앱이죠.

 

iOS용 IPA 빌드하기

iOS 앱은 macOS 환경에서 Xcode를 사용하여 .ipa 파일로 빌드해야 해요. 먼저 Xcode에서 프로젝트를 열고, Apple Developer 계정으로 서명 정보를 설정한 후, 상단 메뉴의 Product > Archive를 선택하여 Archive를 생성합니다.

 

빌드가 완료되면 .xcarchive가 만들어지고, 여기서 Distribute App 옵션을 통해 .ipa 파일을 추출할 수 있어요. 또는 flutter build ipa --release 명령어로도 .ipa를 생성할 수 있지만, 초기에는 GUI로 진행하는 것이 더 직관적일 수 있어요.

 

Firebase 콘솔에서 앱 배포하기

앱 파일이 준비되면, Firebase 콘솔에서 App Distribution 메뉴로 이동해 해당 플랫폼(Android 또는 iOS)을 선택한 후, 빌드 파일을 업로드합니다. 업로드 후에는 테스터 이메일을 입력하거나 미리 설정한 테스터 그룹을 선택하고, 간단한 릴리스 노트도 함께 작성해보세요.

 

이제 Firebase가 지정한 테스터들에게 초대 이메일을 전송하고, 테스터는 해당 메일을 통해 앱을 설치할 수 있게 됩니다. TestFlight와 달리 승인 절차 없이 빠르게 설치할 수 있어, 피드백 수집도 한층 수월해지죠.

 

---

CLI를 통한 자동화 배포와 테스터 설치 가이드

Firebase 콘솔을 통해 수동으로 빌드를 업로드하는 방식은 직관적이고 초보자에게 친숙하지만, 반복적인 빌드나 여러 버전의 앱을 배포할 때는 CLI(Command Line Interface)를 활용한 자동화가 훨씬 효율적이에요.

 

 

Firebase CLI로 배포 자동화하기

Firebase CLI를 사용하면 터미널에서 직접 앱을 업로드하고 테스터에게 배포할 수 있습니다. firebase-tools 패키지를 설치한 후, 프로젝트를 Firebase와 연결하고 아래와 같이 명령어를 입력하면 됩니다.

firebase appdistribution:distribute build/app/outputs/flutter-apk/app-release.apk \
  --app <App ID> \
  --testers "tester@example.com" \
  --release-notes "버그 수정 및 성능 개선"

 

iOS의 경우 .ipa 파일 경로만 바꿔주면 동일한 방식으로 배포할 수 있어요. 이 방식은 CI/CD 파이프라인에도 쉽게 통합할 수 있어, 빌드 완료 후 자동 배포를 구성하는 데 매우 유리하죠.

 

테스터의 앱 설치 과정

테스터는 초대 이메일을 통해 Firebase App Distribution 포털에 접속하고, Google 계정으로 로그인하여 앱 설치를 진행합니다. Android는 APK 파일을 직접 다운로드하고 설치하면 되지만, iOS는 몇 가지 보안 절차가 추가돼요. 프로파일 설치, 기기 등록, 개발자 신뢰 설정 등 Apple 특유의 인증 과정이 필요하므로, 테스터에게 사전에 충분한 안내를 해주는 것이 중요합니다.

 

Firebase는 이 과정을 한 곳에서 관리할 수 있도록 웹 포털과 알림 시스템을 제공하고 있어, 테스터는 손쉽게 새 버전을 받아볼 수 있고 개발자는 피드백을 빠르게 반영할 수 있습니다.

 

---

마치며...

Flutter와 Supabase를 이용한 앱 개발 환경에서 Firebase App Distribution은 테스트 배포에 있어 매우 강력한 도구예요. Android와 iOS 양쪽 플랫폼을 모두 지원하고, 수동 업로드는 물론 CLI를 통한 자동화까지 가능하다는 점에서, 다양한 개발 규모에 맞춰 활용할 수 있습니다.

 

특히 반복적인 테스트나 여러 테스터를 대상으로 하는 프로젝트라면 이 도구의 가치는 더 커집니다. 한 번 설정을 끝내면 이후에는 매우 간편하게 테스트 배포를 이어갈 수 있으니, 이번 기회에 익숙해져 보세요. 테스트가 잘 이뤄져야 제품도 더 나아집니다.