【Flutter】shared_preferences 本地存储 ( 简介 | 安装 shared_preferences 插件

文章目录

一、shared_preferences 本地存储插件简介
二、安装 shared_preferences 插件
三、使用 shared_preferences 流程
四、完整代码示例
五、相关资源

一、shared_preferences 本地存储插件简介

shared_preferences 是 Flutter 提供的本地数据存取插件 ;

在不同的平台 , 基于不同的机制开发 , 如 Android 平台中基于 SharedPreferences 开发 , iOS 平台中基于 NSUserDefaults 开发 ;

访问本地文件是耗时操作 , 因此访问 shared_preferences 存储是一个异步操作 ;

二、安装 shared_preferences 插件

安装 shared_preferences 插件 :

shared_preferences 插件地址 : https://pub.dev/packages/shared_preferences

按照 https://pub.dev/packages/shared_preferences/install 地址的安装教程进行安装 ;

首先 , 在 pubspec.yaml 配置文件中 , 导入插件包 :

dependencies:
  shared_preferences: ^2.0.7

然后 , 下载插件包 , 点击 Pub Get 按钮 , 下载插件包到本工程中 ;

【Flutter】shared_preferences 本地存储 ( 简介 | 安装 shared_preferences 插件 | 使用 shared_preferences 流程 )_android

最后 , 在 Dart 代码中导入如下代码 , 即可使用 shared_preferences ;

import 'package:shared_preferences/shared_preferences.dart';

三、使用 shared_preferences 流程

在完成了上述安装 shared_preferences 插件之后 , 才能开始使用 ;

首先 , 导入插件包 ;

import 'package:shared_preferences/shared_preferences.dart';

然后 , 获取 shared_preferences 实例 ;

final prefs = await SharedPreferences.getInstance();

最后 , 通过上述 shared_preferences 实例可以设置 / 读取存储的键值对数值 ;

/// 设置值
prefs.setInt('counter', counter);

/// 获取值 
final counter = prefs.getInt('counter') ?? 0;}

如果要删除数据 , 调用 shared_preferences 实例的 remove 方法 ;

prefs.remove('counter');

下图是 Flutter 的 SharedPreferences 类提供的所有方法 , 重点关注数据的访问方法 ;

【Flutter】shared_preferences 本地存储 ( 简介 | 安装 shared_preferences 插件 | 使用 shared_preferences 流程 )_android_02

数据存储示例 :

_setValue() async {
    /// 先获取 SharedPreferences 实例
    SharedPreferences prefs = await SharedPreferences.getInstance();
    setState(() {
      textInfo = '保存字符串 " 小王 " 到 shared_preferences 完成';
    });
    /// 将数据保存到 SharedPreferences 中
    await prefs.setString("name", "小王");
  }

数据访问示例 :

_getValue() async {
    /// 先获取 SharedPreferences 实例
    SharedPreferences prefs = await SharedPreferences.getInstance();
    /// 从 SharedPreferences 获取数据
    String? name = await prefs.getString("name");
    setState(() {
      textInfo = '从 shared_preferences 取出数据 " ${name} "';
    });
  }

四、完整代码示例

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

void main() {
  runApp(MyApp());
}

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

  @override
  _MyAppState createState() => _MyAppState();
}

class _MyAppState extends State<MyApp> {

  String textInfo = "点击按钮保存数据到 shared_preferences 中";

  _setValue() async {
    /// 先获取 SharedPreferences 实例
    SharedPreferences prefs = await SharedPreferences.getInstance();
    setState(() {
      textInfo = '保存字符串 " 小王 " 到 shared_preferences 完成';
    });
    /// 将数据保存到 SharedPreferences 中
    await prefs.setString("name", "小王");
  }

  _getValue() async {
    /// 先获取 SharedPreferences 实例
    SharedPreferences prefs = await SharedPreferences.getInstance();
    /// 从 SharedPreferences 获取数据
    String? name = await prefs.getString("name");
    setState(() {
      textInfo = '从 shared_preferences 取出数据 " ${name} "';
    });
  }

  @override
  Widget build(BuildContext context) {
    return MaterialApp(
      home: Scaffold(
        appBar: AppBar(
          title: Text("shared_preferences 数据访问"),
        ),
        body: Column(
          children: [
            Text(textInfo),

            ElevatedButton(
              onPressed: (){
                _setValue();
              },
              child: Text("存储数据到 shared_preferences 中"),
            ),

            ElevatedButton(
              onPressed: (){
                _getValue();
              },
              child: Text("从 shared_preferences 中获取数据"),
            ),

          ],
        ),
      ),
    );
  }
}