Flutter的flutter_native_splash库最全最实用使用说明

****简介****

flutter_native_splash(点我可直达pub库) 是一个 Flutter 库,可以帮助您在启动应用程序时添加原生的启动屏幕。通过使用 flutter_native_splash,您可以轻松地创建适用于 Android 和 iOS 平台的启动屏幕,而无需手动编辑原生代码。

****使用场景****

flutter_native_splash 适用于以下场景:

想要为您的应用程序添加原生启动屏幕。

不希望手动编辑原生代码。

****使用步骤****

步骤1:

要使用 flutter_native_splash 库,您需要在项目中添加依赖项。您可以在 pubspec.yaml 文件中添加以下代码:

dependencies:
  flutter_native_splash: ^2.3.0

如下图:

然后在终端执行命令

flutter pub get

看到库更新成功了说明库就下载好了。

步骤2:
自定义下面的设置,然后添加到工程的 pubspec.yaml 文件中,或者在工程文件夹下放置名为 flutter_native_splash.yaml 的新文件。个人强烈建议单独创建一个flutter_native_splash.yaml 的新文件,特别注意名字就叫flutter_native_splash.yaml不要取其他名字,如下图:

创建好之后,然后设置里面的内容,内容如下,直接全部复制即可。

flutter_native_splash: 

  # 该锯生成原生代码来自定义 Flutter 默认白色原生闪屏界面的背景色和闪屏图像。
  # 自定义下面的参数,然后在命令行终端运行下面的命令:
  # flutter pub run flutter_native_splash:create
  # 要恢复为 Flutter 默认的白色闪屏界面,运行下面的命令:
  # flutter pub run flutter_native_splash:remove

  # 只有 color 或 background_image 是必需的参数。使用 color 将闪屏界面的背景设置为单色。
  # 使用 background_image 可将 png 图像设置为闪屏界面的背景。该图像会被拉伸以适应应用大小。
  # color 和 background_image 不能同时设置,只有一个会被使用。 
  # color: "#42a5f5"
  background_image: "assets/launch_image.png"

  # 以下是可选的参数。去掉注释前面的 #可使参数起作用。

  # image 参数允许你指定在闪屏界面使用的图像。它必须是 png 文件,且应该是用于4倍像素密度的大小。
  #image: assets/splash.png

  # 该属性允许你指定图像作为商标在闪屏界面显示。它必须是 png 文件。现在它只支持 Android 和 iOS 。
  #branding: assets/dart.png

  # 为黑暗模式指定商标图像
  #branding_dark: assets/dart_dark.png

  # 要将商标图像放置在界面底部,可以使用 bottom 、 bottomRight 和 bottomLeft 。如果未指定或者指定了其它值,使用默认值 bottom 。
  # 确保该内容模式值与 android_gravity 值 和 ios_content_mode 值不相似。
  #branding_mode: bottom

  # color_dark 、 background_image_dark 和 image_dark 用于设备在黑暗模式时设置背景色和图像。
  # 如果没有指定,应用会使用上面的参数。如果指定了 image_dark ,必须要指定 color_dark 或 background_image_dark 。
  # color_dark 和 background_image_dark 不能同时设置。
  #color_dark: "#042a49"
  #background_image_dark: "assets/dark-background.png"
  #image_dark: assets/splash-invert.png

  # android 、 ios 和 web 参数可用于不为对应的平台生成闪屏界面。
  #android: false
  #ios: false
  #web: false

  #  可用 android_gravity 、 android_gravity 、 ios_content_mode 和 web_image_mode 来设置闪屏图像的位置。默认是居中。
  #
  # android_gravity 可以是以下 Android Gravity 其中之一 (查看
  # https://developer.android.com/reference/android/view/Gravity): bottom 、 center 、
  # center_horizontal 、 center_vertical 、 clip_horizontal 、 clip_vertical 、 
  # end 、 fill 、 fill_horizontal 、 fill_vertical 、 left 、 right 、 start 或 top 。
  #android_gravity: center
  #
  # ios_content_mode 可以是以下 iOS UIView.ContentMode 其中之一 (查看
  # https://developer.apple.com/documentation/uikit/uiview/contentmode): scaleToFill 、
  # scaleAspectFit 、 scaleAspectFill 、 center 、 top 、 bottom 、
  # left 、 right 、 topLeft 、 topRight 、 bottomLeft 或  bottomRight 。
  #ios_content_mode: center
  #
  # web_image_mode 可以是以下模式其中之一:center 、 contain 、 stretch 和 cover 。
  #web_image_mode: center

  # 要隐藏通知栏,使用 fullscreen 参数 。在 Web 上不起作为,因为 Web 没有通知栏。默认是 false 。
  # 注意: 不像 Android 、 iOS 当应用加载时不会自动显示通知栏。
  #       要显示通知栏,在 Flutter 应用中添加以下代码:
  #       WidgetsFlutterBinding.ensureInitialized();
  #       SystemChrome.setEnabledSystemUIOverlays([SystemUiOverlay.bottom, SystemUiOverlay.top]);
  #fullscreen: true
  
  # 如果改变了 info.plist 的名字,可以使用 info_plist_files 指定对应的文件名。 
  # 只需移除下面三行前面的 # 字符,不要移除任何空格:
  #info_plist_files:
  #  - 'ios/Runner/Info-Debug.plist'
  #  - 'ios/Runner/Info-Release.plist' 

