layout	title	permalink
page	Flutter for React Native 开发者	/flutter-for-react-native/

本文档适用于React Native (RN) 开发人员，可以将您现有的RN知识应用于使用Flutter构建移动应用程序。如果您了解RN框架的基础知识，那么您可以将此文档用作Flutter开发的一个开端

可以将此文档作为cookbook, 通过跳转并查找与您的需求最相关的问题

TOC Placeholder {:toc}

介绍Dart for JavaScript 开发者

像React Native一样, Flutter使用反应式视图.然而,相比于RN转换原生控件,Flutter则编译为原生代码. Flutter控制屏幕上的每个像素,这避免了由于需要JavaScript桥接而导致的性能问题

Dart是一种易于学习的语言，并提供以下功能:

提供用于构建Web的开源，可伸缩编程语言，服务器和移动应用程序。
提供使用C风格的面向对象的单继承语言AOT编译成本机的语法。
可选地转换为JavaScript。
支持接口和抽象类。

下面描述了JavaScript和Dart之间差异的一些示例。

入口点

JavaScript没有预定义的入口函数 - 您可以定义入口点.

// JavaScript
function startHere() {
  // Can be used as entry point
}

在Dart中，每个app都必须有一个顶级的main（）函数作为应用程序的入口点。

// Dart
main() {
}

尝试一下 DartPad.

打印到控制台

要在Dart中打印到控制台，请使用print。

// JavaScript
console.log("Hello world!");

// Dart
print('Hello world!');

尝试一下 DartPad.

变量

Dart是类型安全的 - 它使用静态类型检查和运行时的组合,检查以确保变量的值始终与变量的静态值匹配类型。尽管类型是必需的，但某些类型注释是可选的，因为 Dart执行类型推断。

创建和分配变量

在JavaScript中，无法定义变量类型。

在 Dart中, 变量必须是明确的类型或系统能够解析的类型。

// JavaScript
var name = "JavaScript";

// Dart
String name = 'dart'; // Explicitly typed as a string.
var otherName = 'Dart'; // Inferred string.
// Both are acceptable in Dart.

尝试一下 DartPad。

有关更多信息, 请参阅 Dart的类型系统。

默认值

在JavaScript中，未初始化的变量是 undefined。

在Dart中，未初始化的变量的初始值为“null”。因为数字是Dart中的对象，所以只要是带有数字类型的未初始化变量的值都是“null”。

// JavaScript
var name; // == undefined

// Dart
var name; // == null
int x; // == null

尝试一下 DartPad。

有关更多信息，请参阅文档变量。

检查null或零

在JavaScript中，1或任何非null对象的值被视为true。

// JavaScript
var myNull = null;
if (!myNull) {
  console.log("null is treated as false");
}
var zero = 0;
if (!zero) {
  console.log("0 is treated as false");
}

在Dart中，只有布尔值“true”被视为true。

// Dart
var myNull = null;
if (myNull == null) {
  print('use "== null" to check null');
}
var zero = 0;
if (zero == 0) {
  print('use "== 0" to check zero');
}

尝试一下 DartPad.

Functions

Dart和JavaScript函数通常类似。主要区别是声明。

// JavaScript
function fn() {
  return true;
}

// Dart
fn() {
  return true;
}
// can also be written as
bool fn() {
  return true;
}

尝试一下 DartPad。

有关更多信息，请参阅文档 functions。

异步编程

Futures

与JavaScript一样，Dart支持单线程执行。在JavaScript中，Promise对象表示异步操作的最终完成（或失败）及其结果值

Dart使用 Future 对象提交到这里.

// JavaScript
_getIPAddress = () => {
  const url="https://httpbin.org/ip";
  return fetch(url)
    .then(response => response.json())
    .then(responseJson => {
      console.log(responseJson.origin);
    })
    .catch(error => {
      console.error(error);
    });
};

// Dart
_getIPAddress() {
  final url = 'https://httpbin.org/ip';
  HttpRequest.request(url).then((value) {
      print(json.decode(value.responseText)['origin']);
  }).catchError((error) => print(error));
}

尝试一下 DartPad。

有关更多信息，请参阅文档 Futures。

`async` 和 `await`

async函数声明定义了一个异步函数。

在JavaScript中，async函数返回一个Promise。 await运算符是用来等待'Promise'。

// JavaScript
async _getIPAddress() {
  const url="https://httpbin.org/ip";
  const response = await fetch(url);
  const json = await response.json();
  const data = await json.origin;
  console.log(data);
}

在Dart中，async函数返回一个Future，函数的主体是稍后执行。 await运算符用于等待Future。

// Dart
_getIPAddress() async {
  final url = 'https://httpbin.org/ip';
  var request = await HttpRequest.request(url);
  String ip = json.decode(request.responseText)['origin'];
  print(ip);
}

尝试一下 DartPad。

有关更多信息，请参阅 async and await 文档。

基础

如何创建Flutter应用程序?

要使用React Native创建应用程序，您将运行create-react-native-app从命令行。

{% prettify %} $ create-react-native-app {% endprettify%}

要在Flutter中创建应用程序，请执行以下操作之一:

从命令行使用flutter create命令。确保Flutter SDK配置了环境变量。
使用安装了Flutter和Dart插件的IDE。

{% prettify %} $ flutter create {% endprettify%}

有关更多信息，请参阅入门: 概述教程引导您创建一个按钮单击计数器应用程序。创造一个Flutter 项目构建在Android上运行示例应用程序所需的所有文件和iOS设备。

我如何运行我的应用程序?

在React Native中，您将在项目目录中运行npm run或yarn run。

您可以通过几种方式运行Flutter应用程序:

从项目的根目录使用flutter run。
在带有Flutter和Dart插件的IDE中使用“run”选项。

您的应用在连接的设备，iOS模拟器或Android模拟器上运行。

有关更多信息，请参阅Flutter 入门: 概述文档。

如何导入?

在React Native中，您需要导入每个必需的组件。

//React Native
import React from "react";
import { StyleSheet, Text, View } from "react-native";

在Flutter中，要使用Material Design库中的小部件，请导入material.dart包。要使用iOS样式小部件，请导入Cupertino库。要使用更基本的窗口小部件集，请导入窗口小部件库。或者，您可以编写自己的小部件库并导入它.

import 'package:flutter/material.dart';
import 'package:flutter/cupertino.dart';
import 'package:flutter/widgets.dart';
import 'package:flutter/my_widgets.dart';

无论您导入哪个小部件包，Dart都只会导入在您的应用中使用的小部件。

有关更多信息，请参阅 Flutter Widgets 目录。

Flutter中的应用程序中，什么是React Native“Hello world！”的等价物?

在React Native中，HelloWorldApp类扩展了React.Component和通过返回视图组件来实现render方法。

// React Native
import React from "react";
import { StyleSheet, Text, View } from "react-native";

export default class App extends React.Component {
  render() {
    return (
      <View style={styles.container}>
        <Text>Hello world!</Text>
      </View>
    );
  }
}

const styles = StyleSheet.create({
  container: {
    flex: 1,
    backgroundColor: "#fff",
    alignItems: "center",
    justifyContent: "center"
  }
});

在Flutter中，您可以创建一个完全相同的“Hello world！”应用程序使用核心窗口小部件库中的Center和Text窗口小部件。Center窗口小部件成为窗口小部件树的根，并且有一个子窗口，即“Text”窗口小部件。

// Flutter
import 'package:flutter/material.dart';

void main() {
  runApp(
    Center(
      child: Text(
        'Hello, world!',
        textDirection: TextDirection.ltr,
      ),
    ),
  );
}

以下图片显示了基本Flutter“Hello world！”的Android和iOS UI中的应用。

Android	iOS

