문제해결
컬렉션을 사용해 정리하기
내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.
앱 작업을 개발할 때는 설정이나 앱 작업 테스트 도구에서 문제가 발생할 수 있습니다. 이 페이지에서는 자주 발생하는 문제와 그 해결 방법을 설명합니다.
일반
오류: '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 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 도메인에 대한 프록시 액세스 권한이 필요합니다.
테스트 도구를 실행할 때 발생하는 네트워크 문제를 해결하려면 다음과 같은 일반적인 문제를 확인합니다.
테스트 플러그인으로 앱 작업을 호출할 때 어시스턴트는 "죄송합니다. 말씀하신 내용을 찾을 수 없습니다"라고 말합니다.
설정에 따라 이 응답은 다양한 이유로 나타날 수 있습니다. 다음 단계를 시도해 보세요.
- 동일한 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에서 문제를 제기합니다.
이 페이지에 나와 있는 콘텐츠와 코드 샘플에는 콘텐츠 라이선스에서 설명하는 라이선스가 적용됩니다. 자바 및 OpenJDK는 Oracle 및 Oracle 계열사의 상표 또는 등록 상표입니다.
최종 업데이트: 2025-07-27(UTC)
[[["이해하기 쉬움","easyToUnderstand","thumb-up"],["문제가 해결됨","solvedMyProblem","thumb-up"],["기타","otherUp","thumb-up"]],[["필요한 정보가 없음","missingTheInformationINeed","thumb-down"],["너무 복잡함/단계 수가 너무 많음","tooComplicatedTooManySteps","thumb-down"],["오래됨","outOfDate","thumb-down"],["번역 문제","translationIssue","thumb-down"],["샘플/코드 문제","samplesCodeIssue","thumb-down"],["기타","otherDown","thumb-down"]],["최종 업데이트: 2025-07-27(UTC)"],[],[],null,["# Troubleshoot issues\n\nWhen developing App Actions, you might encounter issues with your setup or with\nthe App Actions test tool. This page describes some commonly encountered issues\nand their fixes.\n\nGeneral\n-------\n\n### Error: \"No App found to open URL\" appears in a toast notification\n\nCheck your fulfillment `urlTemplate` in your `actions.xml` to make sure it's\nconfigured correctly. If using App Links URLs, ensure you can trigger your URL\nmanually using `ACTION_VIEW` and the URL. If using intent-based URLs, ensure\nyour Activity is correctly configured to start using the provided parameters.\n\n### Error: \"App isn't installed\"\n\nThis error may mean that the `\u003cintent-filter\u003e` in your `AndroidManifest.xml`\nfile doesn't filter the deep link that you specified in your `actions.xml`.\nMake sure you check this first before filing a bug.\n\n### Error: \"An entity set reference containing neither an entity set ID nor a URL filter was found.\" appears in Android Studio\n\nThis condition is caused by a known linter issue for the\n`\u003centity-set-reference\u003e` tag. You can safely ignore this message. As a\nworkaround, you can disable lint check for this tag by adding the\n`tools:ignore=\"ValidActionsXml\"` attribute to it.\n\nHere's an example of an entity set reference with a disabled lint check: \n\n```gdscript\n\u003centity-set-reference entitySetId=\"example\" tools:ignore=\"ValidActionsXml\" /\u003e\n```\n\n\u003cbr /\u003e\n\n### Error: \"Invalid location\" for actions schema document when uploading APK\n\nYour APK upload may fail if you use an obfuscation or optimization tool that\naffects resources for your release APK. Tools like ProGuard that avoid\nresource files do not cause this issue.\n\nTo resolve this issue, try disabling the tool for your app's `actions.xml`\nfile (for example, by using an allowlist).\n\n### Error: \"An active APK or Android App Bundle contains an actions.xml file. In order to continue, accept the Actions on Google Terms of Service.\" appears in Google Play Console\n\nYou may see this error while creating an app release in the Play Console. To\naccept the Actions on Google Terms of Service, follow these steps:\n\n1. Select your app in the Play Console.\n2. Navigate to **Setup \\\u003e Advanced Settings**.\n3. Click the **Actions on Google** tab.\n4. Check the box labeled **Integrate my services with App Actions using Actions\n on Google**, and follow the instructions.\n\n### The \"Accept\" button on Play Terms of Service form is disabled.\n\nThis might mean that the signed in user doesn't have the required access\nlevel to accept those terms. Make sure the first submission is done by the\nadministrator of the Play Console profile.\n\nApp Actions test tool\n---------------------\n\nBefore attempting any of the following fixes, update your installation of the\nApp Actions test tool to the most recent version.\n\n### The App Actions test tool plugin cannot locate my `actions.xml` file.\n\nEnsure you have added the correct `\u003cmeta-data\u003e` tag in your\n`AndroidManifest.xml` file.\n\n### My App Action preview doesn't match my current `actions.xml` file.\n\nYour preview does not update itself dynamically with the content of your\n`actions.xml` file. After you change your `actions.xml` file manually or after\nswitching build variants in Android Studio, save your `actions.xml` file and\nclick **Update Preview** in the test tool.\n\n### The App Actions test tool plugin stopped working or is generating errors.\n\nFirst, make sure you've updated Android Studio to the latest version. If\nyou are getting a 403 error, you also might be running the plugin on a\npackage where you don't have permissions to run on.\n\nIf the error still persists, please file a bug and send the following\ndetails to Google:\n\n- Details of the error dialog\n- Android Studio Logs. Go to **Help \\\u003e Show Log in Finder** . This shows you the location of the `idea.log` in your Finder. Search for \"Submit Actions Request Body:\" in the log file, and paste the server responses (there should be two results for actions).\n\n### The App Actions test tool generates `UnknownHostException`, or other network errors\n\nThe App Actions test tool creates a preview of your App Actions, enabling you to\ntest Google Assistant integrations with a single Google Account. To create these\npreviews, the test tool requires an active internet connection and, if\nnecessary, proxy access to Google domains.\n\nTo resolve network issues when running the test tool, check for these common\nissues:\n\n- Ensure you have an active internet connection before generating previews.\n- If your internet connection is active, and your local network uses a proxy\n server, check the following:\n\n - Verify your IDE proxy configuration. For more information, see proxy configuration instructions for [Android Studio](https://developer.android.com/studio/intro/studio-config#proxy), or [IntelliJ](https://www.jetbrains.com/help/idea/settings-http-proxy.html).\n - If your proxy requires an access control list (ACL), update the ACL to allow this URL pattern: `https://actions.googleapis.com/**`.\n\n### When invoking the App Action with the test plugin, the Assistant says, \"Sorry, I couldn't find that.\"\n\nDepending on your setup, this response may appear for different reasons. Try\nthe following steps:\n\n1. Sign in to Android Studio, the Play Console, and your test device with the same Google Account.\n2. Enable [device data syncing](//myaccount.google.com/deviceapps).\n3. Set the device and Google Assistant language to `en-US`.\n4. Check that the package name of the application in the Google Play Console matches with the package name in the test application.\n5. In the fulfillment `urlTemplate`definition in your `actions.xml` file, make sure that the `android:host` and `android:scheme` values match what's declared in the `AndroidManifest` file.\n6. Remove all previous installations of your app from your test device and install a fresh build.\n7. Delete the preview from App Actions test tool and create a new preview again.\n8. Check in the Logcat tool for failures related to fulfillment for Google Assistant. You should see an intent launched to your app.\n9. [Enable the 'App info for your devices' setting](https://support.google.com/accounts/answer/9503395?co=GENIE.Platform%3DAndroid) for the account.\n10. Open Google Assistant and ensure you have completed setup. (Usually the setup progress bar appears as a blue bar at the bottom of the screen, but it may look different in some cases.)\n11. When using Google Assistant to trigger an App Action, make sure that the invocation name matches the preview created by the App Actions test tool.\n12. Try using text input instead of voice to avoid any transcription errors.\n13. Configure your test build so that the `applicationId` exactly matches an APK or AAB uploaded to the Google Play Console. Note that optional `applicationIdSuffix` properties can change the final `applicationId` of builds for certain product flavors and build variants. In this [example](https://www.google.com/url?sa=D&q=https%3A%2F%2Fgithub.com%2Fandroid%2Farchitecture-samples%2Fblob%2Fmaster%2Fapp%2Fbuild.gradle%23L53), the `applicationId` for the mock product flavor is `com.example.android.architecture.blueprints.master.mock`, instead of `com.example.android.architecture.blueprints`.\n14. Configure your preview to use a unique invocation name. Try using a unique word that reduces the chances for collision with other apps.\n15. To isolate issues when troubleshooting a shareable codebase, try running the [the sample App Actions Fitness App](https://github.com/actions-on-google/appactions-fitness-kotlin). Make sure that the Fitness app works end-to-end. Then incrementally add additional features on top of this app to see if you can replicate issues.\n16. If using G Suite accounts, make sure Google Assistant is [turned on by the\n administrator](https://support.google.com/a/answer/9620347#:%7E:text=As%20an%20administrator%2C%20you%20control,or%20while%20working%20from%20home). We recommend creating a non-G Suite test account as a workaround and setting it up as a [licensed tester through Play Store](https://developers.google.com/assistant/app/test-tool#additional-testers). From that account, testers should be able to create previews for their app and test using that account on their device successfully.\n17. If you downloaded Google Assistant as a separate app, try force stopping it on your device. You can usually force stop an app through your phone's Settings app.\n18. If none of these steps work, raise a issue in the [App Action issue tracker](https://issuetracker.google.com/issues?q=componentid:617864%20status:open)."]]
