앱 작업을 개발할 때는 설정이나 앱 작업 테스트 도구에서 문제가 발생할 수 있습니다. 이 페이지에서는 자주 발생하는 문제와 그 해결 방법을 설명합니다.
일반
오류: 'URL을 열 앱을 찾을 수 없습니다'라는 메시지가 토스트 메시지 알림에 표시됩니다
actions.xml에서 처리 urlTemplate을 확인하여 올바르게 구성되었는지 확인합니다. 앱 링크 URL을 사용하는 경우 ACTION_VIEW와 URL을 사용하여 URL을 수동으로 트리거할 수 있는지 확인합니다. 인텐트 기반 URL을 사용하는 경우 제공된 매개변수를 사용하여 시작하도록 활동이 올바르게 구성되었는지 확인합니다.
오류: '앱이 설치되어 있지 않습니다'
이 오류는 AndroidManifest.xml 파일의 <intent-filter>가 actions.xml에 지정된 딥 링크를 필터링하지 않는다는 것을 의미할 수 있습니다.
버그를 신고하기 전에 먼저 이 사항을 확인하세요.
오류: '항목 세트 ID 및 URL 필터가 모두 포함되지 않은 항목 세트 참조가 발견되었습니다'라는 메시지가 Android 스튜디오에 표시됩니다
이 상황은 <entity-set-reference> 태그의 알려진 린터 문제로 인해 발생합니다. 이 메시지는 무시해도 됩니다. 이 문제를 해결하려면 tools:ignore="ValidActionsXml" 속성을 추가하여 이 태그의 린트 검사를 사용 중지하면 됩니다.
다음은 사용 중지된 린트 검사가 있는 항목 세트 참조의 예입니다.
<entity-set-reference entitySetId="example" tools:ignore="ValidActionsXml" />
오류: APK를 업로드할 때 작업 스키마 문서의 '잘못된 위치'
출시 APK 리소스에 영향을 주는 난독화 또는 최적화 도구를 사용하면 APK 업로드가 실패할 수 있습니다. 리소스 파일을 피하는 ProGuard 등의 도구는 이 문제를 일으키지 않습니다.
이 문제를 해결하려면 앱의 actions.xml 파일에서 도구를 사용 중지해 보세요(예: 허용 목록 사용).
오류: '활성 APK 또는 Android App Bundle에 actions.xml 파일이 포함되어 있습니다. 계속하려면 Actions on Google 서비스 약관에 동의하세요'라는 메시지가 Google Play Console에 표시됩니다
Play Console에서 앱 버전을 만들 때 이 오류가 표시될 수 있습니다. Actions on Google 서비스 약관에 동의하려면 다음 단계를 따르세요.
- Play Console에서 앱을 선택합니다.
- 설정 > 고급 설정으로 이동합니다.
- Actions on Google 탭을 클릭합니다.
- Actions on Google을 사용하여 서비스를 앱 작업과 통합 체크박스를 선택하고 안내를 따릅니다.
Play 서비스 약관 양식의 '동의' 버튼이 사용 중지되었습니다
로그인한 사용자에게 이러한 약관에 동의하는 데 필요한 액세스 수준이 없다는 의미일 수 있습니다. Play Console 프로필의 관리자가 처음으로 제출했는지 확인합니다.
앱 작업 테스트 도구
다음 수정사항을 시도하기 전에 앱 작업 테스트 도구 설치를 최신 버전으로 업데이트하세요.
앱 작업 테스트 도구 플러그인이 내 actions.xml 파일을 찾을 수 없습니다
AndroidManifest.xml 파일에 올바른 <meta-data> 태그를 추가했는지
확인합니다.
앱 작업 미리보기가 현재 actions.xml 파일과 일치하지 않습니다
미리보기는 actions.xml 파일의 콘텐츠와 함께 동적으로 업데이트되지 않습니다. actions.xml 파일을 수동으로 변경하거나 Android 스튜디오에서 빌드 변형을 전환한 후 actions.xml 파일을 저장하고 테스트 도구에서 Update Preview를 클릭합니다.
앱 작업 테스트 도구 플러그인의 작동이 중지되었거나 오류가 발생하고 있습니다
먼저 Android 스튜디오를 최신 버전으로 업데이트했는지 확인합니다. 403 오류가 표시된다면 실행할 권한이 없는 패키지에서도 플러그인을 실행 중일 수 있습니다.
오류가 지속되면 버그를 신고하고 다음 세부정보를 Google에 보내주세요.
- 오류 대화상자 세부정보
- Android 스튜디오 로그. Help > Show Log in Finder로 이동합니다. 이렇게 하면 Finder에서
idea.log의 위치를 보여줍니다. 로그 파일에서 'Submit Actions Request Body:'를 검색하고 서버 응답을 붙여넣습니다(작업에 관한 결과가 두 개 있어야 함).
앱 작업 테스트 도구는 UnknownHostException 또는 기타 네트워크 오류를 생성합니다
앱 작업 테스트 도구는 앱 작업의 미리보기를 만들므로 단일 Google 계정으로 Google 어시스턴트의 통합을 테스트할 수 있습니다. 이러한 미리보기를 만들려면 테스트 도구가 인터넷에 연결되어 있어야 하고 필요한 경우 Google 도메인에 대한 프록시 액세스 권한이 필요합니다.
테스트 도구를 실행할 때 발생하는 네트워크 문제를 해결하려면 다음과 같은 일반적인 문제를 확인합니다.
- 미리보기를 생성하려면 인터넷에 연결되어 있어야 합니다.
인터넷 연결이 활성 상태이고 로컬 네트워크에서 프록시 서버를 사용하는 경우 다음을 확인합니다.
- IDE 프록시 구성을 확인합니다. 자세한 내용은 Android 스튜디오 또는 IntelliJ의 프록시 구성 안내를 참고하세요.
- 프록시에 액세스 제어 목록(ACL)이 필요한 경우 이 URL 패턴(
https://actions.googleapis.com/**)을 허용하도록 ACL을 업데이트합니다.
테스트 플러그인으로 앱 작업을 호출할 때 어시스턴트는 "죄송합니다. 말씀하신 내용을 찾을 수 없습니다"라고 말합니다.
설정에 따라 이 응답은 다양한 이유로 나타날 수 있습니다. 다음 단계를 시도해 보세요.
- 동일한 Google 계정으로 Android 스튜디오, Play Console, 테스트 기기에 로그인합니다.
- 기기 데이터 동기화를 사용 설정합니다.
- 기기 및 Google 어시스턴트 언어를
en-US로 설정합니다. - Google Play Console의 애플리케이션 패키지 이름이 테스트 애플리케이션의 패키지 이름과 일치하는지 확인합니다.
actions.xml파일의 처리urlTemplate정의에서android:host및android:scheme값이AndroidManifest파일에 선언된 값과 일치하는지 확인합니다.- 테스트 기기에서 앱의 모든 이전 설치를 삭제하고 새 빌드를 설치합니다.
- 앱 작업 테스트 도구에서 미리보기를 삭제하고 새 미리보기를 다시 만듭니다.
- Logcat 도구에서 Google 어시스턴트의 처리와 관련된 실패를 확인합니다. 앱에 실행된 인텐트가 표시됩니다.
- 계정의 '기기의 앱 정보' 설정을 사용 설정합니다.
- Google 어시스턴트를 열고 설정을 완료했는지 확인합니다. 일반적으로 설정 진행률 표시줄은 화면 하단에 파란색 막대로 표시되지만 경우에 따라 다르게 표시될 수도 있습니다.
- Google 어시스턴트를 사용하여 앱 작업을 트리거할 때 호출 이름이 앱 작업 테스트 도구에서 만든 미리보기와 일치하는지 확인합니다.
- 음성 대신 텍스트 입력을 사용하여 스크립트 작성 오류를 방지합니다.
applicationId가 Google Play Console에 업로드된 APK 또는 AAB와 정확하게 일치하도록 테스트 빌드를 구성합니다. 선택적applicationIdSuffix속성은 특정 제품 버전 및 빌드 변형의 경우 빌드의 최종applicationId를 변경할 수 있습니다. 이 예에서 모의 제품 버전의applicationId는com.example.android.architecture.blueprints가 아닌com.example.android.architecture.blueprints.master.mock입니다.- 고유한 호출 이름을 사용하도록 미리보기를 구성합니다. 다른 앱과의 충돌 가능성을 줄이는 고유한 단어를 사용해 보세요.
- 공유 가능한 코드베이스 문제를 해결할 때 문제를 격리하려면 앱 작업 피트니스 앱 샘플을 실행해 봅니다. 피트니스 앱이 엔드 투 엔드로 작동하는지 확인하세요. 그런 다음 이 앱 위에 점진적으로 기능을 추가하여 문제를 복제할 수 있는지 확인합니다.
- G Suite 계정을 사용하는 경우 관리자가 Google 어시스턴트를 사용 설정했는지 확인합니다. 해결 방법으로 G Suite가 아닌 테스트 계정을 만들고 Play 스토어를 통해 라이선스가 부여된 테스터로 이를 설정하는 것이 좋습니다. 이 계정에서 테스터는 앱의 미리보기를 만들고 기기에서 이 계정을 사용하여 테스트할 수 있어야 합니다.
- Google 어시스턴트를 별도의 앱으로 다운로드했다면 기기에서 강제 종료해 봅니다. 일반적으로 휴대전화의 설정 앱을 통해 앱을 강제 종료할 수 있습니다.
- 이러한 단계를 따라도 문제가 계속되면 앱 작업 Issue Tracker에서 문제를 제기합니다.