说明一下,上面我的需求就是一张图片当启动图,所以设置了一张图,每个人根据自己的需求进行不同的设置即可。

步骤3:
添加文件之后之后,在命令行终端运行以下命令:

flutter pub run flutter_native_splash:create 

当包完成运行后,你的闪屏界面就准备好了。

要指定 YAML 文件的位置,只需在终端命令后添加 --path:

flutter pub run flutter_native_splash:create --path=path/to/my/file.yaml 

注意上面只是一个示例,就是需要找到自己flutter_native_splash.yaml文件所在的位置,如果不确定的话,可以按如下操作进行获取文件路径,然后把上面命令中“path/to/my/file.yaml”替换成自己文件的路径,获取路径的方法如下图:

如果上面和我这里是一模一样的操作的话,可以直接复制下面的命令进行操作

flutter pub run flutter_native_splash:create --path=flutter_native_splash.yaml

执行效果如下图:

这里就是像上图里面所示的文字要特别说明一下,如果flutter_native_splash.yaml里面的内容有变动更新,建议再次执行一遍上面的命令。

步骤4:
在main.dart进行启动图相关移除和显示时间设置,如下图:

代码如下:

//原生的启动屏幕
import 'package:flutter_native_splash/flutter_native_splash.dart';


void main() {

  WidgetsFlutterBinding.ensureInitialized();

  initialization(null);

  runApp(const MyApp());
}

//启动图延时移除方法
void initialization(BuildContext? context) async {
  //延迟3秒
  await Future.delayed(const Duration(seconds: 3));
  FlutterNativeSplash.remove();
}

同样也可以用下面的方法

默认,闪屏界面在首次绘制 Flutter 时会被移除。如果想要在应用初始化时保持闪屏界面,可以如下使用 removeAfter 方法:

i

mport 'package:flutter_native_splash/flutter_native_splash.dart';

void main() {
  FlutterNativeSplash.removeAfter(initialization);
  // runApp 会运行,但是在初始化完成前不会显示:
  runApp(const MyApp());
}

void initialization(BuildContext context) async {
  // 这里可以在闪屏界面显示时初始化应用所需的资源。
  // 该函数完成后,闪屏界面会被移除。
} 

注意: 为了使用此方法, flutter_native_splash 必须在 pubspec.yaml 的 dependencies 部分里,而不是在 dev_dependencies 里。之前的版本是在推后者里。

提一句如果需要移除的可以执行下面这个命令

flutter pub run flutter_native_splash:remove

到此为止在Flutter中集成和使用flutter_native_splash库的详细步骤就已经全部完成了。

欢迎大家给我点赞分享评论,也欢迎大家随时和我留言或私信交流,更欢迎大家打赏作者支持创作,谢谢大家。

本文由mdnice多平台发布

©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 206,839评论 6 482
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 88,543评论 2 382
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 153,116评论 0 344
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 55,371评论 1 279
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 64,384评论 5 374
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 49,111评论 1 285
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 38,416评论 3 400
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 37,053评论 0 259
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 43,558评论 1 300
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 36,007评论 2 325
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 38,117评论 1 334
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 33,756评论 4 324
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 39,324评论 3 307
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 30,315评论 0 19
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 31,539评论 1 262
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 45,578评论 2 355
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 42,877评论 2 345

推荐阅读更多精彩内容