Flutter共享类和实用工具插件playx_core的使用

PlayX Core

核心包用于PlayX生态系统，包含共享类和实用工具。

功能

• 依赖注入: 使用GetIt管理您的依赖关系。
• PlayxPrefs: 由SharedPreferences支持的键值存储。
• PlayxSecurePrefs: 由FlutterSecureStorage支持的加密键值存储。
• PlayxAsyncPrefs: 非阻塞操作的异步键值存储。
• PlayxPrefsWithCache: 带有缓存功能的键值存储，以提高性能。
• PlayxEnv: 使用.env文件配置应用程序中的全局变量。
• bootCore函数: 设置和初始化PlayX生态系统的基本组件。

安装

在pubspec.yaml文件中添加playx_core依赖：

dependencies:
  playx_core: ^0.5.4

使用

初始化核心

在main函数中初始化PlayX核心：

void main() async {
  WidgetsFlutterBinding.ensureInitialized();

  // 启动核心
  await PlayxCore.bootCore(
    securePrefsSettings: PlayxSecurePrefsSettings(),
    createPlayxPrefs: true,
    createPlayxAsyncPrefs: true,
    createPlayxPrefsWithCache: true,
  );

  // 运行应用
  runApp(const MyApp());
}

访问GetIt

要使用依赖注入，访问GetIt实例：

// 注册服务
getIt.registerSingleton<MyService>(MyService());

// 获取服务
MyService myService = getIt<MyService>();

使用偏好设置

PlayxPrefs

使用PlayxPrefs存储和检索数据：

// 存储数据
PlayxPrefs.setString('name', 'John Doe');
PlayxPrefs.setInt('age', 25);
PlayxPrefs.setDouble('height', 5.8);

// 检索数据
String name = PlayxPrefs.getString('name');
int age = PlayxPrefs.getInt('age');
double? height = PlayxPrefs.maybeGetDouble('height');

PlayxSecurePrefs

使用PlayxSecurePrefs进行加密存储：

// 安全地存储数据
await PlayxSecurePrefs.setString('secureName', 'Jane Doe');

// 安全地检索数据
String secureName = await PlayxSecurePrefs.getString('secureName');

PlayxAsyncPrefs

使用PlayxAsyncPrefs进行异步键值存储：

// 异步存储数据
await PlayxAsyncPrefs.setString('asyncName', 'Async John');

// 异步检索数据
String asyncName = await PlayxAsyncPrefs.getString('asyncName');

PlayxPrefsWithCache

使用PlayxPrefsWithCache进行带缓存的偏好设置：

// 带缓存地存储数据
await PlayxPrefsWithCache.setString('cachedName', 'Cached Jane');

// 带缓存地检索数据
String cachedName = await PlayxPrefsWithCache.getString('cachedName');

示例代码

以下是一个完整的示例代码，演示如何使用playx_core插件。

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

Future<void> main() async {
  WidgetsFlutterBinding.ensureInitialized();
  await PlayxCore.bootCore();
  runApp(const MyApp());
}

class MyApp extends StatelessWidget {
  const MyApp({super.key});

  // 此小部件是您的应用程序的根。
  [@override](/user/override)
  Widget build(BuildContext context) {
    return MaterialApp(
      title: 'Playx Core',
      theme: ThemeData(
        colorScheme: ColorScheme.fromSeed(seedColor: Colors.deepPurple),
        useMaterial3: true,
      ),
      home: const MyHomePage(title: 'Playx Core'),
    );
  }
}

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

  final String title;

  [@override](/user/override)
  State<MyHomePage> createState() => _MyHomePageState();
}

class _MyHomePageState extends State<MyHomePage> {
  int _counter = PlayxPrefs.getInt('counter', fallback: 0);

  void _incrementCounter() {
    setState(() {
      _counter++;
      PlayxPrefs.setInt('counter', _counter);
    });
  }

  [@override](/user/override)
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(
        backgroundColor: Theme.of(context).colorScheme.inversePrimary,
        title: Text(widget.title),
      ),
      body: Center(
        child: SizedBox(
          height: context.height * .3,
          child: Column(
            mainAxisAlignment: MainAxisAlignment.center,
            children: [
              const Text(
                '你已经按了按钮这么多次：',
              ),
              Text(
                '$_counter',
                style: context.textTheme.headlineMedium,
              ),
            ],
          ),
        ),
      ),
      floatingActionButton: FloatingActionButton(
        onPressed: _incrementCounter,
        tooltip: '增加',
        child: const Icon(Icons.add),
      ),
    );
  }
}