Android 스튜디오용 Google 어시스턴트 플러그인

Google 어시스턴트 플러그인은 Android 스튜디오 내에서 앱 작업을 테스트합니다. 개발 및 테스트가 진행되는 동안 이 플러그인을 사용하여 애플리케이션의 Google 계정용 어시스턴트의 앱 작업 그러면 배포를 위해 제출하기 전에 앱 작업이 다양한 매개변수를 처리하는 방식을 테스트할 수 있습니다.

작동 방식

Google 어시스턴트 플러그인에는 shortcuts.xml 파일을 파싱하고 앱 작업 미리보기를 만듭니다. 단일 Google 계정으로 로그인해야 합니다. 이러한 미리보기를 사용하면 Google Play Console에 앱의 프로덕션 버전을 배포하기 전에 Google 어시스턴트가 앱 작업을 인식할 수 있습니다.

shortcuts.xml 파일에 있는 각 내장 인텐트(BII)의 경우 도구는 상응하는 JSON-LD 객체를 렌더링하고 기본 매개변수 값을 제공합니다. 그러면 이러한 값을 수정하여 의미 있는 매개변수 조합으로 앱 작업을 테스트하고 올바른 앱 기능을 실행하는지 확인할 수 있습니다. 미리보기는 테스트 도구에서 만들고 업데이트하고 삭제할 수 있으므로 안전한 환경에서 앱 작업을 반복하고 테스트할 수 있습니다.

미리보기가 만들어지면 테스트 도구 창에서 직접 테스트 기기의 앱 작업을 트리거할 수 있습니다. 사용자 트리거에 사용할 수 있는 BII의 경우 기기의 어시스턴트에서 직접 app name을 사용하여 앱 작업을 사용해 볼 수 있습니다. 예를 들어 "Hey Google, 예시 앱을 사용하여 운동을 시작하세요.'라는 메시지가 표시되면 actions.intent.START_EXERCISE BII.

언어 지원

테스트 도구에서 특정 언어의 미리보기를 만드는 방법은 BII에 따라 다릅니다. 내장 인텐트 참조의 각 BII 페이지에서는 테스트 도구에서 특정 언어의 미리보기 생성을 지원하는지, 사용자가 트리거할 수 있는 앱 작업이 있는지 등 BII에 사용할 수 있는 기능에 관한 정보를 제공합니다.

플러그인 가져오기

Google 어시스턴트 플러그인은 Android 스튜디오에서 제공됩니다. Android 스튜디오 설치 및 사용에 관한 자세한 내용은 Android 스튜디오 페이지를 참고하세요.

Android 스튜디오에서 Google 어시스턴트 플러그인을 설치하려면 다음 단계를 따르세요.

  1. 파일로 이동합니다. Settings (macOS의 경우 Android Studio > Preferences)
  2. Plugins 섹션에서 Marketplace로 이동하여 'Google 어시스턴트 플러그인'
  3. 도구를 설치하고 Android 스튜디오를 다시 시작합니다.

Jetbrains 공개 저장소에서 바로 플러그인을 다운로드할 수도 있습니다.

설정 요구사항

Google 어시스턴트 플러그인을 사용하려면 다음을 위한 여러 구성 단계가 필요합니다. 앱 작업을 성공적으로 테스트할 수 있습니다 특히 Android 스튜디오, 테스트 기기, Google Play Console 액세스에서 동일한 사용자 계정을 사용해야 합니다.

다음 구성을 사용하여 개발 환경을 준비합니다.

  • Android 스튜디오 (버전 4.0 이상)에 로그인합니다.
  • 동일한 계정으로 Android 테스트 기기에서 Google 앱에 로그인합니다.
  • 동일한 계정으로, 테스트할 업로드된 앱 패키지에 대한 Play Console 액세스 권한을 얻습니다.
  • Android 테스트 기기에서 Google 앱을 열고 초기 어시스턴트 설정 프로세스를 완료합니다.
  • 테스트 기기에서 기기 데이터 동기화를 사용 설정합니다.

제한사항

Google 어시스턴트 플러그인에는 다음과 같은 제한사항이 있습니다.

  • 웹 인벤토리를 통합하는 앱 작업 및 포그라운드 앱 호출 테스트 도구에서 또는 Android 디버그 브리지 (adb)로 직접 테스트할 수 없음 명령어와 함께 사용하면 됩니다 이러한 앱 작업을 테스트하려면 먼저 테스트 도구를 사용하여 미리보기를 만듭니다. 그런 다음 실제 기기에서 Google 어시스턴트와 상호작용하여 이러한 앱 작업을 트리거합니다.
  • actions.intent.OPEN_APP_FEATURE BII의 인라인 인벤토리는 미리보기를 만들거나 업데이트한 후 6시간 동안만 테스트할 수 있습니다. 6시간 기간을 재설정하려면 테스트 도구 미리보기를 업데이트하거나 새 미리보기를 만듭니다.

