Flutter 入门实例 - 好文

Dart4Flutter -01 – 变量, 类型和函数 <https://juejin.im/post/5b2bafdaf265da597c772819>

Dart4Flutter – 02 –控制流和异常 <https://juejin.im/post/5b2c4d3151882574957a721b>

Dart4Flutter – 03 – 类和泛型 <https://juejin.im/post/5b2c55e9e51d4558aa04f8f4>

Dart4Flutter – 04 – 异步和库 <https://juejin.im/post/5b2c67a351882574a756f2eb>

Dart4Flutter -拾遗01 - flutter-dart环境搭建
<https://juejin.im/post/5b2c8993f265da59a401f03c>

flutter入门 - 状态管理 <https://juejin.im/post/5b2ded226fb9a00e8c443d9f>

Flutter 入门实例1 <https://juejin.im/post/5b31d776e51d455e2b5ab253>

Flutter 入门-本地访问-MethodChannel <https://juejin.im/post/5b35a75e51882574ea3a25e3>

自从10年前Android和iOS出现，在移动开发界，跨平台开发一直是一个目标。一个跨平台的应用可以帮助公司和团队节省大量的时间和精力。

过去这些年，已经发布了很多跨平台的开发工具，包括来自adobe基于web的PhoneGap,来自Microsoft的Xamarin，来自Facebook的React
Native。

最近进入跨平台界的工具是来自google的flutter，现在已经发布了第一个预览版。flutter拥有开发效率高、UI渲染快，更容易的自定义组件、和在两个平台上和本地应用一样的性能。

<>介绍

flutter应用是用dart语言开发的，Dart和其他语言，例如Kotlin
Swift一样，拥有很多共同的语言特性，而且可以转化为JavaScript代码。

作为一个跨平台框架，flutter非常像React Native，例如flutter支持响应式和声明是编程。但是和React
Native不一样的是，flutter不需要JavaScript桥接，这样可提升整个应用的性能和应用启动的时间。Dart是通过AOT技术取得了上述的表现。

另一方面，拥有JIT的Flutter，支持在开发期间，不需要从头构建整个应用，就可以刷新UI，提供开发效率。

正如本教程将要展示的，flutter框架是建立在组件思想之上的。在flutter中，组件不单单指应用的视图，而是整个界面甚至是真个应用。

除了开发跨Android和iOS应用，学习flutter将给你一个在Fuchsia平台开发的超前开始。Fuchsia是google开发中的实验性的操作系统。

本教程，我们构建一个app，首先从github api中获取一个组织的成员信息，然后将成员信息展示在一个滚动列表中。

当开发app时，可是使用Android模拟器、iOS模拟器或者同时使用。

在构建app时，我们将学习flutter一下内容：

* 配置开发环境
* 创建工程
* Hot reload
* 引入文件和库
* 使用组件和创建自己的组件
* 创建网络请求
* 在列表中展示列表项
* 添加应用主题
有也将顺便学习一点Dart。
<>开始

Flutter开发可以在macOS，Linux或Windows上完成。虽然您可以在Flutter工具链中使用任何编辑器，但IntelliJ
IDEA，Android Studio和Visual Studio Code的IDE插件可以简化开发工作。我们将在本教程中使用Android Studio。

<>配置开发环境

您可以在这找到配置flutter开发环境的说明，具体步骤因平台而异，但主要步骤是：

* 下载flutter SDK,地址
<https://storage.googleapis.com/flutter_infra/releases/beta/windows/flutter_windows_v0.5.1-beta.zip>
* 将flutter的bin目录添加到path中
* 执行flutter doctor命令，他会安装flutter框架，包括dart，而且提示你任何其他需要安装的依赖。
* 安装其他依赖
* 在IDE中安装flutter插件
* 测试驱动应用
Flutter网站上提供的说明做得非常好，并允许您在所选平台上轻松设置开发环境。本教程的其余部分假设您已经为Flutter开发设置了Android
Studio，并且您已经解决了flutter doctor发现的任何问题。
<>创建工程

* 如下所示选择File->new->new Flutter Project

* 如下所示选择Flutter Application,点击next.

* 如下如所示填写项目名称、Flutter SDK的路径、项目存储目录。

在Android Studio中，您会在左侧看到一个显示项目结构的面板。有iOS和Android的文件夹，以及包含main.dart的lib文件夹。
您将本教程中的只在lib文件夹中工作。

