故障排除

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

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 到 false; 默认值为 true.
• 插件将自动重试 standard 样式如果 bottom 样式失败 NoCredentialException.
• 这些选项仅影响Android。 iOS正常处理家庭链接账户。
• 错误消息建议禁用 filterByAuthorizedAccounts 当检测到此故障时

存储访问令牌的位置

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

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

相关文档

• 入门
• Android 上的 Google 登录
• 提供者配置
• 隐私清单和 iOS URL 处理器