테스터 추가

앱 작업 통합을 테스트할 수 있도록 프로젝트에 추가 사용자를 초대할 수 있습니다. 이는 개발팀의 다른 구성원이 모두 테스트할 수 있도록 프로젝트를 공유하려고 할 때 또는 프로덕션 출시 준비를 위해 품질 보증(QA) 테스터와 프로젝트를 공유할 때 유용합니다. 테스터는 Google Play 스토어에서 라이선스 테스터로 추가되어야 하며 Google Play Console에 대한 읽기 전용 액세스 권한을 부여받아야 합니다.

테스터를 더 추가하려면 다음 단계를 따르세요.

  1. Play Console에 로그인합니다.
  2. Play Console 도움말 주제애플리케이션 라이선스 설정에 나와 있는 안내를 따릅니다.

    Google Play Console을 통해 라이선스 테스터 추가
    그림 1. 라이선스 테스터 추가
  3. 라이선스 테스터의 Google 계정을 Google Play Console 읽기 전용 사용자로 초대합니다.

    1. 사용자 및 권한 > 신규 사용자 초대 > 앱 추가를 클릭합니다.
    2. 앱 액세스에서 관리자(모든 권한) 체크박스가 선택 해제되어 있는지 확인합니다.

미리보기 테스트에 사용 설정할 각 테스터에 대해 로그인해야 합니다. Android 스튜디오에 별도로 연결해야 합니다. 로그인하면 Google 어시스턴트 플러그인을 사용하여 테스트 사용자의 미리보기를 생성합니다.

Google 어시스턴트 플러그인 사용

Android 스튜디오에서 Tools > Google 어시스턴트 > 앱 작업 테스트 도구를 참고하세요. 도구를 열면 활성 테스트 도구 미리보기가 있는지에 따라 뷰가 변경됩니다.

미리보기 만들기, 업데이트, 삭제

테스트에는 앱의 초안 버전을 사용할 수 있습니다. 자세한 내용은 버전 준비 및 출시를 참고하세요. 앱을 제출하여 검토받기 전에 초안 모드로 앱을 테스트하세요.

테스트 도구는 Google 계정과 앱 패키지 이름(애플리케이션 ID)을 기반으로 미리보기를 만들므로 동일한 Google 계정으로 여러 앱을 테스트할 수 있습니다. 앱마다 애플리케이션 ID가 다르면 미리보기 생성 및 테스트에 동일한 Google 계정을 계속 사용할 수 있습니다. 동일한 앱 패키지에 액세스할 수 있는 여러 Google 계정은 각각 테스트 도구를 사용하여 해당 앱에 관한 별도의 미리보기를 만들 수 있습니다.

미리보기를 만들려면 Android 스튜디오에서 다음을 실행하세요.

  1. 앱 작업 테스트 도구를 엽니다.
  2. 원하는 경우 테스트할 앱 이름과 언어를 입력합니다. 기본 앱 이름과 언어는 test app actionen입니다.
  3. Create Preview를 클릭합니다. 메시지가 표시되면 앱 작업을 검토하고 수락합니다. 정책 및 서비스 약관 미리보기가 만들어지면 테스트 도구 창이 업데이트되어 shortcuts.xml 파일에 있는 BII 정보가 표시됩니다.

테스트 도구는 앱 이름을 사용하여 앱 작업용 어시스턴트 쿼리를 구성하고 시뮬레이션합니다. 배포된 앱 작업은 호출을 위해 Play 스토어 앱 이름을 사용하지만 개발자는 테스트 도구에서 어떤 호출 이름이라도 사용할 수 있습니다. 하지만 앱 이름을 테스트 도구

개발자가 제공하는 언어는 테스트 기기의 Google 어시스턴트 언어와 일치해야 하고 미리보기는 한 번에 한 언어로만 만들 수 있습니다. 예를 들어 어시스턴트 언어가 영어(미국)인 경우 en-US는 입력할 수 있지만 en-** 또는 en-GB, en-US, en-GB는 입력할 수 없습니다. 다음과 같은 루트 언어를 사용할 수 있습니다. en로 설정하여 en-GBen-US를 모두 포함합니다.

