特点

该软件包允许您在 iPhone 设备上的刘海或灵动岛下方添加隐藏的徽标。

readme_welcome_image.png

❗使用此软件包不会影响您在 iOS 以外的任何其他平台上运行的应用程序。此外,它也不会影响您在未标记为目标设备(请参阅下表中的目标 iPhone 列表)的 iPhone 上运行的应用程序。

用法

使用 HiddenLogo 小部件包装您的 MaterialAppCupertinoApp,或定义其 builder 函数(如示例所示)。然后,您需要为两种情况提供 2 个 builder:刘海屏 iPhone 和灵动岛 iPhone。

@override
Widget build(BuildContext context) {
  return MaterialApp(
    builder: (context, child) {
      return HiddenLogo(
        body: child!,
        notchBuilder: (context, constraints) {
          return MyNotchLogoBuilder();
        },
        dynamicIslandBuilder: (context, constraints) {
          return MyDynamicIslandLogoBuilder();
        },
      );
    },
  );
}

由于小部件提供的约束,您的品牌徽标大小可以自适应。它们定义了您可以绘制并保持隐藏的 maxWidthmaxHeight。别忘了为您的刘海屏徽标小部件定义 BorderRadius 属性,使其看起来更漂亮!灵动岛小部件将自动进行圆角处理。

常见错误

  • 不要放置花哨的视觉垃圾(尤其是广告),只放您的品牌或应用程序徽标。显而易见,反之可能会导致应用程序商店发布出现问题!
  • 使您小部件的边界圆角化,使其能够很好地贴合硬件边界,并在不需要时不可见。

附加信息

您不必担心 – 从 iPhone X 开始的所有现有 iPhone 型号都经过了测试,因此该小部件始终会返回正确的最大约束!

要在开发过程中测试小部件的视觉外观,您可以将应用程序最小化到托盘,或者截取应用程序的屏幕截图(对于 iOS 模拟器:设备 → 触发屏幕截图)。

iPhone 硬件顶部边界类型(目标 iPhone)表

带刘海屏的 iPhone 带灵动岛的 iPhone
X 14 Pro
XR 14 Pro Max
XS 15
XS Max 15 Plus
11 15 Pro
11 Pro 15 Pro Max
11 Pro Max
12
12 Mini
12 Pro
12 Pro Max
13
13 Mini
13 Pro
13 Pro Max
14
14 Plus

关于进一步更新

当新 iPhone 发布时,徽标将不会出现在它们上面,因为后续设备的实际形状和尺寸配置是未知的!但软件包将在发布后尽快更新!

欢迎提交任何问题或拉取请求! 谢谢!

GitHub

查看 Github