启动画面和应用图标

安卓

🌐 Android

可以使用 android.adaptiveIcon 属性进一步自定义 Android 图标，这将覆盖之前提到的两个设置。

🌐 Further customization of the Android icon is possible using the android.adaptiveIcon property, which will override both of the previously mentioned settings.

Android 自适应图标由两个独立的图层组成——前景图片和背景颜色或图片。这使操作系统可以将图标裁剪成不同的形状，同时也支持视觉效果。在 Android 13 及更高版本中，操作系统支持使用壁纸和主题来确定由设备主题设置颜色的主题应用图标。

🌐 The Android Adaptive Icon is formed from two separate layers — a foreground image and a background color or image. This allows the OS to mask the icon into different shapes and also supports visual effects. For Android 13 and later, the OS supports a themed app icon that uses a wallpaper and theme to determine the color set by the device's theme.

你提供的设计应遵循Android自适应图标指南用于启动器图标。你还应该：

🌐 The design you provide should follow the Android Adaptive Icon Guidelines for launcher icons. You should also:

• 使用 .png 文件。
• 使用 android.adaptiveIcon.foregroundImage 属性来指定前景图片的路径。
• 使用 android.adaptiveIcon.monochromeImage 属性来指定你的单色图片的路径。
• 默认的背景颜色是白色；要指定不同的背景颜色，请使用 android.adaptiveIcon.backgroundColor 属性。你也可以使用 android.adaptiveIcon.backgroundImage 属性来指定背景图片。确保它的尺寸与前景图片相同。

你可能还希望为不支持自适应图标的旧版 Android 设备提供一个单独的图标。你可以使用 android.icon 属性来实现。这种单独的图标将是前景层和背景层的组合。

🌐 You may also want to provide a separate icon for older Android devices that do not support Adaptive Icons. You can do so with the android.icon property. This single icon would be a combination of your foreground and background layers.

请参阅 Apple 最佳实践 以确保你的图标看起来专业，例如在不同的壁纸上测试你的图标，并避免在产品商标旁边添加文字。请提供至少 512x512 像素的图标。

iOS

图标制作器

了解如何使用新的图标制作器为 Expo 项目创建应用图标。

对于 iOS，你的应用图标应遵循 Apple 人机界面指南。你可以使用 Icon Composer 应用来创建你的应用图标。这将生成一个 .icon 目录，你可以将其添加到项目的 assets 目录中。然后，你可以在应用配置中提供该目录的路径。在 Icon Composer 中可以处理夜间模式的支持，因此使用这种方法时无需提供变体。

🌐 For iOS, your app's icon should follow the Apple Human Interface Guidelines. You can use the Icon Composer app to create your app icon. This will output a .icon directory that you can add to your project's assets directory. You can then provide the path to this directory in your app config. Adding support for dark mode is handled in Icon Composer, so you do not need to provide variants when using this approach.

信息 注意： 通过 ios.icon 提供 Icon Composer .icon 目录在 SDK 54 及更高版本中受到支持。

{
  "expo": {
    "ios": {
      "icon": "./assets/app.icon"
    }
  }
}

另外，之前提供图片的方法仍然支持。你应该：

🌐 Alternatively, the previous approach of providing an image is still supported. You should:

• 使用 .png 文件。
• 1024x1024 是一个合适的大小。如果你使用 npx create-expo-app 创建了 Expo 项目，EAS Build 会为你生成其他尺寸的图标。如果是 bare React Native 项目，则需要你自己生成图标。EAS Build 生成的最大图标尺寸为 1024x1024。
• 图标必须完全是正方形的。例如，1023x1024 的图标无效。
• 确保图标填满整个正方形，不要有圆角或其他透明像素。操作系统会在合适的时候对你的图标进行遮罩处理。
• 使用 ios.icon 可以为不同的系统外观（例如深色和带色调）指定不同的图标。如果指定了，它将覆盖应用配置文件中的顶层图标键。请参见下面的示例：

{
  "expo": {
    "ios": {
      "icon": {
        "dark": "./assets/images/ios-dark.png",
        "light": "./assets/images/ios-light.png",
        "tinted": "./assets/images/ios-tinted.png"
      }
    }
  }
}