التثبيت

يقدم هذا الدليل تعليمات خطوة بخطوة لتثبيت HarborDB على جهاز macOS الخاص بك.

طرق التثبيت

متجر Mac App Store (مُوصى به)

أسهل طريقة لتثبيت HarborDB هي من خلال متجر Mac App Store الرسمي:

1. افتح متجر Mac App Store على جهاز macOS الخاص بك
2. ابحث عن "HarborDB" في شريط البحث
3. انقر على "الحصول" أو زر السعر (19.99 دولاراً) للشراء والتنزيل
4. انتظر التثبيت - سيتم تنزيل التطبيق وتثبيته تلقائياً
5. شغّل HarborDB من مجلد التطبيقات أو Launchpad أو Spotlight

فوائد التثبيت من متجر Mac App Store:

• تحديثات تلقائية
• توزيع موثوق وآمن
• تثبيت وإزالة سهلان
• دعم مشاركة العائلة

التنزيل المباشر (بديل)

لنشر المؤسسات أو أغراض الاختبار، يمكنك تنزيل HarborDB مباشرة:

1. زُر صفحة التنزيل الخاصة بنا على harbordb.com/download
2. نزّل أحدث ملف .dmg
3. افتح ملف .dmg بالنقر المزدوج عليه
4. اسحب HarborDB إلى مجلد التطبيقات الخاص بك
5. أخرِج صورة القرص بعد النسخ

ملاحظة أمان: عند التنزيل مباشرة، تأكد من التحقق من صحة التنزيل باستخدام مجاميع الاختبار المتوفرة.

متطلبات النظام

قبل التثبيت، تحقق من أن نظامك يلبي هذه المتطلبات:

الحد الأدنى من المتطلبات

• macOS: 12.0 (Monterey) أو أحدث
• المعالج: Intel Core i5 (الجيل الثامن) أو Apple Silicon (M1)
• الذاكرة: 8 جيجابايت من ذاكرة الوصول العشوائي
• التخزين: 200 ميجابايت من المساحة المتاحة
• الشاشة: دقة 1280 × 800

المتطلبات الموصى بها

• macOS: 13.0 (Ventura) أو أحدث
• المعالج: Apple Silicon (M2 أو أحدث)
• الذاكرة: 16 جيجابايت من ذاكرة الوصول العشوائي أو أكثر
• التخزين: 500 ميجابايت من المساحة المتاحة (للتخزين المؤقت والتصدير)
• الشاشة: دقة 1920 × 1080 أو أعلى

متطلبات خادم PostgreSQL

• PostgreSQL: الإصدار 9.6 أو أحدث (يُوصى بـ 12+)
• الشبكة: اتصال TCP/IP بخادم PostgreSQL
• الأذونات: يجب أن يكون للمستخدم أذونات الاتصال والاستعلام

التشغيل الأول

بعد التثبيت، شغّل HarborDB لأول مرة:

1. حدد موقع HarborDB في مجلد التطبيقات الخاص بك أو استخدم Spotlight (⌘ + مسافة، اكتب "HarborDB")
2. انقر نقراً مزدوجاً للتشغيل - قد تحتاج إلى منح الإذن للتطبيق للتشغيل (للمرة الأولى فقط)
3. راجع أذونات النظام:
   • إمكانية الوصول: مطلوبة لاختصارات لوحة المفاتيح وتحسينات واجهة المستخدم (اختياري)
   • الشبكة: مطلوبة لاتصالات قاعدة البيانات
   • سلسلة المفاتيح: مطلوبة لتخزين كلمة المرور بشكل آمن

تحذيرات Gatekeeper (التنزيل المباشر)

إذا قمت بتنزيل HarborDB مباشرة، فقد ترى تحذير أمان:

لا يمكن فتح "HarborDB" لأنه لا يمكن التحقق من المطور.

لحل هذا:

1. انتقل إلى تفضيلات النظام → الأمان والخصوصية
2. انقر على "فتح على أي حال" بجانب تحذير HarborDB
3. أكد أنك تريد فتح التطبيق

خطوات ما بعد التثبيت

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

• تحقق من ظهور HarborDB في مجلد التطبيقات الخاص بك
• تحقق من أن التطبيق يعمل دون أخطاء
• تحقق من قائمة About (HarborDB → حول HarborDB) للحصول على معلومات الإصدار

2. تحقق من وجود تحديثات

• متجر Mac App Store: التحديثات تلقائية، ولكن يمكنك التحقق يدوياً في علامة تبويب التحديثات في متجر التطبيقات
• التنزيل المباشر: تحقق من وجود تحديثات في HarborDB → التحقق من وجود تحديثات

3. تكوين التفضيلات (اختياري)

• اضبط السمة (فاتح/داكن/النظام)
• قم بتكوين إعدادات الاتصال الافتراضية
• قم بإعداد اختصارات لوحة المفاتيح

استكشاف أخطاء مشكلات التثبيت وإصلاحها

خطأ "التطبيق تالف"

إذا رأيت "HarborDB.app تالف ولا يمكن فتحه":

# افتح Terminal وشغّل:
sudo xattr -cr /Applications/HarborDB.app

أذونات غير كافية

إذا لم يتمكن HarborDB من الوصول إلى الموارد المطلوبة:

1. انتقل إلى تفضيلات النظام → الأمان والخصوصية → الخصوصية
2. منح الأذونات اللازمة (إمكانية الوصول، الملفات والمجلدات، إلخ.)
3. أعد تشغيل HarborDB

فشل التثبيت

إذا فشل التثبيت أو لم يعمل التطبيق:

1. أعد تشغيل جهاز Mac الخاص بك وحاول مرة أخرى
2. تحقق من مساحة القرص - تأكد من أن لديك 500 ميجابايت مجانية على الأقل
3. تحقق من إصدار macOS - تحقق من حول هذا Mac → إصدار macOS
4. اتصل بالدعم إذا استمرت المشكلات

إلغاء التثبيت

لإزالة HarborDB من نظامك:

إصدار متجر Mac App Store

1. افتح Finder → التطبيقات
2. اسحب HarborDB.app إلى سلة المهملات
3. أفرغ سلة المهملات

إصدار التنزيل المباشر

1. قم بإزالة التطبيق من /Applications

2. قم بإزالة التفضيلات (اختياري):

   rm -rf ~/Library/Preferences/com.harbordb.HarborDB.plist
   rm -rf ~/Library/Application\ Support/HarborDB
   

3. قم بإزالة إدخالات سلسلة المفاتيح (اختياري) - افتح Keychain Access وابحث عن "HarborDB"

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

الآن بعد تثبيت HarborDB:

1. أنشئ أول اتصال لك - اتصل بقاعدة بيانات PostgreSQL
2. استكشف الواجهة - تعرف على ميزات HarborDB
3. جرب استعلامات نموذجية - تدرب على SQL

هل تحتاج إلى مساعدة؟ تحقق من الأسئلة الشائعة أو اتصل بالدعم.