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

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

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

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

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

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

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

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

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

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

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

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

種類の異なる、Monaca 提供の開発ツールを、１台の PC 上で、複数起動させる場合、デフォルトのままでは、ポート番号が競合します。競合を避けるため、各ツールが使用するポート番号を適宜変更してください。

Mac

Windows

IP アドレス

IP アドレスの確認方法

ターミナルを開きます。
ifconfig と入力して、実行します。

IP アドレスの確認方法

コマンドプロンプトを開きます。
ipconfig と入力して、実行します。

ポート番号

ポート状態の確認方法

ターミナルを開きます。
lsof -i :PORT_NUMBER と入力して、実行します。

ポート状態の確認方法

コマンドプロンプトを開きます。
netstat と入力して、実行します。

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

Android 9 以降でカスタムビルドデバッガーを使用する場合は、config.xml の widget タグに 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>

参考ページ