flutter项目相关

功能介绍#

wechat_kit 插件提供的主要功能包括：

• 微信登录：通过微信授权登录，并获取用户的基本信息。
• 微信支付：集成微信支付功能，支持在应用内发起支付请求。
• 微信分享：支持将文字、图片、链接等内容分享到微信的朋友圈或聊天中。
• 获取用户信息：在授权成功后获取微信用户的详细信息。

使用步骤#

1. 依赖安装

   1
   flutter pub add wechat_kit

2. 配置

   在 pubspec.yaml 文件中添加以下内容：

   1
   wechat_kit:
   2
     #  ios: no_pay # 默认 pay
   3
     app_id: ${your wechat app id}
   4
     universal_link: https://${your applinks domain}/universal_link/${example_app}/wechat/

3. 使用

   1
   import 'package:wechat_kit/wechat_kit.dart';
   2
   
   3
    // 示例：初始化微信 SDK
   4
    Wechat.instance.registerApp(appId: 'your_wechat_app_id');
   5
   
   6
    // 示例：发起微信登录
   7
    void loginWithWeChat() async {
   8
      final result = await Wechat.instance.auth(scope: WechatScope.SNSAPI_USERINFO);
   9
      if (result.isSuccessful) {
   10
        // 登录成功，处理用户信息
   11
      } else {
   12
        // 登录失败，处理错误
   13
      }
   14
    }

注意事项

• 微信开发者账号：要使用微信的这些功能，必须注册微信开发者账号，并在微信开放平台上创建应用，获取 AppID 和 AppSecret。
• 平台配置：使用该插件时，还需要进行一些平台相关的配置，如在 iOS 和 Android 项目中配置微信 SDK。
• Flutter 插件版本：请注意选择合适的插件版本，版本号应与项目的 Flutter SDK 兼容。

通过 wechat_kit，开发者可以方便地将微信的功能集成到 Flutter 应用中，提升应用的用户体验和功能性。

bool debug = !kReleaseMode;#

1
Future<void> initXLog() async {
2
  String imId = Sp.getValue(SpConst.spImId, '');
3
  await XLog.init(remoteDir: 'seeapp', fileName: imId, isAutoUpload: true);
4
  XLog.setFetchSignUrl('https://oneapi.qmpoa.com/api/upload/getUploadSign');
5
}
6
Future init() async {
7
  bool debug = !kReleaseMode;
8
  if (!kDebugMode) await initXLog();
9
  ...
10
}

• kReleaseMode: 编译时常量，为 true 表示是 Release 版本
• initXLog() 初始化日志记录功能

Debug 模式下不需要完全的日志记录，Release 模式下需要日志记录

PaintingBinding.instance.imageCache.maximumSizeBytes = 1000 << 20;#

• PaintingBinding 是 Flutter 框架中处理绘制和渲染相关的类。通过 instance 属性访问 PaintingBinding 的单例实例
• imageCache 是 PaintingBinding 中的一个属性，用于管理图像缓存。它是 ImageCache 类的实例，负责缓存已经加载的图像以提高性能。
• maximumSizeBytes 是 ImageCache 类中的一个属性，用于设置缓存的最大大小（以字节为单位）。当缓存的大小超过这个值时，缓存中的图像将被逐出以释放内存。

作用：增加图像缓存的大小可以提高性能，减少图像重新加载的次数。但这需要平衡内存使用，避免过度使用内存。

WebOffline webOffline = WebOffline();#

1
WebOffline webOffline = WebOffline();
2
webOffline.init();

处理 Web 离线缓存或离线功能

RefreshConfiguration#

