トラブルシューティング ガイド

Monaca デバッガーとのペアリングが失敗する場合

Monaca デバッガーと ホスト PC のペアリングが失敗する場合、いくつかの理由が考えられます。

Monaca デバッガー側はホスト PCを認識しているが、ペアリングが失敗する場合

多くの場合、ホスト PC 側のファイアーウォールに起因します。なお、ホスト PC とデバッガー間の通信には、TCP 接続を使用します。ポート番号は、8001 です。待ち受けポートの変更方法に関しては、 設定ダイアログ をご確認ください。ポート番号またはファイアーウォール設定の変更後は、再度、ペアリングをする必要があります。

Monaca デバッガーが ホスト PC を認識していない場合

ホスト PC と端末が、同じネットワークに接続されているか確認します。同じネットワークに接続されているが、Monaca デバッガー側で、ホスト PC を検知できない場合には、次のように、手動でペアリングをします。

  1. Monaca デバッガー画面の左上端に表示された切り替えメニューをタップして、次に、 ローカルコンピュータ ボタンをタップします。

  2. コンピュータを手動で追加する ボタンをタップします。

  3. ホスト PC の IP アドレスとポート番号 を入力して、 ペアリング ボタンをタップします。

  4. ペアリング後、[ ペアリング済み ] タブ下に、次のように、ホスト PC が表示されます。

公共の Wi-Fi アクセスポイントでは、まれに、クライアント同士の接続を禁止しています。この場合、別のネットワーク環境を使用してください。

ホスト PC の IP アドレスとポート番号

Monaca デバッガーと ホスト PC を接続する場合、IP アドレスとポート番号が必要です。IP アドレスは、ホスト PC の識別に使用するもので、ポート番号 ( デフォルトでは、8001 ) は、Monaca 提供のローカル環境用の開発ツール ( Monaca CLI、Monaca Localkit など ) 側が通信に使用するものです。また、ポートは、未使用であること ( 競合していないこと )、開放されていることが必要です。これ以外の場合、通信は確立できません。

種類の異なる、Monaca 提供の開発ツールを、1台の PC 上で、複数起動させる場合、デフォルトのままでは、ポート番号が競合します。競合を避けるため、各ツールが使用するポート番号を適宜変更してください。
OS Mac Windows
IP アドレス IP アドレスの確認方法
  1. ターミナルを開きます。
  2. ifconfig と入力して、実行します。
IP アドレスの確認方法
  1. コマンドプロンプトを開きます。
  2. ipconfig と入力して、実行します。
ポート番号 ポート状態の確認方法
  1. ターミナルを開きます。
  2. lsof -i :PORT_NUMBER と入力して、実行します。
ポート状態の確認方法
  1. コマンドプロンプトを開きます。
  2. netstat と入力して、実行します。

Android 9 以降でペアリングに失敗する場合

Android 9 以降でカスタムビルドデバッガーを使用する場合は、config.xmlwidget タグに andorid 名前空間 設定を追加し、usesCleartextTraffic 設定を追加する必要があります。

config.xml に以下の設定を追加後、カスタムビルドデバッガーを作成してください。

Android カスタムビルドデバッガー v9.0.1 以降をご利用の場合は、下記の設定は必要ありません。
<widget xmlns:android="http://schemas.android.com/apk/res/android">

<platform name="android">
  <edit-config file="AndroidManifest.xml" target="/manifest/application" mode="merge">
    <application android:usesCleartextTraffic="true" />
  </edit-config>
</platform>

参考ページ