iOS开发者学习Flutter
flutter for ios 开发者
本文档适用那些希望将现有 ios 经验应用于 flutter 的开发者。如果你拥有 ios 开发基础,那么你可以使用这篇文档开始学习 flutter 的开发。
开发 flutter 时,你的 ios 经验和技能将会大有裨益,因为 flutter 依赖于移动操作系统的众多功能和配置。flutter 是用于为移动设备构建用户界面的全新方式,但它也有一个插件系统用于和 ios(及 android)进行非 ui 任务的通信。如果你是 ios 开发专家,则你不必将 flutter 彻底重新学习一遍。
你可以将此文档作为 cookbook,通过跳转并查找与你的需求最相关的问题。
views
uiview 相当于 flutter 中的什么?
在 ios 中,构建 ui 的过程中将大量使用 view 对象。这些对象都是 uiview
的实例。它们可以用作容器来承载其他的 uiview,最终构成你的界面布局。
在 flutter 中,你可以粗略地认为 widget
相当于 uiview
。widget 和 ios 中的控件并不完全等价,但当你试图去理解 flutter 是如何工作的时候,你可以认为它们是“声明和构建 ui 的方法”。
然而,widget 和 uiview 还是有些区别的。首先,widgets 拥有不同的生存时间:它们一直存在且保持不变,直到当它们需要被改变。当 widgets 和它们的状态被改变时,flutter 会构建一颗新的 widgets 树。作为对比,ios 中的 views 在改变时并不会被重新创建。但是与其说 views 是可变的实例,不如说它们被绘制了一次,并且直到使用 setneedsdisplay()
之后才会被重新绘制。
此外,不像 uiview,由于不可变性,flutter 的 widgets 非常轻量。这是因为它们本身并不是什么控件,也不会被直接绘制出什么,而只是 ui 的描述。
flutter 包含了 material 组件库。这些 widgets 遵循了 material 设计规范。md 是一个灵活的设计系统,并且为包括 ios 在内的。
但是用 flutter 实现任何的设计语言都非常的灵活和富有表现力。在 ios 平台,你可以使用 cupertino widgets 来构建遵循了 apple’s ios design language 的界面。
我怎么来更新 widgets?
在 ios 上更新 views,只需要直接改变它们就可以了。在 flutter 中,widgets 是不可变的,而且不能被直接更新。你需要去操纵 widget 的 state。
这也正是有状态的和无状态的 widget 这一概念的来源。一个 statelesswidget
正如它听起来一样,是一个没有附加状态的 widget。
statelesswidget
在你构建初始化后不再进行改变的界面时非常有用。
举个例子,你可能会用一个 uiimageview
来展示你的 logo image
。如果这个 logo 在运行时不会改变,那么你就可以在 flutter 中使用 statelesswidget
。
如果你希望在发起 http 请求时,依托接收到的数据动态的改变 ui,请使用 statefulwidget
。当 http 请求结束后,通知 flutter 框架 widget 的 state
更新了,好让系统来更新 ui。
有状态和无状态的 widget 之间一个非常重要的区别是,statefulwidget
拥有一个 state
对象来存储它的状态数据,并在 widget 树重建时携带着它,因此状态不会丢失。
如果你有疑惑,请记住以下规则:如果一个 widget 在它的 build
方法之外改变(例如,在运行时由于用户的操作而改变),它就是有状态的。如果一个 widget 在一次 build 之后永远不变,那它就是无状态的。但是,即便一个 widget 是有状态的,包含它的父亲 widget 也可以是无状态的,只要父 widget 本身不响应这些变化。
下面的例子展示了如何使用一个 statelesswidget
。一个常见的 statelesswidget
是 text
widget。如果你查看 text 的实现,你会发现它是 statelesswidget 的子类。
text(
'i like flutter!',
style: textstyle(fontweight: fontweight.bold),
);
阅读上面的代码,你可能会注意到 text
widget 并不显示地携带任何状态。它通过传入给它的构造器的数据来渲染,除此之外再无其他。
但是,如果你希望 i like flutter
在点击 floatingactionbutton
时动态的改变呢?
为了实现这个,用 statefulwidget
包裹 text
widget,并在用户点击按钮时更新它。
举个例子:
class sampleapp extends statelesswidget {
// this widget is the root of your application.
@override
widget build(buildcontext context) {
return materialapp(
title: 'sample app',
theme: themedata(
primaryswatch: colors.blue,
),
home: sampleapppage(),
);
}
}
class sampleapppage extends statefulwidget {
sampleapppage({key key}) : super(key: key);
@override
_sampleapppagestate createstate() => _sampleapppagestate();
}
class _sampleapppagestate extends state<sampleapppage> {
// default placeholder text
string texttoshow = "i like flutter";
void _updatetext() {
setstate(() {
// update the text
texttoshow = "flutter is awesome!";
});
}
@override
widget build(buildcontext context) {
return scaffold(
appbar: appbar(
title: text("sample app"),
),
body: center(child: text(texttoshow)),
floatingactionbutton: floatingactionbutton(
onpressed: _updatetext,
tooltip: 'update text',
child: icon(icons.update),
),
);
}
}
我怎么对 widget 布局?我的 storyboard 在哪?
在 ios 中,你可能会用 storyboard 文件来组织 views,并对它们设置约束,或者,你可能在 view controller 中使用代码来设置约束。在 flutter 中,你通过编写一个 widget 树来声明你的布局。
下面这个例子展示了如何展示一个带有 padding 的简单 widget:
@override
widget build(buildcontext context) {
return scaffold(
appbar: appbar(
title: text("sample app"),
),
body: center(
child: cupertinobutton(
onpressed: () {
setstate(() { _pressedcount += 1; });
},
child: text('hello'),
padding: edgeinsets.only(left: 10.0, right: 10.0),
),
),
);
}
你可以给任何的 widget 添加 padding,这很像 ios 中约束的功能。
你可以在 中查看 flutter 提供的布局。
我怎么在我的约束中添加或移除组件?
在 ios 中,你在父 view 中调用 addsubview()
或在子 view 中调用 removefromsuperview()
来动态地添加或移除子 views。在 flutter 中,由于 widget 不可变,所以没有和 addsubview()
直接等价的东西。作为替代,你可以向 parent 传入一个返回 widget 的函数,并用一个布尔值来控制子 widget 的创建。
下面这个例子展示了在点击 floatingactionbutton
时如何动态地切换两个 widgets:
class sampleapp extends statelesswidget {
// this widget is the root of your application.
@override
widget build(buildcontext context) {
return materialapp(
title: 'sample app',
theme: themedata(
primaryswatch: colors.blue,
),
home: sampleapppage(),
);
}
}
class sampleapppage extends statefulwidget {
sampleapppage({key key}) : super(key: key);
@override
_sampleapppagestate createstate() => _sampleapppagestate();
}
class _sampleapppagestate extends state<sampleapppage> {
// default value for toggle
bool toggle = true;
void _toggle() {
setstate(() {
toggle = !toggle;
});
}
_gettogglechild() {
if (toggle) {
return text('toggle one');
} else {
return cupertinobutton(
onpressed: () {},
child: text('toggle two'),
);
}
}
@override
widget build(buildcontext context) {
return scaffold(
appbar: appbar(
title: text("sample app"),
),
body: center(
child: _gettogglechild(),
),
floatingactionbutton: floatingactionbutton(
onpressed: _toggle,
tooltip: 'update text',
child: icon(icons.update),
),
);
}
}
我怎么对 widget 做动画?
在 ios 中,你通过调用 animate(withduration:animations:)
方法来给一个 view 创建动画。在 flutter 中,使用动画库来包裹 widgets,而不是创建一个动画 widget。
在 flutter 中,使用 animationcontroller
。这是一个可以暂停、寻找、停止、反转动画的 animation<double>
类型。它需要一个 ticker
当 vsync 发生时来发送信号,并且在每帧运行时创建一个介于 0 和 1 之间的线性插值(interpolation)。你可以创建一个或多个的 animation
并附加给一个 controller。
例如,你可能会用 curvedanimation
来实现一个 interpolated 曲线。在这个场景中,controller 是动画过程的“主人”,而 curvedanimation
计算曲线,并替代 controller 默认的线性模式。
当构建 widget 树时,你会把 animation
指定给一个 widget 的动画属性,比如 fadetransition
的 opacity,并告诉控制器开始动画。
下面这个例子展示了在点击 floatingactionbutton
之后,如何使用 fadetransition
来让 widget 淡出到 logo 图标:
class sampleapp extends statelesswidget {
// this widget is the root of your application.
@override
widget build(buildcontext context) {
return materialapp(
title: 'fade demo',
theme: themedata(
primaryswatch: colors.blue,
),
home: myfadetest(title: 'fade demo'),
);
}
}
class myfadetest extends statefulwidget {
myfadetest({key key, this.title}) : super(key: key);
final string title;
@override
_myfadetest createstate() => _myfadetest();
}
class _myfadetest extends state<myfadetest> with tickerproviderstatemixin {
animationcontroller controller;
curvedanimation curve;
@override
void initstate() {
controller = animationcontroller(duration: const duration(milliseconds: 2000), vsync: this);
curve = curvedanimation(parent: controller, curve: curves.easein);
}
@override
widget build(buildcontext context) {
return scaffold(
appbar: appbar(
title: text(widget.title),
),
body: center(
child: container(
child: fadetransition(
opacity: curve,
child: flutterlogo(
size: 100.0,
)
)
)
),
floatingactionbutton: floatingactionbutton(
tooltip: 'fade',
child: icon(icons.brush),
onpressed: () {
controller.forward();
},
),
);
}
@override
dispose() {
controller.dispose();
super.dispose();
}
}
更多信息,请参阅 animation & motion widgets, animations tutorial 以及 animations overview。
我该怎么绘图?
在 ios 上,你通过 coregraphics
来在屏幕上绘制线条和形状。flutter 有一套基于 canvas
类的不同的 api,还有 custompaint
和 custompainter
这两个类来帮助你绘图。后者实现你在 canvas 上的绘图算法。
想要学习如何实现一个笔迹画笔,请参考 collin 在 * 上的回答。
class signaturepainter extends custompainter {
signaturepainter(this.points);
final list<offset> points;
void paint(canvas canvas, size size) {
var paint = paint()
..color = colors.black
..strokecap = strokecap.round
..strokewidth = 5.0;
for (int i = 0; i < points.length - 1; i++) {
if (points[i] != null && points[i + 1] != null)
canvas.drawline(points[i], points[i + 1], paint);
}
}
bool shouldrepaint(signaturepainter other) => other.points != points;
}
class signature extends statefulwidget {
signaturestate createstate() => signaturestate();
}
class signaturestate extends state<signature> {
list<offset> _points = <offset>[];
widget build(buildcontext context) {
return gesturedetector(
onpanupdate: (dragupdatedetails details) {
setstate(() {
renderbox referencebox = context.findrenderobject();
offset localposition =
referencebox.globaltolocal(details.globalposition);
_points = list.from(_points)..add(localposition);
});
},
onpanend: (dragenddetails details) => _points.add(null),
child: custompaint(painter: signaturepainter(_points), size: size.infinite),
);
}
}
widget 的透明度在哪里?
在 ios 中,什么东西都会有一个 .opacity 或是 .alpha 的属性。在 flutter 中,你需要给 widget 包裹一个 opacity widget 来做到这一点。
我怎么创建自定义的 widgets?
在 ios 中,你编写 uiview
的子类,或使用已经存在的 view 来重载并实现方法,以达到特定的功能。在 flutter 中,你会组合()多个小的 widgets 来构建一个自定义的 widget(而不是扩展它)。
举个例子,如果你要构建一个 custombutton
,并在构造器中传入它的 label?那就组合 raisedbutton
和 label,而不是扩展 raisedbutton
。
class custombutton extends statelesswidget {
final string label;
custombutton(this.label);
@override
widget build(buildcontext context) {
return raisedbutton(onpressed: () {}, child: text(label));
}
}
然后就像你使用其他任何 flutter 的 widget 一样,使用你的 custombutton:
@override
widget build(buildcontext context) {
return center(
child: custombutton("hello"),
);
}
导航
我怎么在不同页面之间跳转?
在 ios 中,你可以使用管理了 view controller 栈的 uinavigationcontroller
来在不同的 view controller 之间跳转。
flutter 也有类似的实现,使用了 navigator
和 routes
。一个路由是 app 中“屏幕”或“页面”的抽象,而一个 navigator 是管理多个路由的 。你可以粗略地把一个路由对应到一个 uiviewcontroller
。navigator 的工作原理和 ios 中 uinavigationcontroller
非常相似,当你想跳转到新页面或者从新页面返回时,它可以 push()
和 pop()
路由。
在页面之间跳转,你有一对选择:
- 具体指定一个由路由名构成的
map
。(materialapp) - 直接跳转到一个路由。(widgetapp)
下面是构建一个 map 的例子:
void main() {
runapp(materialapp(
home: myapphome(), // becomes the route named '/'
routes: <string, widgetbuilder> {
'/a': (buildcontext context) => mypage(title: 'page a'),
'/b': (buildcontext context) => mypage(title: 'page b'),
'/c': (buildcontext context) => mypage(title: 'page c'),
},
));
}
通过把路由的名字 push
给一个 navigator
来跳转:
navigator.of(context).pushnamed('/b');
navigator
类不仅用来处理 flutter 中的路由,还被用来获取你刚 push 到栈中的路由返回的结果。通过 await
等待路由返回的结果来达到这点。
举个例子,要跳转到“位置”路由来让用户选择一个地点,你可能要这么做:
map coordinates = await navigator.of(context).pushnamed('/location');
之后,在 location 路由中,一旦用户选择了地点,携带结果一起 pop()
出栈:
navigator.of(context).pop({"lat":43.821757,"long":-79.226392});
我怎么跳转到其他 app?
在 ios 中,要跳转到其他 app,你需要一个特定的 url scheme。对系统级别的 app 来说,这个 scheme 取决于 app。为了在 flutter 中实现这个功能,你可以创建一个原生平台的整合层,或者使用现有的 ,例如 。
线程和异步
我怎么编写异步的代码?
dart 是单线程执行模型,但是它支持 isolate
(一种让 dart 代码运行在其他线程的方式)、事件循环和异步编程。除非你自己创建一个 isolate
,否则你的 dart 代码永远运行在 ui 线程,并由 event loop 驱动。flutter 的 event loop 和 ios 中的 main loop 相似——looper
是附加在主线程上的。
dart 的单线程模型并不意味着你写的代码一定是阻塞操作,从而卡住 ui。相反,使用 dart 语言提供的异步工具,例如 async
/ await
,来实现异步操作。
举个例子,你可以使用 async
/ await
来让 dart 帮你做一些繁重的工作,编写网络请求代码而不会挂起 ui:
loaddata() async {
string dataurl = "https://jsonplaceholder.typicode.com/posts";
http.response response = await http.get(dataurl);
setstate(() {
widgets = json.decode(response.body);
});
}
一旦 await
到网络请求完成,通过调用 setstate()
来更新 ui,这会触发 widget 子树的重建,并更新相关数据。
下面的例子展示了异步加载数据,并用 listview
展示出来:
import 'dart:convert';
import 'package:flutter/material.dart';
import 'package:http/http.dart' as http;
void main() {
runapp(sampleapp());
}
class sampleapp extends statelesswidget {
@override
widget build(buildcontext context) {
return materialapp(
title: 'sample app',
theme: themedata(
primaryswatch: colors.blue,
),
home: sampleapppage(),
);
}
}
class sampleapppage extends statefulwidget {
sampleapppage({key key}) : super(key: key);
@override
_sampleapppagestate createstate() => _sampleapppagestate();
}
class _sampleapppagestate extends state<sampleapppage> {
list widgets = [];
@override
void initstate() {
super.initstate();
loaddata();
}
@override
widget build(buildcontext context) {
return scaffold(
appbar: appbar(
title: text("sample app"),
),
body: listview.builder(
itemcount: widgets.length,
itembuilder: (buildcontext context, int position) {
return getrow(position);
}));
}
widget getrow(int i) {
return padding(
padding: edgeinsets.all(10.0),
child: text("row ${widgets[i]["title"]}")
);
}
loaddata() async {
string dataurl = "https://jsonplaceholder.typicode.com/posts";
http.response response = await http.get(dataurl);
setstate(() {
widgets = json.decode(response.body);
});
}
}
更多关于在后台工作的信息,以及 flutter 和 ios 的区别,请参考下一章节。
你是怎么把工作放到后台线程的?
由于 flutter 是单线程并且跑着一个 event loop 的(就像 node.js 那样),你不必为线程管理或是开启后台线程而操心。如果你正在做 i/o 操作,如访问磁盘或网络请求,安全地使用 async
/ await
就完事了。如果,在另外的情况下,你需要做让 cpu 执行繁忙的计算密集型任务,你需要使用 isolate
来避免阻塞 event loop。
对于 i/o 操作,通过关键字 async
,把方法声明为异步方法,然后通过await
关键字等待该异步方法执行完成(译者语:这和javascript中是相同的):
loaddata() async {
string dataurl = "https://jsonplaceholder.typicode.com/posts";
http.response response = await http.get(dataurl);
setstate(() {
widgets = json.decode(response.body);
});
}
这就是对诸如网络请求或数据库访问等 i/o 操作的典型做法。
然而,有时候你需要处理大量的数据,这会导致你的 ui 挂起。在 flutter 中,使用 isolate
来发挥多核心 cpu 的优势来处理那些长期运行或是计算密集型的任务。
isolates 是分离的运行线程,并且不和主线程的内存堆共享内存。这意味着你不能访问主线程中的变量,或者使用 setstate()
来更新 ui。正如它们的名字一样,isolates 不能共享内存。
下面的例子展示了一个简单的 isolate,是如何把数据返回给主线程来更新 ui 的:
loaddata() async {
receiveport receiveport = receiveport();
await isolate.spawn(dataloader, receiveport.sendport);
// the 'echo' isolate sends its sendport as the first message
sendport sendport = await receiveport.first;
list msg = await sendreceive(sendport, "https://jsonplaceholder.typicode.com/posts");
setstate(() {
widgets = msg;
});
}
// the entry point for the isolate
static dataloader(sendport sendport) async {
// open the receiveport for incoming messages.
receiveport port = receiveport();
// notify any other isolates what port this isolate listens to.
sendport.send(port.sendport);
await for (var msg in port) {
string data = msg[0];
sendport replyto = msg[1];
string dataurl = data;
http.response response = await http.get(dataurl);
// lots of json to parse
replyto.send(json.decode(response.body));
}
}
future sendreceive(sendport port, msg) {
receiveport response = receiveport();
port.send([msg, response.sendport]);
return response.first;
}
这里,dataloader()
是一个运行于自己独立执行线程上的 isolate
。在 isolate 里,你可以执行 cpu 密集型任务(例如解析一个庞大的 json),或是计算密集型的数学操作,如加密或信号处理等。
你可以运行下面的完整例子:
import 'dart:convert';
import 'package:flutter/material.dart';
import 'package:http/http.dart' as http;
import 'dart:async';
import 'dart:isolate';
void main() {
runapp(sampleapp());
}
class sampleapp extends statelesswidget {
@override
widget build(buildcontext context) {
return materialapp(
title: 'sample app',
theme: themedata(
primaryswatch: colors.blue,
),
home: sampleapppage(),
);
}
}
class sampleapppage extends statefulwidget {
sampleapppage({key key}) : super(key: key);
@override
_sampleapppagestate createstate() => _sampleapppagestate();
}
class _sampleapppagestate extends state<sampleapppage> {
list widgets = [];
@override
void initstate() {
super.initstate();
loaddata();
}
showloadingdialog() {
if (widgets.length == 0) {
return true;
}
return false;
}
getbody() {
if (showloadingdialog()) {
return getprogressdialog();
} else {
return getlistview();
}
}
getprogressdialog() {
return center(child: circularprogressindicator());
}
@override
widget build(buildcontext context) {
return scaffold(
appbar: appbar(
title: text("sample app"),
),
body: getbody());
}
listview getlistview() => listview.builder(
itemcount: widgets.length,
itembuilder: (buildcontext context, int position) {
return getrow(position);
});
widget getrow(int i) {
return padding(padding:edgeinsets.all(10.0),child:text("row ${widgets[i]["title"]}"));}
loaddata()async {
receiveport receiveport = receiveport();await isolate.spawn(dataloader, receiveport.sendport);// the 'echo' isolate sends its sendport as the first message
sendport sendport = await receiveport.first;
list msg = await sendreceive(sendport, "https://jsonplaceholder.typicode.com/posts");setstate((){
widgets = msg;
});}
// the entry point for the isolate
static dataloader(sendport sendport) async {
// open the receiveport for incoming messages.
receiveport port = receiveport();// notify any other isolates what port this isolate listens to.
sendport.send(port.sendport);await for (var msg in port) {
string data = msg[0];sendport replyto = msg[1];string dataurl = data;
http.response response = await http.get(dataurl);// lots of json to parse
replyto.send(json.decode(response.body));}
}
future sendreceive(sendport port, msg) {
receiveport response = receiveport();port.send([msg, response.sendport]);return response.first;
}
}
我怎么发起网络请求?
在 flutter 中,使用流行的 做网络请求非常简单。它把你可能需要自己做的网络请求操作抽象了出来,让发起请求变得简单。
要使用 http
包,在 pubspec.yaml
中把它添加为依赖:
dependencies:
...
http: ^0.11.3+16
发起网络请求,在 http.get()
这个 async
方法中使用 await
:
import 'dart:convert';
import 'package:flutter/material.dart';
import 'package:http/http.dart' as http;
[...]
loaddata() async {
string dataurl = "https://jsonplaceholder.typicode.com/posts";
http.response response = await http.get(dataurl);
setstate(() {
widgets = json.decode(response.body);
});
}
}
我怎么展示一个长时间运行的任务的进度?
在 ios 中,在后台运行耗时任务时你会使用 uiprogressview
。
在 flutter 中,使用一个 progressindicator
widget。通过一个布尔 flag 来控制是否展示进度。在任务开始时,告诉 flutter 更新状态,并在结束后隐去。
在下面的例子中,build 函数被拆分成三个函数。如果 showloadingdialog()
是 true
(当 widgets.length == 0
时),则渲染 progressindicator
。否则,当数据从网络请求中返回时,渲染 listview
。
import 'dart:convert';
import 'package:flutter/material.dart';
import 'package:http/http.dart' as http;
void main() {
runapp(sampleapp());
}
class sampleapp extends statelesswidget {
@override
widget build(buildcontext context) {
return materialapp(
title: 'sample app',
theme: themedata(
primaryswatch: colors.blue,
),
home: sampleapppage(),
);
}
}
class sampleapppage extends statefulwidget {
sampleapppage({key key}) : super(key: key);
@override
_sampleapppagestate createstate() => _sampleapppagestate();
}
class _sampleapppagestate extends state<sampleapppage> {
list widgets = [];
@override
void initstate() {
super.initstate();
loaddata();
}
showloadingdialog() {
return widgets.length == 0;
}
getbody() {
if (showloadingdialog()) {
return getprogressdialog();
} else {
return getlistview();
}
}
getprogressdialog() {
return center(child: circularprogressindicator());
}
@override
widget build(buildcontext context) {
return scaffold(
appbar: appbar(
title: text("sample app"),
),
body: getbody());
}
listview getlistview() => listview.builder(
itemcount: widgets.length,
itembuilder: (buildcontext context, int position) {
return getrow(position);
});
widget getrow(int i) {
return padding(padding: edgeinsets.all(10.0),child:text("row ${widgets[i]["title"]}"));}
loaddata()async {
string dataurl = "https://jsonplaceholder.typicode.com/posts";
http.response response = await http.get(dataurl);setstate((){
widgets = json.decode(response.body);});}
}
工程结构、本地化、依赖和资源
我怎么在 flutter 中引入 image assets?多分辨率怎么办?
ios 把 images 和 assets 作为不同的东西,而 flutter 中只有 assets。被放到 ios 中 images.xcasset
文件夹下的资源在 flutter 中被放到了 assets 文件夹中。assets 可以是任意类型的文件,而不仅仅是图片。例如,你可以把 json 文件放置到 my-assets
文件夹中。
my-assets/data.json
在 pubspec.yaml
文件中声明 assets:
assets:
- my-assets/data.json
然后在代码中使用 assetbundle
来访问它:
import 'dart:async' show future;
import 'package:flutter/services.dart' show rootbundle;
future<string> loadasset() async {
return await rootbundle.loadstring('my-assets/data.json');
}
对于图片,flutter 像 ios 一样,遵循了一个简单的基于像素密度的格式。image assets 可能是 1.0x
2.0x
3.0x
或是其他的任何倍数。这些所谓的 devicepixelratio
传达了物理像素到单个逻辑像素的比率。
assets 可以被放置到任何属性文件夹中——flutter 并没有预先定义的文件结构。在 pubspec.yaml
文件中声明 assets (和位置),然后 flutter 会把他们识别出来。
举个例子,要把一个叫 my_icon.png
的图片放到 flutter 工程中,你可能想要把存储它的文件夹叫做 images
。把基础图片(1.0x)放置到 images
文件夹中,并把其他变体放置在子文件夹中,并接上合适的比例系数:
images/my_icon.png // base: 1.0x image
images/2.0x/my_icon.png // 2.0x image
images/3.0x/my_icon.png // 3.0x image
接着,在 pubspec.yaml
文件夹中声明这些图片:
assets:
- images/my_icon.jpeg
你可以用 assetimage
来访问这些图片:
return assetimage("images/a_dot_burr.jpeg");
或者在 image
widget 中直接使用:
@override
widget build(buildcontext context) {
return image.asset("images/my_image.png");
}
更多细节,参见 adding assets and images in flutter。
我在哪里放置字符串?我怎么做本地化?
不像 ios 拥有一个 localizable.strings
文件,flutter 目前并没有一个用于处理字符串的系统。目前,最佳实践是把你的文本拷贝到静态区,并在这里访问。例如:
class strings {
static string welcomemessage = "welcome to flutter";
}
并且这样访问你的字符串:
text(strings.welcomemessage)
默认情况下,flutter 只支持美式英语字符串。如果你要支持其他语言,请引入 flutter_localizations
包。你可能也要引入 包来支持其他的 i10n 机制,比如日期/时间格式化。
dependencies:
# ...
flutter_localizations:
sdk: flutter
intl: "^0.15.6"
要使用 flutter_localizations
包,还需要在 app widget 中指定 localizationsdelegates
和 supportedlocales
。
import 'package:flutter_localizations/flutter_localizations.dart';
materialapp(
localizationsdelegates: [
// add app-specific localization delegate[s] here
globalmateriallocalizations.delegate,
globalwidgetslocalizations.delegate,
],
supportedlocales: [
const locale('en', 'us'), // english
const locale('he', 'il'), // hebrew
// ... other locales the app supports
],
// ...
)
这些代理包括了实际的本地化值,并且 supportedlocales
定义了 app 支持哪些地区。上面的例子使用了一个 materialapp
,所以它既有 globalwidgetslocalizations
用于基础 widgets,也有 materialwidgetslocalizations
用于 material wigets 的本地化。如果你使用 widgetsapp
,则无需包括后者。注意,这两个代理虽然包括了“默认”值,但如果你想让你的 app 本地化,你仍需要提供一或多个代理作为你的 app 本地化副本。
当初始化时,widgetsapp
或 materialapp
会使用你指定的代理为你创建一个 localizations
widget。localizations
widget 可以随时从当前上下文中访问设备的地点,或者使用 window.locale
。
要访问本地化文件,使用 localizations.of()
方法来访问提供代理的特定本地化类。如需翻译,使用 包来取出翻译副本到 arb 文件中。把它们引入 app 中,并用 intl
来使用它们。
更多 flutter 中国际化和本地化的细节,请访问 ,那里有不使用 intl
包的示例代码。
注意,在 flutter 1.0 beta 2 之前,在 flutter 中定义的 assets 不能在原生一侧被访问。原生定义的资源在 flutter 中也不可用,因为它们在独立的文件夹中。
cocoapods 相当于什么?我该如何添加依赖?
在 ios 中,你把依赖添加到 podfile
中。flutter 使用 dart 构建系统和 pub 包管理器来处理依赖。这些工具将本机 android 和 ios 包装应用程序的构建委派给相应的构建系统。
如果你的 flutter 工程中的 ios 文件夹中拥有 podfile,请仅在你为每个平台集成时使用它。总体来说,使用 pubspec.yaml
来在 flutter 中声明外部依赖。一个可以找到优秀 flutter 包的地方是 pub。
viewcontrollers
viewcontroller 相当于 flutter 中的什么?
在 ios 中,一个 viewcontroller 代表了用户界面的一部分,最常用于一个屏幕,或是其中一部分。它们被组合在一起用于构建复杂的用户界面,并帮助你拆分 app 的 ui。在 flutter 中,这一任务回落到了 widgets 中。就像在界面导航部分提到的一样,一个屏幕也是被 widgets 来表示的,因为“万物皆 widget!”。使用 navigator
在 route
之间跳转,或者渲染相同数据的不同状态。
我该怎么监听 ios 中的生命周期事件?
在 ios 中,你可以重写 viewcontroller
中的方法来补货它的视图的生命周期,或者在 appdelegate
中注册生命周期的回调函数。在 flutter 中没有这两个概念,但你可以通过 hook widgetsbinding
观察者来监听生命周期事件,并监听 didchangeapplifecyclestate()
的变化事件。
可观察的生命周期事件有:
-
inactive
- 应用处于不活跃的状态,并且不会接受用户的输入。这个事件仅工作在 ios 平台,在 android 上没有等价的事件。 -
paused
- 应用暂时对用户不可见,虽然不接受用户输入,但是是在后台运行的。 -
resumed
- 应用可见,也响应用户的输入。 -
suspending
- 应用暂时被挂起,在 ios 上没有这一事件。
更多关于这些状态的细节和含义,请参见 applifecyclestatus
documentation 。
布局
uitableview 和 uicollectionview 相当于 flutter 中的什么?
在 ios 中,你可能用 uitableview 或 uicollectionview 来展示一个列表。在 flutter 中,你可以用 listview
来达到相似的实现。在 ios 中,你通过代理方法来确定行数,每一个 index path 的单元格,以及单元格的尺寸。
由于 flutter 中 widget 的不可变特性,你需要向 listview
传递一个 widget 列表,flutter 会确保滚动是快速且流畅的。
import 'package:flutter/material.dart';
void main() {
runapp(sampleapp());
}
class sampleapp extends statelesswidget {
// this widget is the root of your application.
@override
widget build(buildcontext context) {
return materialapp(
title: 'sample app',
theme: themedata(
primaryswatch: colors.blue,
),
home: sampleapppage(),
);
}
}
class sampleapppage extends statefulwidget {
sampleapppage({key key}) : super(key: key);
@override
_sampleapppagestate createstate() => _sampleapppagestate();
}
class _sampleapppagestate extends state<sampleapppage> {
@override
widget build(buildcontext context) {
return scaffold(
appbar: appbar(
title: text("sample app"),
),
body: listview(children: _getlistdata()),
);
}
_getlistdata() {
list<widget> widgets = [];
for (int i = 0; i < 100; i++) {
widgets.add(padding(padding: edgeinsets.all(10.0), child: text("row $i")));
}
return widgets;
}
}
我怎么知道列表的哪个元素被点击了?
ios 中,你通过 tableview:didselectrowatindexpath:
代理方法来实现。在 flutter 中,使用传递进来的 widget 的 touch handle:
import 'package:flutter/material.dart';
void main() {
runapp(sampleapp());
}
class sampleapp extends statelesswidget {
// this widget is the root of your application.
@override
widget build(buildcontext context) {
return materialapp(
title: 'sample app',
theme: themedata(
primaryswatch: colors.blue,
),
home: sampleapppage(),
);
}
}
class sampleapppage extends statefulwidget {
sampleapppage({key key}) : super(key: key);
@override
_sampleapppagestate createstate() => _sampleapppagestate();
}
class _sampleapppagestate extends state<sampleapppage> {
@override
widget build(buildcontext context) {
return scaffold(
appbar: appbar(
title: text("sample app"),
),
body: listview(children: _getlistdata()),
);
}
_getlistdata() {
list<widget> widgets = [];
for (int i = 0; i < 100; i++) {
widgets.add(gesturedetector(
child: padding(
padding: edgeinsets.all(10.0),
child: text("row $i"),
),
ontap: () {
print('row tapped');
},
));
}
return widgets;
}
}
我怎么动态地更新 listview?
在 ios 中,你改变列表的数据,并通过 reloaddata()
方法来通知 table 或是 collection view。
在 flutter 中,如果你想通过 setstate()
方法来更新 widget 列表,你会很快发现你的数据展示并没有变化。这是因为当 setstate()
被调用时,flutter 渲染引擎会去检查 widget 树来查看是否有什么地方被改变了。当它得到你的 listview
时,它会使用一个 ==
判断,并且发现两个 listview
是相同的。没有什么东西是变了的,因此更新不是必须的。
一个更新 listview
的简单方法是,在 setstate()
中创建一个新的 list,并把旧 list 的数据拷贝给新的 list。虽然这样很简单,但当数据集很大时,并不推荐这样做:
import 'package:flutter/material.dart';
void main() {
runapp(sampleapp());
}
class sampleapp extends statelesswidget {
// this widget is the root of your application.
@override
widget build(buildcontext context) {
return materialapp(
title: 'sample app',
theme: themedata(
primaryswatch: colors.blue,
),
home: sampleapppage(),
);
}
}
class sampleapppage extends statefulwidget {
sampleapppage({key key}) : super(key: key);
@override
_sampleapppagestate createstate() => _sampleapppagestate();
}
class _sampleapppagestate extends state<sampleapppage> {
list widgets = [];
@override
void initstate() {
super.initstate();
for (int i = 0; i < 100; i++) {
widgets.add(getrow(i));
}
}
@override
widget build(buildcontext context) {
return scaffold(
appbar: appbar(
title: text("sample app"),
),
body: listview(children: widgets),
);
}
widget getrow(int i) {
return gesturedetector(
child: padding(
padding: edgeinsets.all(10.0),
child: text("row $i"),
),
ontap: () {
setstate(() {
widgets = list.from(widgets);
widgets.add(getrow(widgets.length + 1));
print('row $i');
});
},
);
}
}
一个推荐的、高效的且有效的做法是,使用 listview.builder
来构建列表。这个方法在你想要构建动态列表,或是列表拥有大量数据时会非常好用。
import 'package:flutter/material.dart';
void main() {
runapp(sampleapp());
}
class sampleapp extends statelesswidget {
// this widget is the root of your application.
@override
widget build(buildcontext context) {
return materialapp(
title: 'sample app',
theme: themedata(
primaryswatch: colors.blue,
),
home: sampleapppage(),
);
}
}
class sampleapppage extends statefulwidget {
sampleapppage({key key}) : super(key: key);
@override
_sampleapppagestate createstate() => _sampleapppagestate();
}
class _sampleapppagestate extends state<sampleapppage> {
list widgets = [];
@override
void initstate() {
super.initstate();
for (int i = 0; i < 100; i++) {
widgets.add(getrow(i));
}
}
@override
widget build(buildcontext context) {
return scaffold(
appbar: appbar(
title: text("sample app"),
),
body: listview.builder(
itemcount: widgets.length,
itembuilder: (buildcontext context, int position) {
return getrow(position);
},
),
);
}
widget getrow(int i) {
return gesturedetector(
child: padding(
padding: edgeinsets.all(10.0),
child: text("row $i"),
),
ontap: () {
setstate(() {
widgets.add(getrow(widgets.length + 1));
print('row $i');
});},);}
}
与创建一个 “listview” 不同,创建一个 listview.builder
接受两个主要参数:列表的初始长度,和一个 itembuilder
方法。
itembuilder
方法和 cellforitemat
代理方法非常类似,它接受一个位置,并且返回在这个位置上你希望渲染的 cell。
最后,也是最重要的,注意 ontap()
函数里并没有重新创建一个 list,而是 .add
了一个 widget。
scrollview 相当于 flutter 里的什么?
在 ios 中,你给 view 包裹上 scrollview
来允许用户在需要时滚动你的内容。
在 flutter 中,最简单的方法是使用 listview
widget。它表现得既和 ios 中的 scrollview
一致,也能和 tableview
一致,因为你可以给它的 widget 做垂直排布:
@override
widget build(buildcontext context) {
return listview(
children: <widget>[
text('row one'),
text('row two'),
text('row three'),
text('row four'),
],
);
}
更多关于在 flutter 总如何排布 widget 的文档,请参阅 。
手势检测及触摸事件处理
我怎么给 flutter 的 widget 添加一个点击监听者?
在 ios 中,你给一个 view 添加 gesturerecognizer
来处理点击事件。在 flutter 中,有两种方法来添加点击监听者:
-
如果 widget 本身支持事件监测,直接传递给它一个函数,并在这个函数里实现响应方法。例如,
raisedbutton
widget 拥有一个raisedbutton
参数:@override widget build(buildcontext context) { return raisedbutton( onpressed: () { print("click"); }, child: text("button"), ); }
-
如果 widget 本身不支持事件监测,则在外面包裹一个 gesturedetector,并给它的 ontap 属性传递一个函数:
class sampleapp extends statelesswidget { @override widget build(buildcontext context) { return scaffold( body: center( child: gesturedetector( child: flutterlogo( size: 200.0, ), ontap: () { print("tap"); }, ), ), ); } }
我怎么处理 widget 上的其他手势?
使用 gesturedetector
你可以监听更广阔范围内的手势,比如:
- tapping
-
ontapdown
— 在特定位置轻触手势接触了屏幕。 -
ontapup
— 在特定位置产生了一个轻触手势,并停止接触屏幕。 -
ontap
— 产生了一个轻触手势。 -
ontapcancel
— 触发了ontapdown
但没能触发 tap。
-
- double tapping
-
ondoubletap
— 用户在同一个位置快速点击了两下屏幕。
-
- long pressing
-
onlongpress
— 用户在同一个位置长时间接触屏幕。
-
- vertical dragging
-
onverticaldragstart
— 接触了屏幕,并且可能会垂直移动。 -
onverticaldragupdate
— 接触了屏幕,并继续在垂直方向移动。 -
onverticaldragend
— 之前接触了屏幕并垂直移动,并在停止接触屏幕前以某个垂直的速度移动。
-
- horizontal dragging
-
onhorizontaldragstart
— 接触了屏幕,并且可能会水平移动。 -
onhorizontaldragupdate
— 接触了屏幕,并继续在水平方向移动。 -
onhorizontaldragend
— 之前接触屏幕并水平移动的触摸点与屏幕分离。
-
下面这个例子展示了一个 gesturedetector
是如何在双击时旋转 flutter 的 logo 的:
animationcontroller controller;
curvedanimation curve;
@override
void initstate() {
controller = animationcontroller(duration: const duration(milliseconds: 2000), vsync: this);
curve = curvedanimation(parent: controller, curve: curves.easein);
}
class sampleapp extends statelesswidget {
@override
widget build(buildcontext context) {
return scaffold(
body: center(
child: gesturedetector(
child: rotationtransition(
turns: curve,
child: flutterlogo(
size: 200.0,
)),
ondoubletap: () {
if (controller.iscompleted) {
controller.reverse();
} else {
controller.forward();
}
},
),
),
);
}
}
主题和文字
我怎么给 app 设置主题?
flutter 实现了一套漂亮的 md 组件,并且开箱可用。它接管了一大堆你需要的样式和主题。
为了充分发挥你的 app 中 md 组件的优势,声明一个* widget,materialapp,用作你的 app 入口。materialapp 是一个便利组件,包含了许多 app 通常需要的 md 风格组件。它通过一个 widgetsapp 添加了 md 功能来实现。
但是 flutter 足够地灵活和富有表现力来实现任何其他的设计语言。在 ios 上,你可以用 cupertino library 来制作遵守 human interface guidelines 的界面。查看这些 widget 的集合,请参阅 cupertino widgets gallery。
你也可以在你的 app 中使用 widgetapp,它提供了许多相似的功能,但不如 materialapp
那样强大。
对任何子组件定义颜色和样式,可以给 materialapp
widget 传递一个 themedata
对象。举个例子,在下面的代码中,primary swatch 被设置为蓝色,并且文字的选中颜色是红色:
class sampleapp extends statelesswidget {
@override
widget build(buildcontext context) {
return materialapp(
title: 'sample app',
theme: themedata(
primaryswatch: colors.blue,
textselectioncolor: colors.red
),
home: sampleapppage(),
);
}
}
我怎么给 text widget 设置自定义字体?
在 ios 中,你在项目中引入任意的 ttf
文件,并在 info.plist
中设置引用。在 flutter 中,在文件夹中放置字体文件,并在 pubspec.yaml
中引用它,就像添加图片那样。
fonts:
- family: mycustomfont
fonts:
- asset: fonts/mycustomfont.ttf
- style: italic
然后在你的 text
widget 中指定字体:
@override
widget build(buildcontext context) {
return scaffold(
appbar: appbar(
title: text("sample app"),
),
body: center(
child: text(
'this is a custom font text',
style: textstyle(fontfamily: 'mycustomfont'),
),
),
);
}
我怎么给我的 text widget 设置样式?
除了字体以外,你也可以给 text widget 的样式元素设置自定义值。text
widget 接受一个 textstyle
对象,你可以指定许多参数,比如:
color
decoration
decorationcolor
decorationstyle
fontfamily
fontsize
fontstyle
fontweight
hashcode
height
inherit
letterspacing
textbaseline
wordspacing
表单输入
flutter 中表单怎么工作?我怎么拿到用户的输入?
我们已经提到 flutter 使用不可变的 widget,并且状态是分离的,你可能会好奇在这种情境下怎么处理用户的输入。在 ios 中,你经常在需要提交数据时查询组件当前的状态或动作,但这在 flutter 中是怎么工作的呢?
在表单处理的实践中,就像在 flutter 中任何其他的地方一样,要通过特定的 widgets。如果你有一个 textfield
或是 textformfield
,你可以通过