データ移行操作ガイド
このページでは、データディレクトリ移行の実際のワークフローについて説明します。技術的な実装詳細については、基本実装をご参照ください。
アプリ関連データディレクトリの検索
- 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 は以下のステップを実行します：
- ディレクトリを外部ストレージにコピー
- 管理リンクメタデータを書き込み
- 元のローカルディレクトリを削除
- シンボリックリンクを作成
自動再署名
設定で「自動再署名」を有効にすると、データディレクトリ移行が関連アプリの署名を自動的にトリガーします：
- 移行前：関連アプリの実外部パスの元の署名をバックアップ（ローカルシェルではなく）
- 移行後：実外部アプリに対して Ad-hoc 再署名を実行（サイレントモード；失敗時はダイアログを表示しない）
リンク済みアプリの場合、AppPorts は Stub Portal シェルやシンボリックリンクの背後にある実アプリパスを自動的に解決し、無効なローカルシェルではなく実際のアプリケーションパッケージに署名変更が適用されることを保証します。
💡 手動操作は不要
自動再署名を有効にすると、データディレクトリ移行ワークフローは完全に自動化されます。署名バックアップと再署名はどちらも実アプリパスを対象とするため、手動介入は不要です。
ログコンテキスト
データディレクトリ操作（移行、復元、正規化、再リンク）のログには、関連アプリのコンテキスト情報が自動的に含まれます：
| フィールド | 説明 |
|---|---|
app_name | 関連アプリ名 |
app_status | アプリステータス（Linked、Local など） |
app_is_resigned | アプリが再署名済みかどうか |
app_bundle_id | アプリの Bundle ID（実パスから読み取り） |
app_real_path | アプリの実外部パス |
これらのフィールドにより、診断パッケージをエクスポートする際に問題をより正確に特定できます。
一括移行
- ツールディレクトリリストで複数のディレクトリにチェックを入れる
- 下部の「一括移行」ボタンをクリック
- AppPorts は順番に移行を実行します
💡 優先度の推奨
データディレクトリは3つの優先度レベルに分類されます：
- 重要（
critical）: 移行後も動作が必須；コアアプリケーション機能に影響 - 推奨（
recommended）: 大きな容量削減効果；移行のメリットが高い - 任意（
optional）: サイズが小さいか再構築可能
「推奨」とマークされたディレクトリから優先的に移行することをお勧めします。
復元操作
- データディレクトリリストで移行済みのディレクトリを見つける（ステータス：「Linked」）
- 右側の「復元」ボタンをクリック
- AppPorts は以下のステップを実行します：
- ローカルのシンボリックリンクを削除
- 外部ストレージからデータをローカルにコピー
- 外部ディレクトリを削除（ベストエフォート）
異常状態の処理
Needs Normalization（正規化が必要）
ディレクトリは AppPorts によって管理されていますが、外部パスが正規の場所にありません。「正規化」をクリックすると、AppPorts は外部データを正規のパスに移動し、シンボリックリンクを再構築します。
Needs Relinking（再リンクが必要）
外部ストレージデータがまだ存在していますが、ローカルのシンボリックリンクが失われています。「再リンク」をクリックすると、AppPorts はシンボリックリンクを再作成します。
Existing Soft Link（既存のソフトリンク）
AppPorts が作成したものではない、ユーザーが作成したシンボリックリンクです。「管理を引き継ぐ」を選択でき、AppPorts は管理リンクメタデータを書き込んで以降管理します。
ツリービュー
サブディレクトリを含むデータディレクトリ（例：Application Support 内の複数のアプリディレクトリ）について、AppPorts はツリーのグループ化ビューを提供します：
- 親ディレクトリの左側に展開/折りたたみ矢印が表示されます
- サブディレクトリは階層インデントで表示されます
- 各ノードは独立してサイズとステータスを表示します
- 個別のサブディレクトリに対して移行/復元操作を実行できます