故障排除

无效的隐私清单（ITMS-91056）

如果 App Store Connect 报告此错误：

ITMS-91056：无效的隐私清单 - 来自以下路径的 PrivacyInfo.xcprivacy 文件无效：…

检查您的应用级别 PrivacyInfo.xcprivacy 文件：

• 该文件必须是有效的 JSON。
• 仅使用 Apple 文档的键和值。
• 不要将隐私清单添加到插件包中；将其添加到您的应用中。

参见 隐私清单和 iOS URL 处理程序 了解更多示例。

Google Play Console AD_ID 权限错误

在将应用程序提交到 Google Play 后，您可能会看到：

Google Api Error: Invalid request - This release includes the com.google.android.gms.permission.AD_ID permission
but your declaration on Play Console says your app doesn't use advertising ID.

Facebook SDK 包含 AD_ID 以及其他与广告相关的权限。如果您的应用程序不使用 Facebook 登录，请在 capacitor.config.ts:

import type { CapacitorConfig } from '@capacitor/cli';

const config: CapacitorConfig = {
  plugins: {
    SocialLogin: {
      providers: {
        google: true,
        facebook: false,
        apple: true,
      },
    },
  },
};

export default config;

然后运行：

npx cap sync

该插件使用虚拟类而不是真正的 Facebook SDK，因此 Facebook 依赖项和权限不会包含在您的构建中。

Google Sign-In 28444 在 Android 上

GetCredentialCustomException: [28444] Developer console is not set up correctly 来自Google Credential Manager的信息是因为安装的APK的签名证书、包名或 webClientId 不匹配Google Cloud Console。

使用完整的 Android Google故障排查清单。登录失败后，过滤Logcat以查找 GoogleProvider;插件打印 package, signingSha1,并且一个掩码 webClientId 用于与您的OAuth客户端进行比较。

Google Sign-In with Family Link监管账户

监管账户可能会出现以下问题：

NoCredentialException: No credentials available

对于需要支持家庭链接账户的应用程序，请禁用授权账户过滤器以支持Google登录调用:

import { SocialLogin } from '@capgo/capacitor-social-login';

await SocialLogin.login({
  provider: 'google',
  options: {
    style: 'bottom',
    filterByAuthorizedAccounts: false,
    scopes: ['profile', 'email'],
  },
});

关键点:

• 设置 filterByAuthorizedAccounts to false到 true.
• ; 默认值为 standard 插件将自动重试 bottom 样式如果 NoCredentialException.
• 样式失败
• 这些选项仅影响Android。 iOS正常处理家庭链接账户。 filterByAuthorizedAccounts 当检测到此故障时。

存储访问令牌的位置

使用 @capgo/capacitor-持久账户 当您的应用程序需要本机安全存储访问令牌或刷新令牌时。

在 Android 上，它将数据存储在 Account Manager 中。 在 iOS 上，它将数据存储在 Keychain 中。

相关文档

• Android 上的 Google 登录
• 提供者配置
• 故障检测时的此处
• 隐私清单和iOS URL处理器