Monaca Docs
検索…
トラブルシューティング ガイド

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

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

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

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

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

ホスト PC と端末が、同じネットワークに接続されているか確認します。同じネットワークに接続されているが、Monaca デバッガー側で、ホスト PC を検知できない場合には、次のように、手動でペアリングをします。
  1. 1.
    Monaca デバッガー画面の左上端に表示された切り替えメニューをタップして、次に、 ローカルコンピュータ ボタンをタップします。
2. コンピュータを手動で追加する ボタンをタップします。
3. ホスト PC の IP アドレスとポート番号 を入力して、ペアリング ボタンをタップします。
4. ペアリング後、[ ペアリング済み ] タブ下に、次のように、ホスト PC が表示されます。
公共の Wi-Fi アクセスポイントでは、まれに、クライアント同士の接続を禁止しています。この場合、別のネットワーク環境を使用してください。
Monaca デバッガーと ホスト PC を接続する場合、IP アドレスとポート番号が必要です。IP アドレスは、ホスト PC の識別に使用するもので、ポート番号 ( デフォルトでは、8001 ) は、Monaca 提供のローカル環境用の開発ツール ( Monaca CLI、Monaca Localkit など ) 側が通信に使用するものです。また、ポートは、未使用であること ( 競合していないこと )、開放されていることが必要です。これ以外の場合、通信は確立できません。
種類の異なる、Monaca 提供の開発ツールを、1台の PC 上で、複数起動させる場合、デフォルトのままでは、ポート番号が競合します。競合を避けるため、各ツールが使用するポート番号を適宜変更してください。
OS    
Mac
Windows
IP アドレス
IP アドレスの確認方法
  1. 1.
    ターミナルを開きます。
  2. 2.
    ifconfig と入力して、実行します。
IP アドレスの確認方法
  1. 1.
    コマンドプロンプトを開きます。
  2. 2.
    ipconfig と入力して、実行します。
ポート番号
ポート状態の確認方法
  1. 1.
    ターミナルを開きます。
  2. 2.
    lsof -i :PORT_NUMBER と入力して、実行します。
ポート状態の確認方法
  1. 1.
    コマンドプロンプトを開きます。
  2. 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>
参考ページ