鸿蒙NEXT+Flutter开发7-存储应用设置项
存储设置项可以让应用记住用户的个性化偏好。例如,用户可以根据自己的习惯设置应用的主题(如亮色模式或暗色模式)、字体大小、语言等。当用户下次打开应用时,这些设置能够自动应用,提供熟悉且舒适的使用体验。如果没有存储这些设置,用户每次打开应用都需要重新配置,这会极大地影响用户体验。 另外,APP要上架应用市场,在第一次下载并进入首页前,需要展示用户协议和隐私政策提醒,同意之后,之后运行就不需要提醒,这就需要记录一下,APP是否是第一次运行。
1.GetX与shared_preferences插件
GetX 是一个功能强大的 Flutter 插件,它提供了状态管理、路由管理、依赖注入等多种功能。其主要优势在于简单易用、性能高效,可以大大简化 Flutter 应用的开发流程。GetX插件作为一款纯dart语言实现的插件,在鸿蒙NEXT系统中可以直接使用。 Flutter插件中,能够提供存储功能的有很多,笔者更推荐使用shared_preferences进行简单设置的存储。鸿蒙NEXT社区对该插件做了适配工作,使其可以应用于鸿蒙NEXT系统。
插件配置
在pubspec.yaml中添加下面的代码,加入getx和shared_preferences的引用:
get: ^4.6.5
shared_preferences:
git:
url: "https://gitee.com/openharmony-sig/flutter_packages.git"
path: "packages/shared_preferences/shared_preferences"
同步插件
在终端输入如下命令,同步新加入的插件:
flutter pub get
2.存储功能的代码实现
我们中lib目录下新建common目录,将一些常用功能实现放入其中。其中再新建services目录存放服务功能,store目录里保存存储相关功能的文件。目录结构如下图所示:
其中services.dart主要功能为导出所有服务项,代码如下:
library services;
export './storage.dart';
storage.dart提供了基础的存储服务,代码如下:
import 'package:get/get.dart';
import 'package:shared_preferences/shared_preferences.dart';
class StorageService extends GetxService {
static StorageService get to => Get.find();
late final SharedPreferences _prefs;
Future<StorageService> init() async {
_prefs = await SharedPreferences.getInstance();
return this;
}
Future<bool> setString(String key, String value) async {
return await _prefs.setString(key, value);
}
Future<bool> setBool(String key, bool value) async {
return await _prefs.setBool(key, value);
}
Future<bool> setList(String key, List<String> value) async {
return await _prefs.setStringList(key, value);
}
String getString(String key, {String def = ""}) {
return _prefs.getString(key) ?? def;
}
bool getBool(String key, {bool def = false}) {
return _prefs.getBool(key) ?? def;
}
List<String> getList(String key, {List<String> def = const []}) {
return _prefs.getStringList(key) ?? def;
}
Future<bool> remove(String key) async {
return await _prefs.remove(key);
}
}
store.dart代码如下:
library store;
export './config.dart';
config.dart提供配置项管理功能,代码如下:
import 'package:get/get.dart';
import '../services/storage.dart';
class ConfigStore extends GetxController {
static ConfigStore get to => Get.find();
// 用户是否第一次打开app
static const String keyStorageIsFirstOpen = 'is_first_open';
bool _isFirstOpen = true;
bool get isFirstOpen => _isFirstOpen;
// 标记用户已打开APP
Future<bool> saveAlreadyOpen() {
return StorageService.to.setBool(keyStorageIsFirstOpen, false);
}
@override
void onInit() {
super.onInit();
_isFirstOpen = StorageService.to.getBool(keyStorageIsFirstOpen, def: true);
}
}
3.存储功能的初始化
通过上面的步骤,存储的功能已经实现了。在main.dart中,添加下面的代码,将对存储功能进行初始化,以便后期调用对应的功能。
import 'common/services/services.dart';
import 'common/store/store.dart';
Future init() async {
WidgetsFlutterBinding.ensureInitialized();
// 初始化存储服务
await Get.putAsync<StorageService>(() => StorageService().init());
// 创建配置库
Get.put<ConfigStore>(ConfigStore());
}
void main() async {
await init();
runApp(const MyApp());
}
本章简单介绍了为什么要存储设置项、GetX与shared_preferences插件配置,以及存储功能的实现与初始化。接下来的文章继续结合GetX插件,利用上面的配置项存储功能,实现用户协议和隐私政策提醒页面。