データ移行操作ガイド
このページでは、データディレクトリ移行の実際のワークフローについて説明します。技術的な実装詳細については、基本実装をご参照ください。
アプリ関連データディレクトリの検索
- AppPorts メインウィンドウで「データディレクトリ」タブに切り替え
- 左パネルにインストール済みのすべてのアプリが表示されます
- アプリをクリック；右パネルに
~/Library/以下の関連データディレクトリが表示されます
AppPorts は、アプリの Bundle ID または名前でマッチングしながら、以下のディレクトリを自動スキャンします：
| スキャンパス | マッチング方法 |
|---|---|
~/Library/Application Support/ | Bundle ID またはアプリ名 |
~/Library/Preferences/ | Bundle ID またはアプリ名 |
~/Library/Containers/ | Bundle ID |
~/Library/Group Containers/ | Bundle ID |
~/Library/Caches/ | Bundle ID またはアプリ名 |
~/Library/WebKit/ | Bundle ID |
~/Library/HTTPStorages/ | Bundle ID |
~/Library/Application Scripts/ | Bundle ID |
~/Library/Logs/ | アプリ名 |
~/Library/Saved Application State/ | アプリ名 |
ツールディレクトリ（ドットフォルダ）
AppPorts は、ユーザーのホームディレクトリにある一般的な開発ツールが作成したドットフォルダを自動検出します：
- データディレクトリタブの「ツールディレクトリ」サブタブに切り替え
- ページには検出されたすべてのツールディレクトリとそのサイズが一覧表示されます
- 各ディレクトリには優先度バッジ（推奨/任意）とステータスが表示されます
サポートされている完全なリストについては、ツールディレクトリ検出をご参照ください。
移行操作
単一ディレクトリの移行
- データディレクトリリストで移行するディレクトリを見つける
- 右側の「移行」ボタンをクリック
- AppPorts は以下のステップを実行します：
- ディレクトリを外部ストレージにコピー
- 管理リンクメタデータを書き込み
- 元のローカルディレクトリを削除
- シンボリックリンクを作成
一括移行
- ツールディレクトリリストで複数のディレクトリにチェックを入れる
- 下部の「一括移行」ボタンをクリック
- AppPorts は順番に移行を実行します
💡 優先度の推奨
データディレクトリは3つの優先度レベルに分類されます：
- 重要（
critical）: 移行後も動作が必須；コアアプリケーション機能に影響 - 推奨（
recommended）: 大きな容量削減効果；移行のメリットが高い - 任意（
optional）: サイズが小さいか再構築可能
「推奨」とマークされたディレクトリから優先的に移行することをお勧めします。
復元操作
- データディレクトリリストで移行済みのディレクトリを見つける（ステータス：「Linked」）
- 右側の「復元」ボタンをクリック
- AppPorts は以下のステップを実行します：
- ローカルのシンボリックリンクを削除
- 外部ストレージからデータをローカルにコピー
- 外部ディレクトリを削除（ベストエフォート）
異常状態の処理
Needs Normalization（正規化が必要）
ディレクトリは AppPorts によって管理されていますが、外部パスが正規の場所にありません。「正規化」をクリックすると、AppPorts は外部データを正規のパスに移動し、シンボリックリンクを再構築します。
Needs Relinking（再リンクが必要）
外部ストレージデータがまだ存在していますが、ローカルのシンボリックリンクが失われています。「再リンク」をクリックすると、AppPorts はシンボリックリンクを再作成します。
Existing Soft Link（既存のソフトリンク）
AppPorts が作成したものではない、ユーザーが作成したシンボリックリンクです。「管理を引き継ぐ」を選択でき、AppPorts は管理リンクメタデータを書き込んで以降管理します。
ツリービュー
サブディレクトリを含むデータディレクトリ（例：Application Support 内の複数のアプリディレクトリ）について、AppPorts はツリーのグループ化ビューを提供します：
- 親ディレクトリの左側に展開/折りたたみ矢印が表示されます
- サブディレクトリは階層インデントで表示されます
- 各ノードは独立してサイズとステータスを表示します
- 個別のサブディレクトリに対して移行/復元操作を実行できます