기존 미리보기의 앱 이름 또는 선택한 언어를 변경하려면 테스트 도구에서 Delete 버튼을 클릭합니다. 그런 다음 새 미리보기를 만들기 전에 원하는 앱 이름과 언어를 입력합니다.

기존 미리보기를 shortcuts.xml 파일과 일치하도록 업데이트하려면 테스트 도구의 Update 버튼 현재 미리보기에 관한 정보는 테스트 도구 창의 Test App Action 섹션에 있습니다.

BII 구성

앱 미리보기를 만든 후에는 플러그인에서 BII의 여러 매개변수 값을 테스트할 수 있습니다. SDK의 각 BII의 경우 shortcuts.xml 파일에서 지정하면 플러그인은 해당하는 JSON-LD 객체와 일치하고 기본 매개변수 값을 제공합니다. 이러한 기본값을 수정하여 의미 있는 매개변수 조합으로 앱 작업을 테스트하고 올바른 앱 기능을 실행하는지 확인할 수 있습니다.

매개변수와 그 값은 일반적으로 속성과 설명의 schema.org 또는 schema.googleapis.com 구조를 따릅니다. 매개변수의 스키마 유형 설명과 상위 수준 매개변수에 액세스하여 BII 매개변수에 관한 정보를 확인할 수 있습니다.

예를 들어, actions.intent.GET_FOOD_OBSERVATION BII는 인텐트 매개변수 foodObservation.forMeal를 지원합니다. MealTypeschema.googleapis.com 페이지에서는 name를 속성으로 나열합니다. forMeal 속성은 전송 모드이며 열거된 MealType 유형의 값(예: MealTypeLunch)을 예상합니다.

테스트 도구에서는 열거형을 foodObservation.forMeal:

  • https://schema.googleapis.com/MealTypeSnack
  • https://schema.googleapis.com/MealTypeBrunch
  • https://schema.googleapis.com/MealTypeLunch
  • https://schema.googleapis.com/MealTypeBreakfast
  • https://schema.googleapis.com/MealTypeDinner
  • https://schema.googleapis.com/MealTypeDesert

앱 작업 트리거

미리보기를 만들고 BII를 구성한 후에는 테스트 도구 창에서 바로 테스트 기기의 앱 작업을 트리거할 수 있습니다.

테스트 도구로 앱 작업을 트리거하려면 다음을 실행하세요.

  1. 테스트 기기를 연결합니다.
  2. Select Target Device 섹션에서 앱 작업을 트리거할 기기를 선택합니다.
  3. Test App Action 섹션에서 Run App Action 버튼을 클릭합니다.

테스트 도구에서 트리거된 앱 작업은 표시된 Android 디버그 브리지(adb) 명령어를 사용합니다. 생성된 adb 셸 명령어에는 Google 앱에서 BII를 실행하는 데 필요한 모든 메타데이터가 포함되어 있습니다. 이 접근 방식은 어시스턴트가 쿼리에서 주요 정보를 추출한 후 앱 작업의 동작을 모방합니다.

Android 스튜디오 로깅

테스트 도구와 관련된 로그는 Logcat 출력이 아닌 Android 스튜디오 로그 파일에서 확인할 수 있습니다. 워크스테이션에서 직접 실행되는 프로세스에서 Android 스튜디오 로그가 생성됩니다. 이러한 도구를 사용하여 생성, 수정, 생성, 테스트, 실행과 같은 미리보기 업데이트 또는 삭제가 포함될 수 있습니다

Android 스튜디오 로그 파일에 액세스하려면 Help > Show log in explorer(macOS의 경우 Help > Show log in finder)로 이동합니다.

앱의 앱 작업과 관련된 로그는 Logcat에서 확인할 수 있습니다. Logcat은 Android 스튜디오에 연결된 가상 기기나 실제 기기에서 로그를 캡처합니다.

기기의 앱 작업 로그를 가져오려면 다음 단계를 따르세요.

  1. Android 스튜디오 도구 창 모음에서 Logcat을 클릭하여 Logcat 로그 메시지에 액세스합니다.
  2. ActivityTaskManager가 포함된 로그를 검색합니다.

지원 및 추가 리소스 받기

Google 어시스턴트 플러그인은 테스트 도구를 사용하여 학습하고 도움을 받는 데 필요한 문서, Codelab, 기타 리소스의 링크를 제공합니다.

Android 스튜디오에서 Tools > Google Assistant > Help를 선택하여 어시스턴트를 열 수 있습니다.

앱 작업 테스트 도구 어시스턴트 그림 2. Google 어시스턴트 플러그인의 도움말 섹션