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

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

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

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

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

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

لإنشاء مساحة عمل جديدة، اتّبِع الخطوات التالية:

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

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

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

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

  2. أدخِل اسم مساحة العمل الجديدة وانقر على إنشاء نسخة. سيتم إنشاء مساحة العمل الجديدة وإضافتها إلى قائمة مساحات العمل.

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

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