Project が表示されないとき
Project が表示されない原因は、iPhone 側よりも Mac 側の準備や初回取り込みにあることが多くあります。まず覚えておきたいのは、iPhone に出る Project は Mac 側で見えている workspace と、iPhone 側で追加した Project をもとにしているということです。
つまり、自動反映される workspace がまだ見えていないか、手動追加が済んでいないと、iPhone の一覧は空のままです。
先に確認すること
- Mac の
プロジェクトに対象 workspace が見えているか、iPhone 側で Project を追加済みか - Mac の
一般でランタイムが実行中 - iPhone の
ホストで対象の Host の接続テストが成功する - iPhone の
プロジェクトまたはホストで更新している
よくある原因と対処
まだ Project を追加していない
いちばん多い原因です。Project の手動追加は、iPhone 側の プロジェクト から行います。
登録手順は次のとおりです。
- iPhone の
プロジェクトを開く - 右上の
+からプロジェクトを追加を押す - Host を選ぶ
プロジェクト名と作業ディレクトリを入れる- 保存する
Browse on Mac を使うと、Mac 側のフォルダを見ながら 作業ディレクトリ を選べます。
Pairing の成否と Project の追加は別です。Pairing が成功しても、Project が 0 件なら iPhone 側は空のままです。
Pairing 直後で、まだ取り込みが終わっていない
初回設定では Project の取り込みも自動で走ります。取り込み中は少し待つだけで表示されることがあります。
特に次のときは、すぐに表示されないことがあります。
- 初回 Pairing の直後
- Mac 側で Bridge を再起動した直後
- iPhone をいったんバックグラウンドにして戻ってきた直後
いったん プロジェクト 画面を下に引いて 更新 してください。ホスト 画面から更新しても構いません。
Host にはつながるが、同じネットワークにいない
ローカルネットワーク前提なので、Host 情報だけ残っていても、今いる場所から Mac が見えなければ Project は取れません。
次を確認します。
- Mac と iPhone が同じ Wi-Fi にいる
- iPhone がモバイル回線へ逃げていない
- iPhone のローカルネットワーク権限が有効
- Mac がスリープしていない
ホスト で 接続テスト に失敗するなら、先に接続側の問題を直してください。
Mac の Codex App にある workspace が自動反映されていない
CodexPocketMac は、Mac の Codex App に登録済みの local workspace を取り込むことがあります。ただし、反映に頼りきらず、見えないときは iPhone 側の プロジェクト から手動追加するのが確実です。
「Mac では開けるのに iPhone には出ない」というときは、自動同期を待つより手動で追加したほうが早く切り分けできます。
作業ディレクトリが意図した場所になっていない
Project 名だけ合っていても、作業ディレクトリ が別の場所を向いていると、期待した Thread が見えないことがあります。iPhone の プロジェクト で対象 Project の設定を開き、パスを見直してください。
iPhone 側でできること
更新
プロジェクト と ホスト のどちらからでも一覧を更新できます。迷ったら、まずここを試します。
Host の 接続テスト
Host そのものがつながっているかを確認できます。成功しているのに Project が 0 件なら、Mac 側の登録内容を見る段階です。
アプリを前面に戻す
iPhone アプリは、前面に戻ったときにも Project 一覧を取り直します。いったんアプリを閉じて、開き直すだけで戻ることがあります。
それでも出てこないときの見方
次の順で見ると、原因が絞りやすくなります。
- Mac の
一般ランタイムと警告表示 - Mac の
プロジェクト件数、名前、作業ディレクトリ - iPhone の
ホスト接続テストの結果 - Mac の
ログstdoutとstderr
ログまで見て Bridge 自体が不安定そうなら、ログを確認する へ進んでください。