现在您已经看到了最基本的Flutter应用程序，下一节将展示如何利用Flutter丰富的小部件库创建一个现代的，优雅的应用程序。

如何使用组件并将其嵌套以形成组件树?

在Flutter中，几乎所有东西都是widget。

widget是应用程序用户界面的基本构建块，您将组件组成一个层次结构，调用组件树。每个窗口widget都嵌套在父窗口widget中，并从其父窗口继承属性。甚至应用程序对象本身也是一个组件，没有单独的“应用程序”对象。相反，根组件担任此角色。

Widget可以定义:

结构元素 - 如按钮或菜单
风格元素 - 像字体或颜色主题
类似布局的填充或对齐的一个方向

以下示例使用Material库中的Widget显示“Hello world！”应用程序。在此示例中，窗口组件树嵌套在MaterialApp根窗口组件中。

// Flutter
import 'package:flutter/material.dart';

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

class MyApp extends StatelessWidget {
  @override
  Widget build(BuildContext context) {
    return MaterialApp(
      title: 'Welcome to Flutter',
      home: Scaffold(
        appBar: AppBar(
          title: Text('Welcome to Flutter'),
        ),
        body: Center(
          child: Text('Hello world'),
        ),
      ),
    );
  }
}

以下图片显示了使用Material Design小部件构建的“Hello world！”。您可以免费获得比基本的“Hello world！”应用程序更多的功能。

Android	iOS

编写应用程序时，您将使用两种类型的widgets: StatelessWidget 和 StatefulWidget。StatelessWidget听起来就像是一个没有状态的组件，StatelessWidget创建一次，永远不会改变其外观。 StatefulWidget根据收到的数据或用户输入动态更改状态

无状态小部件和有状态小部件之间的重要区别在于StatefulWidgets具有一个State对象，该对象存储状态数据并在树重建中进行传递，因此它不会丢失。

在简单或基本的应用程序中，嵌套widgets很容易，但随着代码库变大，应用程序变得复杂，您应该将深层嵌套的小部件分解为返回小部件或更小类的函数。创建单独的函数和小部件允许您重用应用程序中的组件。

如何创建可重用组件?

在React Native中，您将定义一个类来创建可重用的组件，然后使用props方法来设置或返回所选元素的属性和值，在下面的示例中，定义了CustomCard类，然后在父类中使用。

// React Native
class CustomCard extends React.Component {
  render() {
    return (
      <View>
        <Text > Card {this.props.index} </Text>
        <Button
          title="Press"
          onPress={() => this.props.onPress(this.props.index)}
        />
      </View>
    );
  }
}

// Usage
<CustomCard onPress={this.onPress} index={item.key} />

在Flutter中，定义一个类来创建自定义widget，然后重用widget。您还可以定义和调用返回可重用小部件的函数，如以下示例中的构建函数所示。

{% prettify dart %}

// Flutter class CustomCard extends StatelessWidget { [[highlight]]CustomCard({@required this.index, @required [[/highlight]] [[highlight]]this.onPress});[[/highlight]]

final index; final Function onPress;

@override Widget build(BuildContext context) { return Card( child: Column( children: [ Text('Card $index'), FlatButton( child: const Text('Press'), onPressed: this.onPress, ), ], ) ); } } ... // Usage CustomCard( [[highlight]]index: index,[[/highlight]] [[highlight]]onPress: () { [[/highlight]] print('Card $index'); }, ) ...

{% endprettify %}

在前面的例子中, CustomCard类的构造函数使用Dart的大括号语法{}来配置 Optional parameters。

要使用这些字段，请从构造函数中删除花括号，或者将@ required添加到构造函数中。

以下屏幕截图显示了可重用的CustomCard类的示例。

Android	iOS

项目结构和资源

我从哪里开始编写代码?

从main.dart文件开始。它是在您创建时自动生成的Flutter应用程序。

// Dart
void main(){
 print("Hello, this is the main function.");
}

在Flutter中，入口点文件是'项目名称'/ lib / main.dart并执行从main函数开始。

在Flutter项目的目录结构是怎样的?

创建新的Flutter项目时，它会构建以下目录结构。您可以稍后自定义它，但这是您开始的地方

┬
└ projectname
  ┬
  ├ android      - Contains Android-specific files.
  ├ build        - Stores iOS and Android build files.
  ├ ios          - Contains iOS-specific files.
  ├ lib          - Contains externally accessible Dart source files.
    ┬
    └ src        - Contains additional source files.
    └ main.dart  - The Flutter entry point and the start of a new app.
                   This is generated automatically when you create a Flutter
                    project.
                   It's where you start writing your Dart code.
  ├ test         - Contains automated test files.
  └ pubspec.yaml - Contains the metadata for the Flutter app.
                   This is equivalent to the package.json file in React Native.

我在哪里放置我的代码和资源文件以及如何使用它们?

Flutter源码或资源文件是与您的应用捆绑在一起并部署的文件并且可以在运行时访问。 Flutter应用程序可以包含以下文件类型:

静态数据，例如JSON文件
配置文件
图标和图片 (JPEG, PNG, GIF, Animated GIF, WebP, Animated WebP, BMP, and WBMP)

Flutter使用位于项目根目录的pubspec.yaml文件识别应用程序所需的资源文件。

flutter:
  assets:
    - assets/my_icon.png
    - assets/background.png

assets指定的部分应包含在应用程序中的文件。每个assets文件都由相对于pubspec.yaml的显式路径标识, assets文件所在的位置. assets的顺序和命名以及使用的实际目录（在这种情况下为assets）都没影响。但是，虽然assets可以放在任何应用程序目录中，但它是一个将它们放在assets目录中的最佳实践。

在构建期间, Flutter将资源文件放入名为* asset的特殊存档中, 当应用程序从内存中读取时。当资源的路径在 pubspec.yaml中声明时, 构建过程查找任何文件相邻子目录中的相同名称. 这些文件也包含在 assets包以及指定的assets。 Flutter使用assets变量时将为您的应用选择适合分辨率的图像。

在React Native中，您可以通过将图像文件放在源代码目录中并引用它来添加静态图像。

<Image source={require("./my-icon.png")} />

在Flutter中，使用AssetImage类将静态图像添加到应用程序 widget的构建方法。

image: AssetImage('assets/background.png'),

有关更多信息，请参阅在Flutter中添加资源和图片。

如何通过网络加载图像?

在React Native中，你可以在Image组件的source prop中指定uri ，如果需要也提供大小。

In Flutter, use the Image.network constructor to include an image from a URL。

