نصب

این راهنما دستورالعمل‌های گام به گام برای نصب HarborDB روی دستگاه macOS شما را ارائه می‌دهد.

روش‌های نصب

Mac App Store (توصیه می‌شود)

ساده‌ترین راه برای نصب HarborDB از طریق Mac App Store رسمی است:

1. Mac App Store را باز کنید روی دستگاه macOS خود
2. "HarborDB" را جستجو کنید در نوار جستجو
3. روی "دریافت" یا دکمه قیمت ($19.99) کلیک کنید تا خرید و دانلود انجام شود
4. منتظر نصب بمانید - برنامه به طور خودکار دانلود و نصب خواهد شد
5. HarborDB را اجرا کنید از پوشه Applications، Launchpad یا Spotlight

مزایای نصب از طریق Mac App Store:

• به‌روزرسانی‌های خودکار
• توزیع تأیید شده و امن
• نصب و حذف آسان
• پشتیبانی از Family Sharing

دانلود مستقیم (جایگزین)

برای استقرارهای سازمانی یا اهداف آزمایشی، می‌توانید HarborDB را به طور مستقیم دانلود کنید:

1. صفحه دانلود ما را ببینید در harbordb.com/download
2. آخرین فایل .dmg را دانلود کنید
3. فایل .dmg را باز کنید با دوبار کلیک کردن روی آن
4. HarborDB را به پوشه Applications بکشید
5. تصویر دیسک را خارج کنید پس از کپی کردن

نکته امنیتی: هنگام دانلود مستقیم، مطمئن شوید که اصالت دانلود را با استفاده از checksum‌های ارائه شده تأیید می‌کنید.

نیازمندی‌های سیستم

قبل از نصب، بررسی کنید که سیستم شما این نیازمندی‌ها را داشته باشد:

نیازمندی‌های حداقل

• macOS: 12.0 (Monterey) یا جدیدتر
• پردازنده: Intel Core i5 (نسل هشتم) یا Apple Silicon (M1)
• حافظه: 8 GB RAM
• فضای ذخیره‌سازی: 200 MB فضای آزاد
• نمایشگر: رزولوشن 1280 × 800

نیازمندی‌های توصیه شده

• macOS: 13.0 (Ventura) یا جدیدتر
• پردازنده: Apple Silicon (M2 یا جدیدتر)
• حافظه: 16 GB RAM یا بیشتر
• فضای ذخیره‌سازی: 500 MB فضای آزاد (برای cache و export‌ها)
• نمایشگر: رزولوشن 1920 × 1080 یا بالاتر

نیازمندی‌های سرور PostgreSQL

• PostgreSQL: نسخه 9.6 یا جدیدتر (نسخه 12+ توصیه می‌شود)
• شبکه: اتصال TCP/IP به سرور PostgreSQL
• دسترسی‌ها: کاربر باید دسترسی‌های اتصال و کوئری داشته باشد

اولین اجرا

پس از نصب، HarborDB را برای اولین بار اجرا کنید:

1. HarborDB را پیدا کنید در پوشه Applications یا از Spotlight استفاده کنید (⌘ + Space، تایپ کنید "HarborDB")
2. برای اجرا دوبار کلیک کنید - ممکن است نیاز باشد مجوز اجرا را بدهید (فقط بار اول)
3. مجوزهای سیستم را بررسی کنید:
   • دسترسی (Accessibility): برای میانبرهای صفحه‌کلید و بهبود رابط کاربری مورد نیاز است (اختیاری)
   • شبکه (Network): برای اتصالات پایگاه داده مورد نیاز است
   • Keychain: برای ذخیره امن رمز عبور مورد نیاز است

هشدارهای Gatekeeper (دانلود مستقیم)

اگر HarborDB را به طور مستقیم دانلود کرده‌اید، ممکن است یک هشدار امنیتی ببینید:

"HarborDB" cannot be opened because the developer cannot be verified.

برای رفع این مشکل:

1. به System Preferences → Security & Privacy بروید
2. روی "Open Anyway" در کنار هشدار HarborDB کلیک کنید
3. تأیید کنید که می‌خواهید برنامه را باز کنید

مراحل پس از نصب

1. تأیید نصب

• بررسی کنید که HarborDB در پوشه Applications شما ظاهر شده است
• تأیید کنید که برنامه بدون خطا اجرا می‌شود
• منوی About را بررسی کنید (HarborDB → About HarborDB) برای اطلاعات نسخه

2. بررسی به‌روزرسانی‌ها

• Mac App Store: به‌روزرسانی‌ها خودکار هستند، اما می‌توانید به صورت دستی در تب Updates فروشگاه بررسی کنید
• دانلود مستقیم: از HarborDB → Check for Updates برای بررسی به‌روزرسانی‌ها استفاده کنید

3. پیکربندی تنظیمات (اختیاری)

• تنظیم تم (روشن/تیره/سیستم)
• پیکربندی تنظیمات اتصال پیش‌فرض
• تنظیم میانبرهای صفحه‌کلید

رفع مشکلات نصب

خطای "App is Damaged"

اگر پیام "HarborDB.app is damaged and can't be opened" را می‌بینید:

# Terminal را باز کنید و اجرا کنید:
sudo xattr -cr /Applications/HarborDB.app

دسترسی‌های ناکافی

اگر HarborDB نمی‌تواند به منابع مورد نیاز دسترسی پیدا کند:

1. به System Preferences → Security & Privacy → Privacy بروید
2. دسترسی‌های لازم را بدهید (Accessibility، Files & Folders و غیره)
3. HarborDB را مجدداً راه‌اندازی کنید

نصب ناموفق است

اگر نصب ناموفق است یا برنامه اجرا نمی‌شود:

1. Mac خود را ری‌استارت کنید و دوباره امتحان کنید
2. فضای دیسک را بررسی کنید - مطمئن شوید حداقل 500 MB فضای آزاد دارید
3. نسخه macOS را تأیید کنید - About This Mac → macOS version را بررسی کنید
4. با پشتیبانی تماس بگیرید اگر مشکلات ادامه دارد

حذف نصب

برای حذف HarborDB از سیستم خود:

نسخه Mac App Store

1. Finder → Applications را باز کنید
2. HarborDB.app را به سطل زباله بکشید
3. سطل زباله را خالی کنید

نسخه دانلود مستقیم

1. برنامه را از /Applications حذف کنید

2. تنظیمات را حذف کنید (اختیاری):

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

3. موارد Keychain را حذف کنید (اختیاری) - Keychain Access را باز کنید و "HarborDB" را جستجو کنید

مراحل بعدی

اکنون که HarborDB نصب شده است:

1. اولین اتصال خود را ایجاد کنید - به یک پایگاه داده PostgreSQL متصل شوید
2. رابط کاربری را کاوش کنید - درباره ویژگی‌های HarborDB بیاموزید
3. کوئری‌های نمونه را امتحان کنید - با SQL تمرین کنید

به کمک نیاز دارید؟ سؤالات متداول ما را بررسی کنید یا با پشتیبانی تماس بگیرید.