التعاون مع المطوّرين الآخرين

توفّر لغة برمجة التطبيقات بعض الميزات التي تساعدك أنت والمطوّرين الآخرين على إنشاء النصوص البرمجية والإضافات وتطبيقات الويب وصيانتها معًا.

أساسيات التعاون

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

ويمكنك مساعدة فريقك من خلال التخطيط المسبق لكيفية التعامل مع التعديل والمراجعة وتحديد الإصدارات ونشر المشروع أو الإضافة أو تطبيق الويب ونشره (إن أمكن). تكون المشاريع المستقلّة هي الأسهل في التعاون عادةً، لأنّها تظهر مباشرةً في Google Drive وهي نوع مشروع مقترَح لتطوير الإضافات وتطبيقات الويب.

تحدث مشكلة شائعة في التعاون عندما يغادر مالك مشروع النص الفريق دون نقل ملكية المشروع إلى شخص آخر في الفريق. قد يجعلك هذا غير قادر على الحفاظ على المشروع أو تحديثه. يؤدي وضع مشروع النص البرمجي في مساحة تخزين سحابي مشتركة إلى منع هذه المشكلة، لأنّ الملفات في مساحة التخزين السحابي المشتركة ليس لها مالكون محدَّدون.

التعاون باستخدام أداة سطر الأوامر clasp

يتيح لك clasp مزامنة المشاريع بين script.google.com ونظام الملفات المحلي. يتيح لك ذلك تبسيط عملية تطوير الرموز البرمجية وبرمجة عملية تطويرها إذا كنت أنت والمتعاونون الذين تستخدمهم تستخدمون برنامج إدارة تحكّم بالمصدر مثل git.

لمزيد من التفاصيل، يمكنك الاطّلاع على واجهة سطر الأوامر باستخدام دليل clasp.

التعاون باستخدام مساحات التخزين السحابي المشتركة

توفّر مساحات التخزين السحابي المشتركة (المعروفة سابقًا باسم "مساحات التخزين السحابي المشتركة") مساحة مشتركة في Google Drive تمكِّن فيه مجموعات من مستخدمي Drive من التعاون على نحو أكثر فعالية. تعتبر الملفات الموضوعة في مساحة التخزين السحابي المشتركة ملكًا للمجموعة ككل، وليس للأفراد. وهذا يعني أنه عندما يغادر أحد المتعاونين المجموعة، فإنه لا يأخذ ملكية الملفات ويتحكم فيها.

تتيح لك مساحات التخزين السحابي المشتركة أيضًا نقل الملفات بين النطاقات، حيث يمكن أن تضم مساحة التخزين السحابي المشتركة في أحد النطاقات متعاونين من نطاق آخر يمكنهم نقل الملفات من ذلك النطاق إلى مساحة التخزين السحابي المشتركة. قد يكون ذلك مفيدًا جدًا لمطوّري لغة "برمجة تطبيقات Google"، إذ إنّه يوفّر وسيلة للفريق لتطوير الإضافات أو تطبيقات الويب أو أي رمز آخر للعملاء في نطاقات مختلفة.

عند استخدام مساحات التخزين السحابي المشتركة للتعاون في مشاريع برمجة التطبيقات، يُرجى مراعاة ما يلي:

  1. يمكن للمتعاونين الذين لديهم إذن التعديل في مساحة التخزين السحابي المشتركة إنشاء ملفات جديدة أو نقلها إلى مساحة التخزين السحابي المشتركة. ويمكنهم عرض مشاريع النصوص البرمجية وتعديلها، وتشغيل رمز النص البرمجي، وإنشاء نُسخ جديدة من النصوص البرمجية، ونشر الإضافات.
  2. لنشر نصوص برمجية كتطبيقات ويب أو ملفات قابلة للتنفيذ لواجهة برمجة تطبيقات برمجة التطبيقات، يجب أن ينتمي الحساب الذي ينشئ عملية النشر إلى النطاق نفسه الذي ينتمي إليه مساحة التخزين السحابي المشتركة التي يتوفّر فيها النص البرمجي.
  3. تتيح لك مساحات التخزين السحابي المشتركة مشاركة ملفات محددة ضمن مساحة التخزين السحابي المشتركة مع مستخدمين آخرين خارج المجموعة وتعديل أذونات التعديل والعرض الخاصة بهم في تلك الملفات، مثل أي ملف آخر على Drive. ومع ذلك، إذا كان المستخدم جزءًا من الفريق الذي تنتمي إليه مساحة التخزين السحابي المشتركة، لا يمكنك تقليل إمكانية وصوله إلى ملفات محدّدة. على سبيل المثال، إذا كان لدى المستخدم الإذن بتعديل مساحة تخزين سحابي مشتركة، لا يمكنك تغيير هذا الإذن إلى "إذن بالعرض فقط" لملف معيّن داخل مساحة التخزين السحابي المشتركة.
  4. يمكن أيضًا للمتعاونين الذين يمتلكون إذن الوصول الكامل إلى مساحة التخزين السحابي المشتركة حذف الملفات ومشاريع "برمجة تطبيقات Google" ونقل الملفات خارج مساحة التخزين السحابي المشتركة.
  5. تستخدم جميع النصوص البرمجية المرتبطة بالحاوية قوائم وصول المشاهد والمحرر نفسها المحددة لملف الحاوية. على سبيل المثال، إذا كان لديك الإذن بتعديل جدول بيانات Google، سيكون لديك أيضًا الإذن بتعديل أي رمز مشروع لبرمجة تطبيقات Google مرفق به. يؤدي وضع ملف الحاوية كهذا في مساحة تخزين سحابي مشتركة إلى منح المتعاونين في مساحة التخزين السحابي المشتركة إمكانية الوصول نفسها إلى رمز النص البرمجي كما حصلوا على الحاوية نفسها.
  6. عند توفّر مشروع نص برمجي في مساحة تخزين سحابي مشتركة، قد يكون الوصول إلى مشروع Cloud Platform (GCP) مقيدًا. يمكنك الاطّلاع على قسم دليل مشاريع Google Cloud Platform ومساحات التخزين السحابي المشتركة لمعرفة التفاصيل.
  7. ستتوقف تطبيقات الويب المنشورة في أحد النطاقات عن العمل في حال تغيّرت ملكيتها إلى مساحة تخزين سحابي مشتركة أو حساب في نطاق مختلف. يمكن تصحيح ذلك عن طريق إعادة النص البرمجي إلى نطاقه الأصلي.
  8. وبالمثل، تتوقف مشاريع النصوص البرمجية المنشورة كواجهة برمجة تطبيقات لبرمجة التطبيقات عن العمل عند طلبها من واجهة برمجة التطبيقات في حال نقلها عبر مساحة تخزين سحابي مشتركة من نطاق إلى آخر. يمكن تصحيح ذلك من خلال نقل النص البرمجي مرة أخرى إلى نطاقه الأصلي.

