> 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-ko/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-ko/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-ko/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-ko/settings/api-key-management.md)
* [테스트 세션 만들기](/features-ko/test-case-creation/create-test-session.md)
* [케이스 만들기](/features-ko/test-case-creation/create-test-case.md)
* [플랜 관리](/features-ko/test-execution-and-plans/test-plan-specifications.md)