expo-splash-screen

开放Beta测试文档 作为预发布开放Beta测试的一项内容，亚马逊提供了此技术文档。随着亚马逊收到反馈并对功能进行迭代，所描述的这些功能可能会发生变化。有关最新功能的信息，请参阅发布说明。

@amazon-devices/expo-splash-screen库用于要求启动画面保持可见状态，直至被明确要求隐藏。这对于执行将在幕后执行的任务很有用，例如进行API调用、预加载字体、为启动画面设置动画等。

安装
示例
API参考
- 方法
实现详情
支持的版本
其他资源

安装

在package.json文件中添加JavaScript库依赖项。

已复制到剪贴板。

 "dependencies": {
     ...
     "@amazon-devices/expo-splash-screen": "~2.0.0",
     "@amazon-devices/keplerscript-turbomodule-api": "~1.0.0",
     ...
         }

 "overrides": {
     "@amazon-devices/react-native-kepler": "~2.0.0"
     },

使用npm install命令重新安装依赖项。

示例

您需要创建顶级<项目根目录>/assets/raw目录，然后需要在其中放置名为SplashScreenImages.zip的zip文件和desc.txt文件（示例内容见下文），以及带有splash.png文件的_loop文件夹。

文件夹结构：

已复制到剪贴板。

├── assets/
├──── raw/
├────── SplashScreenImages.zip
...
├── src/
...
├── manifest.toml

desc.txt文件的示例内容：

已复制到剪贴板。

1920 1080 30
c 0 0 _loop

启动画面示例

已复制到剪贴板。

import {hideAsync, preventAutoHideAsync} from '@amazon-devices/expo-splash-screen';
import React from 'react';
import {useEffect} from 'react';
import {StyleSheet, Text, View} from 'react-native';

preventAutoHideAsync();

export const App = () => {
  useEffect(() => {
    // 在调用hide async之前执行操作
    setTimeout(() => {
      hideAsync();
    }, 2000);
  }, []);

  return (
    <View style={styles.container}>
      <Text style={styles.text}>SplashScreen演示！👋</Text>
    </View>
  );
};

const styles = StyleSheet.create({
  container: {
    flex: 1,
    backgroundColor: 'white',
    alignItems: 'center',
    justifyContent: 'center',
  },
  text: {
    color: 'black',
    fontSize: 32,
  },
});

API参考

请查看以下专门文档页面，了解有关此库、API参考等的信息：针对expo-splash-screen的官方Expo文档（仅提供英文版）。

方法

方法	描述
`hideAsync`	立即隐藏原生启动画面。当您隐藏启动画面时，请注意确保您的应用已准备好显示内容，否则可能会短暂地看到一个空白屏幕。有关示例，请参阅“用法”部分。
`preventAutoHideAsync`	在调用hideAsync之前，使原生启动画面保持可见

实现详情

启动画面在Vega虚拟设备上不起作用。

支持的版本

程序包版本	基于	@amazon-devices/react-native-kepler版本
2.0.x	0.24.0	2.0.x

其他资源

有关其他库的信息，请参阅支持的第三方库和服务。

Last updated: 2025年9月30日