이 가이드에서는 테스터 관점에서 새 앱을 설치하고 App Distribution을 통해 배포되는 새 앱을 테스트하는 방법을 설명합니다. 자주 묻는 질문(FAQ)에 대한 답변이나 문제 해결에 대한 도움말은 문제 해결 가이드를 참조하세요.
1단계: Google 계정으로 로그인하여 초대 수락
iOS 기기의 경우 Safari에서 이메일 초대장을 엽니다.
이메일 초대장을 열어야 2단계에서 Firebase 프로필을 올바르게 설치하고 기기를 등록할 수 있습니다.
메시지가 표시되면 Google 계정으로 로그인하고 앱 테스트 초대를 수락합니다.
초대를 수락하면 테스트 앱을 설치할 수 있는 액세스 권한이 부여됩니다. 또한 앱 개발자가 새 빌드를 배포하고 나를 테스터로 포함하면 Firebase에서 빌드 알림 이메일을 받게 됩니다.
2단계: Firebase 프로필 설치
임시 배포
테스트 앱 페이지에서 기기 등록을 탭합니다.
메시지가 표시되면 Firebase 프로필을 다운로드한 후 설정 앱에 프로필을 설치합니다.
프로필을 설치하면 Firebase에서 다음을 수행할 수 있습니다.
기기의 고유 기기 ID(UDID)를 수집하여 테스트 기기를 등록합니다. 임시 배포를 테스트할 경우 빌드를 기기에서 테스트할 수 있도록 Firebase가 Firebase 프로젝트의 모든 소유자와 편집자에게 테스트 기기의 UDID와 함께 앱의 프로비저닝 프로필에 기기를 포함하는 방법에 대한 안내를 이메일로 발송합니다.
테스트 기기의 홈 화면에 Firebase App Distribution 웹 클립을 설치합니다. 웹 클립을 사용하면 모든 테스트 앱을 설치하고 액세스할 수 있습니다.
엔터프라이즈 배포
이 단계는 선택사항이지만 엔터프라이즈 서명 배포를 테스트하는 데 권장됩니다. 프로필 설치는 기기의 홈 화면에 Firebase App Distribution 웹 클립을 추가하므로 모든 웹 테스트 앱을 설치하고 액세스할 수 있습니다. 프로필을 수동으로 설치하려면 다음 안내를 따르세요.
테스트 앱에서 테스트할 앱을 선택합니다.
앱 페이지 오른쪽 상단에서 mobile_screen_share를 탭합니다.
표시된 안내를 따라 Firebase 프로필을 설치합니다.
3단계: 빌드 설치 및 테스트
임시 배포
기기를 등록한 후 개발자는 기기의 UDID로 프로비저닝 프로필을 업데이트하고 기기에서 실행되도록 구성된 빌드를 재배포해야 합니다. 빌드를 설치할 수 있게 되면 Firebase에서 알림 이메일을 보냅니다.
Firebase App Distribution 웹 클립의 앱 테스트 섹션에서 새 빌드를 설치할 앱을 선택한 후 다운로드를 탭합니다. 빌드가 기기의 홈 화면에 다운로드되므로 즉시 테스트를 시작할 수 있습니다.
엔터프라이즈 배포
Firebase App Distribution 웹 클립의 앱 테스트 섹션에서 새 빌드를 설치할 앱을 선택한 후 다운로드를 탭합니다. 빌드가 기기의 홈 화면에 다운로드되므로 즉시 테스트를 시작할 수 있습니다.
설정 앱 > 프로필 및 기기 관리 화면에서 앱의 개발자 이름을 선택하고 신뢰합니다.
Firebase App Distribution 웹 클립이 없으며 Firebase의 새 빌드 알림 이메일에서 최신 빌드 다운로드를 탭하여 테스트 앱의 새 빌드를 설치하면 됩니다.
마지막으로 기기의 홈 화면으로 돌아가 테스트 앱을 엽니다.
4단계: (선택사항) 새 빌드 알림 사용 설정
Firebase App Distribution SDK를 테스트 앱에 추가한 경우 새 빌드를 테스트할 수 있게 되면 표시되는 인앱 알림을 선택적으로 사용 설정할 수 있습니다. SDK를 테스트 앱에 추가하는 방법을 비롯하여 SDK에 대한 자세한 내용은 시작 가이드를 참조하세요.
기기의 홈 화면에서 테스트 앱을 엽니다.
알림 사용 설정 대화상자가 표시되면 예를 탭합니다.
1단계에서 이전에 사용한 Google 계정(앱 초대를 수락하는 데 사용한 계정)으로 로그인합니다.
인앱 알림은 자동으로 사용 설정됩니다.
[null,null,["최종 업데이트: 2025-08-12(UTC)"],[],[],null,["\u003cbr /\u003e\n\niOS+ Android \n\n\u003cbr /\u003e\n\nWhen you first distribute an app using\nthe [Firebase console](/docs/app-distribution/android/distribute-console) or\na CLI tool ([Firebase CLI](/docs/app-distribution/android/distribute-cli),\n[fastlane](/docs/app-distribution/android/distribute-fastlane)),\nApp Distribution emails the tester an invitation with instructions on how to\ninstall and test the build.\n\nThis guide describes how to install and test a new app\ndistributed through App Distribution from a tester's point of view. For answers to\nfrequently asked questions or help with troubleshooting, read the\n[troubleshooting guide](/docs/app-distribution/troubleshooting).\n\n**Step 1**: Sign in with Google to accept the invitation\n\n1. On an iOS device, open the email invitation in Safari.\n You must open the email invitation to properly install the Firebase\n profile and register your device in [Step 2](#install-profile).\n\n2. When prompted, sign in with Google and accept the invitation to\n test the app.\n\n| **Keep the following in mind:**\n|\n| - After opening an invitation to test an app, you can sign in with any Google account to accept the invitation, not just the account to which the invitation was originally sent.\n| - Invitations can only be accepted once before becoming invalid.\n| - A Google account can be associated with any email address, not only addresses with Gmail or G Suite domains. Find out how to [sign in](https://support.google.com/accounts/answer/176347?co=GENIE.Platform%3DDesktop&hl=en&oco=1) with another email address.\nOnce you accept an invitation, you're given access to install the test app. You also receive build notification emails from Firebase when the app's developer distributes a new build and includes you as a tester. **Tip:** If you don't want to go through your email to accept new app invitations, you can also access your pending app invitations directly in the Firebase App Distribution web clip: [appdistribution.firebase.google.com](http://appdistribution.firebase.google.com).\n\n**Step 2**: Install the Firebase profile \n\nAd Hoc distributions\n\n1. In the test app's page, tap **Register device**.\n2. When prompted, download the Firebase profile, then install the profile in the **Settings** app.\n\nInstalling the profile gives Firebase permission to:\n\n- Register the test device by collecting the device's unique device ID (UDID). If you're testing an Ad Hoc distribution, Firebase sends all Owners and Editors of the Firebase project an email that includes the test device's UDID , along with instructions on how to include the device in the app's provisioning profile so that the build can be tested on your device.\n- Install a Firebase App Distribution web clip to the test device's home screen. The web clip allows you to install and access all of your test apps.\n\nEnterprise distributions\n\nThis step is optional but recommended for testing Enterprise-signed\ndistributions. The profile installation adds the Firebase App Distribution\nweb clip to your device's home screen, so you can install and access all\nyour test apps. To manually install the profile:\n\n1. Under **Test apps**, select the app you want to test.\n\n2. In the top right of the app's page, tap *mobile_screen_share*.\n\n3. Follow the instructions displayed to install the Firebase profile.\n\n**Step 3**: Install and test the build \n\nAd Hoc distributions\n\nAfter you register your device, the developer must update their\nprovisioning profile with your device's UDID and redistribute a build\nthat's configured to run on your device. Firebase emails you a notification\nwhen the build is available for you to install.\nIn the **Test apps** section of the Firebase App Distribution web clip, select the app for which you want to install a new build, then tap **Download** . The build is downloaded to your device's home screen so you can start testing right away. \n\nEnterprise distributions\n\n1. In the **Test apps** section of the Firebase App Distribution web clip, select the app for which you want to install a new build, then tap **Download** . The build is downloaded to your device's home screen so you can start testing right away. \n2. In the **Settings** app \\\u003e **Profiles \\& Device Management** screen, select\n the app's developer name and trust it.\n\nIf you do not have the Firebase App Distribution web clip, you can install\na new build for your test app by tapping **Download the latest build** in\nthe new build notification email from Firebase.\n\nFinally, return to your device's home screen and open the test app.\n\n**Step 4**: (Optional) Enable new build alerts\n\nIf the Firebase App Distribution SDK has been added to your test app, you\ncan optionally enable in-app alerts that appear when new builds are available\nto test. For more information about the SDK, including how to add it to a test\napp, refer to the Get Started guide.\n\n1. From your device's home screen, open the test app.\n\n2. When the **Enable alerts** dialogue appears, tap **Yes**.\n\n | **If you don't see the dialogue,** note the following:\n | - The dialogue may appear at a different point in your app, depending on where the developer implemented the feature.\n | - If the developer customized the dialogue, it may appear with different text, buttons, or other elements.\n | - Check that you have accepted terms on your test device when you accepted the invitation to test the app.\n3. Sign in with the Google account you previously used in [Step 1](#sign-in)\n (the account you used to accept the app's invitation).\n In-app alerts are turned on automatically.\n\n If you have trouble signing in to your Google account, visit the\n [troubleshooting guide](/docs/app-distribution/troubleshooting#google-signin-ios).\n4. Return to the test app. Now, you receive in-app alerts when new app versions\n are available for testing.\n\nTo download a new app version directly from an alert, tap **Update** in the\nalert dialogue. The new app version is downloaded and added to your device's\nhome screen.\n\nDelete your tester account\n\nTo delete your App Distribution tester account and its\ndata, see the [App Distribution troubleshooting \\& FAQ](/docs/app-distribution/troubleshooting#delete-tester-account)."]]