跳到主要内容
Documentation Hub

移动应用常见问题

谷歌登录无法在移动应用上使用。​

要确保谷歌登录正常运行，请检查回调 URL (Callback URL) 是否在移动应用和 Cognito/RainMaker 管理面板中正确配置。

在 RainMaker 管理面板或 Cognito 配置中设置的回调 URL（参考：配置 Cognito 回调 URL）必须与移动应用的配置匹配：

如果你的应用 ID 是 com.espressif.rainmaker，则：

  • 安卓回调 URL：rainmaker://com.espressif.rainmaker/success
  • iOS 回调 URL：com.espressif.rainmaker.app://success

苹果登录无法在移动应用上使用。​

要确保苹果登录正常运行，请检查回调 URL (Callback URL) 是否在移动应用和 Cognito/RainMaker 管理面板中正确配置。

在 RainMaker 管理面板或 Cognito 配置中设置的回调 URL（参考：配置 Cognito 回调 URL）必须与移动应用的配置匹配：

如果你的应用 ID 是 com.espressif.rainmaker，则 iOS 回调 URL为 com.espressif.rainmaker.app://success。

如何获取手机应用的 Client ID？​

Client ID 是 RainMaker 用户池应用客户端的唯一标识符。

你可以通过 RainMaker 管理面板获取 Client ID，步骤如下：

  1. 使用超级管理员凭证登录 RainMaker 管理面板。

  2. 进入 Deployment Settings 标签页。

  3. 进入 Deployment Details。

    dashboard deployment settings

  4. 在 Cognito Details 部分，找到 App Client ID。

什么是 iOS 的 App Bundle ID？​

Bundle ID（捆绑标识符）是 iOS 生态系统中应用程序的唯一标识，确保每个应用程序都有独特的标识符，不能重复。

为了避免冲突，苹果建议开发者使用反向域名命名规则选择 Bundle ID。例如，对于 RainMaker，适合的 Bundle ID 可以是：com.espressif.rainmaker.softap。

什么是 iOS 的 URL 方案？​

URL 方案提供了一种让应用能够引用其内部资源的方式。例如，用户在邮件中点击自定义 URL，可以直接在应用的特定页面打开。其他应用可以让目标应用在特定状态下启动。例如，照片库应用可能会在启动时直接显示某张特定图片。

想了解更多详情，请参考苹果官方文档：Defining a custom URL scheme for your app。

什么是 iOS 的 App Group？​

App Group 标识符指定某个应用属于特定的组，使同一开发团队的多个应用能够通过公共存储容器共享数据和资源，进行跨应用通信。应用可以属于一个或多个 App Group。

在 iOS 中，标识符的格式如下：

group.<group name>

如需给应用添加以上权限，请在 Xcode 中启用 App Groups 功能，并添加应用所属的 App 组。

在哪里可以找到 iOS Team ID？​

  • 访问苹果开发者账号。
  • 点击 Account。
  • 在左侧导航栏中，点击 Membership。
  • 在 Membership Information 下找到 Team ID。

我已配置 iOS 推送通知，但仍然无法接收手机通知。​

请检查以下事项，确保所有推送通知配置步骤已按正确的顺序完成：

  • 确保已为主应用 Bundle ID 创建推送通知证书。
  • 确保 RainMaker 管理面板中已配置生产、沙盒平台。
  • 检查 APNS_SANDBOX 推送通知是否在调试模式下正常工作。
  • 确保苹果开发者控制台中的证书未过期。
  • 确保 RainMaker 管理面板中已启用推送通知事件。

安卓应用的推送通知无法正常工作。​

Amazon Simple Notification Service (Amazon SNS) 现已支持通过谷歌 Firebase 的 HTTP v1 API 发送移动推送通知。在 Amazon SNS 控制台或 API 中创建新平台应用程序时，可选择基于令牌的认证方式，授权 Amazon SNS 使用全新的谷歌 FCM HTTP v1 API 发送推送通知。还可将现有平台应用程序升级至采用令牌认证方式。只需提供有效的密钥文件，Amazon SNS 会将你的应用程序从旧版 FCM API 切换至新版 HTTP v1 API。

自 2024 年 6 月 1 日起，谷歌将停止对旧版 FCM v1 API 的支持，届时将无法继续发送推送通知。为了避免影响你的现有平台应用，建议务必在 2024 年 6 月 1 日之前完成迁移。

更新密钥的步骤：

  1. 打开 Firebase 控制台，选择你的项目。在左侧导航栏中，点击齿轮图标，然后选择 Project settings。

    firebase8


  2. 进入 Service accounts。在 Firebase Admin SDK 下点击 Generate new private key 生成新的私钥，并下载一个包含项目详细信息的文件。

    firebase9

  3. 使用管理员账户登录 RainMaker 管理面板，进入 Deployment Settings，然后打开 Push Notifications 标签页。

    push_notification12

  4. 在 Push Notification Platforms 下点击 Google Notification (GCM) 的编辑按钮。

    push_notification17

  5. 打开下载的私钥文件，复制所有内容，然后点击 Update 以保存更改。

    push_notification18

On this page