flutter 目录结构介绍
着重几个文件夹
android | android 平台相关代码 |
---|---|
ios | ios 平台相关代码 |
lib | flutter相关代码,我们主要编写的代码就在这个文件夹下 |
test | 用于存放测试代码 |
pubspec.yaml | 配置文件,一般存放一些第三方库的依赖。 |
以 计数器例子 为例子分析
flutter 入口文件、方法
每一个 flutter 项目的 lib 目录里面都有一个 main.dart ,这个文件就flutter的入口文件。
// 导入Material UI组件库。
// Material是一种标准的移动端和web端的视觉设计语言, Flutter默认提供了一套丰富的Material风格的UI组件。
import "package:flutter/material.dart";
// main() 定义入口函数
// 与C/C++、Java类似,Flutter 应用中main函数为应用程序的入口。
// main函数中调用了runApp 方法,它的功能是启动Flutter应用。
// runApp它接受一个Widget参数,在本示例中它是一个MyApp对象,MyApp()是Flutter应用的根组件。
void main() {
// runApp() 系统函数,用来执行组件渲染
// MyApp是一个组件,它的命名是系统规定好的,不过也可以修改,但是要一并修改。
// MyApp是一个静态组件,最外层的组件,在 MyApp 这个组件中,很多都是规定好的。
runApp(MyApp());
}
// 简写:
void main() => runApp(MyApp());
main() 是 dart 的入口函数,runApp() 是 flutter 的入口方法。 MyApp 是自定义的一个组件,MyApp()是该组件的实例。
MyApp 组件
MyApp
类代表Flutter应用,它继承了 StatelessWidget
类,这也就意味着应用本身也是一个widget。
在Flutter中,大多数东西都是widget(后同“组件”或“部件”),包括对齐(alignment)、填充(padding)和布局(layout)等,它们都是以widget的形式提供。
import "package:flutter/material.dart";
void main() => runApp(MyApp());
class MyHomePage extends StatelessWidget {
// Flutter在构建页面时,会调用组件的build方法,build是一个系统规定好的渲染函数,
// widget的主要工作是提供一个build()方法来描述如何构建UI界面(通常是通过组合、拼装其它基础widget)。
// 返回值是一个组件, Widget是返回值的类型。
@override
Widget build(BuildContext context) {
// MaterialApp是Material库中提供的Flutter APP框架,
// 通过它可以设置应用的名称、主题、语言、首页及路由列表等。 MaterialApp也是一个widget。
return new MaterialApp(
title: 'Flutter Demo', //应用名称
theme: new ThemeData( // 主题配置
primaryColor: Colors.green[700],
primarySwatch: Colors.blue,
),
//Flutter应用的首页路由,它也是一个widget。
home: new MyHomePage(title: '计数器 demo'),
);
}
}
MyHomePage 首页组件
// 无状态组件
class MyHomePage extends StatelessWidget {
@override
Widget build(BuildContext context) {
return Center(
child: Text('hello f1lutter', textDirection: TextDirection.ltr),
);
}
}
// 有状态组件
class MyHomePage extends StatefulWidget {
MyHomePage({Key key, this.title}) : super(key: key);
final String title;
@override
_MyHomePageState createState() => new _MyHomePageState();
}
class _MyHomePageState extends State<MyHomePage> {
...
}
MyHomePage
是Flutter应用的首页,它继承自StatefulWidget
类,表示它是一个有状态的组件(Stateful widget)。后边将会详讲Widget,现在我们只需简单认为有状态的组件(Stateful widget) 和无状态的组件(Stateless widget)有两点不同:
- Stateful widget可以拥有状态,这些状态在widget生命周期中是可以变的,而Stateless widget是不可变的。
- Stateful widget至少由两个类组成:
- 一个
StatefulWidget
类。 - 一个
State
类;StatefulWidget
类本身是不变的,但是State
类中持有的状态在widget生命周期中可能会发生变化。
- 一个
_MyHomePageState
类是MyHomePage
类对应的状态类。看到这里,读者可能已经发现:和MyApp
类不同, MyHomePage
类中并没有build
方法,取而代之的是,build
方法被挪到了_MyHomePageState
方法中,至于为什么这么做,先留个疑问,在分析完完整代码后再来解答。
State 类
接下来,我们看看_MyHomePageState
中都包含哪些东西:
(1)该组件的状态。由于我们只需要维护一个点击次数计数器,所以定义一个_counter
状态:
// 定义一个状态值,用于记录按钮点击的总次数。
int _counter = 0; // _counter 为保存屏幕右下角带“+”号按钮点击次数的状态。
(2)设置状态的自增函数。
void _increaseCounter() {
setState(() {
_counter++;
});
}
当按钮点击时,会调用此函数,该函数的作用是先自增_counter
,然后调用setState
方法。setState
方法的作用是通知Flutter框架,有状态发生了改变,Flutter框架收到通知后,会执行build
方法来根据新的状态重新构建界面, Flutter 对此方法做了优化,使重新执行变的很快,所以你可以重新构建任何需要更新的东西,而无需分别去修改各个widget。
(3)构建UI界面构建UI界面的逻辑在build
方法中,当MyHomePage
第一次创建时,_MyHomePageState
类会被创建,当初始化完成后,Flutter框架会调用Widget的build
方法来构建widget树,最终将widget树渲染到设备屏幕上。所以,我们看看_MyHomePageState
的build
方法中都干了什么事:
Widget build(BuildContext context) {
return Scaffold(
appBar: AppBar(
title: Text('${widget.title}'),
),
body: Center(
child: Column(
mainAxisAlignment: MainAxisAlignment.center,
children: <Widget>[
Text('You have pushed the button this many times:'),
Text(
'$_counter',
style: TextStyle(
color: Theme.of(context).primaryColor, // 使用主题色
fontSize: 30,
),
),
],
),
),
floatingActionButton: FloatingActionButton(
onPressed: _increaseCounter, //传入自增函数
tooltip: 'increse button',
child: Icon(Icons.add),
),
);
}
Scaffold
是 Material 库中提供的页面脚手架,它提供了默认的导航栏、标题和包含主屏幕widget树(后同“组件树”或“部件树”)的body
属性,组件树可以很复杂。本书后面示例中,路由默认都是通过Scaffold
创建。body
的组件树中包含了一个Center
组件,Center
可以将其子组件树对齐到屏幕中心。此例中,Center
子组件是一个Column
组件,Column
的作用是将其所有子组件沿屏幕垂直方向依次排列; 此例中Column
子组件是两个Text
,第一个Text
显示固定文本 “You have pushed the button this many times:”,第二个Text
显示_counter
状态的数值。floatingActionButton
是页面右下角的带“+”的悬浮按钮,它的onPressed
属性接受一个回调函数,代表它被点击后的处理器,本例中直接将_incrementCounter
方法作为其处理函数。
现在,我们将整个计数器执行流程串起来:当右下角的floatingActionButton
按钮被点击之后,会调用_increaseCounter
方法。在_increaseCounter
方法中,首先会自增_counter
计数器(状态),然后setState
会通知Flutter框架状态发生变化,接着,Flutter框架会调用build
方法以新的状态重新构建UI,最终显示在设备屏幕上。
为什么要将build方法放在State中,而不是放在StatefulWidget中?
现在,我们回答之前提出的问题,为什么build()
方法放在State(而不是StatefulWidget
)中 ?这主要是为了提高开发的灵活性。如果将build()
方法放在StatefulWidget
中则会有两个问题:
(1)状态访问不便
试想一下,如果我们的StatefulWidget
有很多状态,而每次状态改变都要调用build
方法,由于状态是保存在State中的,如果build
方法在StatefulWidget
中,那么build
方法和状态分别在两个类中,那么构建时读取状态将会很不方便!试想一下,如果真的将build
方法放在StatefulWidget中的话,由于构建用户界面过程需要依赖State,所以build
方法将必须加一个State
参数,大概是下面这样:
Widget build(BuildContext context, State state){
//state.counter
...
}
这样的话就只能将State的所有状态声明为公开的状态,这样才能在State类外部访问状态!但是,将状态设置为公开后,状态将不再具有私密性,这就会导致对状态的修改将会变的不可控。但如果将build()
方法放在State中的话,构建过程不仅可以直接访问状态,而且也无需公开私有状态,这会非常方便。
(2)继承StatefulWidget
不便
例如,Flutter中有一个动画widget的基类AnimatedWidget
,它继承自StatefulWidget
类。AnimatedWidget
中引入了一个抽象方法build(BuildContext context)
,继承自AnimatedWidget
的动画widget都要实现这个build
方法。现在设想一下,如果StatefulWidget
类中已经有了一个build
方法,正如上面所述,此时build
方法需要接收一个state对象,这就意味着AnimatedWidget
必须将自己的State对象(记为_animatedWidgetState)提供给其子类,因为子类需要在其build
方法中调用父类的build
方法,代码可能如下:
class MyAnimationWidget extends AnimatedWidget{
@override
Widget build(BuildContext context, State state){
//由于子类要用到AnimatedWidget的状态对象_animatedWidgetState,
//所以AnimatedWidget必须通过某种方式将其状态对象_animatedWidgetState
//暴露给其子类
super.build(context, _animatedWidgetState)
}
}
这样很显然是不合理的,因为
AnimatedWidget
的状态对象是AnimatedWidget
内部实现细节,不应该暴露给外部。- 如果要将父类状态暴露给子类,那么必须得有一种传递机制,而做这一套传递机制是无意义的,因为父子类之间状态的传递和子类本身逻辑是无关的。
综上所述,可以发现,对于StatefulWidget
,将build
方法放在State中,可以给开发带来很大的灵活性。
组件树
Flutter 创建App的时候,所有的组件最后会生成一个组件树。
void main() {
runApp(MyApp());
}
class MyApp extends StatelessWidget {
@override
Widget build(BuildContext context) {
return MaterialApp(
title: 'Flutter Demo',
theme: ThemeData(),
home: Scaffold(
appBar: AppBar(),
body: Center(
child: Text('hello flutter'),
),
),
);
}
}
生成的组件树如下:
一定要记住 组件树 的概念,这对性能优化、事件(点击、消息等)传递、组件布局等 极其重要。