将main.dart中的代码替换为以下内容：
import 'package:flutter/material.dart'; void main() => runApp(new
GHFlutterApp()); class GHFlutterApp extends StatelessWidget { @override Widget
build(BuildContext context) { return new MaterialApp( title: 'GHFlutter', home:
new Scaffold( appBar: new AppBar( title: new Text('GHFlutter'), ), body: new
Center( child: new Text('GHFlutter'), ), ), ); } }
顶部附近的main()函数使用=>运算符,为了单行函数运行应用程序。您有一个名为GHFlutterApp的应用程序。
你在这里看到你的应用程序本身是一个StatelessWidget(无状态组件)。Flutter应用程序中的大多数实体都是组件，无论是无状态的还是有状态的。
您重写组件的build()方法来创建您的应用的组件。您正在使用MaterialApp 组件，该组件提供了大量遵循Material Design规范应用组件。

对于本入门教程，通过选择它并敲击Delete键，从项目中删除test文件夹中的测试文件widget_test.dart。

你可以在macOS上，启动iOS模拟器。您也可以在macOS，Linux或Windows上使用Android模拟器。

您看到的慢速模式banner表示应用程序正在以调试模式运行。

您可以通过单击Android Studio窗口顶部工具栏右侧的停止按钮来停止正在运行的应用程序：

<>Hot Reload

flutter支持Hot Reload 功能。flutter中的Hot reload和Android Studio的Instant Run类似。
构建并运行应用程序，使其在模拟器或模拟器上运行：

现在，不停止正在运行的应用程序，将应用程序栏字符串更改为其他内容：
appBar: new AppBar( title: new Text('GHFlutter App'), ),
现在单击工具栏上的热重新加载按钮：

在一两秒钟内，您会看到正在运行的应用程序中反映了变化的内容：

由于Flutter处于开发阶段，热重新加载功能可能无法正常工作，但总体而言，在构建UI时节省时间。

<>引入文件

