YHFlutterAdapter 开源项目教程-CSDN博客

本文链接：https://blog.csdn.net/gitblog_00370/article/details/142409634

YHFlutterAdapter 开源项目教程

YHFlutterAdapter Componentized Flutter requires only three lines of code! 三行代码组件化集成 Flutter！可用于已有 iOS 项目，对原工程无侵入，无需更改原项目配置，集成后可直接以组件形式开发 Flutter 业务。项目地址: https://gitcode.com/gh_mirrors/yh/YHFlutterAdapter

一、项目目录结构及介绍

YHFlutterAdapter 是一个旨在简化 Flutter 与原生 Android（Java 或 Kotlin）以及 iOS（Swift 或 Objective-C）进行交互的库。该项目精心设计了其目录结构，以保证开发者可以高效地理解和集成。以下是主要的目录结构及简要介绍：

lib: 此目录包含了 Flutter 部分的主要代码。对于使用 YHFlutterAdapter 的开发者来说，重点在于如何在这里调用原生方法或提供给原生的方法。
android: 包含了与 Android 平台相关的所有代码。进一步地，你会看到以下子目录：
- src/main/java/com/example/yhflutteradapter: 这里放置了与 Android 原生交互的核心 Java 类。通常包括桥接 Flutter 和原生逻辑的类。
ios/Classes: 对应于 iOS 平台的实现部分，这里包含了 Swift 或 Objective-C 文件，用于处理与 Flutter 的通信。
example: 提供了一个示例应用，演示如何在实际项目中使用 YHFlutterAdapter。这是学习和测试功能的好地方。

二、项目的启动文件介绍

Flutter 启动文件

在 example 目录下的 main.dart 是 Flutter 示例应用的入口点。它展示了如何初始化 YHFlutterAdapter，并可能调用原生方法。此文件是了解如何在 Flutter 端发起与原生交互的关键。

void main() => runApp(MyApp());

此处的 MyApp() 将初始化 Flutter 界面，并可能通过 YHFlutterAdapter 桥接来执行原生操作。

Android 启动文件

在 android/app/src/main/java/com/your_package_name 中的 MainActivity.java 通常是 Android 应用的启动点。虽然直接与 YHFlutterAdapter 初始化相关的内容可能不在该文件的表面逻辑中显示，但它是确保 Flutter 与 Android 正确集成的地方。

iOS 启动文件

对于iOS，启动流程更多地与Xcode项目配置相关，而不是单一的“启动文件”。然而，关键的初始化逻辑可能发生在 AppDelegate.swift 中，通过在那里设置 FlutterEngine 并注册任何必要的原生插件。

三、项目的配置文件介绍

pubspec.yaml (Flutter)

在项目根目录下的 pubspec.yaml 文件是 Flutter 项目配置的核心。它定义了项目的依赖、版本信息和一些元数据。对于 YHFlutterAdapter 用户而言，重要的是添加库的依赖项：

dependencies:
  flutter:
    sdk: flutter
  yh_flutter_adapter: ^latest_version

这里的 yh_flutter_adapter 表示项目依赖，latest_version 应替换为实际发布的最新版本号。

AndroidManifest.xml

位于 android/app/src/main 目录下，这个文件控制着Android应用的基础属性，如应用ID、允许的权限、启动Activity等。在使用YHFlutterAdapter时，可能不需要对这个文件做特别的修改，除非有特定的原生需求。

Info.plist (iOS)

在iOS项目中，ios/Runner/Info.plist 文件存储了应用的元数据，包括应用名称、图标等。使用YHFlutterAdapter通常不会直接修改此文件，但如果涉及特定权限或应用标识符，则需关注。

以上就是YHFlutterAdapter项目的基本结构、启动文件和配置文件简介，帮助您快速上手并理解项目的整体框架。