التثبيت

يُوزَّع Getman كتطبيق سطح مكتب لـ macOS وWindows، وكأداة سطر أوامر يثبّتها التطبيق لك. تحتاج إلى التطبيق للعمل اليومي، ولا تحتاج إلى سطر الأوامر إلا إذا أردت تشغيل الطلبات من الطرفية أو السماح لوكيل برمجي باستخدام Getman.

المتطلبات

البند	macOS	Windows
نظام التشغيل	10.13 أو أحدث، بنية universal	10 أو 11، x64
المثبّت	.dmg	.msi أو .exe
برامج إضافية	لا شيء	WebView2
Git	اختياري، للمزامنة مع الفريق	اختياري، للمزامنة مع الفريق
Node.js	20 أو أحدث، لسطر الأوامر فقط	20 أو أحدث، لسطر الأوامر فقط

التثبيت على macOS

1. نزّل البناء المناسب لنظامك من إصدار GitHub الخاص بالفريق، أو من ملفات artifacts لأحدث تشغيل لسير عمل build.
2. افتح ملف .dmg واسحب Getman إلى Applications.
3. افتح Getman لأول مرة بالنقر بالزر الأيمن ثم Open. البناء غير موقّع بعد، لذلك يطلب macOS تأكيدا مرة واحدة.

التثبيت على Windows

1. نزّل المثبّت .msi أو .exe.
2. شغّله واتبع التعليمات.

تثبيت أداة سطر الأوامر

أداة سطر الأوامر اختيارية. وهي المحرك نفسه الذي يستخدمه التطبيق، وتتيح للطرفيات والوكلاء تشغيل الطلبات.

1. افتح Project settings واختر Command line & agents.
2. اختر Install command-line tool.
3. تحقق من أن المشغّل موجود في PATH.

يكتب Getman مشغّل getman في ~/.local/bin، أو في %LOCALAPPDATA%\Getman\bin على Windows. إذا أخبرك Getman أن هذا المجلد ليس في PATH، فأضفه إلى ملف إعداد الصدفة أو إلى إعدادات النظام. ويحذّرك أيضا إذا كان Node.js غير مثبّت.

للتحقق من الأداة، شغّل:

getman help

فتح مساحة عمل الفريق

فتح مساحة عمل الفريق من نسخة محلية جديدة (clone) بخطوة واحدة، من البطاقة Open a team workspace في شاشة الترحيب، أو من عنصر القائمة Open team workspace… في شريط العنوان.

أو اربط نسختك المحلية عبر إعدادات المشروع:

1. انسخ المستودع كالمعتاد.
2. أنشئ مشروعا في Getman أو افتح مشروعا موجودا، ثم انتقل إلى Project settings ← Team sync.
3. اختر Choose folder وحدد مجلد getman في نسختك المحلية.
4. اختر Load from folder. إذا سألك Getman أي نسخة تحتفظ بها، فاختر النسخة التي تقصدها.

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

التحقق من التثبيت

1. افتح مشروعا وأرسل أي طلب.
2. شغّل getman help في الطرفية.
3. تأكد من أن قائمة البيئات تعرض البيئة التي تتوقعها.

إذا فشل شيء ما، راجع استكشاف الأخطاء.