빠른 시작: 개발자 기기 플랫폼 준비

원격 기기 오케스트레이션을 위한 차세대 상업용 제품군인 개발자 기기 플랫폼을 사용하도록 설정합니다.

시작하기 전에

개발자 기기 플랫폼은 이 페이지의 안내에 따라 터미널과 인터넷 액세스가 있는 모든 워크스테이션에서 작동합니다.

이 문서는 이 사이트의 개요 탭에 있는 시작하기 Google Cloud에 설명된 대로 프로젝트와 계정이 있는 Google Cloud 사용자를 대상으로 합니다.

Google Cloud 구성

  1. 계정에 로그인하세요. Google Cloud 를 처음 사용하는 경우 계정을 만들고 Google 제품의 실제 성능을 평가해 보세요. Google Cloud신규 고객에게는 워크로드를 실행, 테스트, 배포하는 데 사용할 수 있는 $300의 무료 크레딧이 제공됩니다.

  2. Google Cloud CLI를 설치합니다.

  3. 외부 ID 공급업체(IdP)를 사용하는 경우 먼저 제휴 ID로 gcloud CLI에 로그인해야 합니다.

  4. gcloud CLI를 초기화하려면, 다음 명령어를 실행합니다. 

    gcloud init

  5. 이 가이드를 완료하는 데 필요한 권한이 있는지 확인합니다.

  6. 프로젝트에 결제가 사용 설정되어 있는지 확인합니다 Google Cloud .

  7. 기기 실행, 기기 스트리밍, Cloud Testing API를 사용 설정합니다.

    API 사용 설정에 필요한 역할

    API를 사용 설정하려면 serviceusage.services.enable 권한이 필요합니다. 프로젝트를 만든 경우 소유자 역할 (roles/owner)을 통해 이 권한이 이미 있을 가능성이 높습니다. 그렇지 않으면 서비스 사용량 관리자 역할 (roles/serviceusage.serviceUsageAdmin)을 통해 이 권한을 얻을 수 있습니다. 역할을 부여하는 방법을 알아보세요. 

    gcloud services enable devicerun.googleapis.com devicestreaming.googleapis.com testing.googleapis.com

  8. 로컬 셸을 사용하는 경우 사용자 계정에 대한 로컬 인증 사용자 인증 정보를 만듭니다. 

    gcloud auth application-default login

    Cloud Shell을 사용하는 경우 이 작업을 수행할 필요는 없습니다.

    인증 오류가 반환되고 외부 ID 공급업체(IdP)를 사용하는 경우 제휴 ID로 gcloud CLI에 로그인했는지 확인합니다.

  9. Google Cloud CLI를 설치합니다.

  10. 외부 ID 공급업체(IdP)를 사용하는 경우 먼저 제휴 ID로 gcloud CLI에 로그인해야 합니다.

  11. gcloud CLI를 초기화하려면, 다음 명령어를 실행합니다. 

    gcloud init

  12. 이 가이드를 완료하는 데 필요한 권한이 있는지 확인합니다.

  13. 프로젝트에 결제가 사용 설정되어 있는지 확인합니다 Google Cloud .

  14. 기기 실행, 기기 스트리밍, Cloud Testing API를 사용 설정합니다.

    API 사용 설정에 필요한 역할

    API를 사용 설정하려면 serviceusage.services.enable 권한이 필요합니다. 프로젝트를 만든 경우 소유자 역할 (roles/owner)을 통해 이 권한이 이미 있을 가능성이 높습니다. 그렇지 않으면 서비스 사용량 관리자 역할 (roles/serviceusage.serviceUsageAdmin)을 통해 이 권한을 얻을 수 있습니다. 역할을 부여하는 방법을 알아보세요. 

    gcloud services enable devicerun.googleapis.com devicestreaming.googleapis.com testing.googleapis.com

  15. 로컬 셸을 사용하는 경우 사용자 계정에 대한 로컬 인증 사용자 인증 정보를 만듭니다. 

    gcloud auth application-default login

    Cloud Shell을 사용하는 경우 이 작업을 수행할 필요는 없습니다.

    인증 오류가 반환되고 외부 ID 공급업체(IdP)를 사용하는 경우 제휴 ID로 gcloud CLI에 로그인했는지 확인합니다.

필요한 역할

개발자 기기 플랫폼을 사용하는 데 필요한 권한을 얻으려면 관리자에게 프로젝트에 대한 다음 IAM 역할을 부여해 달라고 요청하세요.

역할 부여에 대한 자세한 내용은 프로젝트, 폴더, 조직에 대한 액세스 관리를 참조하세요.

커스텀 역할이나 다른 사전 정의된 역할을 통해 필요한 권한을 얻을 수도 있습니다.

명령어 예시

이제 기기 실행 서비스가 있으므로 다음 명령어를 실행하여 카탈로그를 사용해 볼 수 있습니다.

먼저 프로젝트의 모든 기기를 나열합니다.

gcloud device-run devices list

다음으로 프로젝트의 모든 세션을 나열합니다 (없을 가능성이 높음).

gcloud device-run sessions

이제 다음 단계의 기능 안내로 계속 진행하거나 다음 섹션에 따라 개발자 기기 플랫폼 에이전트 스킬을 사용합니다.

개발자 기기 플랫폼 에이전트 기술 설치

이 페이지에 설명된 Google Cloud 환경을 설정하는 것 외에도 개발자 기기 플랫폼 에이전트 스킬에 다음 패키지를 설치해야 합니다.

  • ADB를 사용하여 원격 Android 기기에서 명령어를 실행합니다.
  • ADB 전달을 사용 설정하는 Python 환경
  • Antigravity 또는 에이전트 기술을 지원하는 기타 AI 코딩 에이전트
  • Node.js 및 NPM 패키지 를 사용하여 에이전트 스킬을 설치하는 npx

이제 다음을 사용하여 개발자 기기 플랫폼 에이전트 기술을 설치합니다.

npx skills add https://github.com/google/skills --skill developer-device-platform-basics

이제 다음 단계의 기능 안내로 계속 진행합니다.

증빙 서류

정리

이 페이지에서 사용한 리소스 비용이 계정에 청구되지 않도록 하려면 리소스가 포함된 프로젝트를 삭제하세요. Google Cloud Google Cloud

다음 단계

  • 기기 카탈로그 - DDP 실험실의 모든 기기 유형을 설명하고 각 유형을 자세히 살펴봅니다.
  • 기기 실행 - DDP 실험실의 기기에서 테스트를 실행하고에서 결과를 확인합니다. Google Cloud
  • 기기 스트리밍 API - 원격 실제 Android 기기에 연결하고 로컬 머신에 연결된 것처럼 앱과 상호작용합니다.
  • 기기 스트리밍을 통한 에이전트 개발 - 개발자 기기 플랫폼 에이전트 스킬을 사용하여 DDP에서 기기를 찾고 예약하고 연결합니다.