疑難排解

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

一般

錯誤：「找不到可以開啟網址的應用程式」出現在浮動式訊息通知中

檢查 actions.xml 中的 urlTemplate 出貨狀態，確定 正確設定。如果使用應用程式連結網址，請確保你可以觸發網址 手動使用 ACTION_VIEW 和網址。如要使用意圖網址，請確保 您的活動已正確設定，可以開始使用提供的參數。

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

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

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

這個狀況是由 <entity-set-reference> 標記。您可以放心忽略此訊息。身為 解決方法，只要在該標記中加入 加入 tools:ignore="ValidActionsXml" 屬性。

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

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

錯誤：「位置無效」適用於上傳 APK 的動作架構文件

如果您使用的模糊處理或最佳化工具 影響版本 APK 的資源。ProGuard 等工具 資源檔案不會造成此問題。

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

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

在 Play 管理中心建立應用程式版本時，系統可能會顯示這個錯誤。目的地： 接受《Actions on Google 服務條款》，步驟如下：

  1. 在 Play 管理中心選取應用程式。
  2. 瀏覽至「設定」>「設定」進階設定。
  3. 按一下「Actions on Google」分頁標籤。
  4. 勾選標示為「使用動作將我的服務與應用程式動作整合」的方塊 ，然後遵照指示。

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

這可能表示登入的使用者沒有所需的存取權 接受這些條款。請確認是否已提交第一項提交作業， Play 管理中心設定檔的管理員身分。

應用程式動作測試工具

嘗試進行下列修正作業之前，請先更新 升級至最新版應用程式動作測試工具。

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

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

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

預覽畫面不會自行動態更新為 actions.xml 檔案。手動變更 actions.xml 檔案或完成後變更完成後 在 Android Studio 中切換建構變數、儲存 actions.xml 檔案，然後 按一下測試工具中的「更新預覽」。

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

首先，請確認 Android Studio 已更新至最新版本。如果 出現 403 錯誤時，您也可能會在 未具備執行權限的套件。

如果錯誤仍未解決，請回報錯誤並將下列資訊傳送給我們： 傳送給 Google 的詳細資訊：

  • 錯誤對話方塊的詳細資料
  • Android Studio 記錄。前往「說明」>在 Finder 中顯示記錄。這會指出 「idea.log」在 Finder 中的位置。搜尋「Submit Actions」 要求主體：然後貼上伺服器回應 ( 應該會有兩個動作的結果)。

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

應用程式動作測試工具會建立應用程式動作預覽畫面，方便您 使用單一 Google 帳戶測試 Google 助理整合功能。要建立這些規則 測試工具需要有效的網路連線 存取 Google 網域所需的 Proxy 存取權

如要解決執行測試工具時發生的網路問題，請檢查下列常見問題 問題：

  • 先確保具有有效的網際網路連線，再產生預覽畫面。

  • 如果網際網路連線處於有效狀態，且區域網路使用 Proxy 伺服器，請檢查下列項目：

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

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

視設定而定，系統可能會因不同原因而顯示此回應。嘗試 步驟如下：

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