このガイドでは、macOS デバイスに HarborDB をインストールするためのステップバイステップの手順を説明します。

インストール方法

Mac App Store（推奨）

HarborDB をインストールする最も簡単な方法は、公式の Mac App Store を使用することです：

Mac App Store を開く - macOS デバイスで Mac App Store を開きます
"HarborDB" を検索する - 検索バーで "HarborDB" を検索します
「入手」をクリックする - 「入手」ボタンまたは価格ボタン（$19.99）をクリックして購入・ダウンロードします
インストールを待つ - アプリが自動的にダウンロードされ、インストールされます
HarborDB を起動する - アプリケーションフォルダ、Launchpad、または Spotlight から HarborDB を起動します

Mac App Store インストールの利点：

自動アップデート
検証済みで安全な配布
簡単なインストールと削除
ファミリー共有のサポート

直接ダウンロード（代替方法）

エンタープライズ展開やテスト目的の場合、HarborDB を直接ダウンロードできます：

ダウンロードページにアクセスする - harbordb.com/download にアクセスします
最新の .dmg ファイルをダウンロードする
.dmg ファイルを開く - ダブルクリックして開きます
HarborDB をアプリケーションフォルダにドラッグする
コピー後にディスクイメージを取り出す

セキュリティ注意事項: 直接ダウンロードする場合は、提供されているチェックサムを使用してダウンロードの真正性を確認してください。

システム要件

インストール前に、システムが以下の要件を満たしていることを確認してください：

最小要件

macOS: 12.0 (Monterey) 以降
プロセッサ: Intel Core i5 (第8世代) または Apple Silicon (M1)
メモリ: 8 GB RAM
ストレージ: 200 MB 以上の空き容量
ディスプレイ: 1280 × 800 解像度

推奨要件

macOS: 13.0 (Ventura) 以降
プロセッサ: Apple Silicon (M2 以降)
メモリ: 16 GB RAM 以上
ストレージ: 500 MB 以上の空き容量（キャッシュとエクスポート用）
ディスプレイ: 1920 × 1080 解像度以上

PostgreSQL サーバー要件

PostgreSQL: バージョン 9.6 以降（12以降を推奨）
ネットワーク: PostgreSQL サーバーへの TCP/IP 接続性
権限: ユーザーは接続およびクエリ権限を持っている必要があります

最初の起動

インストール後、初めて HarborDB を起動します：

HarborDB を探す - アプリケーションフォルダ内で見つけるか、Spotlight（⌘ + スペース、「HarborDB」と入力）を使用します
ダブルクリックして起動 - アプリを実行するための許可を求めるメッセージが表示される場合があります（初回のみ）
システム権限を確認：
- アクセシビリティ: キーボードショートカットと UI 拡張に必要（オプション）
- ネットワーク: データベース接続に必要
- キーチェーン: 安全なパスワード保存に必要

Gatekeeper 警告（直接ダウンロード）

HarborDB を直接ダウンロードした場合、セキュリティ警告が表示されることがあります：

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

これを解決するには：

システム環境設定 → セキュリティとプライバシー に移動します
HarborDB 警告の横にある 「とにかく開く」 をクリックします
アプリケーションを開くことを確認します

インストール後の手順

1. インストールの確認

HarborDB がアプリケーションフォルダに表示されていることを確認します
アプリがエラーなく起動することを確認します
バージョン情報を確認するには「HarborDB → HarborDB について」メニューを確認します

2. アップデートの確認

Mac App Store: アップデートは自動ですが、App Store のアップデートタブで手動で確認できます
直接ダウンロード: HarborDB → アップデートを確認でチェックできます

3. 環境設定の設定（オプション）

テーマを調整（ライト/ダーク/システム）
デフォルト接続設定を構成
キーボードショートカットを設定

インストールの問題のトラブルシューティング

「アプリが壊れています」エラー

「HarborDB.app は壊れているため開けません」と表示された場合：

# ターミナルを開いて実行：
sudo xattr -cr /Applications/HarborDB.app

権限不足

HarborDB が必要なリソースにアクセスできない場合：

システム環境設定 → セキュリティとプライバシー → プライバシー に移動します
必要な権限を付与します（アクセシビリティ、ファイルとフォルダなど）
HarborDB を再起動します

インストール失敗

インストールが失敗するか、アプリが起動しない場合：

Mac を再起動して再度試します
ディスク容量を確認 - 少なくとも 500 MB の空き容量があることを確認します
macOS バージョンを確認 - この Mac について → macOS バージョンを確認します
問題が解決しない場合はサポートに連絡してください

アンインストール

システムから HarborDB を削除するには：

Mac App Store バージョン

Finder → アプリケーション を開きます
HarborDB.app をゴミ箱にドラッグします
ゴミ箱を空にします

直接ダウンロードバージョン

/Applications からアプリケーションを削除します

環境設定を削除します（オプション）：

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

キーチェーンエントリを削除します（オプション）- キーチェーンアクセスを開き、「HarborDB」を検索します

次のステップ

HarborDB をインストールしたら：

最初の接続を作成する - PostgreSQL データベースに接続します
インターフェースを探索する - HarborDB の機能について学びます
サンプルクエリを試す - SQL を練習します

ヘルプが必要ですか？ FAQ を確認するか、サポートにお問い合わせください。

インストール