Firebase Studio 작업공간 정보
컬렉션을 사용해 정리하기
내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.
Firebase Studio는 광범위한 프레임워크 및 라이브러리 조합으로 애플리케이션 빌드 프로세스를 간소화하는 클라우드 기반 공동작업 개발 환경을 제공합니다.
Firebase Studio 작업공간을 설정하면 완전한 기능을 갖춘 유연한 개발 환경에 액세스하고 공유할 수 있습니다. 모든 기기에서 Firebase Studio 작업공간에 액세스할 수 있으며 이 작업공간은 개발자와 팀의 개발 프로세스를 간소화하는 통합 도구를 제공합니다.
작업공간 만들기
Firebase Studio의 작업공간은 애플리케이션을 개발하는 데 필요한 모든 것이 포함된 개발 환경입니다. 여기에는 코드, 코드 편집기(프로젝트와 관련된 플러그인 포함), 앱 개발을 지원하는 도구 모음이 포함되어 있습니다. 로컬 데스크톱 개발 환경에서 새 프로젝트를 만드는 것과 비슷하지만 애플리케이션 빌드를 위해 사전 구성되고 전문적으로 맞춤설정된 전체 컴퓨터와 운영체제가 있고 클라우드의 브라우저에서 실행되며 어디서나 액세스할 수 있다는 점이 다릅니다.
Firebase Studio 작업공간은 단일 코드베이스가 포함되도록 최적화되어 있으므로 여러 애플리케이션의 환경과 시스템 수준 종속 항목을 서로 격리할 수 있습니다. 여러 애플리케이션과 프레임워크에서 사용할 작업공간을 여러 개 만들 수 있습니다.
새 작업공간을 만들려면 다음 안내를 따르세요.
작업공간 복제
Firebase Studio 작업공간을 복제하면 home/user 디렉터리 내의 모든 항목이 포함된 프로젝트의 사본이 생성됩니다. 이는 원본에 영향을 주지 않고 프로젝트를 실험하거나 기존 프로젝트를 새 프로젝트의 시작점으로 사용하려는 경우에 유용합니다.
작업공간을 복제하려면 다음 단계를 따르세요.
- Firebase Studio 홈페이지에서 복사하려는 작업공간 옆에 있는 more_horiz 메뉴 > 복제를 클릭합니다.
새 작업공간의 이름을 입력하고 복제를 클릭합니다. 새 작업공간이 생성되어 작업공간 목록에 추가됩니다.
ß
참고: 대규모 작업공간을 복제하는 데 몇 분 정도 걸릴 수 있습니다. 새 작업공간이 로드되지 않으면 5분 동안 기다린 후 페이지를 새로고침하세요.
(선택사항) 원래 작업공간에 연결된 Firebase 프로젝트가 있는 경우 새 작업공간에 별도의 Firebase 프로젝트를 만드는 것이 좋습니다. 이렇게 하면 새 작업공간에서 원래 작업공간에 연결된 Firebase 프로젝트를 변경할 수 없습니다. Firebase 프로젝트를 만드는 방법은 다음과 같습니다.
- 새 작업공간을 열고 Gemini에 Firebase 프로젝트를 만들어 달라고 요청합니다.
.env 또는 .firebaserc와 같이 Firebase 프로젝트를 참조하는 파일을 업데이트합니다.
Firebase Studio는 Nix를 사용하여 각 작업공간의 환경 구성을 정의합니다. Nix는 순전히 기능적인 패키지 관리자이며 고유 식별자를 각 종속 항목에 할당합니다. 즉, 환경에 같은 종속 항목의 여러 버전이 원활하게 포함될 수 있습니다. 또한 재현 가능하고 선언적입니다. Firebase Studio의 맥락에서 이는 작업공간 간에 Nix 구성 파일을 공유하여 같은 환경 구성을 로드할 수 있음을 의미합니다. Nix + Firebase Studio를 자세히 알아보세요.
.idx/dev.nix 파일 만들기 또는 수정
환경 구성은 코드 저장소의 .idx/dev.nix 파일에 정의됩니다. 이 파일은 다음을 포함하여 작업공간에 추가할 모든 구성요소를 지정합니다.
Firebase Studio에서 앱 미리보기를 사용 설정하는 기본 작업공간 환경 구성은 다음 .idx/dev.nix 파일 예시를 참고하세요.
{ pkgs, ... }: {
# Which nixpkgs channel to use.
channel = "stable-23.11"; # or "unstable"
# Use https://search.nixos.org/packages to find packages
packages = [
pkgs.nodejs_20
];
# Sets environment variables in the workspace
env = {
SOME_ENV_VAR = "hello";
};
# Search for the extensions you want on https://open-vsx.org/ and use "publisher.id"
idx.extensions = [
"angular.ng-template"
];
# Enable previews and customize configuration
idx.previews = {
enable = true;
previews = {
web = {
command = [
"npm"
"run"
"start"
"--"
"--port"
"$PORT"
"--host"
"0.0.0.0"
"--disable-host-check"
];
manager = "web";
# Optionally, specify a directory that contains your web app
# cwd = "app/client";
};
};
};
}
새 구성 적용
dev.nix 구성 파일을 추가하거나 업데이트할 때마다 Firebase Studio의 오른쪽 하단에 환경을 다시 빌드하라는 프롬프트가 표시됩니다.
환경을 다시 빌드하는 데 걸리는 시간은 구성에 필요한 패키지 수에 따라 다릅니다.
환경 빌드 실패 디버그
구성 파일은 머신이 읽을 수 있는 코드이므로 오류가 있을 수 있습니다. 이 경우 환경이 빌드되지 않고 시작되지 않을 수 있습니다.
Firebase Studio는 복구 환경을 시작하는 옵션을 표시합니다.
이 작업공간에는 개발자가 정의한 구성이 포함되지 않으며 기본 Code OSS만 실행합니다. 이렇게 하면 dev.nix 구성 파일의 오류를 수정하고 환경을 다시 빌드할 수 있습니다.
다음 단계
달리 명시되지 않는 한 이 페이지의 콘텐츠에는 Creative Commons Attribution 4.0 라이선스에 따라 라이선스가 부여되며, 코드 샘플에는 Apache 2.0 라이선스에 따라 라이선스가 부여됩니다. 자세한 내용은 Google Developers 사이트 정책을 참조하세요. 자바는 Oracle 및/또는 Oracle 계열사의 등록 상표입니다.
최종 업데이트: 2025-08-27(UTC)
[null,null,["최종 업데이트: 2025-08-27(UTC)"],[],[],null,["Firebase Studio provides a collaborative, cloud-based development\nenvironment that simplifies the process of building applications with an\nextensive combination of\n[frameworks and libraries](https://studio.firebase.google.com/templates).\n\nAfter you set up a Firebase Studio workspace, you can access and share a\nfully-functional, flexible development environment:\nFirebase Studio workspaces are accessible from any device and provide\nintegrated tools to streamline you and your team's development process.\n\nCreate a workspace\n\nA workspace in Firebase Studio is a development environment that\ncontains everything you need to develop your application. It contains your\ncode, a code editor (with plugins relevant to your project), and toolchains\nthat support app development. It's just like creating a new project in your\nlocal desktop development environment, except you have an entire computer\nand operating system pre-configured and dedicated *exclusively* to building\nyour application, running on your browser in the cloud, accessible wherever\nyou are.\n\nFirebase Studio workspaces are optimized to contain a single codebase,\nso you can keep the environments and system-level dependencies of different\napplications isolated from each other. You can create multiple workspaces to\nuse with different applications and frameworks.\n| **Key Point:** There's a limit to the number of workspaces you can create. If you have a [Google Developer Profile](https://developers.google.com/profile/help/overview), you can create more workspaces. Learn more at [Firebase Studio pricing, quotas and limits](/docs/studio/pricing).\n\nTo create a new workspace:\n\n- [Opening a template or sample app](/docs/studio/get-started-template).\n- [Importing a project](/docs/studio/get-started-import).\n- [Prototype with AI](/docs/studio/get-started-ai), then switch to Code view (**`\u003c/\u003e`**).\n\nDuplicate a workspace\n\nDuplicating a Firebase Studio workspace creates a copy of your project that\ncontains everything within the `home/user` directory. This is useful when you\nwant to experiment with a project without affecting the original, or when you\nwant to use an existing project as a starting point for a new one.\n\nTo duplicate a workspace:\n\n1. From the [Firebase Studio homepage](https://studio.firebase.google.com/), click the more_horiz menu next to the workspace you want to copy \\\u003e **Duplicate**.\n2. Enter the name of your new workspace and click **Duplicate**. The new\n workspace is created and added to your list of workspaces.\n ß\n Note: Duplicating larger workspaces can take several minutes. If your new\n workspace doesn't load, wait 5 minutes, then refresh the page.\n\n3. *(Optional)* If the original workspace has a linked Firebase project,\n consider creating a separate Firebase project for your new workspace. This\n prevents your new workspace from making changes to the Firebase project\n linked to your original workspace. To create a Firebase project:\n\n 1. Open the new workspace and ask Gemini to create a Firebase project for you.\n 2. Update any files that reference the Firebase project, such as `.env` or `.firebaserc`.\n\nConfigure your workspace\n\nFirebase Studio uses\n[Nix](https://nixos.org/manual/nix/stable/introduction)\nto define the environment configuration for each workspace. Nix is a purely\nfunctional package manager and assigns unique identifiers to each\ndependency, which ultimately means your environment can contain multiple\nversions of the same dependency, seamlessly. It is also reproducible and\ndeclarative. In the context of Firebase Studio, this means you can\nshare your Nix configuration file across workspaces to load the same\nenvironment configuration. Learn more about [Nix +\nFirebase Studio](/docs/studio/customize-workspace#nix+fs).\n\nCreate or edit the `.idx/dev.nix` file\n\nEnvironment configuration is defined in the `.idx/dev.nix` file in your code\nrepository. This file specifies all of the components to be added to your\nworkspace including:\n\n- [System tools](/docs/studio/customize-workspace#system-tools)\n available from the\n [Nix package registry](https://search.nixos.org/packages),\n including compilers, packages (like `go` or `angular`), and command line\n utilities, like extra\n [gcloud CLI components](/docs/studio/customize-workspace#gcloud).\n\n- [IDE extensions](/docs/studio/customize-workspace#extensions) from the\n [OpenVSX registry](https://open-vsx.org/), like\n language-specific debuggers, code formatters, official extensions for cloud\n services, and more.\n\n- [Common services](/docs/studio/customize-workspace#common-services), like\n docker, Pub/Sub messaging, databases like Postgres and Redis, and\n [more](/docs/studio/devnix-reference).\n\nSee the following example `.idx/dev.nix` file for a basic workspace environment\nconfiguration that enables app previews in Firebase Studio: \n\n { pkgs, ... }: {\n\n # Which nixpkgs channel to use.\n channel = \"stable-23.11\"; # or \"unstable\"\n\n # Use https://search.nixos.org/packages to find packages\n packages = [\n pkgs.nodejs_20\n ];\n\n # Sets environment variables in the workspace\n env = {\n SOME_ENV_VAR = \"hello\";\n };\n\n # Search for the extensions you want on https://open-vsx.org/ and use \"publisher.id\"\n idx.extensions = [\n \"angular.ng-template\"\n ];\n\n # Enable previews and customize configuration\n idx.previews = {\n enable = true;\n previews = {\n web = {\n command = [\n \"npm\"\n \"run\"\n \"start\"\n \"--\"\n \"--port\"\n \"$PORT\"\n \"--host\"\n \"0.0.0.0\"\n \"--disable-host-check\"\n ];\n manager = \"web\";\n # Optionally, specify a directory that contains your web app\n # cwd = \"app/client\";\n };\n };\n };\n }\n\nApply new configuration\n\nAny time you add or update the `dev.nix` configuration file, Firebase Studio\nshows a prompt in the bottom-right corner to **Rebuild the environment**.\nThe time it takes to rebuild the environment depends on the number of packages\nyour configuration needs.\n\nDebug environment build failures\n\nBecause configuration files are machine-readable code, they can have\nerrors. If this happens, the environment may fail to build and not start.\nFirebase Studio displays an option to start a *Recovery* environment.\nThis workspace doesn't include any of the configuration you've defined and\njust runs basic\nCode OSS. This gives you the chance to fix errors in your\n`dev.nix` configuration file and rebuild the environment.\n\nNext steps\n\n- [Customize your\n Firebase Studio workspace](/docs/studio/customize-workspace).\n\n- [Create custom templates to use and share](/docs/studio/custom-templates).\n\n- [Share your workspace](/docs/studio/share-your-workspace).\n\n- [Use an \"Open in Firebase Studio\" button to share your workspace\n configuration or custom template](/docs/studio/open-in-firebase-studio)."]]