// Flutter
body: Image.network(
          'https://flutter.io/images/owl.jpg',

如何安装第三方包和第三方包插件?

Flutter支持使用第三方包由其他开发者贡献给 Flutter和Dart生态系统。这使您可以快速构建应用程序而没必要必须从头开发一切。包含的包特定于平台的代码称为包插件。

在React Native中，你可以使用yarn add {package-name}或npm install --save {package-name}从命令行安装软件包。

在Flutter中，使用以下说明安装包:

将包名称和版本添加到pubspec.yaml dependencies部分。下面的示例显示了如何将google_sign_in Dart包添加到 pubspec.yaml文件。在YAML文件中工作时会检查空格，因为空格很重要!

dependencies:
  flutter:
    sdk: flutter
  google_sign_in: ^3.0.3

使用flutter packages get从命令行安装软件包。如果使用IDE，它通常会为您运行flutter packages get，或者它可能提示你这样做。
将包导入您的应用代码，如下所示：

import 'package:flutter/cupertino.dart';

有关更多信息，请参阅使用packages and 开发Packages和插件。

您可以在中找到Flutter开发人员共享的许多软件包 Flutter Packages 部分 pub.dartlang.org。

Flutter widgets

在Flutter中，您可以使用描述其视图内容的widgets来构建UI 应该看起来像他们当前的配置和状态。

Widgets通常由许多小部件组成, 嵌套的单一功能的widget产生强大的效果。例如，Container Widget包含几个widget负责布局, 绘制, 排版, 和测量。具体来说，Container小部件包括LimitedBox, ConstrainedBox, Align, Padding, DecoratedBox, 和 Transform widgets。您可以使用而不是继承“Container”来生成自定义效果以新颖独特的方式构建这些和其他简单的小部件。

“Center”widget是另一种控制布局的方式，要使窗口小部件居中，请将其包装在“Center”窗口小部件中，然后使用布局窗口小部件进行对齐，行，列和网格。这些布局widget没有自己的视觉表现。相反，他们唯一的目的是控制。其他widget的布局方向。检查相邻的widget对于理解widget是如何呈现另一个widget是很有帮助的。

有关更多信息，请参见 Flutter框架概览。

有关小部件包中的核心部件的更多信息，请参见基础 Widgets, Widgets 目录，或者 Flutter Widget 索引。

Views

什么是等效的“视图”容器?

在React Native中，View是一个支持Flexbox布局的容器，风格，触摸处理和辅助功能控件。

在Flutter中，您可以使用Widgets库中的核心布局小部件如 Container, Column, Row, 和 Center.

有关更多信息，请参阅布局 Widget 目录。

什么是`FlatList`或`SectionList`的等价物?

“List”是垂直排列的可滚动组件列表。

在React Native中，FlatList或SectionList用于渲染简单或分段列表。

// React Native
<FlatList
  data={[ ... ]}
  renderItem={({ item }) => <Text>{item.key}</Text>}
/>

ListView 是Flutter最常用的滚动小部件。默认构造函数构造每一个子条目。 ListView 最适合少量数据小部件。对于大型或无限列表, 使用 ListView.builder, 它根据需要构建其子条目且仅构建那些可见的条目。

// Flutter
var data = [ ... ];
ListView.builder(
  itemCount: data.length,
  itemBuilder: (context, int index) {
    return Text(
      data[index],
    );
  },
)

Android	iOS

要了解如何实现无限滚动列表，请参阅 [编写第一个Flutter应用, Part 1](https://codelabs.developers.google.com/codelabs/first-flutter-app-pt1/#0) 。

如何使用Canvas绘制或渲染?

在React Native中，不存在canvas组件，因此使用了诸如react-native-canvas之类的第三方库

// React Native
handleCanvas = canvas => {
  const ctx = canvas.getContext("2d");
  ctx.fillStyle = "skyblue";
  ctx.beginPath();
  ctx.arc(75, 75, 50, 0, 2 * Math.PI);
  ctx.fillRect(150, 100, 300, 300);
  ctx.stroke();
};

render() {
  return (
    <View>
      <Canvas ref={this.handleCanvas} />
    </View>
  );
}

在Flutter中，你可以使用 CustomPaint 和 CustomPainter 类去绘制到画布。

以下示例显示如何使用CustomPaint小部件在绘制阶段绘制。它实现了抽象类CustomPainter，并将其传递给CustomPaint的painter属性。 CustomPaint子类必须实现paint和shouldRepaint方法。

// Flutter
class MyCanvasPainter extends CustomPainter {

  @override
  void paint(Canvas canvas, Size size) {
    Paint paint = Paint();
    paint.color = Colors.amber;
    canvas.drawCircle(Offset(100.0, 200.0), 40.0, paint);
    Paint paintRect = Paint();
    paintRect.color = Colors.lightBlue;
    Rect rect = Rect.fromPoints(Offset(150.0, 300.0), Offset(300.0, 400.0));
    canvas.drawRect(rect, paintRect);
  }

  bool shouldRepaint(MyCanvasPainter oldDelegate) => false;
  bool shouldRebuildSemantics(MyCanvasPainter oldDelegate) => false;
}
class _MyCanvasState extends State<MyCanvas> {

  @override
  Widget build(BuildContext context) {
    return Scaffold(
      body: CustomPaint(
        painter: MyCanvasPainter(),
      ),
    );
  }
}

Android	iOS

布局

如何使用小部件定义布局属性?

在React Native中，大多数布局都可以使用传递的道具来完成到特定的组件。例如，你可以使用style 道具在 View组件上以指定flexbox属性。排版你的在列中的组件，您将指定一个支柱，如: flexDirection: “column”。

// React Native
<View
  style={%raw%}{{
    flex: 1,
    flexDirection: "column",
    justifyContent: "space-between",
    alignItems: "center"
  }}{%endraw%}
>

在Flutter中，布局主要由专门设计的小部件定义并提供布局，结合控件小部件及其样式属性。

例如, 列和行 widgets 控制一个数组中的条目并且分别垂直和水平对齐它们。 Container widget 控制一个布局的样式和属性, 并且 Center widget 负责居中它的子widget。

// Flutter
Center(
  child: Column(
    children: <Widget>[
      Container(
        color: Colors.red,
        width: 100.0,
        height: 100.0,
      ),
      Container(
        color: Colors.blue,
        width: 100.0,
        height: 100.0,
      ),
      Container(
        color: Colors.green,
        width: 100.0,
        height: 100.0,
      ),
    ],
  ),
)

Flutter在其核心小部件库中提供了各种布局小部件。例如, Padding, Align, 和 Stack.

有关完整列表，请参阅布局 Widget。

Android	iOS

如何分层widgets?

在React Native中，组件可以使用absolute定位进行分层。

Flutter 使用Stack widget 控制子widget在一层。子widgets可以完全或者部分覆盖基础widgets。

Stack控件将其子项相对于其框的边缘定位。如果您只想重叠多个子窗口小部件，这个类很有用。

// Flutter
Stack(
  alignment: const Alignment(0.6, 0.6),
  children: <Widget>[
    CircleAvatar(
      backgroundImage: NetworkImage(
        "https://avatars3.githubusercontent.com/u/14101776?v=4"),
    ),
    Container(
      decoration: BoxDecoration(
          color: Colors.black45,
      ),
      child: Text('Flutter'),
    ),
  ],
)

上一个示例使用 Stack 覆盖容器 (显示其“Text”在半透明的黑色背景上) 在'CircleAvatar`之上. Stack偏移文本使用alignment属性和Alignment定位。

Android	iOS

有关更多信息，请参阅 Stack class 文档。

样式

如何设置组件的样式?

在React Native中，内联样式和stylesheets.create用于样式组件

// React Native
<View style={styles.container}>
  <Text style={%raw%}{{ fontSize: 32, color: "cyan", fontWeight: "600" }}{%endraw%}>
    This is a sample text
  </Text>
</View>

const styles = StyleSheet.create({
  container: {
    flex: 1,
    backgroundColor: "#fff",
    alignItems: "center",
    justifyContent: "center"
  }
});

在Flutter中，Text小部件可以使用TextStyle类的风格属性。如果要在多个位置使用相同的文本样式，你可以创建一个 TextStyle 类并将其应用于各个 Text widgets。

// Flutter
var textStyle = TextStyle(fontSize: 32.0, color: Colors.cyan, fontWeight:
   FontWeight.w600);
	...
Center(
  child: Column(
    children: <Widget>[
      Text(
        'Sample text',
        style: textStyle,
      ),
      Padding(
        padding: EdgeInsets.all(20.0),
        child: Icon(Icons.lightbulb_outline,
          size: 48.0, color: Colors.redAccent)
      ),
    ],
  ),
)

Android	iOS

我如何使用`Icons`和`Colors`?

React Native不包含对图标的支持，因此使用第三方库。

在Flutter中，导入Material库也会引入丰富的Material icons 和 colors。

Icon(Icons.lightbulb_outline, color: Colors.redAccent)

使用Icons类时，请务必在该项目的pubspec.yaml文件中设置uses-material-design：true。这确保显示包含在您的应用程序中图标的MaterialIcons字体。 {% prettify dart %} name: my_awesome_application flutter: [[highlight]]uses-material-design: true[[/highlight]] {% endprettify %}

Flutter的 Cupertino (iOS风格) 包提供高保真小部件对于当前的iOS设计语言. 要使用CupertinoIcons字体，请添加项目中cupertino_icons的依赖项 pubspec.yaml 文件。

name: my_awesome_application
dependencies:
  cupertino_icons: ^0.1.0

全局定制组件的颜色和样式, 使用ThemeData指定主题各个方面的默认颜色。将MaterialApp中的theme属性设置为ThemeData对象。 Colors 类从Material Design中提供颜色 color palette。

以下示例将主色板设置为“blue”，将文本选择设置为“red”。

{% prettify dart %} class SampleApp extends StatelessWidget { @override Widget build(BuildContext context) { return MaterialApp( title: 'Sample App', theme: ThemeData( [[highlight]]primarySwatch: Colors.blue,[[/highlight]] [[highlight]]textSelectionColor: Colors.red[[/highlight]] ), home: SampleAppPage(), ); } } {% endprettify %}

如何添加样式主题?

在React Native中，为样式表和组件中的组件定义了通用主题然后用于组件。

在Flutter中, 通过在ThemeData类中定义样式并将其传递到MaterialApp Widgets中的theme属性，为几乎所有内容创建统一样式。

  @override
  Widget build(BuildContext context) {
    return MaterialApp(
      theme: ThemeData(
        primaryColor: Colors.cyan,
        brightness: Brightness.dark,
      ),
      home: StylingPage(),
    );
  }

即使不使用MaterialApp小部件，也可以应用Theme。 Theme widget 在data参数中获取ThemeData并应用ThemeData到它的所有子窗口小部件。

 @override
  Widget build(BuildContext context) {
    return Theme(
      data: ThemeData(
        primaryColor: Colors.cyan,
        brightness: brightness,
      ),
      child: Scaffold(
         backgroundColor: Theme.of(context).primaryColor,
              ...
              ...
      ),
    );
  }

状态管理

状态是可以在构建窗口小部件时同步读取的信息，也可以是在窗口小部件的生命周期内可能更改的信息。如果要管理应用程序状态需要StatefulWidget。

StatelessWidget

Flutter中的StatelessWidget是一个不需要状态更改的小部件 - 它没有要管理的内部状态。

当您描述的用户界面部分不依赖于对象本身中的配置信息以及窗口小部件的BuildContext 时，无状态窗口小部件非常有用。

AboutDialog, CircleAvator和 Text 是StatelessWidget子类的无状态小部件的示例.

// Flutter
import 'package:flutter/material.dart';

void main() => runApp(MyStatelessWidget(text: "StatelessWidget Example to show immutable data"));

class MyStatelessWidget extends StatelessWidget {
  final String text;
  MyStatelessWidget({Key key, this.text}) : super(key: key);

  @override
  Widget build(BuildContext context) {
    return Center(
      child: Text(
        text,
        textDirection: TextDirection.ltr,
      ),
    );
  }
}

在前面的示例中，您使用了MyStatelessWidget类的构造函数传递标记为final的text。这个类继承了StatelessWidget-它包含不可变数据

无状态小部件的build方法通常只会在以下三种情况调用:

将窗口小部件插入树中时
当小部件的父级更改其配置时
当它依赖的InheritedWidget发生变化时

StatefulWidget

StatefulWidget 是一个改变状态的部件。使用setState方法管理StatefulWidget的状态的改变。调用setState告诉Flutter框架，某个状态发生了变化导致应用程序重新运行build方法，以便应用程序可以反映出来更改。

状态是在构建窗口小部件时可以同步读取的信息可能会在小部件的生命周期中发生变化。这是小部件实现者的责任，确保在状态改变时及时通知状态变化. 使用StatefulWidget，当窗口小部件可以动态更改时。例如, 通过键入表单或移动滑块来更改窗口小部件的状态. 或者, 它可以随时间变化 - 也许数据推送更新UI

Checkbox, Radio, Slider, InkWell, Form, 和 TextField 都是有状态的小部件StatefulWidget的子类。

下面的示例声明了一个StatefulWidget，它需要一个createState（）方法。此方法创建管理窗口小部件状态的状态对象_MyStatefulWidgetState。

class MyStatefulWidget extends StatefulWidget {
  MyStatefulWidget({Key key, this.title}) : super(key: key);
  final String title;

  @override
  _MyStatefulWidgetState createState() => _MyStatefulWidgetState();
}

以下状态类_MyStatefulWidgetState实现窗口小部件的build（）方法。当状态改变时，例如，当用户切换按钮时，使用新的切换值调用setState。这会导致框架在UI中重建此窗口小部件。

class _MyStatefulWidgetState extends State<MyStatefulWidget> {
  bool showtext=true;
  bool toggleState=true;
  Timer t2;

  void toggleBlinkState(){
    setState((){
      toggleState=!toggleState;
    });
    var twenty = const Duration(milliseconds: 1000);
    if(toggleState==false) {
      t2 = Timer.periodic(twenty, (Timer t) {
        toggleShowText();
      });
    } else {
      t2.cancel();
    }
  }

  void toggleShowText(){
    setState((){
      showtext=!showtext;
    });
  }

  @override
  Widget build(BuildContext context) {
    return Scaffold(
      body: Center(
        child: Column(
          children: <Widget>[
            (showtext
              ?(Text('This execution will be done before you can blink.'))
              :(Container())
            ),
            Padding(
              padding: EdgeInsets.only(top: 70.0),
              child: RaisedButton(
                onPressed: toggleBlinkState,
                child: (toggleState
                  ?( Text('Blink'))
                  :(Text('Stop Blinking'))
                )
              )
            )
          ],
        ),
      ),
    );
  }
}

什么是StatefulWidget和StatelessWidget最佳实践?

在设计窗口小部件时，需要考虑以下几点。

1. 确定窗口小部件应该是StatefulWidget还是StatelessWidget

在Flutter中，小部件是有状态的还是无状态的 - 取决于是否他们依赖于状态的变化。

如果窗口小部件发生更改 - 由于用户与其进行交互或数据馈送中断用户界面，那么它就是有状态的。
如果一个小部件是final或immutable修饰，那么它就是无状态。

2. 确定哪个对象管理窗口小部件的状态（对于StatefulWidget）

在Flutter中，管理状态有三种主要方式：

每个小部件管理自己的状态
父窗口小部件管理窗口小部件的状态
混合搭配管理的方法

在决定使用哪种方法时，请考虑以下原则：

如果部件的状态取决于用户的数据，例如已选中或未选中复选框的模式，或滑块的位置，那么最好管理状态由父窗口小部件来管理。
如果部件的状态取决于动作。例如动画，那么最好是由小部件自身来管理状态
如有疑问，请让父窗口小部件管理子窗口小部件的状态。

3. StatefulWidget 和 Stated的子类

MyStatefulWidget类管理自己的状态 - 它扩展了StatefulWidget，它覆盖createState（）方法来创建State对象，框架调用createState（）来构建小部件。在这个例子中，createState（）创建了一个_MyStatefulWidgetState的实例在下一个最佳实践中实施。

class MyStatefulWidget extends StatefulWidget {
  MyStatefulWidget({Key key, this.title}) : super(key: key);
  final String title;

  @override
  _MyStatefulWidgetState createState() => _MyStatefulWidgetState();
}

class _MyStatefulWidgetState extends State<MyStatefulWidget> {

  @override
  Widget build(BuildContext context) {
    ...
  }
}

4. 将StatefulWidget添加到窗口小部件树中

将自定义的StatefulWidget添加到应用程序构建方法中的窗口小部件树中。

class MyStatelessWidget extends StatelessWidget {
  // This widget is the root of your application.

  @override
  Widget build(BuildContext context) {
    return MaterialApp(
      title: 'Flutter Demo',
      theme: ThemeData(
        primarySwatch: Colors.blue,
      ),
      home: MyStatefulWidget(title: 'State Change Demo'),
    );
  }
}

Android	iOS

Props

在React Native中，大多数组件在使用不同的参数或属性创建时都可以自定义，称为“props”。可以使用this.props在子组件中使用这些参数。

// React Native
class CustomCard extends React.Component {
  render() {
    return (
      <View>
        <Text> Card {this.props.index} </Text>
        <Button
          title="Press"
          onPress={() => this.props.onPress(this.props.index)}
        />
      </View>
    );
  }
}
class App extends React.Component {

  onPress = index => {
    console.log("Card ", index);
  };

  render() {
    return (
      <View>
        <FlatList
          data={[ ... ]}
          renderItem={({ item }) => (
            <CustomCard onPress={this.onPress} index={item.key} />
          )}
        />
      </View>
    );
  }
}

在Flutter中，使用参数化构造函数中接收的属性分配标记为“final”的局部变量或函数。

// Flutter
class CustomCard extends StatelessWidget {

  CustomCard({@required this.index, @required this.onPress});
  final index;
  final Function onPress;

  @override
  Widget build(BuildContext context) {
  return Card(
    child: Column(
      children: <Widget>[
        Text('Card $index'),
        FlatButton(
          child: const Text('Press'),
          onPressed: this.onPress,
        ),
      ],
    ));
  }
}
    ...
//Usage
CustomCard(
  index: index,
  onPress: () {
    print('Card $index');
  },
)

Android	iOS

本地存储

如果您不需要存储大量数据并且不需要结构，则可以使用shared_preferences，它允许您读取和写入原始数据类型的持久键值对：布尔值，浮点数，整数，长整数和字符串。

如何存储应用程序全局的持久键值对?

在React Native中，使用AsyncStorage组件的setItem和getItem函数来存储和检索持久的数据。

// React Native
await AsyncStorage.setItem( "counterkey", json.stringify(++this.state.counter));
AsyncStorage.getItem("counterkey").then(value => {
  if (value != null) {
    this.setState({ counter: value });
  }
});

在Flutter中，使用shared_preferences插件来存储和检索持久性的键值数据。 shared_preferences插件包含iOS上的NSUserDefaults和Android上的SharedPreferences，为简单数据提供持久存储。要使用该插件，请在pubspec.yaml文件中添加shared_preferences作为依赖项，然后在Dart文件中导入该包。

dependencies:
  flutter:
    sdk: flutter
  shared_preferences: ^0.3.0

// Dart
import 'package:shared_preferences/shared_preferences.dart';

要实现持久数据，请使用SharedPreferences类提供的setter方法。 Setter方法可用于各种基本类型，例如setInt，setBool和setString。要读取数据，请使用SharedPreferences类提供的相应getter方法。对于每个setter，都有一个相应的getter方法，例如getInt，getBool和getString。

SharedPreferences prefs = await SharedPreferences.getInstance();
_counter = prefs.getInt('counter');
prefs.setInt('counter', ++_counter);
setState(() {
  _counter = _counter;
});

路由

大多数应用程序包含多个用于显示不同类型信息的页面。例如，您可能有一个产品页面，显示用户可以点击产品图片的图片，以便在新页面上获得有关产品的更多信息。

在Android中，新页面是新Activity。在iOS中，新页面是新的 ViewControllers。在Flutter中，页面只是小部件！使用Navigator小部件导航到新的 Flutter中的页面。

如何在页面之间导航?

在React Native中，有三个主要的导航器：StackNavigator，TabNavigator，和DrawerNavigator。每种方法都提供了配置和定义页面的方法。

// React Native
const MyApp = TabNavigator(
  { Home: { screen: HomeScreen }, Notifications: { screen: tabNavScreen } },
  { tabBarOptions: { activeTintColor: "#e91e63" } }
);
const SimpleApp = StackNavigator({
  Home: { screen: MyApp },
  stackScreen: { screen: StackScreen }
});
export default (MyApp1 = DrawerNavigator({
  Home: {
    screen: SimpleApp
  },
  Screen2: {
    screen: drawerScreen
  }
}));

在Flutter中，有两个主要的小部件用于在页面之间导航：

Route 是一个应用程序抽象的屏幕或页面。
Navigator 是一个管理路由的小部件。

Navigator被定义为一个小部件，以栈管理的方式来管理一组部件 navigator管理一堆Route对象，并提供管理堆栈的方法，如Navigator.push和Navigator.pop。可以在MaterialApp 小部件中指定路由列表，也可以动态构建它们，例如，在三维动画中。以下示例指定MaterialApp 小部件中的命名路由。

// Flutter
class NavigationApp extends StatelessWidget {
  // This widget is the root of your application.
  @override
  Widget build(BuildContext context) {
    return MaterialApp(
            ...
      routes: <String, WidgetBuilder>{
        '/a': (BuildContext context) => usualNavscreen(),
        '/b': (BuildContext context) => drawerNavscreen(),
      }
            ...
  );
  }
}

要导航到命名路由，Navigator 窗口小部件的of方法用于指定BuildContext（窗口小部件树中窗口小部件位置的句柄）。路由的名称将传递给pushNamed函数以导航到指定的路由。

Navigator.of(context).pushNamed('/a');

您还可以使用Navigator的push方法，该方法将给定route添加到导航器的历史记录中，该路由会和给定的context，并转换为它。在以下示例中，MaterialPageRoute窗口小部件是一种模版路由，它根据平台自适应替换整个页面。在以下示例中，窗口小部件是一种模版路由，它使用平台自适应替换整个页面。它需要一个WidgetBuilder作为必需参数。

Navigator.push(context, MaterialPageRoute(builder: (BuildContext context)
 => UsualNavscreen()));

如何使用选项卡导航和抽屉导航?

在Material Design应用程序中，Flutter导航有两个主要选项：标签和抽屉。当没有足够的空间来支撑标签，抽屉式提供一个很好的选择。

标签导航

在React Native中，createBottomTabNavigator和TabNavigation用于显示标签和标签导航。

// React Native
import { createBottomTabNavigator } from 'react-navigation';

const MyApp = TabNavigator(
  { Home: { screen: HomeScreen }, Notifications: { screen: tabNavScreen } },
  { tabBarOptions: { activeTintColor: "#e91e63" } }
);

Flutter为抽屉和标签导航提供了几个专门的小部件：

TabController—协调选择TabBar还是TabBarView选项卡。
TabBar —显示水平的行选项卡。
Tab—创建material design风格的TabBar选项卡。
TabBarView—显示与当前选定选项卡对应的窗口小部件。

// Flutter
TabController controller=TabController(length: 2, vsync: this);

TabBar(
  tabs: <Tab>[
    Tab(icon: Icon(Icons.person),),
    Tab(icon: Icon(Icons.email),),
  ],
  controller: controller,
),

需要TabController 来协调选择 TabBar还是TabBarView选项卡。 TabController 构造函数length参数表示tab的数量。当每帧触发状态更改时，都需要TickerProvider来触发通知。 TickerProvider 用 vsync关键字表示. 每当您创建一个新的TabController时，都将vsync: this参数传递给TabController的构造函数。 TickerProvider是一个由Ticker 对象的类实现的接口。每当帧触发时必须通知的任何对象都可以使用Tickers，但它们最常用于通过AnimationController间接使用 AnimationControllers需要通过TickerProvider来获取他们的Ticker。如果要从State创建AnimationController，则可以使用TickerProviderStateMixin或SingleTickerProviderStateMixin 类来获取合适的TickerProvider Scaffold widget 包装一个新的TabBar小部件并创建两个选项卡。 TabBarView小部件作为Scaffold小部件的body参数传递。对应于“TabBar”小部件选项卡的所有页面都是TabBarView小部件的子部件以及相同的TabController。

// Flutter

class _NavigationHomePageState extends State<NavigationHomePage> with SingleTickerProviderStateMixin {
  TabController controller=TabController(length: 2, vsync: this);
  @override
  Widget build(BuildContext context) {
    return Scaffold(
      bottomNavigationBar: Material (
        child: TabBar(
          tabs: <Tab> [
            Tab(icon: Icon(Icons.person),)
            Tab(icon: Icon(Icons.email),),
          ],
          controller: controller,
        ),
        color: Colors.blue,
      ),
      body: TabBarView(
        children: <Widget> [
          home.homeScreen(),
          tabScreen.tabScreen()
        ],
        controller: controller,
      )
    );
  }
}

抽屉导航

在React Native中，导入所需的react-navigation包，然后使用createDrawerNavigator和DrawerNavigation。

// React Native
export default (MyApp1 = DrawerNavigator({
  Home: {
    screen: SimpleApp
  },
  Screen2: {
    screen: drawerScreen
  }
}));

在Flutter中，我们可以将Drawer小部件与Scaffold结合使用，以使用Material Design抽屉创建布局。要向应用添加 Drawer，请将其包裹在Scaffold小部件中 Scaffold小部件为遵循Material Design准则的应用程序提供一致的可视化结构它还支持特殊的Material Design组件，例如Drawers，AppBars和SnackBars。 Drawer小部件是一个水平滑动的Material Design面板 Scaffold的边缘，以显示应用程序中的导航链接。您可以提供Button，Text小部件或项目列表，以显示为Drawer小部件的子项。在以下示例中, ListTile 提供了导航功能。

// Flutter
Drawer(
  child:ListTile(
    leading: Icon(Icons.change_history),
    title: Text('Screen2'),
    onTap: () {
      Navigator.of(context).pushNamed("/b");
    },
  ),
  elevation: 20.0,
),

Scaffold小部件还包括一个AppBar小部件，当Drawer中的抽屉可用时，它会自动显示一个适当的IconButton来显示“抽屉”。 Scaffold自动处理边缘滑动手势以显示Drawer。

// Flutter
@override
Widget build(BuildContext context) {
  return Scaffold(
    drawer: Drawer(
      child: ListTile(
        leading: Icon(Icons.change_history),
        title: Text('Screen2'),
        onTap: () {
          Navigator.of(context).pushNamed("/b");
        },
      ),
      elevation: 20.0,
    ),
    appBar: AppBar(
      title: Text("Home"),
    ),
    body: Container(),
  );
}

Android	iOS

手势检测和触摸事件处理

为了监听和响应手势，Flutter支持点击，拖动和缩放。Flutter中的手势系统有两个独立的层。第一层包括原始指针事件，描述了它的位置和移动屏幕上的指针（如触摸，鼠标和测针移动. 第二层包括手势，其描述由一个或多个指针移动组成的语义动作。

如何监听窗口小部件单击或按压事件?

在React Native中，使用“PanResponder”或“Touchable”组件将监听事件添加到组件中。

// React Native
<TouchableOpacity
  onPress={() => {
    console.log("Press");
  }}
  onLongPress={() => {
    console.log("Long Press");
  }}
>
  <Text>Tap or Long Press</Text>
</TouchableOpacity>

对于更复杂的手势并将多个触摸组合到单个手势中，请使用PanResponder。

// React Native
class App extends Component {

  componentWillMount() {
    this._panResponder = PanResponder.create({
      onMoveShouldSetPanResponder: (event, gestureState) =>
        !!getDirection(gestureState),
      onPanResponderMove: (event, gestureState) => true,
      onPanResponderRelease: (event, gestureState) => {
        const drag = getDirection(gestureState);
      },
      onPanResponderTerminationRequest: (event, gestureState) => true
    });
  }

  render() {
    return (
      <View style={styles.container} {...this._panResponder.panHandlers}>
        <View style={styles.center}>
          <Text>Swipe Horizontally or Vertically</Text>
        </View>
      </View>
    );
  }
}

在Flutter中，要向窗口小部件添加单击（或按下）监听器，请使用具有onPress: field的按钮或可触摸窗口小部件。或者，通过将手势检测包装在GestureDetector中，将手势检测添加到任何小部件。

// Flutter
GestureDetector(
  child: Scaffold(
    appBar: AppBar(
      title: Text("Gestures"),
    ),
    body: Center(
      child: Column(
        mainAxisAlignment: MainAxisAlignment.center,
        children: <Widget>[
          Text('Tap, Long Press, Swipe Horizontally or Vertically '),
        ],
      )
    ),
  ),
  onTap: () {
    print('Tapped');
  },
  onLongPress: () {
    print('Long Pressed');
  },
  onVerticalDragEnd: (DragEndDetails value) {
    print('Swiped Vertically');
  },
  onHorizontalDragEnd: (DragEndDetails value) {
    print('Swiped Horizontally');
  },
);

有关更多信息，包括Flutter GestureDetector回调列表，请参阅GestureDetector class.

Android	iOS

发出HTTP网络请求

获取来自互联网的数据是在大多数应用程序中是很常见的。在Flutter中，http包提供了从Internet获取数据的最简单方法。

如何从API调用中获取数据?

React Native为网络提供了Fetch API - 您可以进行获取请求然后收到响应以获取数据

// React Native
_getIPAddress = () => {
  fetch("https://httpbin.org/ip")
    .then(response => response.json())
    .then(responseJson => {
      this.setState({ _ipAddress: responseJson.origin });
    })
    .catch(error => {
      console.error(error);
    });
};

Flutter使用http包。要安装http包，请将其添加到pubspec.yaml的dependencies部分。

dependencies:
  flutter:
    sdk: flutter
  http: <latest_version>

Flutter使用dart:io核心HTTP支持客户端。要创建HTTP客户端，请导入dart:io

import 'dart:io';

客户端支持以下HTTP操作：GET，POST，PUT和DELETE。

// Flutter
final url = Uri.https('httpbin.org', 'ip');
final httpClient = HttpClient();
_getIPAddress() async {
  var request = await httpClient.getUrl(url);
  var response = await request.close();
  var responseBody = await response.transform(utf8.decoder).join();
  String ip = json.decode(responseBody)['origin'];
  setState(() {
    _ipAddress = ip;
  });
}

Android	iOS

表单输入

文本字段允许用户在您的应用中键入文本，以便它们可用于构建表单，消息传递应用程序，搜索体验等。 Flutter提供了两个核心文本字段小部件：TextField和TextFormField。

如何使用文本字段小部件?

在React Native中，要输入文本，请使用“TextInput”组件来显示文本输入框然后使用回调将值存储在变量中。

// React Native
<TextInput
  placeholder="Enter your Password"
  onChangeText={password => this.setState({ password })}
 />
<Button title="Submit" onPress={this.validate} />

在Flutter中，使用TextEditingController类来管理TextField小部件。每当修改文本字段时，控制器都会通知其侦听器。

监听器读取文本和选择属性以了解用户键入的内容，您可以通过控制器的text属性访问TextField中的文本

// Flutter
final TextEditingController _controller = TextEditingController();
      ...
TextField(
  controller: _controller,
  decoration: InputDecoration(
    hintText: 'Type something', labelText: "Text Field "
  ),
),
RaisedButton(
  child: Text('Submit'),
  onPressed: () {
    showDialog(
      context: context,
        child: AlertDialog(
          title: Text('Alert'),
          content: Text('You typed ${_controller.text}'),
        ),
     );
   },
 ),
)

在此示例中，当用户单击“提交”按钮时，对话框将显示在文本字段中输入的当前文本。这是显示的使用提示消息的alertDialog小部件实现的，通过TextEditingController的text属性访问TextField 中的文本。

我如何使用表单小部件?

在Flutter中，使用 Form窗口小部件，其中TextFormField窗口小部件和提交按钮将作为子项传递。 TextFormField小部件有一个名为onSaved的参数，它接受回调并在保存表单时执行。 FormState对象用于保存，重置或验证作为此Form的后代的每个FormField 。要获取FormState, 可以将Form.of与其父类为Form的上下文一起使用，或将GlobalKey传递给Form构造函数并调用GlobalKey.currentState。

final formKey = GlobalKey<FormState>();

...

Form(
  key:formKey,
  child: Column(
    children: <Widget>[
      TextFormField(
        validator: (value) => !value.contains('@') ? 'Not a valid email.' : null,
        onSaved: (val) => _email = val,
        decoration: const InputDecoration(
          hintText: 'Enter your email',
          labelText: 'Email',
        ),
      ),
      RaisedButton(
        onPressed: _submit,
        child: Text('Login'),
      ),
    ],
  ),
)

下面的例子展示了Form.save（）和formKey（它是一个GlobalKey）用于在提交时保存表单。

void _submit() {
  final form = formKey.currentState;
  if (form.validate()) {
    form.save();
    showDialog(
      context: context,
      child: AlertDialog(
        title: Text('Alert'),
        content: Text('Email: $_email, password: $_password'),
      )
    );
  }
}

Android	iOS

特定于平台的代码

在构建跨平台应用程序时，您希望重用尽可能多的代码。但是，跨平台可能会出现这样的情况：根据操作系统，代码有所不同。这需要通过声明特定平台来单独实现。

在React Native中，将使用以下实现：

// React Native
if (Platform.OS === "ios") {
  return "iOS";
} else if (Platform.OS === "android") {
  return "android";
} else {
  return "not recognised";
}

在Flutter中，使用以下实现：

// Flutter
if (Theme.of(context).platform == TargetPlatform.iOS) {
  return "iOS";
} else if (Theme.of(context).platform == TargetPlatform.android) {
  return "android";
} else if (Theme.of(context).platform == TargetPlatform.fuchsia) {
  return "fuchsia";
} else {
  return "not recognised ";
}

调试

在运行应用程序之前，请使用flutter analyze验证您的代码。 Flutter分析器（它是dartanalyzer工具的包装器）检查您的代码并帮助识别可能的问题。如果您正在使用支持Flutter的IDE，则会自动执行此操作。

如何访问应用内开发人员菜单?

在React Native中，可以通过摇动设备来访问开发人员菜单：⌘D 适用于iOS模拟器或 ⌘M forAndroid模拟器。

在Flutter中，如果您使用的是IDE，则可以使用IDE工具。如果你开始你的应用程序使用flutter run你也可以通过在终端窗口输入h来访问菜单，或输入以下快捷方式：

Action	Terminal Shortcut	Debug functions and properties
Widget hierarchy of the app	`w`	debugDumpApp()
Rendering tree of the app	`t`	debugDumpRenderTree()
Layers	`L`	debugDumpLayerTree()
Accessibility	`S` (traversal order) or `U` (inverse hit test order)	debugDumpSemantics()
To toggle the widget inspector	`i`	WidgetsApp. showWidgetInspectorOverride
To toggle the display of construction lines	`p`	debugPaintSizeEnabled
To simulate different operating systems	`o`	defaultTargetPlatform
To display the performance overlay	`P`	WidgetsApp. showPerformanceOverlay
To save a screenshot to flutter. png	`s`
To quit	`q`

如何执行热重新加载?

Flutter的热重载功能可帮助您快速轻松地实验，构建UI，添加功能，并修复错误。而不是每次你重新编译你的应用程序更改，您可以立即热重新加载您的应用程序。该应用程序已更新以反映您的更改，并保留应用程序的当前状态。

在React Native中，快捷键为iOS模拟器的⌘R，并且两次点击R两次Android模拟器。

在Flutter中，如果您使用的是IntelliJ IDE或Android Studio，则可以选择“保存”全部（⌘s/ ctrl-s），或者您可以单击工具栏上的“热重新加载”按钮。如果你使用flutter run在命令行运行应用程序，在中输入r 终端窗口。您还可以通过在中键入“R”来执行完全重新启动终端窗口。

我可以使用哪些工具在Flutter中调试我的应用程序?

当您需要调试时，可以使用几个选项和工具Flutter的应用程序

除了Flutter analyzer之外，Dart Observatory还是一个用于分析和调试Dart应用程序的工具。

如果您使用终端中的flutter run启动应用程序，则可以打开打印到终端窗口的Observatory URL的网页,例如: http://127.0.0.1:8100/.

Observatory包括对分析，检查堆，观察执行的代码行，调试内存泄漏和内存碎片的支持。有关更多信息，请参阅Observatory文档。当您下载并安装Dart SDK时，免费提供Observatory。

如果您使用的是IDE，则可以使用IDE调试器调试应用程序。

如果您使用的是IntelliJ和Android Studio，则可以使用Flutter Inspector。 Flutter Inspector使您更容易理解应用程序的原因正在渲染它的方式。它允许您：

将应用程序的UI结构视为小部件树
在您的设备或模拟器上选择一个点，然后找到相应的小部件渲染那些像素
查看各个小部件的属性
快速确定布局问题其原因

可以从View> Tool Windows> Flutter打开Flutter Inspector视图检查。仅在应用程序运行时显示内容。

要检查特定小部件，请在中选择Toggle inspect mode操作工具栏，然后在连接的手机或模拟器上单击所需的小部件。该小部件在应用程序的UI中突出显示。您将在IntelliJ中看到窗口小部件中的层次结构以及该窗口小部件的各个属性。

有关更多信息，请参阅调试 Flutter Apps.

动画

精心设计的动画使UI感觉直观，有助于优雅应用的外观和感觉，并改善用户体验。 Flutter的动画支持可以轻松实现简单和复杂的动画。 Flutter SDK包含许多包含标准动作效果的Material Design小部件，您可以轻松自定义这些效果以个性化您的应用。

在React Native中，动画API用于创建动画。

在Flutter中, 使用 Animation 类和 AnimationController 类.

Animation是一个代表当前值和状态（已完成和已消失）的抽象类。 AnimationController`类可以让你向前或向后播放动画，或停止动画并设置动画到特定值以自定义运动。

如何添加简单的淡入动画?

在下面的React Native示例中，动画组件FadeInView 是使用Animated API创建。初始不透明状态，最终状态和定义了转换发生的持续时间。动画组件添加到Animated组件中，不透明状态fadeAnim被映射到我们想要动画的Text组件的不透明度，然后，调用start（）来启动动画。

// React Native
class FadeInView extends React.Component {
  state = {
    fadeAnim: new Animated.Value(0) // Initial value for opacity: 0
  };
  componentDidMount() {
    Animated.timing(this.state.fadeAnim, {
      toValue: 1,
      duration: 10000
    }).start();
  }
  render() {
    return (
      <Animated.View style={%raw%}{{...this.props.style, opacity: this.state.fadeAnim }}{%endraw%} >
        {this.props.children}
      </Animated.View>
    );
  }
}
    ...
<FadeInView>
  <Text> Fading in </Text>
</FadeInView>
    ...

要在Flutter中创建相同的动画，请创建名为controller的AnimationController 对象并指定持续时间。默认情况下，AnimationController在给定的持续时间内线性生成范围从0.0到1.0的值。只要运行应用程序的设备准备好显示新帧，动画控制器就会生成一个新值。通常，此速率约为每秒60个值。

定义AnimationController时，必须传入vsync对象。该 vsync的存在可以防止屏幕外动画消耗不必要的动画资源。您可以通过添加将有状态对象用作vsync到TickerProviderStateMixin类定义。一个AnimationController 需要一个TickerProvider，它使用vsync参数配置构造函数。

Tween描述开始值和结束值之间的插值或从输入范围到输出范围的映射。若要将Tween对象与动画一起使用，请调用Tween对象的animate方法并将其传递给要修改的Animation对象。

对于此示例，使用FadeTransition小部件，并将opacity属性映射到animation 对象。

要启动动画，请使用controller.forward()。也可以使用控制器执行其他操作，例如fling()或repeat()。对于此示例，FlutterLogo 小部件在FadeTransition小部件中使用。

// Flutter
import 'package:flutter/material.dart';

void main() {
  runApp(Center(child: LogoFade()));
}

class LogoFade extends StatefulWidget {
  _LogoFadeState createState() => _LogoFadeState();
}

class _LogoFadeState extends State<LogoFade> with TickerProviderStateMixin {
  Animation animation;
  AnimationController controller;

  initState() {
    super.initState();
    controller = AnimationController(
        duration: const Duration(milliseconds: 3000), vsync: this);
    final CurvedAnimation curve =
    CurvedAnimation(parent: controller, curve: Curves.easeIn);
    animation = Tween(begin: 0.0, end: 1.0).animate(curve);
    controller.forward();
  }

  Widget build(BuildContext context) {
    return FadeTransition(
      opacity: animation,
      child: Container(
        height: 300.0,
        width: 300.0,
        child: FlutterLogo(),
      ),
    );
  }

  dispose() {
    controller.dispose();
    super.dispose();
  }
}

Android	iOS

如何向卡添加滑动动画?

在React Native中，使用PanResponder或第三方库滑动动画。

在Flutter中，要添加滑动动画，请使用Dismissible窗口小部件并嵌套子窗口小部件。

child: Dismissible(
  key: key,
  onDismissed: (DismissDirection dir) {
    cards.removeLast();
  },
  child: Container(
    ...
  ),
),

Android	iOS

React Native和Flutter Widget等效组件

下表列出了常用的React Native组件，这些组件映射到相应的Flutter窗口小部件和常用窗口小部件属性。

React Native Component	Flutter Widget	Description
Button	Raised Button	一个基本的凸起按钮。
	onPressed [required]	点击或以其他方式激活按钮时的回调。
	Child	按钮的标签.

Button	Flat Button	一个基本的平面按钮。
	onPressed [required]	点击或以其他方式激活按钮时的回调
	Child	按钮的标签.

ScrollView	ListView	可线性排列的小部件可滚动列表
	children	( <Widget> [ ]) 要显示的子窗口小部件列表。
	controller	[ Scroll Controller ] 可用于控制可滚动窗口小部件的对象
	itemExtent	[ double ] 如果为非null，则强制子项在滚动方向上具有给定范围。
	scroll Direction	[ Axis ] 滚动视图滚动的轴。

FlatList	ListView. builder()	根据需要创建的线性小部件数组的构造函数。
	itemBuilder [required]	[ Indexed Widget Builder] 帮助按需建立子项. 只有索引大于或等于零且小于itemCount才会调用此回调。
	itemCount	[ int ] 提高了ListView估计最大滚动范围的能力。

Image	Image	显示图像的小部件。
	image [required]	要显示的图像。
	Image. asset	提供了几种构造函数，用于指定图像的各种方式
	width, height, color, alignment	图像的样式和布局。
	fit	将图像刻入布局期间分配的空间.

Modal	ModalRoute	阻止与先前路由交互的路由.
	animation	驱动路线过渡和前一路线前进过渡的动画

Activity Indicator	Circular Progress Indicator	显示沿圆圈进度的小部件。
	strokeWidth	用于绘制圆的线条的宽度。
	backgroundColor	进度指示器的背景颜色。默认情况下，当前主题.

Activity Indicator	Linear Progress Indicator	显示沿圆圈进度的小部件。
	value	此进度指示器的值.

Refresh Control	Refresh Indicator	支持Material“下滑刷新”成语的小部件.
	color	进度指示器的前景色
	onRefresh	当用户拖动刷新指示器足以证明他们希望应用程序刷新时调用的函数.

View	Container	围绕子窗口小部件的窗口小部件

View	Column	一个窗口小部件，用于在垂直数组中显示其子项

View	Row	一个小部件，用于在水平数组中显示其子项.

View	Center	A widget that centers its child within itself.

View	Padding	一个小部件，通过给定的填充来保护其子级。
	padding [required]	[ EdgeInsets ] 插入孩子的空间量

Touchable Opacity	Gesture Detector	检测手势的小部件。
	onTap	点击发生时的回调
	onDoubleTap	当快速连续两次在同一位置发生敲击时的回调。

Text Input	Text Input	系统文本输入控件的界面。
	controller	[ Text Editing Controller ] 用于访问和修改文本。

Text	Text	Text小部件，显示具有单个样式的文本字符串.
	data	[ String ] 要显示的文本。
	textDirection	[ Text Align ] 文本流动的方向.

Switch	Switch	A material design switch.
	value [required]	[ boolean ] 此开关是打开还是关闭
	onChanged [required]	[ callback ] 当用户打开或关闭开关时调用。

Slider	Slider	用于从一系列值中进行选择.
	value [required]	[ double ] 滑块的当前值.
	onChanged [required]	当用户为滑块选择新值时调用。

Files

flutter-for-react-native.md

Latest commit

History

flutter-for-react-native.md

File metadata and controls

介绍Dart for JavaScript 开发者

入口点

打印到控制台

变量

创建和分配变量

默认值

检查null或零

Functions

异步编程

Futures

async 和 await

基础

如何创建Flutter应用程序?

我如何运行我的应用程序?

如何导入?

Flutter中的应用程序中，什么是React Native“Hello world！”的等价物?

如何使用组件并将其嵌套以形成组件树?

如何创建可重用组件?

项目结构和资源

我从哪里开始编写代码?

在Flutter项目的目录结构是怎样的?

我在哪里放置我的代码和资源文件以及如何使用它们?

如何通过网络加载图像?

如何安装第三方包和第三方包插件?

Flutter widgets

Views

什么是等效的“视图”容器?

什么是FlatList或SectionList的等价物?

如何使用Canvas绘制或渲染?

布局

如何使用小部件定义布局属性?

如何分层widgets?

样式

如何设置组件的样式?

我如何使用Icons和Colors?

如何添加样式主题?

状态管理

StatelessWidget

StatefulWidget

什么是StatefulWidget和StatelessWidget最佳实践?

1. 确定窗口小部件应该是StatefulWidget还是StatelessWidget

2. 确定哪个对象管理窗口小部件的状态（对于StatefulWidget）

3. StatefulWidget 和 Stated的子类

4. 将StatefulWidget添加到窗口小部件树中

Props

本地存储

如何存储应用程序全局的持久键值对?

路由

如何在页面之间导航?

如何使用选项卡导航和抽屉导航?

标签导航

抽屉导航

手势检测和触摸事件处理

如何监听窗口小部件单击或按压事件?

发出HTTP网络请求

如何从API调用中获取数据?

表单输入

如何使用文本字段小部件?

我如何使用表单小部件?

特定于平台的代码

调试

如何访问应用内开发人员菜单?

如何执行热重新加载?

我可以使用哪些工具在Flutter中调试我的应用程序?

动画

如何添加简单的淡入动画?

如何向卡添加滑动动画?

React Native和Flutter Widget等效组件

`async` 和 `await`

什么是`FlatList`或`SectionList`的等价物?

我如何使用`Icons`和`Colors`?