トラブルシューティング

移行中断

症状

外部ストレージの取り外し、システムクラッシュ、またはアプリの強制終了により移行が中断されました。

解決方法

AppPorts には組み込みの自動回復メカニズムがあります。AppPorts を再起動すると：

残留移行データを検出（外部コピーが存在するがローカルのシンボリックリンクが作成されていない）
外部ディレクトリ内の .appports-link-metadata.plist を確認
schemaVersion、managedBy、sourcePath、destinationPath、dataDirType が完全に一致する場合のみ、回復または再リンクを続行
metadata が一致しない場合は自動処理を停止し、既存データを保持してユーザー確認を待つ

💡 手動介入は不要です

AppPorts の自動回復メカニズムは、次回起動時に中断された移行を処理します。自動回復が失敗した場合、データディレクトリリストに「Needs Normalization」または「Needs Relinking」ステータスが表示される場合があります — 対応する操作を手動で実行してください。

外部ストレージオフライン

症状

外部ストレージの取り外しまたは切断後、移行済みアプリが起動できなくなり、データディレクトリに赤いエラーステータスが表示されます。

解決方法

外部ストレージを再接続
AppPorts の FolderMonitor がストレージボリュームのマウントを自動検出し、再スキャンをトリガー
アプリとデータディレクトリは通常の使用を再開

⚠️ 備考

外部ストレージがオフラインの間、ローカルエントリ（Stub Portal）の open 呼び出しは失敗します；アプリは起動できませんが、クラッシュすることはありません。データディレクトリのシンボリックリンクは無効なパスを指しており、関連アプリはデータを読み取れない場合があります。

署名復元失敗

症状

元の署名の復元に失敗する、または復元後もアプリに「破損」が表示される。

考えられる原因と解決方法

原因	解決方法
バックアップファイルが存在しない	元の署名は復元不可；代替として Ad-hoc 再署名を実行
元の開発者証明書がローカル Keychain にない	AppPorts は自動的に Ad-hoc 署名にフォールバック；アプリは起動可能だが Keychain アクセスが異常になる場合がある
Mac App Store アプリ（SIP 保護）	再署名不可；SIP がシステムアプリ署名へのあらゆる変更を防止
アプリディレクトリが root 所有	AppPorts が管理者権限で所有権変更を試行；ポップアップで認証してください
Contents シンボリックリンクターゲットが消失	署名不可；外部データを復元するかアプリを先に復元する必要があります

詳細なメカニズムについては、再署名とクラッシュ防止をご参照ください。

App Store アプリが外付けドライブに移行できない

macOS 15.1 未満

macOS 15.1 以前は App Store アプリの外付けドライブへのインストールをサポートしていません。以下が必要です：

AppPorts の設定で「App Store アプリ移行」を有効にする
移行後、アプリの更新には手動での再移行による上書きが必要

macOS 15.1 以上

App Store が外付けドライブ上のアプリを更新できない場合：

App Store の設定を開く
「大容量アプリを外付けドライブにダウンロードしてインストール」を有効にする
AppPorts の外部ストレージライブラリと同じ外部ストレージを選択

移行後にアプリが起動できない