Flutter未知功能插件jocaaguraarchetype的使用（由于介绍为undefined，故以“未知功能”代称）

Flutter未知功能插件jocaaguraarchetype的使用

摘要

本指南旨在详细介绍如何使用jocaaguraarchetype插件。该插件提供了许多工具类和组件，帮助开发者更方便地管理主题、颜色、响应式布局等。

重要信息

• 等待Flutter修复Color类中已弃用的red, green, 和blue值。

文档索引

• JocaaguraArchetype
• LabColor
• ProviderTheme
• ServiceTheme
• BlocTheme
• BlocLoading
• BlocResponsive

LabColor

LabColor是一个实用类，用于在不同的颜色空间之间转换颜色，特别是从RGB到Lab（CIELAB）。

参数

• lightness: 颜色的亮度。
• a: CIELAB颜色空间中的a分量。
• b: CIELAB颜色空间中的b分量。

示例代码

Color colorRGB = Color.fromARGB(255, 255, 0, 0); // 红色
List<double> labColor = LabColor.colorToLab(colorRGB);
LabColor lab = LabColor(labColor[0], labColor[1], labColor[2]);
LabColor adjustedLab = lab.withLightness(50.0);

ProviderTheme

ProviderTheme作为主题服务与UI界面之间的中介，简化了应用级别的主题应用和颜色操作，确保一致的视觉设计。

示例代码

ColorScheme colorScheme = ColorScheme.light(primary: Color(0xFF00FF00));
TextTheme textTheme = TextTheme(bodyText1: TextStyle(color: Color(0xFF000000)));
ProviderTheme providerTheme = ProviderTheme(ServiceTheme());
ThemeData customTheme = providerTheme.customThemeFromColorScheme(colorScheme, textTheme);

ServiceTheme

ServiceTheme提供了一系列方法来创建和操作主题及颜色。包括将RGB颜色转换为MaterialColor，调整颜色亮度和暗度，以及根据颜色方案生成自定义主题。

示例代码

ServiceTheme serviceTheme = ServiceTheme();
MaterialColor materialColor = serviceTheme.materialColorFromRGB(255, 0, 0); // 红色

BlocTheme

BlocTheme是一个BLoC模块，用于管理应用内的主题状态。它支持动态主题更新，使UI能够适应用户偏好或特定条件，如在亮模式和暗模式之间切换。

示例代码

void main() {
  ColorScheme lightScheme = ColorScheme.light();
  ColorScheme darkScheme = ColorScheme.dark();
  TextTheme textTheme = TextTheme(bodyText1: TextStyle(color: Colors.white));

  bool isDarkMode = true; // 用户偏好
  ThemeData themeToUpdate = isDarkMode
      ? blocTheme.providerTheme.serviceTheme.customThemeFromColorScheme(darkScheme, textTheme, true)
      : blocTheme.providerTheme.serviceTheme.customThemeFromColorScheme(lightScheme, textTheme, false);

  blocTheme._themeDataController.value = themeToUpdate;
}

BlocLoading

BlocLoading是一个BLoC组件，用于管理应用内的加载消息。它提供了一种集中的方式来显示和更新加载状态消息，这有助于向用户传达正在进行的操作。

示例代码

void main() async {
  await blocLoading.loadingMsgWithFuture(
      "Loading data...",
      () async {
        await Future.delayed(Duration(seconds: 2)); // 模拟数据加载操作
      });
}

BlocResponsive

BlocResponsive是用于管理适应性UI的重要组件。这个BLoC帮助处理屏幕大小和组件可见性，确保应用在不同分辨率和设备上进行最佳调整。

示例代码

Widget responsiveWidget = AspectRatio(
  aspectRatio: 16 / 9,
  child: Container(
    width: blocResponsive.widthByColumns(4),
    decoration: BoxDecoration(color: Colors.blue),
  ),
);

完整示例Demo

import 'package:flutter/material.dart';
import 'package:jocaagura_domain/jocaagura_domain.dart';
import 'package:jocaaguraarchetype/jocaaguraarchetype.dart';
import 'package:jocaaguraarchetype/services/service_connectivity.dart';

import 'blocs/bloc_counter.dart';
import 'ui/pages/my_home_page.dart';

final JocaaguraArchetype jocaaguraArchetype = JocaaguraArchetype();

/// 初始化区域
final BlocTheme blocTheme = BlocTheme(
  const ProviderTheme(
    ServiceTheme(),
  ),
);
final BlocConnectivity blocConnectivity = BlocConnectivity(
  ServiceConnectivity(
    const FakeConnectivityProvider(),
    const FakeInternetProvider(),
    debouncer: Debouncer(milliseconds: 1000),
  ),
);
final BlocUserNotifications blocUserNotifications = BlocUserNotifications();
final BlocLoading blocLoading = BlocLoading();
final BlocMainMenuDrawer blocMainMenuDrawer = BlocMainMenuDrawer();
final BlocSecondaryMenuDrawer blocSecondaryMenuDrawer =
    BlocSecondaryMenuDrawer();
final BlocResponsive blocResponsive = BlocResponsive();
final BlocOnboarding blocOnboarding = BlocOnboarding(
  <Future<void> Function()>[
    // 替换为初始配置函数
    () async {
      blocNavigator.addPagesForDynamicLinksDirectory(<String, Widget>{
        MyDemoHomePage.name: const MyDemoHomePage(title: '测试'),
      });
    },
    jocaaguraArchetype.testMe,
    jocaaguraArchetype.testMe,
    jocaaguraArchetype.testMe,
    jocaaguraArchetype.testMe,
    () async {
      blocNavigator.setHomePageAndUpdate(
        const MyHomePage(),
      );
    },
  ],
);
final BlocNavigator blocNavigator = BlocNavigator(
  PageManager(),
  OnBoardingPage(
    blocOnboarding: blocOnboarding,
  ),
);

final AppManager appManager = AppManager(
  AppConfig(
    blocTheme: blocTheme,
    blocUserNotifications: blocUserNotifications,
    blocLoading: blocLoading,
    blocMainMenuDrawer: blocMainMenuDrawer,
    blocSecondaryMenuDrawer: blocSecondaryMenuDrawer,
    blocResponsive: blocResponsive,
    blocOnboarding: blocOnboarding,
    blocNavigator: blocNavigator,
    blocModuleList: <String, BlocModule>{
      BlocCounter.name: BlocCounter(),
      BlocConnectivity.name: blocConnectivity,
    },
  ),
);

void main() {
  runApp(
    JocaaguraApp(
      appManager: appManager,
    ),
  );
}