FAQ
インストールと権限
AppPorts にはどの権限が必要ですか？
AppPorts は /Applications ディレクトリの読み取りと変更のためにフルディスクアクセス権限が必要です。初回起動時に権限の取得を案内します。システム設定 → プライバシーとセキュリティ → フルディスクアクセスから手動で追加することもできます。
どの macOS バージョンがサポートされていますか？
最低サポートは macOS 12.0（Monterey）です。macOS 15.1（Sequoia）以降は、App Store アプリの外付けドライブへのインストールとインプレース更新が追加でサポートされています。
アプリ移行
移行後にアプリが開かない場合はどうすればよいですか？
- 外部ストレージが接続されアクセス可能であることを確認
- アプリのステータスバッジを確認：「Orphan Link」の場合、外部アプリが消失；手動でのリンク解除が必要
- 「Damaged」プロンプトが表示された場合、アプリを右クリックして「再署名」を選択
- それでも解決しない場合は、外部アプリライブラリで「ローカルに戻す」を選択
「Damaged」プロンプトが表示される場合はどうすればよいですか？
macOS のコード署名メカニズムがアプリパッケージ構造の変更を検出した場合です。解決方法：
- AppPorts でアプリを右クリック
- 「再署名」を選択
- AppPorts は自動的に元の署名をバックアップし、Ad-hoc 再署名を実行
詳細なメカニズムについては、再署名とクラッシュ防止をご参照ください。
外部ストレージを抜くとアプリはクラッシュしますか？
ローカルエントリ（Stub Portal）は外部アプリを起動するために open を呼び出そうとします。外部ストレージが接続されていない場合、アプリは起動できませんが、クラッシュすることはありません。外部ストレージを再接続すると通常の使用を再開します。
移行後にアプリを更新できますか？
アプリのタイプによって異なります：
| アプリタイプ | 自動更新可能 | 備考 |
|---|---|---|
| ネイティブアプリ（自動更新なし） | ✓ | 通常の更新 |
| Chrome、Edge（カスタムアップデーター） | ✓ | 更新はローカルにインストール；AppPorts がバージョン差異を検出し「移行待ち」タグを付与 |
| Sparkle / Electron アプリ | ✗ | ロックによりアプリ内更新を防止；更新する前に AppPorts でローカルに復元する必要があります |
| App Store アプリ（macOS 15.1+） | ✓ | App Store が外付けドライブ上でインプレース更新可能 |
| App Store アプリ（macOS <15.1） | ✗ | 手動での再移行が必要 |
App Store アプリを外付けドライブに移行するにはどうすればよいですか？
macOS 15.1+: App Store の設定で「大容量アプリを外付けドライブにダウンロードしてインストール」を有効にし、AppPorts と同じ外部ストレージを選択します。
macOS <15.1: AppPorts の設定で「App Store アプリ移行」を有効にします。手動移行後、アプリの更新には再移行が必要です。
移行が遅い/スタックした場合はどうすればよいですか？
- 移行進捗が100%の時点で、ローカルエントリ作成中に1〜2秒の一時停止が発生する場合があります
- 大容量アプリ（例：Xcode、Adobe）の移行には時間がかかります — これは正常です
- 長時間スタックする場合、外部ストレージの接続安定性を確認してください
- USB 2.0 は遅い；USB 3.0 以上、または Thunderbolt の使用を推奨
データディレクトリ移行
データディレクトリ移行後にデータは失われますか？
いいえ。AppPorts はシンボリックリンク戦略を使用：データは最初に外部ストレージに完全にコピーされ、コピーが成功したことを確認した後にのみ元のローカルディレクトリが削除されます。失敗したステップがある場合は自動ロールバックがトリガーされます。
どの場合にデータディレクトリ移行でアプリに問題が発生する可能性がありますか？
- ファイルロックまたは SQLite WAL ログを使用しているアプリ
- シンボリックリンクをまたぐと拡張属性が失われる場合がある
- 同じ Team 下の複数のアプリで共有される Group Containers ディレクトリ
移行したデータディレクトリを復元するにはどうすればよいですか？
AppPorts のデータディレクトリ管理画面で、移行済みのディレクトリを選択して「復元」をクリックします。AppPorts はシンボリックリンクを削除し、外部ストレージからデータをローカルにコピーし直します。
その他
AppPorts はデータを収集しますか？
いいえ。AppPorts は完全にオフラインで動作し、ユーザーデータを収集またはアップロードしません。ログファイルはローカルの ~/Library/Application Support/AppPorts/ に保存されます。
問題を報告するにはどうすればよいですか？
プロジェクトのIssuesページでご提出ください。診断パッケージ（メニューバー → ログ → 診断パッケージをエクスポート）を含めることで、問題解決を迅速化できます。