基础环境版本
• Flutter version 1.17.0
• Dart version 2.8.1
• node 10+
内置集成功能:
1、状态管理:集成Provider在Flutter项目中,任何页面声明好store,注入lib/providers_config.dart文件内即可使用。
2、页面组件更便捷的接收 路由别名跳转传参,底层已处理无需任何插件支持!简单易用,无学习成本。
3、页面路由跳转容错处理,未声明路由跳转错误,指定跳转到错误页面。能让你第一时间发现低级错误bug,友好提示页面清晰明了。
4、内置全局主题一键换色,只需要配置你的主题颜色,调用方法即可。
5、内置全局浮动调试组件,让你在真机上也能便利的获取错误捕获。
这是项目中一直会使用的结构
lib/
|- components/ # 共用widget组件封装
|- config/ # 全局的配置参数
|- ioc/ # git_it的IOC容器文件
|- provider/ # 全局状态管理
|- pages/ # 页面ui层,每个独立完整的页面
|- AppHomePage/ # APP主体页面
|- SplashPage/ # APP进入时广告页面、欢迎页
|- service/ # 请求接口抽离层
|- routes/ # 定义路由相关文件夹
|- utils/ # 公共方法抽离
|- dio/ # dio底层请求封装safeRequest
|- main.dart # 入口文件
1、全局安装cli插件,确保你的电脑中有node环境。
npm i -g flib-cli // 全局安装插件
// 方式二:手动下载,但没有全局指令功能
git clone https://github.com/tec8297729/flutter_flexible.git
2、打开终端输入以下指定创建项目
flib create // 根据提示步骤往下进行,都有默认参数可直接回车
相关指令介绍
flib create 创建一个flutter项目
flib page <name> 创建一个页面组件
进入项目目录文件夹,初始化安装依赖包以及启用APP(记的开启你的模拟器)
输入以下命令:
npm run initApp // 方式一
// 方式二:手动输入flutter命令
flutter pub get
flutter run
指令也是为了更方便记忆使用,你也可以使用原生flutter指令打包等
集成在项目中的指令如下:
命令 | 说明 |
---|---|
npm start | 启动APP项目,请提前开好模拟器或连接真机 |
npm run build | 打包项目生成APP,会打包安卓和IOS二个版本 |
npm run build:apk | 打包生成安卓的APP文件 |
npm run build:ios | 打包生成IOS的APP文件 |
npm run build:web | 打包生成纯前端web的文件 |
npm run upsdk | 更新sdk版本,全局的flutter和dart版本将更新为最新版本 |
npm run appkey | 验证打包后的安卓apk签名信息 |
启动屏图片修改到指定路径中替换成自己的图片
// 这是安卓启动屏图片路径,默认只添加了一个文件加,需要不同分别率在mipmap-**相应文件夹内添加
android\app\src\main\res\mipmap\splash_bg.png
// 这是IOS启动屏图片路径,LaunchImage**.png都替换成自己的启动屏图片
ios\Runner\Assets.xcassets\LaunchImage.imageset\LaunchImage.png
PS:启动屏欢迎页及广告页面在flutter组件中定制功能,在lib\pages\SplashPage目录中修改
全局Key和全局context都注入存放在IOC容器当中,而IOC容器实现是使用了get_it实现。
使用方式引入ioc/locator.dart 容器实例文件,直接使用你之前已经注入的类方法。
PS:你可以把一些全局的类都可以注入到IOC容器中使用,从而实现页面更加简洁,不需要在某个组件或页面中导入更多的import
import 'package:flexible/ioc/locator.dart' show locator, CommonService; // 引入容器实例
CommonService _commonIoc = locator.get<CommonService>(); // 获取指定IOC容器的方法
_commonIoc.getGlobalContext; // 全局context对象
已经抽离请求组件dio,可直接使用
import 'package:flexible/utils/dio/safeRequest.dart';
// get请求使用方法,同dio组件request方法
getHomeData() async {
Map resData = await safeRequest(
'http://url',
queryParameters: {'version': version},
options: Options(method: 'GET'),
);
}
// post请求
getHomeData() async {
Map resData = await safeRequest(
'http://url',
data: {'version': version}, // 传递参数
options: Options(method: 'POST'),
);
}
别名路由传递参数,在接收过程更便捷利与使用。
1、进入路由配置文件routes/routesData.dart,加入别名传参支持。
// routesData.dart文件
import 'package:flutter/material.dart';
import '../pages/ErrorPage/ErrorPage.dart';
import '../pages/TestDemo/TestDemo.dart';
final Map<String, WidgetBuilder> routesData = {
// 路由/testDemo 添加别名路由传参支持。
'/testDemo': (BuildContext context, {params}) => TestDemo(params: params),
// error路由不加入别名传参功能,
'/error': (BuildContext context, {params}) => ErrorPage(),
};
2、在页面中使用别名跳转,直接使用原生别名跳转方法即可
// 某页面跳转
Navigator.pushNamed(
context,
'/testDemo',
arguments: {'data': 'hello world'}, // 传递参数
);
3、在接收的子页面直接读取params参数变量即可。
// 子页面组件使用及接收
class testDemo extends StatefulWidget {
testDemo({Key key, this.params}) : super(key: key);
final params; // 别名传参接收变量
@override
_testDemoState createState() => _testDemoState();
}
class _testDemoState extends State<testDemo>{
@override
void initState() {
super.initState();
print(widget.params); // 路由别名参数
}
}
1、添加安卓的存储权限申请标签(默认已添加, 可跳过此步),如有删除安卓目录生成过的,请自行添加一下。
安卓权限配置文件 android\app\src\main\AndroidManifest.xml
<manifest xmlns:android="http://schemas.android.com/apk/res/android" package="com.example.flutter_flexible">
<uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE"/>
<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE"/>
<application>...其它配置忽略</application>
</manifest>
2、在lib\components\UpdateAppVersion\getNewAppVer.dart文件中,getNewAppVer方法直接运行更新APP版本,但有少部份需要自己实现,已标注TODO位置,指定APP下载地址和获取新版本的接口替换。
// TODO:替换成自己的获取新版本APP的接口
Map resData = await getNewVersion();
// 模拟参数结构如下 {"code":"0","message":"success","data":{"version":"1.1.0","info":["修复bug提升性能","增加彩蛋有趣的功能页面","测试功能"]}}
UpdateAppVersion(
// TODO: 传入新版本APP相关参数、版本号、更新内容、下载地址等
version: resData['version'] ?? '', // 版本号
info: (resData['info'] as List).cast<String>() ?? [], // 更新内容介绍
// ios是苹果应用商店地址
iosUrl: 'itms-apps://itunes.apple.com/cn/app/id414478124?mt=8',
// 安卓APK下载地址
androidUrl: 'https://www.jonhuu.com/download/aweme.apk',
),
)
3、在指定页面运行 检查APP版本函数,默认在lib\pages\AppHomePage\AppHomePage.dart中,运行检查更新APP函数,你可以指定其它位置运行检查新版本。
import 'package:flexible/components/UpdateAppVersion/UpdateAppVersion.dart' show getNewAppVer;
getNewAppVer(); // 在指定组件页面 执行更新检查
把你的主题配置参数文件放入lib\config\themes文件夹中,然后part到index_theme.dart文件中统一管理,另外还有灰度模式。
案例内容如下:
import 'package:flutter/material.dart';
// 以下你配置的全局主题颜色参数
part 'themeBlueGrey.dart';
part 'themeLightBlue.dart';
part 'themePink.dart';
主题配色具体可以参考是关配色文件 themeBlueGrey.dart等。
在需要替换主题的页面中调用如下:
import 'package:flexible/config/themes/index_theme.dart' show themeBlueGrey; // 主题文件
import 'package:flexible/provider/themeStore.p.dart'; // 全局主题状态管理
ThemeStore _theme = Provider.of<ThemeStore>(context);
_theme.setTheme(themeBlueGrey); // 替换主题,注入主题配置即可
首页灰度模式不需要单独配置主题文件,使用方式如下:
import 'package:flexible/pages/AppHomePage/provider/appHomePageStore.p.dart';
AppHomePageStore appHomePageStore = Provider.of<AppHomePageStore>(context);
appHomePageStore.setGrayTheme(true); // 设置灰度模式
默认监听全局路由页面,只需要添加你的第三方统计埋点即可,如需要某页面tab监听还需要你手动继承类,并且实现相关方法。
具体实现由ana_page_loop插件完成,详细插件文档》》 https://github.com/tec8297729/ana_page_loop
1、先找到如下文件 lib\utils\myAppSetup\anaPageLoopInit.dart,配置第三方统计方法,如果想指定路由不监听处理事件,写入相关路由名称即可。
// 找到如下文件 lib\utils\myAppSetup\anaPageLoopInit.dart
void anaPageLoopInit() {
anaPageLoop.init(
beginPageFn: (name) {
// TODO: 第三方埋点统计开始
},
endPageFn: (name) {
// TODO: 第三方埋点统计结束
},
routeRegExp: ['/appHomePage'], // 过滤路由
debug: false,
);
}
如果你的项目很简单,此时你已经完整了全局埋点处理,只需要添加一下第三方埋点方法即可。
要是你需要独立统计PageView或是Tab组件中页面的,接着往第二步操作。
2、首先提供了二个mixin继承类使用,用在你需要独立统计的页面,并且记得把当前独立统计的页面路由过滤掉,例如/home页面是独立统计四个页面,所以需要过滤整体的/home路由。
PageViewListenerMixin类:用于监听类PageView组件
TabViewListenerMixin类:用于监听类TabBar组件
演示在PageView组件中的使用如下:
// 当前路由页面名称是 /appHomePage
class _AppHomePageState extends State<AppHomePage> with PageViewListenerMixin {
PageController pageController;
@override
void initState() {
super.initState();
pageController = PageController();
}
@override
void dispose() {
pageController?.dispose();
super.dispose();
}
// 实现PageViewListenerMixin类上的方法
@override
PageViewMixinData initPageViewListener() {
return PageViewMixinData(
controller: pageController, // 传递PageController控制器
tabsData: ['首页', '分类', '购物车', '我的中心'], // 自定义每个页面记录的名称
);
}
// 调用如下几个生命周期
@override
void didPopNext() {
super.didPopNext();
}
@override
void didPop() {
super.didPop();
}
@override
void didPush() {
super.didPush();
}
@override
void didPushNext() {
super.didPushNext();
}
@override
Widget build(BuildContext context) {
return Scaffold(
body: PageView(
controller: pageController, // 控制器
children: <Widget>[],
),
// ...
);
}
}