> For the complete documentation index, see [llms.txt](https://ja.docs.monaca.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://ja.docs.monaca.io/products_guide/debugger/troubleshooting.md).

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

### Monaca デバッガーとのペアリングが失敗する場合 <a href="#monaca-debaggtonopearingugasuru" id="monaca-debaggtonopearingugasuru"></a>

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

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

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

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

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

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

![](/files/-MgZYBM64Inb2FYNqczG)

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

&#x20;   3\. [ホスト PC の IP アドレスとポート番号](/products_guide/debugger/troubleshooting.md#ip-port) を入力して、`ペアリング`  ボタンをタップします。

![](/files/-MgZYKMI2opV3oQ7YeGw)

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

![](/files/-MgZYMYrzEaeNg1Y_9jL)

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

[**ホスト** **PC** **の** **IP** **アドレスとポート番号**](/products_guide/debugger/troubleshooting.md)

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

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

| OS　　　　      | Mac                                                                                                    | Windows                                                                                         |
| ----------- | ------------------------------------------------------------------------------------------------------ | ----------------------------------------------------------------------------------------------- |
| **IP アドレス** | <p>IP アドレスの確認方法</p><ol><li>ターミナルを開きます。</li><li><code>ifconfig</code> と入力して、実行します。</li></ol>            | <p>IP アドレスの確認方法</p><ol><li>コマンドプロンプトを開きます。</li><li><code>ipconfig</code> と入力して、実行します。</li></ol> |
| **ポート番号**   | <p>ポート状態の確認方法</p><ol><li>ターミナルを開きます。</li><li><code>lsof -i :PORT\_NUMBER</code> と入力して、実行します。</li></ol> | <p>ポート状態の確認方法</p><ol><li>コマンドプロンプトを開きます。</li><li><code>netstat</code> と入力して、実行します。</li></ol>    |

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

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

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

{% hint style="info" %}
Android カスタムビルドデバッガー v9.0.1 以降をご利用の場合は、下記の設定は必要ありません。
{% endhint %}

```markup
<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>
```

参考ページ

* [インストール方法](/products_guide/debugger/installation.md)
* [使用例](/products_guide/debugger/debug.md)
* [機能の概要](/products_guide/debugger/features.md)