> For the complete documentation index, see [llms.txt](https://help.aximo.autify.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.aximo.autify.com/features-ja/settings/registered-devices.md).

# 登録済みデバイスの管理

**登録済みデバイス** は、自分のコンピューターや物理接続した iOS または Android 端末を Aximo のテスト実行先として登録するための設定ページです。登録したデバイスを CLI で Aximo に接続している間、**デスクトップ** タブの登録はセッション開始時の **デスクトップ** タブで選択したり、デスクトップ ケースに紐づけたり、デスクトップ ケースを含むプランに割り当てたりできます。**ローカルデバイス** タブの登録は、新規セッションの **ローカルデバイス** タブから実機モバイル セッションに使用できます。

{% hint style="warning" %}

* **登録済みデバイス** は、組織で BYOD（自分のマシンをテスト実行先として使う機能）が有効な場合のみ表示されます。BYOD はお客様自身では切り替えできないため、有効化を希望する場合は営業担当者までご連絡ください。
* デバイスの登録には API キーが必要です。
* **デスクトップ** タブに登録したデバイスは、**デスクトップ** 実行、デスクトップ ケースの紐づけ、プランへの割り当てに使用します。
* **ローカルデバイス** タブに登録したデバイスは iOS または Android 端末が対象で、新規セッションの **ローカルデバイス** タブで使用します。
  {% endhint %}

## 登録済みデバイスを開く

1. 画面左下のアカウントアイコンをクリックし、**設定** をクリックします。
2. 左メニューから **登録済みデバイス** をクリックします。

ページでは、選択中のタブにある登録済みデバイスごとに次の情報を確認できます。

| 項目       | 内容                                              |
| -------- | ----------------------------------------------- |
| 名前       | 登録したデバイス名                                       |
| プラットフォーム | `windows`、`macos`、`linux`、`android`、`ios` のいずれか |
| ステータス    | **オンライン** または **オフライン**                         |
| 最終確認     | デバイスが最後にオンラインまたはオフラインになった日時                     |
| 作成日      | デバイスを登録した日                                      |

## デバイスを登録する

実行先に応じて、次のどちらかの登録方法を選びます。

* **デスクトップ**: 自分のコンピューター上のブラウザーでテストを実行する場合
* **ローカルデバイス**: 物理接続した iOS または Android 端末で実機モバイル テストを実行する場合

### デスクトップを登録する

1. API キーをまだ持っていない場合は、[APIキーの管理](/features-ja/settings/api-key-management.md) を参照して作成します。
2. **登録済みデバイス** ページで **デスクトップ** タブを開き、**デスクトップを登録** をクリックします。
3. 登録するマシンで、CLI をインストールします。

   ```bash
   npm i -g @autifyhq/aximo-cli
   ```
4. 登録するマシンで、環境変数 `AXIMO_API_KEY` に API キーを設定します。

   ```bash
   export AXIMO_API_KEY=your-api-key
   ```
5. 登録するマシンで、デバイス名を指定して登録します。

   ```bash
   aximo device register --name 'My PC'
   ```
6. 登録するマシンで、Aximo へ接続します。

   ```bash
   aximo device connect
   ```
7. **登録済みデバイス** ページに戻り、追加したデバイスが一覧に表示されることを確認します。

### ローカルデバイスを登録する

1. API キーをまだ持っていない場合は、[APIキーの管理](/features-ja/settings/api-key-management.md) を参照して作成します。
2. **登録済みデバイス** ページで **ローカルデバイス** タブを開き、**モバイルデバイスを登録** をクリックします。
3. 登録するマシンで、CLI をインストールします。

   ```bash
   npm i -g @autifyhq/aximo-cli
   ```
4. 登録するマシンで、環境変数 `AXIMO_API_KEY` に API キーを設定します。

   ```bash
   export AXIMO_API_KEY=your-api-key
   ```
5. 登録するマシンで、デバイス名を指定して端末を登録します。

   ```bash
   aximo mobile register --name 'My phone' --platform android
   ```

   iPhone を登録する場合は、`--platform ios` を指定します。
6. 登録するマシンで、端末を Aximo へ接続します。

   ```bash
   aximo mobile connect
   ```
7. **登録済みデバイス** ページに戻り、追加したデバイスが一覧に表示されることを確認します。

{% hint style="info" %}
登録した iOS または Android 端末は、新規セッションの **ローカルデバイス** タブで使用します。Device Farm のデバイスを選ぶ場合は **モバイル** タブを使用します。
{% endhint %}

デバイスが接続されている間は、ステータスが **オンライン** になり、**最終確認** が更新されます。

## 登録済みデバイスを削除する

1. **登録済みデバイス** ページで削除するデバイスを見つけます。
2. デバイスの行にある削除アイコンをクリックします。
3. 確認ダイアログで **削除** をクリックします。

{% hint style="warning" %}
削除したデバイスは元に戻せません。同じマシンを再度使用する場合は、あらためて登録と接続が必要です。
{% endhint %}

## 参考情報

* [APIキーの管理](/features-ja/settings/api-key-management.md)
* [テストセッションの作成](/features-ja/test-case-creation/create-test-session.md)
* [ケースの作成](/features-ja/test-case-creation/create-test-case.md)
* [プランの管理](/features-ja/test-execution-and-plans/test-plan-specifications.md)