التعاون باستخدام مجلد مشترك

إذا لم تتمكن من التعاون في مساحة تخزين سحابي مشتركة، يمكنك استخدام مجلد مشترك بدلاً من ذلك. عند إنشاء مشروع "برمجة تطبيقات Google" أو نقله إلى مجلد في Google Drive يمكن للمستخدمين الآخرين الوصول إليه، سيكتسبون إذن الوصول نفسه إلى مشروع "برمجة تطبيقات Google" الذي يملكونه للمجلد. مثال:

  • إذا كان لدى أحد المستخدمين الإذن بتعديل المجلد، يمكنه تعديل مشروع "برمجة تطبيقات Google" أو حذفه وتشغيل النص البرمجي.
  • إذا كان لدى أحد الأشخاص الإذن بالاطّلاع على المجلد فقط، يمكنه عرض مشروع "برمجة تطبيقات Google" وتشغيل النص البرمجي.

التعاون من خلال مشاركة المشروع

يمكنك التعاون في مشروع من خلال مشاركة المشروع مباشرةً مع جميع المتعاونين. يمكنك مشاركة مشاريع النصوص البرمجية مباشرةً في مجلدات Google Drive العادية أو في مساحات التخزين السحابي المشتركة. إذا استخدمت هذه الطريقة، ننصحك بالتخطيط بعناية للمستخدم الذي يملك النص البرمجي ويحافظ عليه بمرور الوقت.

تظهر المشاريع المستقلة في Google Drive كملف، ويمكنك مشاركتها مثل أي ملف آخر. لمزيد من المعلومات، راجع مشاركة الملفات والمجلدات.

لا تظهر المشاريع المرتبطة بالحاويات من Google Drive. لمشاركة مشروع مرتبط بحاوية، يمكنك مشاركة ملف الحاوية الرئيسية. على سبيل المثال، إذا كان لديك نص برمجي مرتبط بجدول بيانات في "جداول بيانات Google"، يمكنك جعل شخص ما محررًا للنص البرمجي من خلال جعله محررًا لجدول البيانات. تكتسب المشاريع المرتبطة بالحاويات إعدادات وصول المشاهد والمحرر إلى الملف الحاوية الخاص بها.

تستخدم جميع النصوص البرمجية المرتبطة بالحاويات قائمة وصول المالك والمشاهد والمحرر نفسه المحددة لملف الحاوية. يحصل مالك الحاوية على ملكية مشروع نص برمجي جديد بغض النظر عن الشخص الذي أنشأه.

موارد التعاون والمشروع

الموارد هي كيانات مرتبطة بمشروعك ولكنها موجودة بشكل مستقل عن التعليمات البرمجية الخاصة به. يوضّح هذا القسم كيف يؤثر التعاون في مشروع ما في موارده، وخاصةً: مشروع Cloud Platform والمشغلات والمكتبات وخصائص المستخدمين.

التعاون ومشاريع Google Cloud

يرتبط كل مشروع من مشاريع "برمجة تطبيقات Google" بمشروع Google Cloud مرتبط به. تتضمّن مشاريع Google Cloud مجموعة خاصة بها من المالكين والمحرِّرين والأدوار الأخرى، والتي يمكن أن تختلف عن مجموعة المستخدمين الذين يمكنهم الوصول إلى مشروع النصوص البرمجية.

إذا كان من المفترض نشر مشروع النص البرمجي كإضافة، يجب استخدام مشروع عادي على Google Cloud. عند التعاون على تطبيق يستخدم مشروعًا عاديًا على Google Cloud، ننصحك بضبط مالكي حسابات Google Cloud وأدوارهم لضمان حصول جميع المتعاونين على مستويات الوصول المناسبة. يساعد ذلك في منع المواقف التي تفقد فيها إمكانية الوصول إلى إعدادات السحابة الإلكترونية للمشروع لأن مالكيه لم يعودوا تابعين لمؤسستك. هذا مهم بشكل خاص للإضافات.

التعاون وعوامل التشغيل

عند التعاون في مشروع، لا تتم مشاركة أي مشغلات قابلة للتثبيت تنشئها مع المستخدمين الذين لديهم إمكانية الوصول إلى مشروعك. إذا كنت بحاجة إلى إعداد مشغِّل متسق لجميع المتعاونين، يمكنك استخدام خدمة النص البرمجي لإنشاء عوامل تشغيل بشكل آلي في وقت التشغيل. لمزيد من المعلومات، يُرجى الاطّلاع على مقالة إدارة العوامل المشغِّلة آليًا.

التعاون والمكتبات

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

التعاون وخصائص المستخدِمين

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