لمحة عن مساحات العمل في Firebase Studio

Firebase Studio يوفر بيئة تطوير تعاونية مستندة إلى السحابة تسهّل عملية إنشاء التطبيقات باستخدام مجموعة كبيرة من أُطر العمل والمكتبات.

بعد إعداد مساحة عمل Firebase Studio، يمكنك الوصول إلى بيئة تطوير مرنة وعملية بالكامل ومشاركتها: يمكن الوصول إلى مساحات عمل Firebase Studio من أي جهاز وتوفّر أدوات متكاملة لتسهيل عملية التطوير لك ولفريقك.

إنشاء مساحة عمل

مساحة العمل في Firebase Studio هي بيئة تطوير تحتوي على كل ما تحتاج إليه لتطوير تطبيقك. وتحتوي على الرمز البرمجي ومحرّر الرموز البرمجية (مع مكوّنات إضافية ذات صلة بمشروعك) وسلاسل الأدوات التي تتيح تطوير التطبيقات. يشبه ذلك إنشاء مشروع جديد في بيئة تطوير سطح المكتب المحلية، ولكن لديك جهاز كمبيوتر ونظام تشغيل كاملان تم إعدادهما مسبقًا ومخصّصان حصريًا لإنشاء تطبيقك، ويتم تشغيلهما على متصفحك في السحابة، ويمكنك الوصول إليهما أينما كنت.

Firebase Studio تم تحسين مساحات العمل لتضم قاعدة رموز برمجية واحدة، ما يتيح لك إبقاء بيئات العمل والتبعيات على مستوى النظام للتطبيقات المختلفة منفصلة عن بعضها البعض. يمكنك إنشاء مساحات عمل متعددة لاستخدامها مع تطبيقات وأُطر عمل مختلفة.

لإنشاء مساحة عمل جديدة:

تكرار مساحة عمل

يؤدي تكرار مساحة عمل Firebase Studio إلى إنشاء نسخة من مشروعك تحتوي على كل ما في الدليل home/user ويكون ذلك مفيدًا عندما تريد تجربة مشروع بدون التأثير في المشروع الأصلي، أو عندما تريد استخدام مشروع حالي كنقطة بداية لمشروع جديد.

لتكرار مساحة عمل:

  1. من صفحة Firebase Studio الرئيسية، انقر على قائمة بجانب مساحة العمل التي تريد نسخها > تكرار.

  2. أدخِل اسم مساحة العمل الجديدة وانقر على تكرار. تم إنشاء مساحة العمل الجديدة وإضافتها إلى قائمة مساحات العمل. ß ملاحظة: قد يستغرق تكرار مساحات العمل الأكبر حجمًا عدة دقائق. إذا لم يتم تحميل مساحة العمل الجديدة، انتظِر 5 دقائق، ثم أعِد تحميل الصفحة.

  3. (اختياري) إذا كانت مساحة العمل الأصلية مرتبطة بمشروع على 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 في مستودع الرموز البرمجية. يحدّد هذا الملف جميع المكوّنات التي ستتم إضافتها إلى مساحة العمل، بما في ذلك:

في ما يلي مثال على ملف .idx/dev.nix لإعدادات بيئة مساحة عمل أساسية تتيح معاينات التطبيقات في Firebase Studio:

{ pkgs, ... }: {

  # Which nixpkgs channel to use.
  channel = "stable-24.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 الأساسيCode OSS. يمنحك ذلك فرصة لإصلاح الأخطاء في ملف إعداد dev.nix وإعادة إنشاء البيئة.

الخطوات التالية