Platform.isIOS在真实iOS设备不生效苹果登录按钮真机不显示

开发者阿泽

2026-10-5

问题排查与修复方案

首先确认Platform类的导入来源，必须是dart:io库提供的原生Platform类，不要导入其他第三方依赖中的同名Platform类（部分设备信息、全局工具库也会定义同名类，不同环境下的取值逻辑不一致，很容易导致模拟器和真机返回值不同）。正确导入语句为：
```
import 'dart:io';
```
检查Xcode中项目的Signing & Capabilities配置，确认已经添加Sign in with Apple权限，真机运行时如果缺少该权限，Apple登录相关组件初始化会失败，可能间接导致按钮无法正常渲染。

确认你的测试真机系统版本≥iOS13，Apple登录是iOS13才推出的系统能力，如果你的App最低支持版本低于iOS13，_LoginWithAppleIdWidget内部如果调用了高版本API会抛出异常，导致widget无法正常展示，建议补充系统版本判断逻辑：

import 'package:device_info_plus/device_info_plus.dart';

// 同时判断系统版本
final deviceInfo = DeviceInfoPlugin();
final iosInfo = await deviceInfo.iosInfo;
final systemVersion = double.parse(iosInfo.systemVersion);
if (Platform.isIOS && systemVersion >= 13.0) {
  _LoginWithAppleIdWidget()
}

如果以上配置都正常，可以添加临时调试打印，确认真机环境下Platform.isIOS的实际返回值：
```
debugPrint("当前设备是否为iOS：${Platform.isIOS}");
if (Platform.isIOS) {
  debugPrint("进入Apple登录按钮渲染逻辑");
  return _LoginWithAppleIdWidget();
}
```
如果打印结果为false，基本可以确定是导入了错误的Platform类，替换为dart:io的导入即可解决。