التكاملات
GitHub
أرسل كود تطبيقك إلى مستودع خاص في حسابك على GitHub، وأرسل النسخ الجديدة متى شئت، وسلّم الكود إلى مطوّر.
كود تطبيقك ملكك. مع GitHub يمكنك الاحتفاظ بنسخة منه في مستودع خاص داخل حسابك على GitHub، وإرسال النسخ الأحدث إليه متى شئت، ومشاركته مع مطوّر. تصدير الكود إلى GitHub متاح في كل الخطط ولا يستهلك أرصدة.
كيف تعمل المزامنة مع GitHub
| ما تفعله | ما يحدث |
|---|---|
| ترسل مشروعك للمرة الأولى | ينشئ Buildliy مستودعًا خاصًا في حسابك على GitHub، باسم مشروعك (مثل buildliy-candle-shop، أو buildliy-candle-shop-2 إذا كان الاسم مستخدمًا)، ويرسل إليه أحدث نسخة لديك مع ملف README |
| تواصل الإنشاء في Buildliy | لا يُرسل شيء تلقائيًا. تظهر نقطة صغيرة على أيقونة GitHub لتخبرك بوجود نسخ أحدث لم تصل إلى GitHub بعد |
| تختار إرسال أحدث نسخة | تذهب أحدث نسخة إلى المستودع على شكل إيداع جديد (commit) |
| عدّل شخص ما المستودع على GitHub | لا يستبدل Buildliy عمله. يصلك تحديثك على شكل طلب دمج يمكنك مراجعته ودمجه على GitHub |
التعديلات التي تتم على GitHub تبقى على GitHub. فهي لا تعود إلى مشروعك في Buildliy ولا إلى معاينته.
ربط GitHub وإنشاء المستودع
انقر على أيقونة GitHub
افتح مشروعك وانقر على أيقونة GitHub بجانب نشر في أعلى اليسار. إذا لم تكن قد ربطت GitHub بعد، فستنتقل إلى GitHub.
وافق على GitHub
سجّل الدخول إلى GitHub إذا لزم الأمر، ووافق على منح Buildliy الإذن. يعرض لك GitHub ما يطلبه Buildliy: وصولًا كاملًا إلى مستودعاتك العامة والخاصة، وهو يحتاجه لإنشاء مستودع مشروعك وتحديثه، ووصولًا للقراءة فقط إلى ملفك الشخصي. ثم تعود إلى مشروعك وترى الرسالة "تم ربط GitHub — يمكنك الآن إرسال هذا المشروع إلى GitHub."
أنشئ المستودع
انقر على أيقونة GitHub مرة أخرى واختر إنشاء مستودع خاص. يحتاج هذا إلى عملية إنشاء واحدة مكتملة على الأقل؛ وإلى أن يتم ذلك تظهر عبارة الإنشاء أولًا. وعند الانتهاء ترى "تم الإرسال إلى GitHub" مع اسم المستودع وزر فتح.
يمكنك أيضًا النقر على نسخ احتياطي إلى GitHub في إدارة ← نظرة عامة (تحت مساعدات سحرية، عندما تصبح الواجهة الخلفية لتطبيقك جاهزة). وهو يفعل الشيء نفسه: ينشئ المستودع في المرة الأولى ويحدّثه بعد ذلك. اربط GitHub أولًا بواسطة أيقونة GitHub.
إرسال النسخ الأحدث
انقر على أيقونة GitHub لفتح قائمتها:
- إرسال أحدث نسخة يرسل أحدث نسخة لديك. تعرض القائمة تغييرات جديدة عندما يكون هناك ما يُرسل، أو محدّث.
- فتح المستودع يفتح المستودع على GitHub.
- فصل GitHub يزيل وصول Buildliy (انظر أدناه).
بعد الإرسال سترى إحدى هذه الرسائل:
- "تم رفع أحدث نسخة لديك إلى…": المستودع يطابق تطبيقك الآن.
- "…يحتوي بالفعل على أحدث نسخة لديك.": لم يكن هناك جديد لإرساله.
- "تم فتح طلب دمج على GitHub": كان في المستودع تغييرات أُجريت على GitHub، فذهب تحديثك إلى طلب دمج. انقر على مراجعة، ثم ادمجه على GitHub ليصبح المستودع محدّثًا.
ما الذي يحتويه المستودع
- كل ملفات تطبيقك، بما فيها الصور، مع التعديلات الصغيرة نفسها لتعزيز الأمان التي يجريها Buildliy عند النشر (مثلًا، تُستبعد أداة Buildliy المساعدة على التعديل داخل المعاينة).
- ملف README فيه اسم تطبيقك ووصفه، وعنوانه المباشر إذا كان منشورًا، وطريقة تشغيله على حاسوب (Node.js 20 أو أحدث، ثم
npm installوnpm run dev)، وأي إعدادات يحتاجها، ورابطًا يعيدك إلى مشروعك في Buildliy. - ملف
.env.example، عندما يقرأ تطبيقك أي إعدادات (متغيرات البيئة)، ويسرد أسماءها مع ملاحظات. ولا يحتوي أبدًا على القيم.
هناك أشياء لا تكون في المستودع أبدًا:
- المفاتيح السرية. لن يرسل Buildliy كودًا يحتوي على ما يبدو أنه مفتاح سري. وإذا وجد واحدًا، فسيخبرك في أي ملف هو، ويطلب منك نقل المفتاح إلى إدارة ← المفاتيح السرية (أو أن تطلب ذلك من الذكاء الاصطناعي) قبل أن تحاول مرة أخرى. المفاتيح المحفوظة كمفاتيح سرية أو في الموصّلات تبقى داخل Buildliy. انظر المفاتيح السرية ومفاتيح API.
- بيانات تطبيقك. الجداول وكل ما حُفظ فيها يبقى في قاعدة بيانات تطبيقك. وإذا وجّهت الكود إلى قاعدة بيانات جديدة، فسيبدأ ببيانات فارغة.
- مفتاح Buildliy الخاص بتطبيقك. تستخدمه الميزات المدمجة مثل الذكاء الاصطناعي في تطبيقك والمدفوعات. يُضبط تلقائيًا عندما يعمل تطبيقك على Buildliy؛ أما إذا عمل الكود في مكان آخر، فلن تعمل هذه الميزات بدونه.
إذا تعذّر على Buildliy تحديث مستودعك
إذا حُذف المستودع أو أُرشف، أو كان يتبع حساب GitHub مختلفًا عن الحساب الذي ربطته، أو لم يكن حسابك مسموحًا له بالإرسال إليه، فسيعرض Buildliy عبارة تعذّر التحديث مع اسم المستودع والسبب. اختر إنشاء مستودع جديد لإرسال أحدث نسخة إلى مستودع خاص جديد بدلًا منه. أما المستودع القديم فلا يتغير ولا يُحذف.
العمل مع مطوّر
امنحه حق الوصول على GitHub
ادعُ المطوّر إلى المستودع من إعدادات GitHub نفسها. مستودعك خاص، لذلك لا يراه إلا من تدعوهم.
اطلب منه اتباع ملف README
يشرح ملف README كيفية تشغيل التطبيق على الحاسوب وما الإعدادات التي يجب ملؤها. ينسخ المطوّر
.env.exampleإلى.env.localويضيف قيمه الخاصة.اتفقا على مكان إجراء التغييرات
لا يسحب Buildliy التعديلات من GitHub إلى مشروعك. إذا واصلت الإنشاء في Buildliy بينما يعدّل المطوّر على GitHub، فسيصله كل إرسال منك على شكل طلب دمج يمكنه دمجه مع عمله.
تفضّل ألا تستخدم GitHub؟ يمكنك تنزيل كامل الكود كملف ZIP من تبويب الكود. انظر عرض الكود وتنزيله.
في مساحة العمل المشتركة، لا يستطيع إرسال المشروع إلى GitHub إلا مالك مساحة العمل، لأن الكود يذهب إلى حسابه على GitHub. يمكن لأعضاء الفريق فتح المستودع المرتبط من أيقونة GitHub، لكن GitHub لا يعرضه إلا للأشخاص الذين منحهم المالك حق الوصول على GitHub.
فصل GitHub
انقر على أيقونة GitHub، واختر فصل GitHub ثم أكّد. يفقد Buildliy الوصول إلى حسابك على GitHub في كل المشاريع، ويُلغى الوصول الذي كان لديه. تبقى مستودعاتك وكودها على GitHub، ويبقى كل مشروع مرتبطًا بمستودعه. وإلى أن تعيد الربط، تعرض قائمة GitHub في المشروع المرتبط عبارة ربط GitHub للإرسال. يمكنك إعادة الربط في أي وقت، حتى بحساب GitHub مختلف.
مواضيع ذات صلة
ما زلت عالقًا؟ اقرأ الأسئلة الشائعة أو تواصل معنا.