Crie apps mobile reativos em Flutter — artigo complementar
Aprenda os princípios e padrões por trás da criação de apps mobile reativos e do gerenciamento de estado no Flutter.
ATUALIZAÇÃO (março de 2019) — Se você está começando a aprender sobre Flutter e gerenciamento de estado, recomendo que leia a seção sobre gerenciamento de estado em flutter.dev em vez deste artigo. Eu escrevi tanto este artigo quanto a seção em flutter.dev, e acho esta última mais acessível e completa. Ela também é mais recente.
No Google I/O, Matt e eu demos uma palestra sobre gerenciamento de estado chamada Crie apps móveis reativos em Flutter. Se você não a assistiu, pode vê-la abaixo:
O código da palestra está no GitHub:
Este artigo trata das coisas que não couberam na sessão de 33 minutos.
ValueNotifier
ValueNotifier é uma implementação básica de observável que vem com o framework Flutter. Ele tem um valor, listeners (callbacks) e chama os listeners sempre que o valor muda. A funcionalidade é implementada em cerca de
200
linhas de código Dart, a maior parte delas comentários de documentação.
Você pode usar ValueNotifier assim:
final counter = ValueNotifier(0);
counter.addListener(_myCallback);
counter.value = 10; // Calls _myCallback.
counter.value += 1; // Also calls _myCallback.
counter.removeListener(_myCallback);
counter.value += 1; // Doesn't call anything.
counter.dispose();
Em outras palavras, sempre que você atribuir um novo valor a value, todos os listeners registrados serão chamados.
Você pode estender ValueNotifier para obter mais funcionalidades. Isso faz mais sentido com valores mutáveis.
class CartObservable extends ValueNotifier<Cart> {
CartObservable(Cart value) : super(value);
void add(Product product) {
value.add(product);
notifyListeners();
}
}
A vantagem de ValueNotifier é que ele é simples, fácil de entender e já vem incluído no Flutter. Também é completamente síncrono, o que pode ser uma vantagem em alguns casos. Por si só, ele não ajuda com o acesso (você ainda vai precisar passar o objeto de algum jeito — por meio de InheritedWidget ou, para árvores de widgets rasas, pelos construtores), e você ainda vai precisar chamar manualmente setState() e gerenciar os listeners.
Referências do Firebase / Cloud Firestore
Na palestra, mostramos como usar o widget StreamBuilder para reconstruir a UI automaticamente quando o estado muda.
Cloud Firestore (e seu irmão mais velho, Firebase Realtime Database) têm ótimos plugins para Flutter (cloud_firestore
e firebase_database), e esses plugins usam Streams. Assim, por exemplo, você pode simplesmente conectar os snapshots do Firestore a um StreamBuilder, e pronto.
StreamBuilder(
stream: Firestore.instance.collection('baby').snapshots(),
builder: (context, snapshot) {
if (!snapshot.hasData) return const Text('Loading...');
return ListView.builder(
itemCount: snapshot.data.documents.length,
itemBuilder: (context, index) {
DocumentSnapshot ds = snapshot.data.documents[index];
return Text("${ds['name']} ${ds['votes']}");
}
);
},
);
Isso é tudo o que você precisa se seu app apenas exibe dados ou se a lógica de negócio é bem simples. Você pode saber mais no codelab de Firebase para Flutter.
Claro que, conforme o seu app cresce, você pode deixar de expor o stream bruto do Firebase para os widgets e encapsulá-lo. Por exemplo, um componente de lógica de negócio pode se comunicar internamente com um banco de dados em tempo real, enquanto os widgets não precisam saber disso.
InheritedWidget
Usamos InheritedWidget extensivamente na nossa palestra: implicitamente com ScopedModel, que se baseia em InheritedWidget, e explicitamente com BLoC, para passar referências a streams de dados. InheritedWidget
faz parte da plataforma central do Flutter e oferece uma forma simples de tornar os dados acessíveis em qualquer ponto de uma árvore de widgets.
Definir um InheritedWidget é simples:
class MyInheritedValue extends InheritedWidget {
const MyInheritedValue({
Key key,
@required this.value,
@required Widget child,
}) : assert(value != null),
assert(child != null),
super(key: key, child: child);
final int value;
static MyInheritedValue of(BuildContext context) {
return context.inheritFromWidgetOfExactType(MyInheritedValue);
}
@override
bool updateShouldNotify(MyInheritedValue old) =>
value != old.value;
}
Também é fácil fornecê-lo a um ancestral:
Widget build(BuildContext context) {
return MyInheritedValue(
value: 42,
child: ...
);
}
E é fácil usá-lo em qualquer ponto da árvore.
MyInheritedValue.of(context).value
Embora InheritedWidget seja útil para manter sua árvore de widgets DRY e encapsulada (já que as referências aos dados não precisam ser passadas explicitamente), observe que os dados são imutáveis. Para usar InheritedWidget no rastreamento de dados que mudam, você pode a) envolvê-los em um StatefulWidget
ou b) usar streams ou ValueNotifier dentro do InheritedWidget.
Redux
O que mais se pode dizer sobre o Redux que ainda não foi dito em outros lugares? Basta dizer que o Dart tem uma implementação do Redux, e existe uma extensão do Flutter que oferece um framework de widgets elegante por cima dela.
Na prática, a estrutura de widgets é muito parecida com a do Scoped Model, em que um StoreProvider
dá acesso ao estado em toda a árvore de widgets, por meio do StoreConnector.
Há um exemplo simples de uso do Redux para gerenciar estado no app incrementador padrão do Flutter no site do pub. Também há um exemplo mais sofisticado, com um app de exemplo de lista de tarefas. Se você se interessa por usar Redux no Flutter, vale conferir.
Business Logic Components (BLoC)
Se você se interessa pelo conceito de business logic components, veja a palestra de Paolo Soares na DartConf (janeiro de 2018):
O padrão BLoC foi concebido por Cong Hui, Paolo Soares e Wenfan Huang, no Google. Como você pode ver na palestra de Paolo, há muito mais no BLoC do que o que discutimos na nossa sessão do I/O. Entre outras coisas, o BLoC permite ao Google compartilhar código entre apps Flutter (mobile) e apps AngularDart (web), e Paolo dá algumas orientações sobre isso. Aqui, quero focar nos aspectos que se aplicam ao Flutter independentemente de você usar o componente em outros lugares.
Dito isso, seguem algumas observações adicionais sobre este padrão:
-
O BLoC não pressupõe uma forma específica de acessar o componente. Na palestra, mostro como você pode fazer isso com
InheritedWidget, mas nada impede que você o passe manualmente pelos construtores ou use alguma forma de injeção de dependência automática. -
Evite ter um BLoC como parâmetro de outro BLoC. Em vez disso, conecte apenas as saídas necessárias às entradas aplicáveis. Isso ajuda a evitar acoplamento forte.
-
Apps grandes precisam de mais de um BLoC. Um bom padrão é usar um componente de nível superior para cada tela e um para cada widget complexo o suficiente. Muitos BLoCs, porém, podem se tornar trabalhosos. Além disso, se você tiver centenas e centenas de observáveis (streams) no app, isso afeta negativamente o desempenho. Em outras palavras: não complique demais o seu app.
-
Em uma hierarquia de BLoCs, o BLoC de nível superior (de tela) normalmente é responsável por conectar os streams dos BLoCs filhos entre si. Falaremos mais sobre isso em um artigo posterior.
-
O BLoC é compatível com lógica do lado do servidor. O padrão não obriga você a reimplementar essa lógica no cliente (como o Flux/Redux exigiria). Basta envolver a lógica do servidor com um componente.
-
Uma desvantagem decorrente da assincronia dos streams é que, ao construir um
StreamBuilder, ele sempre mostrainitialDataprimeiro (porque está disponível de forma síncrona) e só depois exibe o primeiro evento vindo doStream. Isso pode causar um flash (um frame) de dados ausentes. Existem formas de evitar isso — fique de olho em um artigo mais detalhado. ATUALIZAÇÃO: se você usarrxdartna versão0.19.0ou superior, pode simplesmente usarValueObservablepara as saídas, e o flash do assíncrono deixa de ser um problema. -
A implementação interna do BLoC costuma ser feita de forma puramente funcional-reativa (sem estado auxiliar, apenas transformações puras de um stream em outro). Mas não há obrigação de fazer assim. Às vezes, é mais fácil e legível/fácil de manter expressar a lógica de negócio por meio de uma abordagem híbrida, imperativa e funcional (como eu fiz na palestra do I/O, embora isso tenha sido principalmente para economizar tempo).
Algumas pessoas pediram um exemplo de BLoC mais complexo. Recriei o app de compras em um exemplo mais realista, em que o catálogo de produtos é buscado na rede página por página, e temos uma lista infinita desses produtos. Além disso, para cada produto do catálogo, queremos alterar ligeiramente a apresentação do ProductSquare quando o produto já está no carrinho. As chamadas de rede são simuladas, mas a complexidade de conectar as diferentes partes está presente.
ProductSquare
mostram se o produto está no carrinho (sublinhando o nome do produto, por simplicidade).
Você encontra o código no repositório complementar, em lib/src/bloc_complex. Há um arquivo README com mais informações sobre esta versão.
Esperamos que a palestra e este artigo tenham sido úteis. Você pode querer assistir a outras palestras e vídeos sobre Flutter no YouTube.