لمحة عن مساحات العمل في 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 وإعادة إنشاء البيئة.

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