您不需要将所有的Dart代码保存在一个main.dart文件中，而是希望能够从您创建的其他类中导入。
现在您将看到一个用于导入字符串的示例，这将有助于您应用的本地化。
在lib文件夹中右键单击并选择New File创建一个名为strings.dart的文件：
在新建的文件中添加如下类：
class Strings { static String appTitle = "GHFlutter"; }
在main.dart的顶部添加如下引入：
import 'strings.dart';
如下更新应用的title：
return new MaterialApp( title: Strings.appTitle,
更新其他的字符串，使用新的字符串文件，所以最终GHFlutterApp类如下：
class GHFlutterApp extends StatelessWidget { @override Widget
build(BuildContext context) { return new MaterialApp( title: Strings.appTitle,
home: new Scaffold( appBar: new AppBar( title: new Text(Strings.appTitle), ),
body: new Center( child: new Text(Strings.appTitle), ), ), ); } }
构建并运行应用程序，您应该看不到任何变化，但现在您正在使用字符串文件中的字符串。

<>组件

几乎Flutter应用程序的每个元素都是一个组件。组件被设计成不可变的，因为使用不可变组件有助于保持应用程序UI的轻量级。

您将使用两种基本类型的组件：

Stateless: 仅依赖于自己的配置信息的组件，例如图像视图中的静态图像
Stateful: 需要维护动态信息的组件，并通过与状态对象交互来实现
无状态和有状态的组件在每个帧的Flutter应用程序中重绘，不同之处在于有状态组件将其配置委托给状态对象。

要开始制作自己的组件，请在main.dart的底部创建一个新类：
class GHFlutter extends StatefulWidget { @override createState() => new
GHFlutterState(); }
你已经创建了一个StatefulWidget子类，并且你重写了createState()方法来创建它的状态对象。
现在在GHFlutter上添加一个GHFlutterState类：
class GHFlutterState extends State<GHFlutter> { }
GHFlutterState使用GHFlutter的参数扩展状态。

制作新组件时的主要任务是重写在组件呈现在屏幕上时调用的build()方法。

重写GHFlutterState 的build()方法:
@override Widget build(BuildContext context) { }
最终如下：
@override Widget build(BuildContext context) { return new Scaffold ( appBar:
new AppBar( title: new Text(Strings.appTitle), ), body: new
Text(Strings.appTitle), ); }
Scaffold 是material design组件的容器。它充当组件层次结构的根。
您已将AppBar和一个body添加到scaffold中，并且每个都包含一个Text组件

更新GHFlutterApp，以便它使用新的GHFlutter组件作为其home属性，而不是构建默认的scaffold：
class GHFlutterApp extends StatelessWidget { @override Widget
build(BuildContext context) { return new MaterialApp( title: Strings.appTitle,
home: new GHFlutter(), ); } }
构建并运行应用程序，您将看到新的组件正在运行:

现在还没有多少变化，但是现在你已经开始构建新的组件。

<>网络请求

之前，您将自己的strings.dart文件导入到项目中。您可以同样导入Flutter框架的其他库或者Dart的库。

例如，您现在将使用框架中的库来进行HTTP网络调用，并将生成的JSON响应解析为Dart对象。在main.dart的顶部添加两个新的引入：
import 'dart:convert'; import 'package:flutter/material.dart'; import
'package:http/http.dart' as http; import 'strings.dart';
您会看到当前未使用的指标在引入上。

Dart应用程序是单线程的，但Dart支持在其他线程上运行代码以及运行异步代码，通过使用async/await模式,从而不会阻止UI线程。

您将进行异步网络调用以检索GitHub组织成员列表。在GHFlutterState顶部添加一个空List作为属性，并添加一个属性来保存文本样式(
_biggerFont)：
var _members = []; final _biggerFont = const TextStyle(fontSize: 18.0);
名字以下划线开头的变量表示类的私有成员变量。
要进行异步HTTP调用，请在GHFlutterState中添加一个_loadData()方法：
_loadData() async { String dataURL =
"https://api.github.com/orgs/raywenderlich/members"; http.Response response =
await http.get(dataURL); setState(() { _members = JSON.decode(response.body);
}); }
您已将async关键字添加到_loadData()中，以告诉Dart它是异步的，但是http.get()的await关键字表示阻塞执行。通过dataUrl
设置API的请求地址。

当HTTP调用完成时，您将回调传递给在UI线程上同步运行的setState()。这时，您解码JSON响应并将其赋值给_members变量。
在GHFlutterState中重写initState方法，在initState中调用_loadData()
方法。当组件状态初始化时，_loadData()会被调用，加载数据。
@override void initState() { super.initState(); _loadData(); }
<>使用 ListView

现在您已经有了成员列表，您需要一种方法在列表UI中显示它们。 Dart提供了一个ListView组件，可让您在列表中显示数据。
ListView的作用类似于Android上的RecyclerView和iOS上的UITableView，通过重复回收利用以后的view，使列表滚动更加顺滑。
在GHFlutterState中添加_buildRow()方法：
Widget _buildRow(int i) { return new ListTile( title: new
Text("${_members[i]["login"]}", style: _biggerFont) ); }
您将返回一个ListTile组件，该组件显示第iJSON成员的"login"值，还使用您之前创建的文本样式(_biggerFont)。

更新build方法,使body属性值为ListView.builder：
body: new ListView.builder( padding: const EdgeInsets.all(16.0), itemCount:
_members.length, itemBuilder: (BuildContext context, int position) { return
_buildRow(position); }),
您已添加padding，将itemCount设置为成员数量，设置itemBuilder调用_buildRow()，传递postion变量。

您可以尝试热重新加载，但可能会收到"Full restart may be required"的消息。如果是这样，重启：

发起网络请求，解析数据，并在列表中显示结果是很容易的！

<>添加分割线

为了在列表中增加分割线，需要翻倍list的itemCount属性，然后list中的position为偶数时返回Divider组件。
body: new ListView.builder( itemCount: _members.length * 2, itemBuilder:
(BuildContext context, int position) { if (position.isOdd) return new
Divider(); final index = position ~/ 2; return _buildRow(index); }),

一定要itemCount翻倍，因为增加了分割线，所以删除padding。在itemBuilder中，返回Divider组件，或者通过整数除法计算一个新的index，利用_buildRow(index)返回一个组件。

尝试重新加载，你应该在列表中看到分割线：

要在每行中添加padding，可以在_buildRow()中使用Padding组件：
Widget _buildRow(int i) { return new Padding( padding: const
EdgeInsets.all(16.0), child: new ListTile( title: new
Text("${_members[i]["login"]}", style: _biggerFont) ) ); }
ListTile现在是Padding的子部件。热加载以查看行上的padding而不是分隔符上的Padding。

<>解析为自定义类型

在上一节中，JSON解析器将JSON响应中的每个成员都作为Dart
Map类型实例添加到_members列表中，这相当于Kotlin中的Map或Swift中的Dictionary。
但是，如果你想使用自定义类。
在main.dart文件中添加Member类：
class Member { final String login; Member(this.login) { if (login == null) {
throw new ArgumentError("login of Member cannot be null. " "Received:
'$login'"); } } }
member有一个login属性，和一个构造函数，在构造函数中当login值为null时,会抛出一个error。
更新GHFlutterState类中的_members变量声明，所以现在他就是一个Member对象的list
var _members = <Member>[];
更新_buildRow()方法使用Member对象的login属性而不是map的"login"key的值。
title: new Text("${_members[i].login}", style: _biggerFont)
现在更新在_loadData()中的传递给setState()的回调，将map解析为Member对象，添加到member对象list中。
setState(() { final membersJSON = JSON.decode(response.body); for (var
memberJSON in membersJSON) { final member = new Member(memberJSON["login"]);
_members.add(member); } });
如果你热加载，有可能看到一个错误，这时你重新启动。

<>下载图片

每个member都有一个头像url.你将添加头像到Member类中，然后在app中显示头像。

在Member类中添加avatarUrl属性，这个属性不能为null。
class Member { final String login; final String avatarUrl; Member(this.login,
this.avatarUrl) { if (login == null) { throw new ArgumentError("login of Member
cannot be null. " "Received: '$login'"); } if (avatarUrl == null) { throw new
ArgumentError("avatarUrl of Member cannot be null. " "Received: '$avatarUrl'");
} } }
更新_buildRow()方法，通过NetworkImage 和 the CircleAvatar 组件显示头像。
Widget _buildRow(int i) { return new Padding( padding: const
EdgeInsets.all(16.0), child: new ListTile( title: new
Text("${_members[i].login}", style: _biggerFont), leading: new CircleAvatar(
backgroundColor: Colors.green, backgroundImage: new
NetworkImage(_members[i].avatarUrl) ), ) ); }
设置头像为ListTile的leading属性，头像将显示在title的前面。
更新_loadData()方法，使在创建一个新的Member时使用map的"avatar_url"值。
final member = new Member(memberJSON["login"], memberJSON["avatar_url"]);
构建运行，你将能看到每一个行的头像。

<>整理代码

大部分代码现在位于main.dart文件中。为了使代码更清晰一点，你可以重构组件和你已经添加到他们自己的文件中的类。
在lib文件夹中创建名为member.dart和ghflutter.dart的文件。
将Member类移入member.dart，并将GHFlutterState和GHFlutter类转移到ghflutter.dart。
您不需要member.dart中的任何导入语句，但flutter.dart中的导入应如下所示：
import 'dart:convert'; import 'package:flutter/material.dart'; import
'package:http/http.dart' as http; import 'member.dart'; import 'strings.dart';
您还需要更新main.dart中的导入，所以整个文件包含以下内容：
import 'package:flutter/material.dart'; import 'ghflutter.dart'; import
'strings.dart'; void main() => runApp(new GHFlutterApp()); class GHFlutterApp
extends StatelessWidget { @override Widget build(BuildContext context) { return
new MaterialApp( title: Strings.appTitle, home: new GHFlutter(), ); } }
通过构建并运行应用程序，您应该看不到任何更改，但代码现在更清晰一些

<>添加主题

您可以通过将主题属性添加到您在main.dart中创建的MaterialApp来轻松地将主题添加到应用程序:
lass GHFlutterApp extends StatelessWidget { @override Widget
build(BuildContext context) { return new MaterialApp( title: Strings.appTitle,
theme: new ThemeData(primaryColor: Colors.green.shade800), home: new
GHFlutter(), ); } }
您正在使用绿色阴影作为Material Design主题颜色值。

构建并运行应用程序，以查看新的主题：

大部分应用截图都来自Android模拟器。您也可以在iOS模拟器中运行最终的主题应用程序：

这就是我所说的跨平台

最终代码地址
<https://koenig-media.raywenderlich.com/uploads/2018/03/ghflutter-final.zip>

<>参考

https://www.raywenderlich.com/188257/getting-started-with-flutter
<https://www.raywenderlich.com/188257/getting-started-with-flutter>

热门工具换一换