故障排除

无效的隐私清单（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 on 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 监督账户

家长控制账户的 Family Link 可能会出现以下问题:

NoCredentialException: No credentials available

对于需要支持 Family Link 账户的应用程序，请在 Google 登录调用中禁用授权账户过滤:

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

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

关键点:

• 设置 filterByAuthorizedAccounts 到 false; 默认值为 true.
• 插件将自动重试 standard 如果 bottom 样式 NoCredentialException.
• 样式失败时使用
• 错误消息建议禁用 filterByAuthorizedAccounts 当检测到此故障时

存储访问令牌的位置

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

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

相关文档

• Android 上的 Google 登录
• 存储访问令牌的位置
• 服务提供商配置
• 隐私清单和iOS URL处理