1
runApp(RefreshConfiguration(
2
    shouldFooterFollowWhenNotFull: (state) => false,

• RefreshConfiguration 用于配置下拉刷新和上拉加载更多的行为
• shouldFooterFollowWhenNotFull: (state) => false：列表没有填满屏幕时，底部加载更多控件不会跟随列表移动。

OverlaySupport.global(…)#

• OverlaySupport 提供全局覆盖功能的组件，通常用于显示全局通知或弹出层
• OverlaySupport.global 包装器，允许在应用的根级别显示覆盖层内容

GetMaterialApp(…)#

1
GetMaterialApp(
2
  builder: FlutterSmartDialog.init(builder: (context, widget) {
3
    return MediaQuery(
4
      // 设置文字大小不随系统设置改变
5
      data: MediaQuery.of(context).copyWith(textScaleFactor: 1.0),
6
      child: widget!,
7
    );
8
  }),
9
  debugShowCheckedModeBanner: false,
10
  defaultTransition: Transition.cupertino,
11
  navigatorObservers: [
12
    CommonNavigatorObserver(),
13
    NavigatorObserversOfCommonState.instance,
14
  ],
15
  ...
16
  onReady: () {
17
    //测试按钮
18
    // if (CommonLibConfig().commonUtilsParams.isDebug && Get.overlayContext != null)
19
    //   CommonDebug().showDebugBtn(Get.overlayContext!);
20
    if (kDebugMode && Get.overlayContext != null) CommonDebug().showDebugBtn(Get.overlayContext!);
21
  },
22
);

• GetMaterialApp GetX 提供的用于管理路由、状态和其他全局配置的 Material 设计应用程序的根 Widget
• FlutterSmartDialog 用于显示对话框的库
• defaultTransition: Transition.cupertino：设置全局默认的页面过渡效果为 cupertino，这是 iOS 风格的页面过渡动画
• CommonNavigatorObserver 继承自 NavigatorObserver， 用于监听导航事件。通过扩展 NavigatorObserver 来实现自定义的导航行为和记录。
• NavigatorObserversOfCommonState 是一个单例模式的 NavigatorObserver 实例，用于管理公共状态或全局功能。
• onReady 是 GetX 的 GetMaterialApp 中的一个回调函数，用于在应用启动完成后执行初始化操作，如显示调试按钮。
• kDebugMode 用于确定是否在调试模式下执行特定操作，这对于在生产环境中禁用调试功能是很有用的。
• Overlay 是一个在应用上层显示的层，允许在应用中插入浮动的元素。Get.overlayContext 提供了当前的 Overlay 上下文。

initState#

1
void initState() {
2
    super.initState();
3

4
    CommonOperate.nextFrameRefresh(() async {
5
      try {
6
        /// 判断开屏广告显示
7
        bool isShow = SplashAdLogic.showSplash();
8
        if (isShow) await Future.delayed(Duration(milliseconds: 300));
9
      } catch (e) {}
10

11
      ///判断登录
12
      String uuid = Sp.getValue(SpConst.spKeyLoginUserToken, "");
13
      child = LinkRoute.getRoot(uuid);
14
      setState(() {});
15
    });
16

17
    /// 获取开屏广告图片
18
    SplashAdLogic.getData();
19
  }

• CommonOperate.nextFrameRefresh 用于在下一帧更新中执行特定的操作
• await Future.delayed(Duration(milliseconds: 300))： 如果需要显示广告，则等待 300 毫秒。这个延迟可能用于展示广告的时间。
• LinkRoute.getRoot(uuid)： 根据获取的 uuid 决定跳转到应用的哪个根页面。LinkRoute.getRoot 是一个静态方法，返回根页面的 Widget。

_buildLaunch#

1
Widget _buildLaunch() {
2
  return Column(
3
    children: [
4
      const Spacer(),
5
      Padding(
6
        padding: EdgeInsets.only(bottom: 32).safeBottom(),
7
        child: Image.asset('assets/./3.0x/launch_bottom_image.png', width: 252),
8
      ).center(),
9
    ],
10
  );
11
}

_buildLaunch 可以用于创建启动页或引导页。通常，这个页面会在应用启动时显示，并可能包含应用名称、logo 或其他欢迎信息。