Flutter启动画面插件animated_native_splash的使用

发布于 1周前 作者 nodeper 来自 Flutter

Flutter启动画面插件animated_native_splash的使用

Animated Native Splash 🚀

Maintenance GitHub release likes popularity pub points

Getting Started 🚀

创建一个带有原生动画的启动画面可能看起来是一个巨大的问题，但使用animated_native_splash包可以轻松实现。您只需要一个JSON文件来设置动画对象，我们就可以帮助您将它们带入生活。

Usage 🎨

首先，在您的pubspec.yaml文件中添加animated_native_splash作为开发依赖项。它属于dev_dependencies，因为它是一个命令行工具。

dev_dependencies:
  animated_native_splash: ^1.0.0

然后配置animated_native_splash：

animated_native_splash:

  # 这个包生成原生代码以自定义Flutter的启动画面

  # jsonFile是唯一必需的参数。这是用于设置动画对象的文件。
  jsonFile: assets/splash.json

运行包

添加设置后，在终端中运行以下命令：

flutter pub run animated_native_splash:create

现在等待所有内容完成注入。恭喜，您已经设置了带有动画的原生启动画面！🎉

注意：在Web上，您可能会在调试运行时遇到不良的启动画面效果，但在将网站部署到您选择的任何Web主机后，一切都会恢复正常。

Release Notes 💙

🚀 New Feature
✅ 支持Android
✅ 支持Web

Known Issues 💔

目前没有已知的问题。

Demo 👀

Web


查看在线示例

Mobile

示例代码

以下是一个完整的示例项目，展示了如何使用animated_native_splash。

import 'package:flutter/material.dart';

void main() {
  // 模拟延迟以展示启动画面
  Future.delayed(const Duration(seconds: 4), () {
    runApp(const MyApp());
  });
}

class MyApp extends StatelessWidget {
  const MyApp({Key? key}) : super(key: key);

  @override
  Widget build(BuildContext context) {
    return MaterialApp(
      title: 'Flutter Demo',
      theme: ThemeData(
        primarySwatch: Colors.blue,
      ),
      home: const MyHomePage(title: 'Flutter Demo Home Page'),
    );
  }
}

class MyHomePage extends StatefulWidget {
  const MyHomePage({Key? key, required this.title}) : super(key: key);

  final String title;

  @override
  State<MyHomePage> createState() => _MyHomePageState();
}

class _MyHomePageState extends State<MyHomePage> {
  int _counter = 0;

  void _incrementCounter() {
    setState(() {
      _counter++;
    });
  }

  @override
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(
        title: Text(widget.title),
      ),
      body: Center(
        child: Column(
          mainAxisAlignment: MainAxisAlignment.center,
          children: <Widget>[
            const Text(
              'You have pushed the button this many times:',
            ),
            Text(
              '$_counter',
              style: Theme.of(context).textTheme.headline4,
            ),
          ],
        ),
      ),
      floatingActionButton: FloatingActionButton(
        onPressed: _incrementCounter,
        tooltip: 'Increment',
        child: const Icon(Icons.add),
      ),
    );
  }
}

在这个示例中，Future.delayed模拟了一个启动画面的显示时间。实际应用中，您可以根据需要调整这个延迟时间或移除它以直接进入主界面。

希望这个指南能帮助您成功地使用animated_native_splash为您的Flutter应用添加一个漂亮的启动画面！如果有任何问题，请随时提问。


更多关于Flutter启动画面插件animated_native_splash的使用的实战系列教程也可以访问 https://www.itying.com/category-92-b0.html

Harmonyos Next教程
1 回复

更多关于Flutter启动画面插件animated_native_splash的使用的实战系列教程也可以访问 https://www.itying.com/category-92-b0.html


当然，下面是一个关于如何在Flutter项目中使用animated_native_splash插件来创建启动画面的代码示例。

1. 添加依赖

首先，你需要在pubspec.yaml文件中添加animated_native_splash依赖：

dependencies:
  flutter:
    sdk: flutter
  animated_native_splash: ^2.2.1  # 请注意版本号，确保使用最新版本

然后运行flutter pub get来安装依赖。

2. 配置启动画面

在项目的android/app/src/main/res/drawable目录下创建一个新的XML文件，例如launch_background.xml，用于定义启动背景：

<!-- res/drawable/launch_background.xml -->
<layer-list xmlns:android="http://schemas.android.com/apk/res/android">
    <item>
        <shape android:shape="rectangle">
            <solid android:color="#FFFFFF"/>
        </shape>
    </item>
    <item
        android:top="100dp"
        android:bottom="100dp"
        android:left="100dp"
        android:right="100dp">
        <bitmap
            android:gravity="center"
            android:src="@drawable/your_logo"/>  <!-- 替换为你的Logo图片 -->
    </item>
</layer-list>

确保你已经在android/app/src/main/res/drawable目录下放置了一个名为your_logo.png的图片文件，或者根据实际需要调整文件名和路径。

3. 配置native_splash.yaml

在项目的根目录下创建一个名为native_splash.yaml的文件，用于配置启动画面的参数：

flutter:
  name: Your App Name
  color: "#FFFFFF"  # 启动背景颜色
  image: assets/splash.png  # 启动画面图片，可以是一个Flutter资源图片
  android:
    image_path: "drawable/launch_background"  # 引用上面创建的XML文件
    loading_text: "Loading..."  # 可选的加载文本
    loading_color: "#000000"  # 加载文本颜色
  ios:
    image: assets/splash.png  # iOS启动画面图片
    image_dark_mode: assets/splash_dark.png  # iOS暗模式启动画面图片（可选）

确保你已经在assets目录下放置了splash.png和splash_dark.png（如果需要暗模式）图片文件。

4. 更新MainActivity.kt（Android）

打开android/app/src/main/kotlin/your_package_name/MainActivity.kt文件（或者MainActivity.java，取决于你的项目配置），确保启动画面插件能够正确初始化。如果你使用的是Kotlin，通常不需要手动修改这个文件，插件会自动处理。但如果你需要自定义行为，可以在这里进行。

5. 更新Info.plist（iOS）

对于iOS，你可能需要在Info.plist中添加启动画面的配置，但通常animated_native_splash插件会自动处理这些。如果需要手动配置，可以按照Apple的官方文档进行。

6. 使用插件

在你的main.dart文件中，你可以直接使用AnimatedNativeSplash来控制启动画面的显示和隐藏。但通常情况下，插件会自动处理启动画面的显示，直到你的主应用界面加载完成。

import 'package:flutter/material.dart';
import 'package:animated_native_splash/animated_native_splash.dart';

void main() {
  // 插件会自动处理启动画面，直到runApp被调用
  runApp(MyApp());
}

class MyApp extends StatelessWidget {
  @override
  Widget build(BuildContext context) {
    return MaterialApp(
      home: Scaffold(
        appBar: AppBar(
          title: Text('Flutter Demo'),
        ),
        body: Center(
          child: Text('Hello, World!'),
        ),
      ),
    );
  }
}

总结

以上步骤展示了如何在Flutter项目中使用animated_native_splash插件来创建和配置启动画面。这个插件大大简化了启动画面的配置过程，使得开发者可以专注于应用的核心功能。如果你需要更多高级配置，请查阅animated_native_splash的官方文档。

回到顶部