疑難排解

開發應用程式動作時,可能會遇到設定或應用程式動作測試工具相關的問題。本頁將說明部分常見問題及其修正方法。

一般

錯誤:浮動式訊息通知顯示「找不到可以開啟網址的應用程式」

檢查 actions.xml 中的 urlTemplate 執行要求,確認設定正確無誤。如果要使用應用程式連結網址,請確保您可以使用 ACTION_VIEW 和網址手動觸發網址。如果是使用意圖網址,請確保 Activity 的設定正確無誤,可開始使用提供的參數。

錯誤:「應用程式未安裝」

這項錯誤可能表示 AndroidManifest.xml 檔案中的 <intent-filter> 未篩選 actions.xml 中指定的深層連結。回報錯誤前,請務必先檢查這一點。

錯誤:Android Studio 顯示「系統找到未包含實體集 ID 和網址篩選器的實體集參照。」

這個狀況是由 <entity-set-reference> 標記的已知 Linter 問題所造成。您可以放心忽略此訊息。如要解決問題,可以在該標記中加入 tools:ignore="ValidActionsXml" 屬性,停用 Lint 檢查。

以下是已停用 Lint 檢查的實體集參照範例:

<entity-set-reference entitySetId="example" tools:ignore="ValidActionsXml" />

錯誤:上傳 APK 時,動作架構文件發生「位置無效」錯誤

如果您使用的模糊處理或最佳化工具會影響發布版 APK 的資源,APK 上傳作業可能會失敗。ProGuard 等會避開資源檔案的工具則不會引起這個問題。

如要解決這個問題,請嘗試針對應用程式的 actions.xml 檔案停用該工具 (例如,使用許可清單)。

錯誤:Google Play 管理中心顯示「目前使用的 APK 或 Android App Bundle 含有 actions.xml 檔案。如要繼續,請接受《Actions on Google 服務條款》。」

在 Play 管理中心建立應用程式版本時,系統可能會顯示這個錯誤。如要接受《Actions on Google 服務條款》,請按照下列步驟操作:

  1. 在 Play 管理中心選取應用程式。
  2. 依序前往「設定」>「進階設定」
  3. 按一下「Actions on Google」分頁標籤。
  4. 勾選標示為「使用 Actions on Google 將我的服務與 App Actions 進行整合」的方塊,然後按照指示操作。

《Google Play 服務條款》表單的「接受」按鈕已停用。

這可能表示登入的使用者未具備所需存取層級,因此無法接受這些條款。請確認 Play 管理中心設定檔的系統管理員已完成首次提交作業。

應用程式動作測試工具

嘗試進行下列修正作業之前,請先更新應用程式動作測試工具來安裝最新版本。

應用程式動作測試工具外掛程式找不到 actions.xml 檔案。

請確認您已在 AndroidManifest.xml 檔案中加入正確的 <meta-data> 標記。

應用程式動作預覽與目前的 actions.xml 檔案不相符。

預覽畫面不會自行動態更新為 actions.xml 檔案的內容。手動變更 actions.xml 檔案或在 Android Studio 中切換建構變化版本後,請儲存 actions.xml 檔案,然後按一下測試工具中的「Update Preview」

應用程式動作測試工具外掛程式已停止運作或產生錯誤。

首先,請確認 Android Studio 已更新至最新版本。如果系統顯示 403 錯誤,表示您也可能在未具備執行權限的套件中執行外掛程式。

如果錯誤仍未解決,請回報錯誤並將下列詳細資料傳送給 Google:

  • 錯誤對話方塊的詳細資料
  • Android Studio 記錄。依序前往「Help」>「Show Log in Finder」。這樣可在 Finder 中顯示 idea.log 的位置。在記錄檔中搜尋「Submit Actions Request Body:」,然後貼上伺服器回應內容 (應會有動作的兩個結果)。

應用程式動作測試工具會產生 UnknownHostException 或其他網路錯誤

應用程式動作測試工具會建立應用程式動作預覽畫面,方便您使用單一 Google 帳戶測試 Google 助理的整合成果。如要建立這些預覽畫面,測試工具需要有效的網際網路連線,以及 Google 網域的 Proxy 存取權 (在必要情況下)。

如要解決執行測試工具時發生的網路問題,請確認下列常見問題:

  • 先確保具有有效的網際網路連線,再產生預覽畫面。
  • 如果網際網路連線處於有效狀態,且區域網路使用 Proxy 伺服器,請檢查下列項目:

    • 驗證 IDE Proxy 設定。詳情請參閱 Android StudioIntelliJ 的 Proxy 設定操作說明。
    • 如果 Proxy 需要存取控制清單 (ACL),請將 ACL 更新為允許以下網址模式:https://actions.googleapis.com/**

使用測試外掛程式叫用應用程式動作時,Google 助理會說:「很抱歉,我找不到。」

視設定而定,系統可能會因不同原因而顯示此回應。請嘗試下列步驟:

  1. 使用相同的 Google 帳戶登入 Android Studio、Play 管理中心和測試裝置。
  2. 啟用裝置資料同步功能。
  3. 將裝置和 Google 助理的語言設為 en-US
  4. 確認 Google Play 管理中心的應用程式套件名稱與測試應用程式中的套件名稱相符。
  5. actions.xml 檔案的執行要求 urlTemplate 定義中,請確認 android:hostandroid:scheme 的值與 AndroidManifest 檔案中宣告的值相符。
  6. 從測試裝置移除所有先前安裝的應用程式版本,然後安裝新的版本。
  7. 從應用程式動作測試工具中刪除預覽畫面,然後重新建立新的預覽畫面。
  8. 在 Logcat 工具中檢查是否有 Google 助理執行要求相關的失敗問題。您應該會看到應用程式已啟動的意圖。
  9. 針對該帳戶啟用「App info for your devices」設定
  10. 開啟 Google 助理,並確實完成設定 (設定進度列通常會顯示為畫面底部的藍色列,但在某些情況下外觀可能不同)。
  11. 使用 Google 助理觸發應用程式動作時,請確認叫用名稱與應用程式動作測試工具建立的預覽相符。
  12. 嘗試使用文字輸入而非語音輸入,避免發生任何語音轉錄錯誤。
  13. 設定測試版本,使 applicationId 完全符合上傳至 Google Play 管理中心的 APK 或 AAB。請注意,選用的 applicationIdSuffix 屬性可變更特定變種版本和建構變化版本的最終 applicationId。在此範例中,模擬變種版本的 applicationIdcom.example.android.architecture.blueprints.master.mock,而非 com.example.android.architecture.blueprints
  14. 設定預覽畫面以使用不重複的叫用名稱。請嘗試使用不重複的字詞,減少與其他應用程式發生衝突的機會。
  15. 如要在針對可共用程式碼集進行疑難排解時找出問題,請嘗試執行範例應用程式動作健身應用程式。請確保健身應用程式能夠進行端對端運作。接著,在這個應用程式中逐步加入其他功能,看看是否能重現問題。
  16. 如果您使用的是 G Suite 帳戶,請確認系統管理員已啟用 Google 助理。建議您改為建立非 G Suite 測試帳戶,並透過 Play 商店將該帳戶設為授權測試人員。測試人員應可透過該帳戶建立應用程式的預覽畫面,並在裝置上使用該帳戶完成測試。
  17. 如果您以個別應用程式的形式下載 Google 助理,請嘗試在裝置上強制停止 Google 助理。通常可以透過手機的「設定」應用程式強制停止應用程式。
  18. 如果以上步驟都無法解決問題,請透過應用程式動作 Issue Tracker 回報問題。