パッケージ、リポジトリ、アプリカテゴリを検索

flutter_splash_screen のカバー
パッケージ詳細v4.0.0

flutter_splash_screen

Flutter用のスプラッシュスクリーンAPIで、プログラム的にスプラッシュスクリーンを非表示および表示できます。AndroidおよびiOSで動作します。

AndroidiOS
30日間ダウンロード
193
いいね数
70
Pub ポイント
140

パッケージをインストール

flutter pub add flutter_splash_screen

パッケージ概要

公開情報に基づく選定ガイドです。参考としてご利用ください。

AndroidおよびiOSでのスプラッシュスクリーンを制御するためのプログラムAPIを提供するFlutterパッケージです。アプリ起動中にスプラッシュスクリーンを動的に表示・非表示にでき、スムーズな遷移やカスタムスプラッシュロジックを実現できます。ネイティブプラットフォームとシームレスに統合され、追加の構成なしにiOSおよびAndroidの両方をサポートしています。アプリの状態に基づいてスプラッシュスクリーンを条件付きで処理したり、遅延表示が必要なアプリに最適です。

用途

  • ダイナミックスプラッシュ制御
  • アプリの初期化遅延
  • 条件付きスプラッシュ表示
  • オンボーディング統合
  • カスタムスプラッシュトランジション
  • ログイン後のスプラッシュ管理

主な機能

  • プログラムによる表示/非表示
  • Android および iOS サポート
  • 最小限のセットアップ
  • ネイティブプラットフォーム統合
  • 追加の設定は不要です
  • スムーズな遷移処理

適している対象

  • オンボーディングフローを備えたアプリ
  • 遅延スプラッシュを必要とするアプリ
  • 開発者がスプラッシュタイミングを管理しています
  • クロスプラットフォームのスプラッシュが必要
  • 複雑な起動ロジックを持つアプリ

注意事項

  • 完全な機能を実現するにはネイティブプラットフォームのセットアップが必要です
  • スプラッシュ画面のみに制限
  • 複雑なUIオーバーレイには適していません
  • カスタムデザイン用に追加のスタイル設定が必要になる場合があります
  • 正しい初期化順序に依存する

元の README

関連するソースリポジトリの README 原文のスナップショットです。最新の内容はリポジトリをご覧ください。

flutter_splash_screen

Download PRs Welcome flutter_splash_screen release License MIT RN

A splash screen API for flutter which can programatically hide and show the splash screen. Works on Android and iOS.

Content

Changes

Examples

Screenshots Screenshots
flutter_splash_screen-Android flutter_splash_screen-iOS

1. Installation

Depend on it

Run this command:

flutter pub add flutter_splash_screen

2. Plugin Configuration

Android
Update the MainActivity.kt

Update the MainActivity.kt to use flutter_splash_screen via the following changes:

package org.devio.flutter.splashscreen.example

import android.os.Bundle
import io.flutter.embedding.android.FlutterActivity

import org.devio.flutter.splashscreen.SplashScreen // add

class MainActivity : FlutterActivity() {
    override fun onCreate(savedInstanceState: Bundle?) {
        // SplashScreen.show(this) 
        // or enable full screen
        SplashScreen.show(this, true)
        super.onCreate(savedInstanceState)
    }
}
Create launch_screen.xml file

Create a file called launch_screen.xml in app/src/main/res/layout (create the layout-folder if it doesn't exist). The contents of the file should be the following:

<?xml version="1.0" encoding="utf-8"?>
<FrameLayout xmlns:android="http://schemas.android.com/apk/res/android"
    android:layout_width="match_parent" android:layout_height="match_parent"
    android:background="@android:color/white">

    <ImageView android:layout_width="match_parent" android:layout_height="match_parent"
        android:layout_gravity="center|top" android:scaleType="centerCrop"
        android:src="@mipmap/launch_screen" />
</FrameLayout>

Customize your launch screen by creating a launch_screen.png-file and placing it in an appropriate mipmap-folder. Android automatically scales drawable, so you do not necessarily need to provide images for all phone densities. You can create splash screens in the following folders:

  • mipmap-ldpi
  • mipmap-mdpi
  • mipmap-hdpi
  • mipmap-xhdpi
  • mipmap-xxhdpi
  • mipmap-xxxhdpi

Add a color called primary_dark in app/src/main/res/values/colors.xml

<?xml version="1.0" encoding="utf-8"?>
<resources>
    <color name="primary_dark">#000000</color>
</resources>

Optional steps:

If you want the splash screen to be transparent, follow these steps.

Open android/app/src/main/res/values/styles.xml and add <item name="android:windowIsTranslucent">true</item> to the file. It should look like this:


<resources>
    <!-- Base application theme. -->
    <style name="AppTheme" parent="Theme.AppCompat.Light.NoActionBar">
        <!-- Customize your theme here. -->
        <!--设置透明背景-->
        <item name="android:windowIsTranslucent">true</item>
    </style>
</resources>

To learn more see examples

If you want to customize the color of the status bar when the splash screen is displayed:

Create android/app/src/main/res/values/colors.xml and add

<?xml version="1.0" encoding="utf-8"?>
<resources>
    <color name="status_bar_color"><!-- Colour of your status bar here --></color>
</resources>

Create a style definition for this in android/app/src/main/res/values/styles.xml:

<?xml version="1.0" encoding="utf-8"?>
<resources>
    <style name="SplashScreenTheme" parent="SplashScreen_SplashTheme">
        <item name="colorPrimaryDark">@color/status_bar_color</item>
    </style>
</resources>

Change your show method to include your custom style:

SplashScreen.show(this,R.style.SplashScreenTheme);
iOS

Customize your splash screen via LaunchScreen.storyboard,

Learn more to see examples

Usage

Use like so:

import 'dart:async';

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

void main() => runApp(MyApp());

class MyApp extends StatefulWidget {
  @override
  _MyAppState createState() => _MyAppState();
}

class _MyAppState extends State<MyApp> {
  @override
  void initState() {
    super.initState();
    hideScreen();
  }

  ///hide your splash screen
  Future<void> hideScreen() async {
    Future.delayed(Duration(milliseconds: 1800), () {
      FlutterSplashScreen.hide();
    });
  }

  ...

API

Method Type Optional Description
show() function false Open splash screen (Native Method )
hide() function false Close splash screen

Testing

Contribution

Issues are welcome. Please add a screenshot of you bug and a code snippet. Quickest way to solve issue is to reproduce it in one of the examples.

Pull requests are welcome. If you want to change the API or do something big it is best to create an issue and discuss it first.


MIT Licensed

カテゴリー

ソースリポジトリ

このパッケージを使用しているプロジェクト