این صفحه به‌وسیله ‏Cloud Translation API‏ ترجمه شده است.

درباره فضاهای کاری Firebase Studio

Firebase Studio یک محیط توسعه مشارکتی و مبتنی بر ابر فراهم می‌کند که فرآیند ساخت برنامه‌ها را با ترکیبی گسترده از چارچوب‌ها و کتابخانه‌ها ساده می‌کند.

پس از راه‌اندازی فضای کاری Firebase Studio ، می‌توانید به یک محیط توسعه کاملاً کاربردی و انعطاف‌پذیر دسترسی داشته باشید و آن را به اشتراک بگذارید: فضاهای کاری Firebase Studio از هر دستگاهی قابل دسترسی هستند و ابزارهای یکپارچه‌ای را برای ساده‌سازی فرآیند توسعه شما و تیمتان ارائه می‌دهند.

ایجاد یک فضای کاری

یک فضای کاری در Firebase Studio یک محیط توسعه است که شامل هر چیزی است که برای توسعه برنامه خود نیاز دارید. این محیط شامل کد شما، یک ویرایشگر کد (با افزونه‌های مرتبط با پروژه شما) و ابزارهایی است که از توسعه برنامه پشتیبانی می‌کنند. این دقیقاً مانند ایجاد یک پروژه جدید در محیط توسعه دسکتاپ محلی شماست، با این تفاوت که شما یک کامپیوتر کامل و سیستم عامل از پیش پیکربندی شده و منحصراً برای ساخت برنامه خود دارید که روی مرورگر شما در فضای ابری اجرا می‌شود و از هر کجا که هستید قابل دسترسی است.

فضاهای کاری Firebase Studio برای در بر گرفتن یک کدبیس واحد بهینه شده‌اند، بنابراین می‌توانید محیط‌ها و وابستگی‌های سطح سیستمی برنامه‌های مختلف را از یکدیگر جدا نگه دارید. می‌توانید چندین فضای کاری برای استفاده با برنامه‌ها و چارچوب‌های مختلف ایجاد کنید.

برای ایجاد یک فضای کاری جدید:

باز کردن یک الگو یا برنامه نمونه
وارد کردن یک پروژه .
نمونه اولیه را با هوش مصنوعی ایجاد کنید ، سپس به نمای Code ( </> ) بروید.

کپی کردن یک فضای کاری

کپی کردن فضای کاری Firebase Studio یک کپی از پروژه شما ایجاد می‌کند که شامل همه چیز در دایرکتوری home/user است. این زمانی مفید است که می‌خواهید بدون تأثیر بر پروژه اصلی، روی یک پروژه آزمایش کنید، یا زمانی که می‌خواهید از یک پروژه موجود به عنوان نقطه شروع برای یک پروژه جدید استفاده کنید.

برای کپی کردن یک فضای کاری:

از صفحه اصلی Firebase Studio ، روی منوی در کنار فضای کاری که می‌خواهید کپی کنید > Duplicate کلیک کنید.
نام فضای کاری جدید خود را وارد کنید و روی «تکرار» کلیک کنید. فضای کاری جدید ایجاد شده و به فهرست فضاهای کاری شما اضافه می‌شود. ß توجه: کپی کردن فضاهای کاری بزرگتر می‌تواند چند دقیقه طول بکشد. اگر فضای کاری جدید شما بارگیری نشد، ۵ دقیقه صبر کنید، سپس صفحه را رفرش کنید.
(اختیاری) اگر فضای کاری اصلی دارای یک پروژه Firebase مرتبط است، ایجاد یک پروژه Firebase جداگانه برای فضای کاری جدید خود را در نظر بگیرید. این کار مانع از ایجاد تغییرات در پروژه Firebase مرتبط با فضای کاری اصلی توسط فضای کاری جدید شما می‌شود. برای ایجاد یک پروژه Firebase:
1. فضای کاری جدید را باز کنید و از Gemini بخواهید یک پروژه Firebase برای شما ایجاد کند.
2. هر فایلی که به پروژه Firebase ارجاع می‌دهد، مانند .env یا .firebaserc را به‌روزرسانی کنید.

فضای کاری خود را پیکربندی کنید

Firebase Studio از Nix برای تعریف پیکربندی محیط برای هر فضای کاری استفاده می‌کند. Nix یک مدیر بسته کاملاً کاربردی است و شناسه‌های منحصر به فردی را به هر وابستگی اختصاص می‌دهد، که در نهایت به این معنی است که محیط شما می‌تواند شامل چندین نسخه از یک وابستگی یکسان، به طور یکپارچه باشد. همچنین قابل تکرار و اعلانی است. در زمینه Firebase Studio ، این بدان معناست که می‌توانید فایل پیکربندی Nix خود را در فضاهای کاری به اشتراک بگذارید تا پیکربندی محیط یکسانی را بارگذاری کنید. درباره Nix + Firebase Studio بیشتر بدانید.

فایل `.idx/dev.nix` را ایجاد یا ویرایش کنید

پیکربندی محیط در فایل .idx/dev.nix در مخزن کد شما تعریف شده است. این فایل تمام اجزایی را که باید به فضای کاری شما اضافه شوند، از جمله موارد زیر، مشخص می‌کند:

ابزارهای سیستمی موجود در رجیستری بسته Nix ، شامل کامپایلرها، بسته‌ها (مانند go یا angular ) و ابزارهای خط فرمان، مانند اجزای اضافی gcloud CLI .
افزونه‌های IDE از رجیستری OpenVSX ، مانند اشکال‌زداهای مخصوص زبان، قالب‌دهنده‌های کد، افزونه‌های رسمی برای سرویس‌های ابری و موارد دیگر.
سرویس‌های رایج ، مانند docker، پیام‌رسانی Pub/Sub، پایگاه‌های داده مانند Postgres و Redis و موارد دیگر .

برای پیکربندی اولیه محیط فضای کاری که پیش‌نمایش برنامه‌ها را در 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 خود برطرف کرده و محیط را بازسازی کنید.